Extraction d'un document Domino

L'activité Extraire permet d'extraire un document à partir d'une base de données Domino. Chaque document extrait est identifié de manière unique par son UniversalID ou NotesID. L'extraction est effectuée selon l'entrée, c-à-d. son UniversalID ou NotesID.

Utilisation de l'activité Extraire

  1. 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é.
  2. Sélectionnez l'onglet Activités et développez le dossier Domino.
  3. Faites glisser l'activité Extraire du dossier Domino vers l'orchestration. Une représentation graphique de l'orchestration, y compris le panneau Liste de contrôle, apparaît.
  4. 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.
  5. 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.

  6. Cliquez sur Configurer dans la Liste de contrôle. La tâche Configuration apparaît.
    • 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.
      Remarque : Le bouton Suivant est activé uniquement après la sélection du nom de la base de données.
    • Dans la zone Champs avec des noms canoniques, vous pouvez spécifier des noms de champs canoniques avec des valeurs telles que John Smith/IBM/COUNTRY, en veillant à les séparer par des virgules. Cela peut être utile si vous voulez convertir les valeurs dans ces champs en adresses mail internet telles que johnsmith@country.ibm.com. Exemples de noms de champs : De, A, CC, Organisateur, Participants obligatoires, etc.

Spécification des entrées de mappe pour l'activité Extraire

Le paramètre d'entrée pour l'activité Extraire est UniversalID ou NotesID. Lorsque les deux sont indiqués, UniversalID est utilisé pour extraire le document Domino.
  1. 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é. Certains paramètres d'entrée communs sont définis dans le tableau suivant.
    Nom de paramètre Description
    UniversalID Le paramètre UniversalID 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, le paramètre ID unique est une combinaison de 32 caractères de 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 L'ID Notes 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. L'ID Notes 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 ID Notes différents. Un ID Notes ne change pas, sauf si le document est supprimé.
    Remarque : Vous devez mapper les paramètres d'entrée de l'activité.

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
Le paramètre d'entrée optionnel est décrit dans le tableau suivant :
Tableau 1. Paramètres optionnels
Nom de paramètre Description
databaseName databaseName est le nom de la base de données d'où le document est extrait. 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 extraits de plusieurs bases de données à l'aide de la même orchestration.
Le connecteur Domino permet aussi au noeud final de se connecter dynamiquement à un autre serveur Domino. A l'exécution, si vous voulez vous connecter dynamiquement à un serveur Domino autre que celui qui est configuré dans la page du noeud final, ajoutez les nouveaux paramètres optionnels dans les dominoConnectionProperties de la mappe des entrées. Les paramètres des dominoConnectionProperties sont décrits dans le tableau suivant :
Tableau 2. Paramètres de connexion optionnels
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 l'activité Extraire

  1. 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.
    Remarque : Les champs ajoutés dynamiquement présents dans le document Domino et non générés dans les structures d'entrée/sortie de mappe sont pris en charge par le connecteur Domino. Lors de l'extraction de documents à l'aide de cette activité, les données pour ces champs sont disponibles dans la section Mapper les sorties, sous AdditionalFields.



Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/Domino_retrieve_outactivity.html