Créer et gérer des modèles de requête web

Licence :

Ces fonctions nécessitent une licence pour l’extension d’organisation ArcGIS Workflow Manager Advanced.

Les modèles de requête web peuvent être configurés de pair avec des activités de tâche pour envoyer automatiquement des requêtes Web aux extrémités REST lorsque des activités de tâche spécifiques ont lieu dans un workflow. Par exemple, un modèle de requête Web peut être configuré pour extraire des données ou publier des mises à jour sur un système tiers lorsqu’une tâche est mise à jour. La réponse peut alors être stockée sous forme de valeurs en sortie personnalisées pour diriger les chemins suivis par les workflows ou mettre à jour les propriétés de la tâche.

Créer des modèles de requête web

Pour créer un modèle de requête Web, procédez comme suit :

1. Accédez à l’application Web Workflow Manager.
2. Cliquez sur l’onglet Design (Création).

   La page Design (Création) apparaît.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Création) n’est pas disponible.

3. Cliquez sur Templates (Modèles) .

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, Templates (Modèles) n’est pas disponible.

4. Cliquez sur l’onglet Web Request (Requête Web).

   Le volet Web Request (Requête Web) s’affiche.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Web Request (Requête Web) n’est pas disponible.

5. Cliquez sur Create New (Créer) dans le volet Web Request (Requête web).
6. Indiquez un nom pour le modèle de requête web dans la zone de texte Name (Nom).
7. Cliquez sur la flèche de la liste déroulante URL et sélectionnez le type de requête à envoyer.
8. Saisissez l’URL de l’extrémité REST dans la zone de texte URL.
9. Vous pouvez ajouter des variables de chemin à l’URL avec la syntaxe suivante :

   https://yourorg.maps.arcgis.com/apps/workflowmanager/:pathVariable/

   Les variables de chemin apparaissent dans la section Path Variables (Variables de chemin).

10. Vous pouvez également ajouter des paramètres de requête au modèle de requête web.
    1. Cliquez sur Add Key & Value (Ajouter une clé et une valeur) dans la section Query Parameters (Paramètres de la requête).
    2. Indiquez une clé dans la zone de texte Key (Clé).

       Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

    3. Indiquez une valeur dans la zone de texte Value (Valeur).

       Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

    4. Laissez la case Enabled (Activé) cochée.
    5. Répétez les sous-étapes a à d pour ajouter davantage de paires clé-valeur.
11. Si vous avez ajouté des variables de chemin à l’URL, indiquez une valeur pour chaque variable dans la section Path Variables (Variables de chemin).

    Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

    Conseil :

    Cliquez sur This input supports Arcade Expressions (Cette entrée prend en charge les expressions Arcade) et sélectionnez une expression Arcade pour l’ajouter à la zone de texte associée.

12. Cliquez sur l’onglet Autorisation.
13. Sélectionnez la méthode d’authentification de l’extrémité REST et indiquez des informations d’authentification si nécessaire.

    Attention :

    Les informations d’authentification que vous indiquez dans l’étape ne sont chiffrées. Vous pouvez conserver des informations en toute sécurité en ajoutant un paramètre défini par l’utilisateur chiffré auquel vous pouvez faire référence dans l’étape à l’aide des propriétés de tâche dynamiques.

    Remarque :

    L’option Federated Token (Jeton fédéré) permet d’authentifier les requêtes Web lorsque l’utilisateur effectue l’étape. L’option Federated Token (Jeton fédéré) n’est compatible qu’avec les services accessibles au même utilisateur Workflow Manager.

    1. Le cas échéant, si vous sélectionnez l’option API Key (Clé API) ou Bearer Token (Jeton du porteur), cliquez sur Alternatively Generate Token from Endpoint (Générer alternativement un jeton à partir du point de terminaison).

       La boîte de dialogue Generate Token from Endpoint (Générer alternativement un jeton à partir du point de terminaison) s’affiche.

    2. Configurez des paramètres de jeton afin de générer un jeton pour la requête Web.
14. Vous pouvez cliquer sur l’onglet Headers (En-têtes) pour ajouter des paires clé-valeur d’en-tête personnalisées au modèle de requête Web.
    1. Cliquez sur Add Key & Value (Ajouter une clé et une valeur) dans la section Custom Headers (En-têtes personnalisés).
    2. Indiquez une clé dans la zone de texte Key (Clé).

       Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

    3. Indiquez une valeur dans la zone de texte Value (Valeur).

       Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

    4. Laissez la case Enabled (Activé) cochée.
    5. Répétez les sous-étapes a à d pour ajouter davantage de paires clé-valeur.
15. Vous pouvez cliquer sur l’onglet Body (Corps) pour ajouter des données à la requête Web.

    Le corps de la requête prend en charge les paires clé-valeur de données de formulaire, les paires clé-valeur codées au format URL et les données brutes au format JSON ou texte brut.

    Conseil :

    Vous pouvez également utiliser une expression ArcGIS Arcade pour extraire des paramètres définis par l’utilisateur ou indiquer des valeurs dynamiques dans le texte du corps.

16. Si vous disposez d’une licence pour l’extension d’organisation ArcGIS Workflow Manager Advanced, configurez les paramètres en sortie du modèle de requête Web.

    Remarque :

    L’activité de la tâche pour laquelle le modèle est configuré doit être terminée pour que vous puissiez tester la valeur en sortie de la requête Web.

17. Si vous le souhaitez, cliquez sur l’onglet Test puis sur Test Response (Réponse au test) pour envoyer la requête configurée et en afficher la réponse.

    Si la requête web contient des expressions Arcade spécifiques à la tâche, vous devez activer la fonction Include Job ID (Inclure l’ID de tâche) et spécifier un ID de tâche dans la zone de texte Job ID (ID de tâche) pour mettre correctement en forme la requête.

Configurer les paramètres de jeton

Si l’extrémité REST nécessite un jeton pour l’authentification, effectuez ces étapes pour configurer le modèle de requête Web afin de générer un jeton pouvant être utilisé pour authentifier les requêtes Web.

1. Dans l’onglet Authorization (Autorisation), sélectionnez l’option API Key (Clé API) ou Bearer Token (Jeton du porteur), puis cliquez sur Alternatively Generate Token from Endpoint (Générer alternativement un jeton à partir de l’extrémité).

   Les paramètres Generate Token from Endpoint (Générer un jeton à partir de l’extrémité) apparaissent dans le volet Web Request (Requête Web).

2. Cliquez sur la flèche de la liste déroulante URL et sélectionnez le type de requête à envoyer.
3. Saisissez l’URL de l’extrémité REST dans la zone de texte URL.
4. Vous pouvez ajouter des variables de chemin à l’URL avec la syntaxe suivante :

   https://yourorg.maps.arcgis.com/apps/workflowmanager/:pathVariable/

   Les variables de chemin apparaissent dans la section Path Variables (Variables de chemin).

5. Vous pouvez également ajouter des paramètres de requête à la requête Web.
   1. Cliquez sur Add Key & Value (Ajouter une clé et une valeur) dans la section Query Parameters (Paramètres de la requête).
   2. Indiquez une clé dans la zone de texte Key (Clé).

      Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

   3. Indiquez une valeur dans la zone de texte Value (Valeur).

      Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

   4. Laissez la case Enabled (Activé) cochée.
   5. Répétez les sous-étapes a à d pour ajouter davantage de paires clé-valeur.
6. Si vous avez ajouté des variables de chemin à l’URL, indiquez une valeur pour chaque variable dans la section Path Variables (Variables de chemin).

   Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

   Conseil :

   Cliquez sur This input supports Arcade Expressions (Cette entrée prend en charge les expressions Arcade) et sélectionnez une expression Arcade pour l’ajouter à la zone de texte associée.

7. Vous pouvez cliquer sur l’onglet Headers (En-têtes) pour ajouter des paires clé-valeur d’en-tête personnalisées à la requête Web.
   1. Cliquez sur Add Key & Value (Ajouter une clé et une valeur) dans la section Query Parameters (Paramètres de la requête).
   2. Indiquez une clé dans la zone de texte Key (Clé).

      Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

   3. Indiquez une valeur dans la zone de texte Value (Valeur).

      Vous pouvez aussi utiliser des expressions ArcGIS Arcade pour fournir une valeur dynamique.

   4. Laissez la case Enabled (Activé) cochée.
   5. Répétez les sous-étapes a à d pour ajouter davantage de paires clé-valeur.
8. Vous pouvez cliquer sur l’onglet Body (Corps) pour ajouter des données à la requête Web.

   Le corps de la requête prend en charge les paires clé-valeur de données de formulaire, les paires clé-valeur codées au format URL et les données brutes au format JSON ou texte brut.

   Conseil :

   Vous pouvez également utiliser une expression ArcGIS Arcade pour extraire des paramètres définis par l’utilisateur ou indiquer des valeurs dynamiques dans le texte du corps.

9. Cliquez sur l’onglet Token (Jeton).
10. Cliquez sur le bouton bascule Test Mode (Mode test) dans la section Token (Jeton).
11. Collez un exemple de réponse de l’extrémité REST dans la zone de texte Sample Response (Exemple de réponse).

    Exemple de réponse au format JSON :

    {"access_token": "12345abcde",
    "expires_in":7199,
    "spatialReference": {
      "wkid": 4326,
      "latestWkid": 4326
    },
    "location": [
      {
        "name": "380 New York Street",
        "extent": {
          "xmin": -117.196701,
          "ymin": 34.055489
        }
      }
    ]}

12. Indiquez un nom pour le jeton dans la zone de texte Output Value (Valeur en sortie).

    Il s’agit du nom utilisé par le modèle de requête web pour référencer le jeton généré.

13. Indiquez une expression JSONPath en notation par points ou en notation par crochets dans la zone de texte Extraction Path (Chemin d’extraction) pour analyser la réponse et renvoyer le jeton généré.

    Exemple d’expression JSONPath en notation par points :

    $.access_token

    Exemple d’expression JSONPath en notation par crochets :

    $['access_token']

    La valeur apparaît dans la colonne Sample Result (Exemple de résultat).

14. Cliquez sur Back (Retour) pour continuer à configurer la requête web.

Configurer les paramètres en sortie

Licence :

Ces fonctions nécessitent une licence pour l’extension d’organisation ArcGIS Workflow Manager Advanced.

Vous pouvez enregistrer la réponse de l’extrémité REST en tant que fichier, la joindre au modèle et la configurer en tant que valeurs en sortie personnalisées. Les valeurs en sortie peuvent être utilisées pour diriger les chemins suivis par les workflows ou comme entrées d’étapes. Si aucune valeur en sortie n’est configurée pour le modèle, le code de statut HTTP de la requête est stocké en tant que valeur en sortie du modèle. Pour configurer les paramètres en sortie du modèle, procédez comme suit :

1. Cliquez sur l’onglet Sortie.
2. Vous pouvez cliquer sur le bouton bascule Enabled (Activé) dans la section Attach Response (Joindre une réponse) pour enregistrer la réponse de l’extrémité REST en tant que fichier et joindre ce dernier au modèle.
3. Si vous le souhaitez, configurez le nom de la pièce jointe et le dossier dans lequel la réponse sera stockée :
   1. Indiquez le nom du dossier dans lequel la pièce jointe sera stockée dans la zone de texte Folder Name (Nom du dossier).

      Le nom du dossier ne peut pas contenir de chemin du système de fichiers et de caractères spéciaux. Si vous n’indiquez pas de nom, un dossier nommé General (Général) est créé automatiquement.

      Remarque :

      Le dossier est contenu dans l’élément de processus et n’est pas un chemin du système de fichiers.

   2. Sélectionnez l’une des options Attachment Name (Nom de la pièce jointe) suivantes :
      • Autogenerated (Généré automatiquement) : nomme automatiquement la pièce jointe avec la syntaxe suivante : <NomÉtape>_<DateExécution>_<HeureExécution>.
      • Custom (Personnalisé) : permet d’indiquer un nom de pièce jointe personnalisé.
4. Si vous le souhaitez, configurez des valeurs en sortie personnalisées pour la réponse de l’extrémité REST :
   1. Cliquez sur le bouton bascule Test Mode (Mode test) dans la section Output Values (Valeurs en sortie).
   2. Collez un exemple de réponse de l’extrémité REST dans la zone de texte Sample Response (Exemple de réponse).

      Exemple de réponse au format JSON :

      {"access_token": "",
      "expires_in":7199,
      "spatialReference": {
        "wkid": 4326,
        "latestWkid": 4326
      },
      "location": [
        {
          "name": "380 New York Street",
          "extent": {
            "xmin": -117.196701,
            "ymin": 34.055489
          }
        }
      ]}

   3. Cliquez sur Add Output & Path (Ajouter une sortie et un chemin).
   4. Indiquez un nom pour la valeur en sortie dans la zone de texte Output Value (Valeur en sortie).

      Il s’agit du nom de valeur utilisé pour l’obtention de la valeur en sortie personnalisée.

   5. Indiquez une expression JSONPath en notation par points ou en notation par crochets pour la valeur que vous souhaitez stocker dans la zone de texte Extraction Path (Chemin d’extraction).

      Exemple d’expression JSONPath en notation par points :

      $.location.0.name

      Exemple d’expression JSONPath en notation par crochets :

      $['location'][0]['name']

      La valeur apparaît dans la colonne Sample Result (Exemple de résultat).

   6. Au besoin, répétez les sous-étapes c à e pour ajouter davantage de valeurs en sortie personnalisées.
5. Cliquez sur Save (Enregistrer) pour enregistrer les modifications.

Modifier des modèles de requête web

Pour modifier des modèles de requête Web, procédez comme suit :

1. Accédez à l’application Web Workflow Manager.
2. Cliquez sur l’onglet Design (Création).

   La page Design (Création) apparaît.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Création) n’est pas disponible.

3. Cliquez sur Templates (Modèles) .

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, Templates (Modèles) n’est pas disponible.

4. Cliquez sur l’onglet Web Request (Requête Web).

   Le volet Web Request (Requête Web) s’affiche.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Web Request (Requête Web) n’est pas disponible.

5. Cliquez sur le nom de la requête web que vous souhaitez modifier dans le volet Web Request (Requête web).

   Conseil :

   Vous pouvez filtrer la liste des requêtes web dans le volet Web Request (Requête web) en saisissant un terme de recherche dans la zone de texte Search Web Request Templates (Rechercher des modèles de requête web).

6. Mettez la requête web à jour selon les besoins.
7. Cliquez sur Save (Enregistrer) pour enregistrer les modifications.

Supprimer des modèles de requête web

La suppression d’un modèle de requête web est définitive et ne peut pas être annulée. Pour supprimer des modèles de requête Web, procédez comme suit :

1. Accédez à l’application Web Workflow Manager.
2. Cliquez sur l’onglet Design (Création).

   La page Design (Création) apparaît.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Design (Création) n’est pas disponible.

3. Cliquez sur Templates (Modèles) .

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, Templates (Modèles) n’est pas disponible.

4. Cliquez sur l’onglet Web Request (Requête Web).

   Le volet Web Request (Requête Web) s’affiche.

   Remarque :

   Si vous ne disposez pas de privilèges suffisants, l’onglet Web Request (Requête Web) n’est pas disponible.

5. Cliquez sur le nom de la requête web que vous souhaitez supprimer dans le volet Web Request (Requête web).

   Conseil :

   Vous pouvez filtrer la liste des requêtes web dans le volet Web Request (Requête web) en saisissant un terme de recherche dans la zone de texte Search Web Request Templates (Rechercher des modèles de requête web).

6. Cliquez sur More Actions (Plus d’actions) puis sur Delete (Supprimer).

   Un message de confirmation apparaît.

7. Cliquez sur Yes (Oui) pour supprimer la requête web ou sur No (Non) pour annuler l’opération.