IBM® Enterprise
Records fournit les exemples d'événements suivants pour les modèles de données Base, DoD et PRO.
Vous pouvez personnaliser ces exemples selon vos besoins. Pour plus d'informations, voir le fichier LisezMoi du dossier Events (Evénements) dans le progiciel.
Tableau 1. Evénements et descriptionsÉvénements |
Description |
RMAutoDeclare |
Configure la déclaration automatique d'enregistrements. Lorsqu'un utilisateur effectue une opération spécifique (restitution ou classement dans un dossier) sur un document de la librairie des enregistrements (ROS), IBM Enterprise
Records crée automatiquement un enregistrement électronique correspondant dans une librairie de plans de fichiers.
Vous pouvez aussi configurer cet exemple d'événement de manière à déclarer chaque document appartenant à une classe de document spécifique lorsqu'un utilisateur restitue le document.
Cet exemple d'événement prend uniquement en charge la déclaration déclassifiée d'un enregistrement électronique. Cet événement doit être configuré pour utiliser des événements asynchrones et non des événements synchrones.
|
RMAutoSynchronizeProperties |
Synchronise les propriétés des enregistrements et les documents associés. Par exemple, lorsqu'un utilisateur met à jour la valeur d'une propriété d'un enregistrement, IBM Enterprise
Records met à jour la valeur de propriété correspondante dans les documents associés.
Cet exemple d'événement ne fonctionne qu'avec les propriétés qui utilisent le même nom symbolique.
Vous pouvez effectuer une synchronisation d'un enregistrement vers un document ou d'un document vers un enregistrement, mais vous ne pouvez pas faire les deux. Si vous effectuez une synchronisation d'un enregistrement vers un document, IBM Enterprise
Records met à jour le document lorsque la propriété correspondante de l'enregistrement est mise à jour.
Cet événement synchronise également des propriétés ayant un alias dans des librairies d'objets, d'un enregistrement vers un document ou d'un document vers un enregistrement, mais pas dans les deux sens à la fois.
|
RMUpdateDateDeclared RMLastRetrievalOfRecord
|
Ensemble, ces exemples d'événement déterminent quand éliminer un conteneur ou s'assurent qu'un planning d'élimination n'élimine pas un conteneur dans lequel des enregistrements ont été récemment déclarés ou extraits.
IBM Enterprise
Records applique cet exemple d'événement aux classes Volume et Boîte et définit la date de la dernière déclaration dans le dossier parent lorsqu'un utilisateur déclare un enregistrement.
Pour le modèle de données PRO, IBM Enterprise
Records abonne automatiquement l'événement RMUpdateDateDeclared à la classe Volume ou Boîte, et il vous suffit de l'activer.
Dans le cas des autres modèles de données, vous devez exécuter le script d'importation pour créer l'événement RMUpdateDateDeclared et souscrire à la classe Volume ou Box (Boîte).
RMLastRetrievalOfRecord définit la date de la dernière révision du contenu d'un enregistrement dans la propriété LastRetrievalofRecord de son dossier.
|
RMSecurityPropagation |
(PRO uniquement) Utilisé uniquement pour le modèle de données PRO, cet exemple d'événement définit la valeur de marquage de la propriété Security Category (Catégorie de sécurité) de l'enregistrement, du volume et du dossier d'enregistrement (mais pas de la catégorie d'enregistrement) en fonction du niveau le plus élevé d'une entité associée.
Par exemple, si la propagation de l'enregistrement à dossier est définie, IBM Enterprise
Records met à jour la sécurité du dossier parent si la sécurité de l'enregistrement est supérieure à celle de son dossier parent.
Les autres dossiers dans lesquels l'enregistrement est classé ne sont pas affectés.
Si la propagation de dossier à enregistrement est définie, IBM Enterprise
Records met à jour la sécurité des enregistrements d'un niveau de sécurité inférieur vers le niveau de sécurité le plus élevé de leurs dossiers parent.
C'est le paramétrage des librairies de plans de fichiers PRO dans la configuration système qui détermine la façon dont la sécurité est propagée : de dossier à enregistrement, d'enregistrement à dossier, dans les deux sens ou aucune propagation autorisée.
|
RMSendEmailOnSupercede |
Cet exemple d'événement provoque l'envoi d'un courrier électronique chaque fois qu'un enregistrement est remplacé par une nouvelle version. Le message électronique contient des détails sur l'enregistrement de remplacement (description, date et heure du remplacement). Il est envoyé lorsque le conteneur comporte un planning d'élimination qui définit un déclencheur basé sur l'événement de remplacement.
Restriction : Cet événement n'est pas pris en charge sous JBoss et WebLogic.
|
Les fichiers .jar du gestionnaire d'exemples d'événement IBM Enterprise
Records sont stockés sous forme de modules de code dans la librairie d'objets cible. Cela présente un avantage : vous pouvez ajouter ou mettre à jour le gestionnaire d'événements en optant pour une nouvelle version dans redémarrer le serveur d'applications.
La configuration des exemples d'événements IBM Enterprise
Records s'effectue à l'aide des tâches suivantes :
Création d'actions d'événement
Avant d'entamer cette procédure, vérifiez que le dossier CodeModules existe dans le dossier racine de la librairie d'objets dans laquelle vous allez créer des actions d'événement. Si ce dossier n'existe pas, suivez les instructions du manuel IBM FileNet P8 Platform Installation
and Upgrade Guide pour le créer.
- Copiez le dossier sous la racine CDroot (~CDRoot\RecordsManager.<plateforme>\Events) du serveur sur lequel vous exécutez EM. Ce dossier contient les scripts d'importation, les fichiers JAR et les fichiers de configuration.
- Exécutez les scripts d'importation appropriés pour créer les actions d'événement que vous souhaitez utiliser.
- Cliquez avec le bouton droit de la souris sur la librairie d'objets cible IBM Enterprise
Records.
- Sélectionnez Import All (Tout importer).
- Dans la boîte de dialogue Import Helper (Assistant d'importation), sous l'onglet Import Options (Options d'importation), dans le champ Import Manifest File (Fichier de manifeste d'importation), naviguez jusqu'au dossier que vous avez copié et sélectionnez le script d'importation associé à l'événement choisi. Chaque fichier porte un nom reflétant l'événement.
Par exemple, le fichier d'importation de l'événement RMAutoDeclare se nomme RMAutoDeclareImport.xml.
- Dans le champ External Content Path (Chemin de contenu externe), naviguez jusqu'au dossier ~\Events\lib.
- Cliquez sur Import (Importer).
Une fois l'importation terminée, vous devez voir s'afficher un message signalant la réussite de l'importation. L'action d'événement doit être créée sous le dossier d'action d'événement (Event Action) de la librairie d'objets et les modules de code doivent être créés dans le dossier de modules de code (Code Module).
Personnalisation des fichiers de configuration
Les événements RMAutoDeclare
et RMSendEmailOnSupercede possèdent leurs propres fichiers de configuration.
Le script d'importation crée les fichiers dans la librairie d'objets :
- Le fichier de configuration RMAutoDeclare se nomme RMAutoDeclare.properties et se trouve sous le dossier Root
Folder\RM Samples.
- Le fichier de configuration RMSendEmailOnSupercede se nomme RMSendEmailOnSupercede.properties et se trouve sous le même dossier Root Folder\RM Samples.
Effectuez l'extraction du fichier de configuration à partir de Workplace ou Workplace XT ou Enterprise Manager. Une fois le fichier édité, restituez-le. Voir Configuration de la déclaration automatique des enregistrements. Concernant le fichier RMSendEmailOnSupercede, les commentaires précédant la ligne que vous modifiez sont significatifs (hôte SMTP, numéro de port, émetteur et destinataire courrier électronique).
Création de souscriptions
Chaque événement nécessite des souscriptions à une ou plusieurs classes.
Souscription à l'événement RMAutoDeclare
- Dans Enterprise Manager, naviguez jusqu'à la classe Object Stores/ROS/Document
class ou sous-classe dans laquelle vous souhaitez créer l'abonnement.
- Cliquez avec le bouton droit de la souris sur la classe et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement Check In (Restituer).
- Dans l'écran de spécification d'action d'événement (Specify Event Action), sélectionnez l'action d'événement que vous avez importée.
- Sur l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case Synchrone, comme recommandé, et sélectionnez ou désélectionnez la case Include Subclasses (Inclure les sous-classes) si nécessaire pour chaque événement, puis terminez la procédure de l'assistant.
Pour souscrire à la classe ou sous-classe Folder (Dossier) :
- Dans Enterprise Manager, accédez à la classe Object Stores/ROS/Folder
class ou sous-classe dans laquelle vous souhaitez créer l'abonnement.
- Cliquez avec le bouton droit de la souris sur la classe et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement File (Fichier).
- Désélectionnez la case Synchrone, comme recommandé, et activez ou désélectionnez la case Include Subclasses (Inclure les sous-classes) si nécessaire pour chaque événement, puis terminez la procédure de l'assistant.
Pour souscrire à une classe spécifique de la librairie des enregistrements :
- Dans Enterprise Manager, accédez au dossier dans lequel vous souhaitez créer l'abonnement.
- Cliquez avec le bouton droit de la souris sur le dossier et sélectionnez New Subscription (Nouvelle souscription).
- Indiquez un nom unique et une description pour la souscription.
- Acceptez les valeurs par défaut.
- Sélectionnez le déclencheur d'événement File (Fichier).
- Dans l'écran de spécification d'action d'événement (Specify Event Action), sélectionnez l'événement RMAutoDeclare.
- Sur l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), ne sélectionnez pas la case Synchrone, comme recommandé, et acceptez le reste des paramètres par défaut, puis terminez la procédure de l'assistant.
Souscription à l'événement RMAutoSynchronizeProperties
La souscription à l'événement RMAutoSynchronizeProperties permet de synchroniser les propriétés du document source vers son enregistrement ou de l'enregistrement vers son document source.
Ne tentez pas d'effectuer une synchronisation dans les deux sens.
Cet événement doit être configuré pour utiliser des événements synchrones.
Pour effectuer une synchronisation du document source vers son enregistrement :
- Dans Enterprise Manager, accédez à la classe Object Stores/ROS/Document à la
class ou sous-classe.
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement Update (Mettre à jour).
- Sélectionnez l'action d'événement que vous avez importée.
- Sur l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), sélectionnez la case Synchrone, mais désélectionnez la case Include Subclasses (Inclure les sous-classes) désélectionnée et terminez la procédure de l'assistant.
Pour effectuer une synchronisation de l'enregistrement vers son document source :
- Dans Enterprise Manager, accédez à la classe Object Stores/ROS/Document à la
class ou sous-classe.
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement Update (Mettre à jour).
- Sélectionnez l'action d'événement que vous avez importée.
- Sur l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), sélectionnez la case Synchrone, mais désélectionnez la case Include Subclasses (Inclure les sous-classes) désélectionnée et terminez la procédure de l'assistant.
Souscription à l'événement RMLastRetrievalOfRecord
Pour souscrire à l'événement RMLastRetrievalOfRecord :
- Dans Enterprise Manager, accédez à Object Stores/FPOS/Other Classes/CustomObject/RM
System class.
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement Creation (Création).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case Include Subclasses (Inclure les sous-classes), sélectionnez la case Synchronous (Synchrone) et terminez la procédure de l'assistant.
Souscription à l'événement RMSecurityPropagation
Vous pouvez créer une souscription à cet événements pour la classe Record Folder (Dossier d'enregistrement), Volume et Record (Enregistrement).
Pour souscrire à cet événement pour la classe Record Folder (Dossier d'enregistrement) :
- Dans Enterprise Manager, accédez à Object Stores/PRO-FPOS/Other Classes/Folder/RM
Folder/Record Folder class.
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez les déclencheurs d'événement File (Fichier) et Update (Mettre à jour).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case Include
Subclasses (Inclure les sous-classes) et terminez la procédure de l'assistant.
Pour souscrire à cet événement pour la classe Volume :
- Dans Enterprise Manager, accédez à Object Stores/PRO FPOS/Other Classes/Folder/RM
Folder/Volume class.
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez les déclencheurs d'événement File (Fichier) et Update (Mettre à jour).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case Include
Subclasses (Inclure les sous-classes) et terminez la procédure de l'assistant.
Pour souscrire à cet événement pour la classe Record (Enregistrement) :
- Dans Enterprise Manager, accédez à Object Stores/PRO-FPOS/Document Class/Record
class.
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement Update (Mettre à jour).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), sélectionnez la case Include
Subclasses (Inclure les sous-classes) et terminez la procédure de l'assistant.
Souscription à l'événement RMSendEmailOnSupercede
Pour souscrire à l'événement RMSendEmailOnSupercede :
- Dans Enterprise Manager, accédez à Object Stores/FPOS/Document Class/Record
class.
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez les déclencheurs d'événement Update (Mettre à jour) et Check In (Restituer).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), sélectionnez la case Include
Subclasses (Inclure les sous-classes) et terminez la procédure de l'assistant.
Souscription à l'événement RMUpdateDateDeclared
Pour le modèle de données PRO, vous devez activer un événement déjà existant en procédant comme suit :
- Dans Enterprise Manager, accédez au dossier Object Stores/FPOS/Events/Event
Action.
- Cliquez avec le bouton droit de la souris sur UpdateDateDeclared.
- Cliquez sur Enable (Activer).
Pour les modèles de données DoD et Base, souscrivez aux classes Record
Category (Catégorie d'enregistrement), Volume et Box (Boîte) après avoir créé l'événement.
Pour souscrire à cet événement pour la classe Record Category (Catégorie d'enregistrement) :
- Dans Enterprise Manager, accédez à Object Stores/<FPOS>/Other Classes/Folder/RM Folder/Record
Category
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement File (Fichier).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case Include
Subclasses (Inclure les sous-classes) et terminez la procédure de l'assistant.
Pour souscrire à cet événement pour la classe Volume :
- Dans Enterprise Manager, accédez à Object Stores/FPOS/Other Classes/Folder/RM
Folder/Volume
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement File (Fichier).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case Include
Subclasses (Inclure les sous-classes) et terminez la procédure de l'assistant.
Pour souscrire à cet événement pour la classe Box (Boîte) :
- Dans Enterprise Manager, accédez à Object Stores/FPOS/Other Classes/Folder/RM
Folder/Physical Container/Box
- Cliquez avec le bouton droit de la souris et sélectionnez Add Subscription (Ajouter une souscription).
- Indiquez un nom unique et une description pour la souscription.
- Sélectionnez le bouton d'option Applies to all instances (Appliquer à toutes les instances).
- Dans l'écran de spécification des déclencheurs (Specify Triggers), sélectionnez le déclencheur d'événement File (Fichier).
- Sélectionnez l'action d'événement que vous avez importée.
- Dans l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case Include
Subclasses (Inclure les sous-classes) et terminez la procédure de l'assistant.
Pour plus d'informations sur la personnalisation d'événements, voir le progiciel P8.