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. Consultez le fichier readme dans le dossier Events (Evénements) du 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 (telle que la restitution ou la sauvegarde dans un dossier) sur un document de la librairie d'enregistrements (ROS), IBM Enterprise
Records crée automatiquement un enregistrement électronique correspondant dans une librairie de plans de fichiers spécifique (FPOS). 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. Ces exemples d'événements vous assurent également qu'un planning d'élimination n'élimine pas un conteneur dans lequel les enregistrements sont 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 vous devez activer l'événement. 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 à la propriété LastRetrievalofRecord du 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 est de l'enregistrement à dossier, 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é bas vers le niveau de sécurité le plus élevé de leurs dossiers parent.
Le paramètre de configuration du système pour la librairie de plan de fichiers PRO détermine la façon dont la sécurité est propagée. Les options de cette propagation sont : 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 informations détaillées sur la description du remplacement, et la date et l'heure auxquelles il a été remplacé. Le courrier électronique est envoyé lorsque le conteneur comporte un planning d'élimination qui définit un déclencheur basé sur un é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 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.
Pour créer des actions liées à un événement, procédez comme suit :
- Copiez le dossier sous la racine du CD, ~CDRoot\RecordsManager.<platform>\Events, sur le serveur sur lequel vous exécutez IBM Administration
Console for Content Platform Engine. 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 (Aide à l'importation), onglet Import Options (Options d'importation), zone Import Manifest File (Importer le fichier de manifeste), accédez au dossier que vous avez copié. Sélectionnez le script d'importation
pour l'événement requis. 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 voyez un message signalant la réussite de l'importation. L'action d'événement peut être créée sous le dossier Event Action (Action d'événement) de la librairie. Les modules de code sont créés dans le dossier Code Module (Module de code).
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 :
- 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 IBM Administration
Console for Content Platform Engine. Une fois le fichier édité, restituez-le. Pour plus d'informations, voir la rubrique Configuration de la déclaration automatique des enregistrements. Dans le fichier RMSendEmailOnSupercede, les commentaires précédant la ligne que vous modifiez sont explicites : hôte SMTP, numéro de port, émetteur et adresses électroniques du récepteur.
Création de souscriptions
Chaque événement nécessite des souscriptions à une ou plusieurs classes.
Souscription à l'événement RMAutoDeclare
Pour créer la souscription, procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, accédez à Object Stores/ROS/Document class ou à la 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).
- Sur l'écran de spécification d'action d'événement (Specify Event Action), sélectionnez l'action d'événement que vous avez importé.
- Sur l'écran de spécification de propriétés supplémentaires (Specify Additional Properties), désélectionnez la case à cocher Synchronous (Synchrone), cochez ou décochez la case à cocher Include Subclasses (Inclure les sous-classes) comme il convient pour chaque événement, et suivez l'assistant.
Pour souscrire à la classe ou sous-classe Folder (Dossier), procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, accédez à Object
Stores/ROS/Folder class ou à la 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 à cocher Synchronous (Synchrone), cochez ou décochez la case à cocher Include Subclasses (Inclure les sous-classes), le cas échéant, et fermez l'assistant.
Pour souscrire à une classe spécifique de la librairie des enregistrements :
- Dans IBM Administration
Console for Content Platform Engine, 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), désélectionnez la case à cocher Synchronous (Synchrone), acceptez le reste des paramètres par défaut, et suivez 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 IBM Administration
Console for Content Platform Engine, accédez à Object
Stores/ROS/Document class ou à la
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, procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, accédez à Object
Stores/ROS/Document class ou à la
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 IBM Administration
Console for Content Platform Engine, 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), procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, 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 IBM Administration
Console for Content Platform Engine, 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 IBM Administration
Console for Content Platform Engine, 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, procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, 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. Pour cela, procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, 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), procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, 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 IBM Administration
Console for Content Platform Engine, 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), procédez comme suit :
- Dans IBM Administration
Console for Content Platform Engine, 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 package logiciel FileNet P8.