IBM® Enterprise
Records fornisce
i seguenti eventi di esempio per i modelli di dati Base, DoD e PRO.
È possibile personalizzare gli esempi in base alle proprie esigenze. Vedere il file Leggimi nella cartella Events nel package del software.
Tabella 1. Eventi e descrizioniEventi |
Descrizione |
RMAutoDeclare |
Configura la dichiarazione automatica dei record. Quando un utente esegue un'operazione specifica su un documento (come ad esempio il check in o l'archiviazione in una cartella) in un ROS (Records Object Store), IBM Enterprise
Records automaticamente crea un record elettronico corrispondente in un FPOS (File Plan Object Store) specifico.
È possibile configurare anche questo evento di esempio per dichiarare, al momento del check in del documento, i documenti che appartengono ad un a classe documento specifica.
L'evento di esempio supporta solo la dichiarazione non classificata dei record elettronici. Questo evento deve essere configurato per utilizzare eventi asincroni e NON quelli sincroni.
|
RMAutoSynchronizeProperties |
Sincronizzare le proprietà dei record e dei relativi documenti associati. Ad esempio, quando un utente aggiorna un valore della proprietà di un recordIBM Enterprise
Records aggiorna il corrispondente valore della proprietà nel documento associato.
Questo evento di esempio funziona per le proprietà che utilizzano lo stesso nome simbolico.
È possibile eseguire la sincronizzazione da documento a record e da record a documento, ma non entrambe. Se si esegue la sincronizzazione da record a documento, IBM Enterprise
Records aggiorna il documento quando viene aggiornata la corrispondente proprietà del record.
Questo evento sincronizza anche gli alias delle proprietà tra archivi oggetti sia da record a documento che da documento a record, ma non entrambi.
|
RMUpdateDateDeclared RMLastRetrievalOfRecord
|
Insieme, questi eventi di esempio determinano quando disporre del contenitore o assicura che la pianificazione di disposizione non disponga di un contenitore in cui i record sono stati recentemente dichiarati o recuperati.
IBM Enterprise
Records applica questo evento di esempio alle classi Volume e Casella ed imposta la Data ultima dichiarazione nella cartella padre quando l'utente dichiara un record.
Per il modello di dati PRO, IBM Enterprise
Records sottoscrive automaticamente l'evento RMUpdateDateDeclared alla classe Volume o Casella e l'utente deve solo abilitarlo. Per gli altri modelli di dati, è necessario eseguire lo script di importazione per creare l'evento
RMUpdateDateDeclared e sottoscrivere la classe Volume o Casella.
RMLastRetrievalOfRecord imposta la data dell'ultima revisione del contenuto del record nella proprietà LastRetrievalofRecord della cartella.
|
RMSecurityPropagation |
(Solo PRO) Utilizzato solo nei modelli dati PRO, questo evento di esempio imposta il valore di contrassegno della proprietà Categoria sicurezza
del record, volume e cartella record (ma non categoria record) in base al livello più alto di un'entità associata.
Ad esempio, quando la propagazione avviene dal record alla cartella, IBM Enterprise
Records aggiorna la sicurezza della cartella padre se la sicurezza del record è superiore a quella della relativa cartella padre.
Non sono influenzate le altre cartelle in cui il record è archiviato.
Se la propagazione avviene dalla cartella al record, IBM Enterprise
Records porta la sicurezza dei record con un livello di sicurezza inferiore al livello di sicurezza più alto delle loro cartelle padre.
L'impostazione nella configurazione di sistema di FPOS PRO controlla in che modo viene propagata la sicurezza, dalla cartella al record, dal record alla cartella, entrambe oppure se la propagazione non è consentita.
|
RMSendEmailOnSupercede |
Questo evento di esempio causa l'invio di una e-mail ogni volta che un record viene sostituito da una nuova versione. Il messaggio di e-mail contiene i dettagli relativi alla descrizione del record sostitutivo, la data e l'ora in cui è stato sostituito. L'e-mail viene inviata quando il contenitore ha una pianificazione di disposizione che definisce un trigger basato sull'evento sostituzione.
Limitazione: Questo evento non è supportato in JBoss o WebLogic.
|
IBM Enterprise
RecordsI file jar del gestore di eventi di esempio
sono memorizzati come moduli di codice nell'archivio oggetti di destinazione. Il vantaggio è che è possibile aggiungere o aggiornare il gestore di eventi eseguendo il check in una nuova versione senza riavviare il server delle applicazioni.
La configurazione di un evento di esempio IBM Enterprise
Records è descritta di seguito:
Creazione di azioni dell'evento
Prima di avviare questa procedura, assicurarsi che la cartella denominata
CodeModules esista nella cartella principale dell'archivio oggetti in cui si ha intenzione di creare le azioni dell'evento. Se tale cartella non esiste, seguire le istruzioni in IBM FileNet P8 Platform Installation and Upgrade Guide per creare la cartella.
- Copiare la cartella nella directory principale ~CDRoot\RecordsManager.<platform>\Events,
nel server su cui è in esecuzione EM. Questa cartella contiene gli script di importazione, file JAR e file di configurazione.
- Eseguire gli script di importazione opportuni per creare le azioni dell'evento che si desidera utilizzare.
- Fare clic con il tasto destro del mouse sull'archivio oggetti IBM Enterprise
Records di destinazione.
- Selezionare Importa tutto.
- Nella finestra di dialogo Importa assistente, nella scheda Importa opzioni, nel campo Importa file Manifest, sfogliare la cartella copiata e selezionare lo script di importazione per l'evento richiesto. Ciascun file è denominato dopo l'evento.
Ad esempio, il file di importazione per l'evento RMAutoDeclare viene denominato RMAutoDeclareImport.xml.
- Nel campo Percorso contenuto esterno sfogliare la cartella ~\Events\lib.
- Fare clic su Importa.
Dopo aver completato l'importazione, dovrebbe essere visualizzato un messaggio "Importazione riuscita". L'azione dell'evento dovrebbe essere creata nella cartella Azione dell'evento dell'archivio oggetti e i moduli di codice verranno creati nella cartella Modulo di codice.
Personalizzazione dei file di configurazione
Gli eventi RMAutoDeclare
e RMSendEmailOnSupercede hanno loro propri file di configurazione.
Lo script di importazione crea i file nell' archivio oggetti:
- Il file di configurazione RMAutoDeclare è RMAutoDeclare.properties nella cartella Root
Folder\RM Samples.
- Il file di configurazione RMSendEmailOnSupercede è RMSendEmailOnSupercede.properties nella stessa cartella
Root Folder\RM Samples.
Estrarre il file di configurazione da Workplace o Workplace XT o Enterprise Manager. Dopo la modifica, eseguire il check-in. Consultare Configurazione dell'autodichiarazione di record. Per il file RMSendEmailOnSupercede
i commenti che precedono la riga che si modifica sono auto-esplicativi
(host SMTP, numero porta, indirizzi e-mail mittente e destinatario).
Creazione sottoscrizioni
Ogni evento richiede le sottoscrizioni ad una o più classi.
Sottoscrizione dell'evento RMAutoDeclare
- In Enterprise Manager, spostarsi in Archivi oggetto/ROS/Classe documento o sottoclasse in cui si desidera creare la sottoscrizione.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigger evento Check in.
- Nella schermata Specifica azione dell'evento, selezionare l'azione dell'evento importata.
- Nella schermata Specifica proprietà aggiuntive non selezionare la casella di spunta Sincrono come consigliato
e selezionare o deselezionare la casella di spunta Includi sottoclassi opportunamente per ciascun evento e completare la procedura guidata.
Per sottoscrivere la classe cartella o sottoclasse
- In Enterprise Manager, spostarsi in Archivi oggetto/ROS/Classe documento o sottoclasse in cui si desidera creare la sottoscrizione.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigegr evento Archiviazione.
- Non selezionare la casella di controlloSincrono, come consigliato e selezionare o deselezionare la casella di controllo
Includi sottoclassi opportunamente e completare la procedura guidata.
Per sottoscrivere in una specifica cartella nel ROS:
- In Enterprise Manager, passare alla cartella in cui si desidera creare la sottoscrizione.
- Fare clic con il tasto destro del mouse e selezionare Nuova sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Accettare il valore predefinito.
- Selezionare il trigger evento Archiviazione.
- Nella schermata Specifica azione dell'evento, selezionare l'evento RMAutoDeclare.
- Nella schermata Specifica proprietà aggiuntive, non selezionare la casella di controllo Sincrono, come consigliato, ed accettare le restanti impostazioni di default e completare la procedura guidata.
Sottoscrizione dell'evento RMAutoSynchronizeProperties
La sottoscrizione dell'evento
RMAutoSynchronizeProperties sincronizza le proprietà dal documento origine al relativo record o dal record al relativo documento origine.
Non tentare di effettuare la sincronizzazione in entrambe le direzioni.
Questo evento deve essere configurato per utilizzare eventi sincroni.
Per sincronizzare dal documento origine al relativo record:
- In Enterprise Manager, spostarsi in Archivi oggetto/ROS/Classe documento o sottoclasse.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigger evento Aggiornamento.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, selezionare la casella di spunta Sincrono, ma deselezionare la casella di spunta Includi sottoclassi e completare la procedura guidata.
Per sincronizzare dal record al relativo documento origine
- In Enterprise Manager, spostarsi in Archivi oggetto/ROS/Classe documento o sottoclasse.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigger evento Aggiornamento.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, selezionare la casella di spunta Sincrono, ma deselezionare la casella di spunta Includi sottoclassi e completare la procedura guidata.
Sottoscrizione dell'evento RMLastRetrievalOfRecord
Per sottoscrivere l'evento
RMLastRetrievalOfRecord:
- In Enterprise Manager, spostarsi in Archivi oggetto/FPOS/Altre classi/CustomObject/Classe Sistema RM.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigger evento Creazione.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, deselezionare la casella di controllo Includi sottoclassi, selezionare la casella di controlloSincrono e completare la procedura guidata.
Sottoscrizione dell'evento RMSecurityPropagation (Solo per PRO).
È possibile creare una sottoscrizione per questo evento per la classe Cartella record, la classe Volume o la classe Record.
Per sottoscrivere l'evento per la classe Cartella record
- In Enterprise Manager, spostarsi in Archivi oggetto/PRO-FPOS/Altre classi/Cartella/Cartella RM/Classe Cartella record.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare i trigger evento Archiviazione e Aggiornamento.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, deselezionare la casella di controllo Includi sottoclassi e completare la procedura guidata.
Per sottoscrivere l'evento per la classe Volume:
- In Enterprise Manager, spostarsi in Archivi oggetto/PRO FPOS/Altre classi/Cartella/Cartella RM/Classe Volume.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare i trigger evento Archiviazione e Aggiornamento.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, deselezionare la casella di controllo Includi sottoclassi e completare la procedura guidata.
Per sottoscrivere l'evento per la classe Record:
- In Enterprise Manager, spostarsi in Archivi oggetto/PRO-FPOS/Classe documenti/Classe Record.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigger evento Aggiornamento.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, selezionare la casella di controllo Includi sottoclassi e completare la procedura guidata.
Sottoscrizione dell'evento RMSendEmailOnSupercede
Per sottoscrivere
l'evento RMSendEmailOnSupercede
- In Enterprise Manager, spostarsi in Archivi oggetto/FPOS/Classe documenti/Classe Record.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigger evento Aggiornamento e Check in.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, selezionare la casella di controllo Includi sottoclassi e completare la procedura guidata.
Sottoscrizione dell'evento RMUpdateDateDeclared
Per il modello di dati
PRO, è necessario abilitare l'evento già esistente come di seguito riportato:
- In Enterprise Manager, spostarsi nella cartella Archivi oggetti/FPOS/Eventi/Azione evento.
- Fare clic con il tasto destro del mouse su UpdateDateDeclared.
- Fare clic su Abilita.
Per i modelli di dati DoD e Base, sottoscrivere la Categoria record, Volume
e classi Casella dopo aver creato l'evento.
Sottoscrivere l'evento per la classe categoria record
- In Enterprise Manager, spostarsi in Archivi oggetto/<FPOS>/Altre classi/Cartella/Cartella RM/Categoria record.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigegr evento Archiviazione.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, deselezionare la casella di controllo Includi sottoclassi e completare la procedura guidata.
Per sottoscrivere l'evento per la classe Volume:
- In Enterprise Manager, spostarsi in Archivi oggetto/FPOS/Altre classi/Cartella/Cartella RM/Volume.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigegr evento Archiviazione.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, deselezionare la casella di controllo Includi sottoclassi e completare la procedura guidata.
Per sottoscrivere l'evento per la classe Casella
- In Enterprise Manager, spostarsi in Archivi oggetto/FPOS/Altre classi/Cartella/Cartella RM/Casella.
- Fare clic con il tasto destro del mouse e selezionare Aggiungi sottoscrizione.
- Specificare un nome univoco e una descrizione per la sottoscrizione.
- Selezionare il pulsante di scelta Applica a tutte le istanze.
- Nella schermata Specifica trigger, selezionare il trigegr evento Archiviazione.
- Selezionare l'azione dell'evento importata
- Nella schermata Specifica proprietà aggiuntive, deselezionare la casella di controllo Includi sottoclassi e completare la procedura guidata.
Per informazioni relative alla personalizzazione degli eventi, fare riferimento al package del software P8.