Mise à jour d'un document Domino
Utilisez l'activité Mettre à jour les documents pour mettre à jour un document dans la base de données Domino. Chaque document mis à jour doit être identifiable de manière unique par son UniversalID ou NotesID.
Utilisation de l'activité Mettre à jour
- Cliquez avec le bouton droit de la souris sur Orchestration dans le panneau Projet et cliquez sur Nouvelle orchestration pour créer ou ouvrir une orchestration. Le panneau d'orchestration est affiché.
- Sélectionnez l'onglet Activités et développez le dossier Domino.
- Faites glisser l'activité Mettre à jour du dossier Domino sur l'orchestration. La représentation graphique de l'orchestration, y compris le panneau de liste de contrôle, apparaît.
- Le panneau Liste de contrôle répertorie les tâches (Récapitulatif, Sélectionner le noeud final, Configurer, Mapper les entrées, Mapper les sorties) que vous devez effectuer pour configurer l'activité sortante.
- Cliquez sur Sélectionner le noeud final, puis sélectionnez un noeud final Domino.
Vous trouverez des instructions pour la création ou l'édition d'un noeud final Domino dans la section Création ou édition d'un noeud final pour une activité Domino.
- Cliquez sur Configurer dans la Liste de contrôle. Le panneau Configurer s'affiche.
- Cliquez sur Parcourir pour sélectionner une base de données existante dans le panneau Parcourir les bases de données Domino. Le panneau Parcourir les bases de données Domino affiche toutes les bases de données du noeud final sélectionné.
- Cliquez sur Suivant pour sélectionner un formulaire existant dans le panneau Parcourir les formulaires Domino. Le panneau Parcourir les formulaires Domino affiche tous les formulaires se trouvant dans la base de données sélectionnée du serveur Domino.
Spécification des entrées de mappe pour l'activité Mettre à jour
- Cliquez sur Mapper les entrées dans le panneau Liste de contrôle. Les paramètres d'entrée de l'activité Domino spécifique sont affichés dans le panneau Vers l'activité. Les paramètres d'entrée sont définis dans le tableau suivant.
Nom de paramètre Description UniversalID Le paramètre UniversalID d'un document est une propriété en lecture/écriture qui identifie de manière unique un document dans toutes les répliques d'une base de données. Au format alphanumérique, un UniversalID est une combinaison de 32 chiffres hexadécimaux (0 à 9, A à F). L'UniversalID est également appelé ID unique ou UNID. Son type de données est Chaîne (String). NotesID Le NotesID d'un document est une propriété en lecture seule et possède une valeur hexadécimale comptant jusqu'à 8 caractères, qui identifie de manière unique un document dans une base de données particulière. Un NotesID représente l'emplacement d'un document au sein d'un fichier de base de données spécifique. Par conséquent, les documents qui sont des répliques les uns des autres ont généralement des NotesID différents. Un NotesID ne change pas, sauf si le document est supprimé. Remarque : Vous devez mapper les paramètres d'entrée de l'activité.Remarque : Pour peupler les champs du document Domino ajoutés dynamiquement (et qui ne font donc pas partie de la structure de mappe des entrées), utilisez la propriété AdditionalFields et fournissez les noms et les valeurs des champs en question dans la section FieldDetails.
Lorsque le type de formulaire est le même pour plusieurs bases de données, vous pouvez spécifier le nom de la base de données dans les paramètres optionnels de la tâche Mapper les entrées, endroit où la même orchestration peut être utilisée pour effectuer des opérations sortantes sur différentes bases de données. Pour cela, vous devez spécifier le nom de base de données dans le paramètre optionnel databaseName (décrit au tableau 1). Si une valeur est attribuée au paramètre databaseName, l'opération sortante est réalisée sur la base de données désignée par cette valeur. Si aucune valeur n'est attribuée à ce paramètre, l'opération sortante est exécutée sur la base de données spécifiée dans la configuration.
Paramètres optionnels pour une activité Domino
Nom de paramètre | Description |
---|---|
MarkAsRead | Spécifie si le document doit être marqué comme lu pendant une opération de mise à jour. Il est de type booléen. |
MakeResponse | Spécifie si le document doit être mis à disposition en tant que réponse du document sauvegardé, y compris si un autre utilisateur modifie et sauvegarde le document. Il est de type booléen. |
ForceSave | Spécifie si la sauvegarde du document doit être imposée pendant un conflit d'une opération de mise à jour. Il est de type booléen. |
databaseName | databaseName est le nom de la base de données dans laquelle le document est mis à jour. Si une valeur est fixée pour ce paramètre, elle annule et remplace la valeur spécifiée pour la base de données dans le panneau Configurer. Ce paramètre est utile lorsque des documents à la structure (forme) identique doivent être mis à jour dans plusieurs bases de données à l'aide de la même orchestration. |
Paramètres | Description |
---|---|
Paramètres dominoConnectionProperties | |
hostName | Spécifie le nom d'hôte ou l'adresse IP de la machine sur laquelle le serveur Domino s'exécute. |
diiopPort | Port DIIOP (Domino Internet Inter-ORB Protocol) qui permet aux applets ou aux applications Java d'accéder à des données Domino distantes via CORBA. La valeur par défaut est 63148. |
username | Spécifie le nom d'utilisateur pour la connexion au serveur Domino. |
password | Spécifie le mot de passe associé au nom d'utilisateur pour la connexion au serveur Domino. |
Paramètres connectionPool | |
minimumConnections | Spécifie le nombre minimal de connexions au serveur Domino que le dispositif d'intégration maintient ouvertes dans le pool de connexions. La valeur 0 (zéro) est prise en charge. La valeur par défaut est 5. |
maximumConnections | Spécifie le nombre maximal de connexions au serveur Domino que le dispositif d'intégration peut maintenir ouvertes dans le pool de connexions. La valeur 0 (zéro) signifie que le nombre de connexions est illimité. La valeur par défaut est 25. |
maxIdleTime | Spécifie la durée en minutes pendant laquelle une connexion au serveur Domino peut rester ouverte tout en étant inactive avant d'être fermée par le dispositif d'intégration. La valeur 0 (zéro) signifie que les connexions sont fermées lorsqu'elles sont renvoyées vers le pool - pas de délai d'inactivité. La valeur par défaut est 120 minutes. |
maxWait | Spécifie la durée en secondes pendant laquelle le dispositif d'intégration attend une connexion lorsque toutes les connexions du pool sont utilisées. S'il n'obtient pas de connexion après ce délai, une exception est émise. La valeur par défaut est 300 secondes. |
reclaimConnections | Spécifie l'intervalle suivant lequel le connecteur recherche les connexions inactives. Les connexions inactives sont récupérées jusqu'à ce que le nombre minimal de connexions, défini par le paramètre Nombre minimal de connexions, soit atteint. La valeur par défaut est de 5 minutes. |
Spécification des sorties de mappe pour une activité Domino
- Cliquez sur Mapper les sorties dans le panneau Liste de contrôle.
Les paramètres de sortie de l'activité Domino sont affichés dans le panneau Depuis l'activité.
Remarque : Vous pouvez mapper les paramètre de sortie de cette activité en fonction des besoins.
Comportement de la balise Summary (balise de zone)
Lorsqu'un document est mis à jour pour un formulaire contenant des zones de type Auteurs, Lecteurs ou Noms et que des données sont définies pour ces zones dans l'entrée de mappe, la balise Summary est définie avec les permissions appropriées en fonction du type de zone Domino. Cette fonctionnalité est supportée à compter de la version 8.5.3 du serveur Domino.
- Si une zone Domino du type Auteurs est définie avec une valeur CN=SYSTEM/O=IBM, la balise Summary sera alors SUMMARY READ/WRITE-ACCESS NAMES "CN=SYSTEM/O=IBM".
- Si une zone Domino du type Lecteurs est définie avec une valeur CN=SYSTEM/O=IBM, la balise Summary sera alors SUMMARY READ-ACCESS NAMES "CN=SYSTEM/O=IBM".
- Si une zone Domino du type Noms est définie avec une valeur CN=SYSTEM/O=IBM, la balise Summary sera alors SUMMARY NAMES "CN=SYSTEM/O=IBM".