Jira

Utilisez la boîte à outils « IBM® App Connect Enterprise » pour configurer les nœuds de flux de messages issus de la conversion des activités Jira « IBM » et « App Connect Professional ».

A propos de cette tâche

Lorsque vous importez une orchestration contenant des activités Jira, l'utilitaire de conversion crée un flux de messages avec le nœud Jira Request. Voir le tableau 1 pour savoir quels sont les nœuds utilisés pour chacune des activités.

Tableau 1. IBM App Connect Professional Activités Jira et nœuds de flux de messages correspondants dans l' IBM App Connect Enterprise
IBM App Connect Professional activité IBM App Connect Enterprise nœud
Create objects

Nœud de demande Jira
Update objects

Nœud de demande Jira
Retrieve objects

Nœud de demande Jira
Retrieve all objects

Nœud de demande Jira
Delete objects

Nœud de demande Jira

Le nœud « Jira Request » est utilisé dans IBM App Connect Enterprise pour toutes les activités du connecteur Jira sur IBM App Connect Professional.

Connexion à Jira

Procédure

  1. Sélectionnez le nœud Jira Request dans le flux de messages.
  2. Dans l'onglet Propriétés, cliquez sur Lancer la découverte du connecteur pour ouvrir l'assistant.
    App Connect Enterprise boîte à outils montrant une interface pour spécifier les propriétés des nœuds de requête Jira Interface de spécification d'un projet politique
  3. Sélectionnez le projet de politique Jira dans le menu déroulant ou créez-en un nouveau. Les informations de connexion Jira sont ensuite enregistrées dans une politique.
    Interface pour le projet de politique de dénomination avec boîte de saisie complétée
  4. Cliquez sur Tester l'accès au coffre-fort pour vérifier si les informations d'identification du coffre-fort sont correctes. Si ce n'est pas le cas, saisissez les informations d'identification. Le coffre-fort est ensuite utilisé pour stocker les informations d'identification de la connexion Jira. Le processus de connexion à Jira et de découverte des informations qu'il contient entraîne l'enregistrement de vos informations d'identification Jira dans le coffre-fort.
  5. Cliquez sur Lancer la découverte pour ouvrir une nouvelle fenêtre de configuration du nœud de connexion.
    Interface montrant un projet de politique avec l'emplacement de la chambre forte et les champs clés complétés

    Si vous vous êtes précédemment connecté à Jira, une liste de ces connexions s'affiche. Si vous ne vous êtes pas connecté à Jira auparavant, l'état du connecteur Jira est indiqué comme Non connecté.

  6. Si vous ne vous êtes pas encore connecté à un système Jira, procédez comme suit :
    1. Développez le panneau Non connecté, développez n'importe quelle section (par exemple, Questions ) et choisissez n'importe quelle action (par exemple, Créer une question ).
      Liste élargie affichant toutes les actions relatives aux questions
    2. La liste des objets et des actions est remplacée par un bouton Connecter. Cliquez sur Connexion.
      Fenêtre de découverte du connecteur
  7. Complétez les informations de connexion requises pour le compte Jira en fournissant l'hôte et le port Jira, le nom d'utilisateur et le mot de passe de la section endpoint du document généré.
    Interface permettant de spécifier les détails des points d'extrémité
  8. Cliquez sur Connecter pour vérifier la connexion. Fermez ensuite la fenêtre.

Etape suivante

Note : Pour toutes les actions avec Jira, appliquez les étapes suivantes, puis passez aux étapes spécifiques à chaque activité :
  • Sélectionnez le nœud dans le flux de messages.
  • Dans l'onglet Propriétés, cliquez sur Lancer la découverte du connecteur pour ouvrir l'assistant.
  • Sélectionnez un projet de politique Jira dans le menu déroulant ou créez-en un nouveau.
  • Cliquez sur Tester l'accès au coffre-fort pour vérifier si les informations d'identification du coffre-fort sont correctes. Si ce n'est pas le cas, saisissez les informations d'identification du coffre-fort que vous utilisez.
  • Cliquez sur Lancer la découverte. Une nouvelle fenêtre de configuration du nœud de connexion s'ouvre alors.
  • Développez la section Jira et sélectionnez le compte Jira auquel vous souhaitez vous connecter.

Nœud de demande Jira pour l'activité de création d'objets

Procédure

  1. Développez Questions et sélectionnez Créer une question.
  2. Développez Contrôles et complétez Comment voulez-vous remplir les champs cibles dans Jira.
  3. Option 1 :
    1. Indiquez les données pour tous les champs cibles requis.
    2. Vous pouvez également fournir des données pour les champs facultatifs que vous avez l'intention d'utiliser dans l'application cible. Vous pouvez soit saisir les valeurs directement dans les champs, soit les mapper à partir des résultats des nœuds précédents.
    3. Si une valeur par défaut est disponible, reportez-vous au document généré pour la connaître. Dans le cas contraire, les résultats des nœuds précédents sont utilisés.
    4. Pour savoir comment mapper les valeurs des nœuds précédents, reportez-vous à la section Comment ajouter la sortie du nœud précédent dans la documentation.
  4. Option 2 : utiliser le message d'entrée tel quel.
  5. Cliquez sur Enregistrer et fermez la fenêtre.
    Capture d'écran de la fenêtre de découverte du connecteur

Nœud de demande Jira pour l'activité de mise à jour des objets

Procédure

  1. Développez Questions et sélectionnez Mettre à jour la question.
  2. Développez Contrôles et complétez Comment voulez-vous remplir les champs cibles dans Jira.
  3. Option 1 :
    1. Indiquez les données pour tous les champs cibles requis.
    2. Vous pouvez également fournir des données pour les champs facultatifs que vous avez l'intention d'utiliser dans l'application cible. Vous pouvez soit saisir les valeurs directement dans les champs, soit les mapper à partir des résultats des nœuds précédents.
    3. Si une valeur par défaut est disponible, reportez-vous au document généré pour la connaître. Dans le cas contraire, les résultats des nœuds précédents sont utilisés.
    4. Pour savoir comment mapper les valeurs des nœuds précédents, reportez-vous à la section Comment ajouter la sortie du nœud précédent dans la documentation.
  4. Option 2 : utiliser le message d'entrée tel quel.
  5. Cliquez sur Enregistrer et fermez la fenêtre.
    Capture d'écran de la fenêtre de découverte du connecteur

Nœud de demande Jira pour l'activité de récupération d'objets

Procédure

  1. Développez Questions et sélectionnez Récupérer la question.
  2. Ajoutez les conditions, soit en saisissant les valeurs dans les champs, soit en les transférant à partir des résultats des nœuds précédents.
    1. Si une valeur par défaut est disponible, reportez-vous au document généré pour la connaître.
    2. Dans le cas contraire, les résultats des nœuds précédents sont utilisés.
    3. Pour savoir comment mapper les valeurs des nœuds précédents, reportez-vous à la section Comment ajouter la sortie du nœud précédent dans la documentation.
      Capture d'écran de la fenêtre de découverte du connecteur
      Remarque : dans IBM App Connect Professional le champ ID est généralement utilisé pour récupérer des objets. Veillez donc à ajouter la condition en utilisant le champ ID approprié.

Nœud de demande Jira pour l'activité de récupération de tous les objets

Procédure

  1. Développez Commentaires sur les questions et sélectionnez Récupérer tous les commentaires sur les questions.
  2. Ajoutez les conditions, soit en saisissant les valeurs dans les champs, soit en les transférant à partir des résultats des nœuds précédents.
    1. Si une valeur par défaut est disponible, reportez-vous au document généré pour la connaître.
    2. Dans le cas contraire, les résultats des nœuds précédents sont utilisés.
    3. Pour savoir comment mapper les valeurs des nœuds précédents, reportez-vous à la section Comment ajouter la sortie du nœud précédent dans la documentation.
      Capture d'écran de la fenêtre de découverte du connecteur

Nœud de demande Jira pour l'activité de suppression d'objets

Procédure

  1. Développez les questions et sélectionnez Supprimer la question.
  2. Définissez les correspondances soit en saisissant les valeurs dans les champs, soit en les établissant à partir des résultats des nœuds précédents.
    1. Si une valeur par défaut est disponible, reportez-vous au document généré pour la connaître.
    2. Dans le cas contraire, les résultats des nœuds précédents sont utilisés.
    3. Pour savoir comment mapper les valeurs des nœuds précédents, reportez-vous à la section Comment ajouter la sortie du nœud précédent dans la documentation.
      Capture d'écran de la fenêtre de découverte du connecteur

Ajout de la sortie du nœud précédent

A propos de cette tâche

Subflow avec le nœud de calcul peut être utilisé pour capturer la sortie d'autres nœuds.

Procédure

  1. Cliquez avec le bouton droit de la souris sur l'application que vous avez créée > Nouveau > Sélectionner un sous-débit.
  2. Donnez un nom au sous-flux et cliquez sur Terminer.
    Interface de création d'un nouveau sous-flux
  3. Ajoutez un nœud de calcul entre les nœuds d'entrée et de sortie, comme indiqué dans la capture d'écran.
    Capture d'écran montrant un exemple de flux avec d'abord le nœud d'entrée, puis le nœud de calcul et enfin le nœud de sortie
  4. Dans Propriétés, allez dans l'onglet Basique et réglez le mode de calcul sur All.
    Interface permettant de spécifier les propriétés des nœuds de calcul
  5. Dans le nœud de calcul, copiez le code ESQL suivant dans le nœud de calcul pour enregistrer les sorties de chaque nœud qui pointe vers le sous-débit dans l'arbre d'environnement :
    DECLARE I SHARED INTEGER 1;
CREATE COMPUTE MODULE SFSubflow_Compute
	CREATE FUNCTION Main() RETURNS BOOLEAN
	BEGIN
		-- CALL CopyMessageHeaders();
		-- CALL CopyEntireMessage();
		SET Environment.Node[I] = InputBody;
		SET I =I+1;
		RETURN TRUE;
	END;

	CREATE PROCEDURE CopyMessageHeaders() BEGIN
		DECLARE I INTEGER 1;
		DECLARE J INTEGER;
		SET J = CARDINALITY(InputRoot.*[]);
		WHILE I < J DO
			SET OutputRoot.*[I] = InputRoot.*[I];
			SET I = I + 1;
		END WHILE;
	END;

	CREATE PROCEDURE CopyEntireMessage() BEGIN
		SET OutputRoot = InputRoot;
	END;
END MODULE;
  6. Dans votre flux de messages, faites pointer la borne de sortie de chacun des nœuds vers le sous-flux, comme indiqué dans la capture d'écran. Ne connectez pas la borne de sortie du sous-flux à un nœud quelconque.
    App Connect Enterprise boîte à outils montrant les nœuds connectés
  7. Pour utiliser la sortie d'autres nœuds dans le nœud, ajoutez l'environnement dans la demande. Dans Propriétés, allez dans l'onglet requête et cliquez sur Ajouter. La fenêtre d' entrée Add map inputs s'ouvre, définissez le nom de l'entrée sur Environment dans la liste déroulante et cliquez sur OK.
    Interface pour la saisie des données cartographiques. Le champ du nom est complété Interface pour la saisie des données cartographiques. InputLocalEnvironment est mis en évidence
  8. Dans la fenêtre de découverte, cliquez sur Insérer une icône de cartographie, sélectionnez l'environnement dans Entrées de carte/environnement.
    Interface de saisie des correspondances disponibles avec une liste déroulante d'options à choisir
  9. Cliquez sur Environnement et sélectionnez Modifier l'expression.
    Capture d'écran montrant la liste des options d'actions. L'expression à éditer est mise en surbrillance
  10. Saisissez les données comme dans la capture d'écran. L'indexation commence à zéro et est mise en correspondance de manière à ce que la sortie du premier nœud soit stockée dans l'index zéro et ainsi de suite.
    Capture d'écran montrant que la saisie des champs "Record IDs" et "Merge IDs" est terminée