Configuration de la méthode HTTP, de l'URL et des paramètres d'URL

Spécifiez la méthode HTTP et l'URL d'exécution de la demande REST et configurez tous les paramètres d'URL pour la tâche REST.

Les procédures suivantes peuvent également être utilisées lors de l'entrée (ou de la modification) de l'URL de scrutation facultative et de l'URL d'arrêt.

Configuration de la méthode HTTP et de l'URL

La méthode est une méthode HTTP standard telle que GET ou POST. L'URL est le point d'extrémité de l'API REST de la ressource à laquelle accéder dans la demande REST.

Par exemple, le point d'extrémité REST suivant liste les ressources de données dans l'ID espace de travail finance123 :

http://myserver.com:8081/workspaces/finance123/dataAssets

Des paramètres peuvent être inclus dans l'URL à l'aide de la syntaxe ${}. Par exemple, le point d'extrémité REST suivant liste les ressources de données d'un espace de travail à l'aide de la syntaxe de paramètre pour les sections de variable de l'URL qui spécifient l'hôte du serveur et l'ID de l'espace de travail.

http://${myserver}:8081/workspaces/${workspaceId}/dataAssets

Lorsque vous spécifiez des parties de l'URL à l'aide de la syntaxe de paramètre, ces parties sont converties en paramètres d'URL de chaîne pour la tâche REST. Une valeur par défaut doit être affectée à chaque paramètre d'URL.

Lorsque la tâche est exécutée, vous pouvez modifier les valeurs de ces paramètres d'URL. Par exemple, lors de l'exécution, vous pouvez fournir différentes valeurs pour le serveur et l'ID espace de travail.

La procédure suivante peut également être utilisée pour entrer (ou modifier) l'URL de scrutation facultative et l'URL d'arrêt.

Pour configurer la méthode HTTP et l'URL :

  1. À l'étape Définir les détails d'exécution de la page Configurer les détails de l'API REST, sous Méthode HTTP, sélectionnez la méthode HTTP à utiliser pour l'URL de cette tâche REST.

    Pour configurer l'URL de scrutation et l'URL d'arrêt facultatives, allez à l'étape Spécifier les critères d'achèvement, sélectionnez l'onglet Sondage ou Résiliation et sélectionnez la méthode HTTP. Notez que les onglets Sondage et Résiliation ne s'affichent que lorsque la case Configurer une condition de scrutation et d'arrêt pour un appel REST sans attente est cochée.

  2. Dans le champ URL, entrez l'URL complète, puis appuyez sur Entrée.

    Si la syntaxe de paramètre ${} est utilisée pour des parties de l'URL, ces parties sont converties en paramètres d'URL pour la tâche REST.

    Le tableau de l'onglet Paramètres d'URL sous le champ URL est mis à jour avec les parties paramétrées. Par défaut, chaque paramètre d'URL est de type chaîne.

    Pour affecter une valeur par défaut à chaque paramètre d'URL, voir Configuration des paramètres d'URL. Vous pouvez modifier le type de données et ajouter une description à chaque paramètre.

  3. Si vous modifiez l'URL à tout moment en ajoutant ou en supprimant une syntaxe de paramètre, la table des paramètres d'URL est mise à jour en conséquence.
Configuration des paramètres d'URL

Après avoir entré (ou modifié) l'URL et appuyé sur Entrée, toute section de l'URL qui utilise la syntaxe de paramètre ${} est convertie en paramètres d'URL pour la tâche REST.

Par défaut, chaque paramètre d'URL ajouté est de type chaîne. Dans l'onglet Paramètres d'URL, vous pouvez ajouter des valeurs par défaut pour les paramètres de tâche REST et modifier le type de données des paramètres, si nécessaire.

La procédure suivante peut également être utilisée pour modifier les paramètres d'URL pour l'URL de scrutation facultative et l'URL d'arrêt.

Pour configurer les paramètres d'URL :

  1. À l'étape Définir les détails d'exécution de la page Configurer les détails de l'API REST, sélectionnez l'onglet Paramètres d'URL.

    Pour configurer les paramètres d'URL pour l'URL facultative de scrutation et d'arrêt, allez à l'étape Spécifier les critères d'achèvement, sélectionnez l'onglet Sondage ou Résiliation, puis sélectionnez Paramètres d'URL. Notez que les onglets Sondage et Résiliation ne s'affichent que lorsque la case Configurer une condition de scrutation et d'arrêt pour un appel REST sans attente est cochée.

  2. Dans le tableau, dans la rangée d'un nouveau paramètre d'URL, sélectionnez Modifier dans le menu Actions (Menu Actions).
  3. Dans le panneau Modifier le paramètre, le champ en lecture seule Identificateur est le nom du paramètre de tâche REST pour la section de variable d'URL paramétrée.
    1. Entrez une Description facultative pour le paramètre.
    2. Utilisez le menu Type de données pour modifier le type de données du paramètre.
    3. Dans le champ Valeur, entrez la valeur par défaut du paramètre.
    4. Sélectionnez enregistrer.
      Le paramètre URL est mis à jour dans la table.
  4. Pour afficher ou masquer l'URL à l'aide des valeurs de paramètre par défaut que vous avez configurées, sélectionnez Afficher l'URL de prévisualisation ou Masquer l'URL de prévisualisation.