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

Indiquez la méthode HTTP et l'URL de la demande REST à exécuter, et configurez les paramètres d'URL de la tâche REST.

Les procédures suivantes peuvent également être utilisées lors de la saisie (ou de la modification) de l'URL d'interrogation et de l'URL de terminaison facultatives.

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 l'adresse d'API REST de la ressource à laquelle accéder dans la demande REST.

Par exemple, l'adresse REST suivante répertorie les ressources de données dans l'ID d'espace de travail finance123 :

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

L'URL peut inclure des paramètres à l'aide de la syntaxe ${}. Par exemple, l'adresse REST suivante répertorie les ressources de données d'un espace de travail en utilisant la syntaxe de paramètre pour les sections variables 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 transformées en paramètres d'URL de type 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 des valeurs différentes pour le serveur et l'ID de l'espace de travail.

La procédure suivante peut également être utilisée pour saisir (ou modifier) l'URL d'interrogation et l'URL de terminaison facultatives.

Pour configurer la méthode et l'URL HTTP, procédez comme suit :

  1. A 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 d'interrogation et l'URL de terminaison facultatives, accédez à l'étape Indiquer des critères de fin, cliquez sur l'onglet Interrogation ou Interruption et sélectionnez la méthode HTTP. Notez que les onglets Interrogation et Fin de contrat apparaissent uniquement lorsque la case Configurer une condition d'interrogation et de fin de contrat 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 transformées en paramètres d'URL pour la tâche REST.

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

    Pour affecter une valeur par défaut à chaque paramètre d'URL, reportez-vous à 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 à un moment donné en ajoutant ou en supprimant la 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 saisi (ou modifié) l'URL et appuyé sur Entrée, les sections de l'URL qui utilisent la syntaxe de paramètre ${} sont transformées en paramètres d'URL pour la tâche REST.

Par défaut, les données de tous les nouveaux paramètres d'URL ajoutés sont 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, ainsi que 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 d'interrogation et l'URL de terminaison facultatives.

Pour configurer les paramètres d'URL :

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

    Pour configurer les paramètres d'URL pour l'URL d'interrogation et de terminaison facultative, accédez à l'étape Indiquer des critères de fin, cliquez sur l'onglet Interrogation ou Interruption, puis sur Paramètres d'URL. Notez que les onglets Interrogation et Fin de contrat apparaissent uniquement lorsque la case Configurer une condition d'interrogation et de fin de contrat pour un appel REST sans attente est cochée.

  2. Dans la ligne de table correspondant à un nouveau paramètre d'URL ajouté, sélectionnez Modifier dans le menu Actions (menu Actions).
  3. Dans le panneau Modifier le paramètre, le champ en lecture seule Identificateur contient le nom du paramètre de tâche REST pour la section variable d'URL paramétrée.
    1. (Facultatif) Entrez une Description du 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. Cliquez sur Enregistrer.
      Le paramètre URL est mis à jour dans la table.
  4. Pour afficher ou masquer l'URL avec les valeurs par défaut de paramètre que vous avez configurées, cliquez sur Afficher l'URL d'aperçu ou sur masquer l'URL d'aperçu.