Interrogation des documents Domino
L'activité Interroger les documents est utilisée pour interroger les documents de la base de données dans le serveur Lotus® Domino® correspondant aux valeurs spécifiées dans les zones de document.
- Données métier document : lorsque vous spécifiez les données métier de document dans la section Mapper les entrées, le connecteur lit toutes les données valides de l'entrée de mappe. Le connecteur recherche dans la base de données les documents correspondant à ces données valides. Tous les documents correspondants pouvant être représentés à l'aide du schéma de sortie de mappe sont renvoyés en réponse.
- ParentDocumentUNID : lorsque vous spécifiez un ParentDocumentUNID valide dans la section Mapper les entrées, le connecteur interroge tous les documents enfants de ce document parent. Tous les documents correspondants pouvant être représentés à l'aide du schéma de sortie de mappe sont renvoyés en réponse.
- Pas de données : lorsque vous ne fournissez pas de données dans l'entrée de mappe, le connecteur interroge les documents pouvant être représentés à l'aide du schéma de sortie de mappe.
- Méthode Recherche de base de données : Compte tenu des critères de sélection d'un
document, renvoie tous les documents d'une base de données conformes aux critères.
Par défaut, celle méthode est celle utilisée pour rechercher des documents. Pour définir explicitement la recherche d'après ce type, définissez la valeur du paramètre facultatif searchType à NORMAL_SEARCH dans la section d'entrée de mappe. Cette méthode prend en charge la recherche de documents d'après les critères de recherche suivants :
- Valeurs uniques : vous pouvez spécifier une valeur unique dans le critère de recherche. Par exemple, le
connecteur peut interroger des documents selon le mot, le numéro ou la date spécifiée dans la zone de recherche. Vous trouverez plus d'informations sur les valeurs de recherche pouvant être spécifiées dans les zones de type Nombre et Date
dans les parties suivantes.
- Nombres : vous pouvez spécifier un nombre à deux chiffres ou un entier en critère de recherche dans la zone de type Nombres. Vous pouvez utiliser cette fonction de recherche pour interroger les documents au sein desquels une zone de type Nombre équivaut à une certaine valeur. Par exemple, pour interroger des documents où le salaire des employés est égal à 1234.56, entrez la valeur 1234.56 dans le champ EmployeeSalary.
- Date : vous pouvez spécifier une date en critère de recherche dans toute zone de type Date. Par exemple, pour interroger les documents au sein desquels l'anniversaire est 1982/11/22, entrez la valeur 1982/11/22 dans le champ Birthday.
- Plusieurs valeurs : vous pouvez spécifier plusieurs valeurs en critères de recherche pour tous les types de zones Lotus Domino. Cette fonction peut être utilisée pour rechercher les documents avec les valeurs spécifiées au moment de l'exécution. Par exemple, vous pouvez configurer le connecteur de sorte qu'il extraie les documents correspondant aux mots spécifiés dans les critères de recherche.
- Recherche de texte pour le contenu de texte riche : vous pouvez spécifier les textes dans l'ordre pour qu'ils recherchent les documents avec un contenu riche au moment de l'exécution. Le connecteur mène une recherche en utilisant les textes spécifiés dans le champ RichText ; tous les documents correspondants sont extraits par le connecteur. Le connecteur prend en charge les recherches de contenu de texte unique et multiple pour le champ RichText. Vous pouvez également fournir des suffixes génériques, tels que * pour rechercher des documents dans le champ RichText.
- Recherche à l'aide de plusieurs zones : Vous pouvez spécifier des valeurs de recherche dans plusieurs zones. Dans cette configuration, l'activité utilise l'opérateur logique ET pour regrouper les chaînes de recherche. Par exemple, vous pouvez spécifier une valeur unique, plusieurs valeurs, RichText ou ParentDocumentUNID dans différents champs. L'activité renvoie uniquement le contenu de recherche correspondant à tous les critères spécifiés.
- Valeurs uniques : vous pouvez spécifier une valeur unique dans le critère de recherche. Par exemple, le
connecteur peut interroger des documents selon le mot, le numéro ou la date spécifiée dans la zone de recherche. Vous trouverez plus d'informations sur les valeurs de recherche pouvant être spécifiées dans les zones de type Nombre et Date
dans les parties suivantes.
- Méthode Recherche de base de données FTSearch/indexée : Effectue une recherche en texte intégral sur tous les
documents d'une base de données. Lorsque la base de données est complètement indexée, la méthode de recherche indexée est plus rapide que la méthode Recherche de base de données. La méthode trie les données de sortie d'après leur score de pertinence. Lorsque la collection est triée par pertinence, les données avec la pertinence la plus élevée sont présentées en premier. Pour définir explicitement la recherche d'après ce type, définissez la valeur du paramètre facultatif searchType à FULL_TEXT_SEARCH dans la section d'entrée de mappe.
- Recherche à l'aide de plusieurs zones : La méthode de recherche indexée est également compatible avec une recherche utilisant plusieurs zones. Vous pouvez spécifier des valeurs de recherche dans plusieurs zones. Dans cette configuration, le connecteur utilise l'opérateur logique ET pour regrouper les chaînes de recherche. Par exemple, vous pouvez spécifier une valeur unique, plusieurs valeurs ou ParentDocumentUNID dans différents champs. Le connecteur renvoie le produit logique (opération ET) de tous les critères de recherche spécifiés, avec les correspondances exactes et proches des champs de type chaîne et les correspondances exactes des champs de type numérique.
Remarque : La méthode de recherche indexée ne fonctionne pas sur les champs RichText, Attachments et Date.
- 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é Interroger du dossier Domino vers l'orchestration. Une représentation graphique de l'orchestration, y compris le panneau Liste de contrôle, apparaît.
- 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. 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.
- Sélectionnez Mapper les entrées dans la Liste de contrôle.
Les schémas XML
générés à partir de l'objet sélectionné de l'activité Interroger les documents s'affichent
sous forme de noeuds sous le paramètre d'entrée de demande dans le panneau Vers 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.
Le paramètre d'entrée optionnel est décrit dans le tableau suivant :
Tableau 1. Paramètre d'entrée optionnel Nom de paramètre Description databaseName databaseName est le nom de la base de données dans laquelle le document est interrogé. 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 interrogés dans 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. 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. password Spécifie le mot de passe associé au nom d'utilisateur pour la connexion au serveur Domino. - Créez une mappe entre les variables d'orchestration et le paramètre d'entrée de l'activité. Remarque : Des valeurs doivent être fournies lors de l'exécution pour les éléments obligatoires de la structure d'entrée. Une valeur peut être indiquée en spécifiant une valeur par défaut pour l'élément ou en reliant l'élément avec un noeud d'entrée. A l'exécution, si aucune valeur n'est fournie pour un élément obligatoire, l'activité émet une exception qui est signalée par la console de gestion Web. Si aucune valeur n'est fournie au moment de l'exécution pour un paramètre d'entrée facultatif, aucune exception n'est émise lors de l'exécution.
- Sélectionnez le type de recherche à utiliser pour l'activité :
Tableau 3. Type de recherche Nom de paramètre Description searchType Spécifie le type de recherche à utiliser pour l'activité . Valeurs possibles : - NORMAL_SEARCH : Utilise la méthode Recherche de base de données Domino.
- FULL_TEXT_SEARCH : Utilise la méthode de recherche FTSearch de base de données Domino.
- Sélectionnez Mapper les sorties dans la liste de contrôle.
Le schéma XML généré pour contenir la réponse de l'activité s'affiche sous forme de noeuds sous le paramètre de
sortie de réponse dans le panneau Depuis l'activité.
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.
queryUsingTimestamp est le paramètre utilisé pour interroger les documents d'après leur horodatage. La propriété timestamp est récursive. Vous pouvez définir groupFields, name, operator et value sous la propriété timestamp.
Les paramètres de sortie optionnels sont décrits dans le tableau suivant :
Nom de paramètre Description queryUsingTimestamp Les propriétés timestamp sont les suivantes :Tableau 4. Propriétés timestamp Propriété Valeurs groupFields Vous pouvez spécifier plusieurs valeurs telles que AND, OR, (,), AND(, OR(, )AND, )OR, )AND( et )OR(. Remarque : Vous pouvez avoir plusieurs conditions. groupFields doit être utilisé lorsqu'il existe plusieurs conditions.name Spécifiez l'une de ces valeurs : createdTimestamp ou lastModifiedTimestamp operator Spécifiez l'une de ces valeurs : GREATER_THAN, GREATER_THAN_OR_EQUAL_TO, EQUAL_TO, LESS_THAN, LESS_THAN_OR_EQUAL_TO, NOT_EQUAL_TO value Spécifiez les valeurs de date et d'heure. Par exemple, 26-09-2013 12:05:00 PM EST. Remarque : Si vous ne précisez pas le fuseau horaire, par défaut, c'est le fuseau horaire du serveur qui est pris en compte.Remarque :- L'interrogation de documents avec l'opérateur NOT_EQUAL_TO (!=) n'est pas possible avec la recherche en texte intégral.
- L'interrogation de documents avec utilisation de l'heure comme critère n'est pas possible avec la recherche en texte intégral. Par exemple, [_RevisionDate] = 05/06/2013 09:30:00.
- L'interrogation de documents en utilisant l'opérateur EQUAL_TO avec un horodatage ne fonctionne pas en mode de recherche normal. Par exemple, @Modified = [05/06/2013 09:14:22].
- L'interrogation de documents avec le type de recherche en texte intégral ne peut se faire que sur la base de la date, et non sur la date et l'heure. Par exemple, lastModfiedDateTime >= 05/20/2013 20:00:00 n'est pas accepté en mode de recherche en texte intégral.
- Créez une mappe entre les paramètres de sortie et les variables d'orchestration.