Utilisation de l'activité JIRA Rechercher objets

Utilisez l'activité Rechercher objets pour extraire de JIRA les enregistrements correspondant aux chaînes de recherche des objets suivants : Issue, User, UsersOverMultiProject, AssignableUser et UsersWithPermissions. L'activité de recherche pour l'objet Issue extrait des données de zones personnalisées.

Pourquoi et quand exécuter cette tâche

Utilisez cette tâche pour rechercher des objets dans l'instance JIRA en définissant des paramètres de requête. L'appel de cette activité est un appel synchrone lorsque les données entrées sont envoyées à l'activité pour traitement et que la réponse est renvoyée à l'orchestration.

Procédure

  1. Dans une orchestration active, ouvrez l'onglet Activités et développez le contenu du dossier JIRA.
  2. Faites glisser l'icône de l'activité Rechercher objets sur l'orchestration. Sélectionnez l'activité. La liste de contrôle JIRA Rechercher objets s'affiche.
  3. Dans la liste de contrôle, cliquez sur Récapitulatif.
  4. Vérifiez le contenu de la zone Nom d'activité et apportez les modifications nécessaires.
  5. Dans la liste de contrôle, cliquez sur Sélectionner le noeud final.
  6. Cliquez sur Parcourir et utilisez la boîte de dialogue Explorateur de projets pour sélectionner le noeud final JIRA approprié.
  7. Facultatif : vous pouvez créer le noeud final en cliquant sur Nouveau et en spécifiant les détails de connexion requis. Cliquez sur OK pour sauvegarder et utiliser le noeud final pour cette configuration.
  8. Pour apporter des modifications à la configuration du noeud final sélectionné, cliquez sur Editer pour accéder aux options dans une fenêtre distincte. Toute modification effectuée affecte globalement toutes les utilisations de ce noeud final dans les orchestrations actives.
  9. Dans la liste de contrôle, cliquez sur Configurer.
  10. Cliquez sur Parcourir pour sélectionner le type d'objet. La fenêtre Parcourir JIRA s'affiche.
  11. Dans la fenêtre Parcourir JIRA, vous pouvez sélectionner le type d'objet dans la liste des types d'objet. Cliquez sur OK.
  12. Dans la liste de contrôle, cliquez sur Réessayer. Passez en revue les paramètres par défaut et procédez aux modifications requises.
  13. 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é Extraire objets s'affichent sous forme de noeuds sous le paramètre d'entrée de demande dans le panneau Vers l'activité.
  14. 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.
  15. 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é.
  16. Créez une mappe entre les paramètres de sortie et les variables d'orchestration. Paramètre de requête

    Voici les paramètres de requête de l'activité Rechercher objets :

    Tableau 1. Paramètres de requête communs pour l'activité Rechercher objets
    Nom de zone Description
    startAt Index du premier enregistrement à renvoyer (base 0)
    maxResults Nombre maximal d'utilisateurs à renvoyer (valeur par défaut : 50). La valeur maximale autorisée est 1 000. Si vous indiquez une valeur supérieure à ce nombre, vos résultats de recherche seront tronqué.
    Tableau 2. Paramètres de requête des objets Issue
    Nom de zone Description
    validateQuery Ce paramètre permet de valider la requête JQL.
    responseFields Liste des zones à renvoyer pour chaque objet Issue. Par défaut, toutes les zones navigables sont renvoyées.
    criteria Les paramètres field, operator, value et logicalOperator sont définis dans criteria. Vous pouvez indiquer plusieurs critères en développant les occurrences du noeud criteria.
    field Le nom de zone standard à utiliser dans les critères doit être indiqué.
    operator Opérateur à appliquer (par exemple, les opérateurs valides sont =, !=, <, >, <=, >=, ~, !~, IN, NOT IN, IS et IS NOT)
    value Valeur de la zone utilisée dans la recherche.
    logicalOperator Opérateur logique à appliquer (par exemple, les opérateurs logiques valides sont AND, OR, NOT et ORDER BY)
    orderBy Les paramètres field et order sont définis dans orderBy. Vous pouvez indiquer plusieurs orderby en développant les occurrences du noeud orderBy.
    field Nom de zone standard permettant d'afficher les zones dans l'ordre.
    order Les ordres sont ASC et DESC.
    Tableau 3. Paramètres de requête communs des objets utilisateur
    Nom de zone Description
    includeActive Ce paramètre permet d'inclure les utilisateurs actifs.
    includeInActive Ce paramètre permet d'inclure les utilisateurs inactifs.
    Tableau 4. Paramètres de requête communs des objets UserWithPermission
    Nom de zone Description
    permissions Liste séparée par des virgules des autorisations de projet ou de problème dont doivent disposer les utilisateurs retournés.
    Remarque : L'énumération n'est pas prise en charge par le connecteur ; l'utilisateur doit donc entrer les données dans les paramètres de requête.

Résultats

Vous venez de configurer l'activité JIRA Rechercher objets.