Création d'une tâche REST

Une tâche REST dans Data Integration permet d'appeler une adresse d'API REST à l'aide du protocole HTTP.

Créer une tâche REST dans un projet ou un dossier. Data Integration inclut un projet par défaut pour vous lancer. Pour créer d'autres projets ou dossiers, reportez-vous à la rubrique Projets et dossiers.

Dans Data Integration, par défaut, vous pouvez avoir des exécutions de tâche simultanées ou parallèles d'une tâche à un moment donné. Pour interdire les exécutions de tâche simultanées lancées manuellement, cochez la case Désactiver l'exécution simultanée de la tâche lorsque vous créez la tâche. Lorsque les exécutions de tâche simultanées sont interdites, une demande d'exécution pour la tâche échoue si une exécution de tâche en cours est déjà dans un état non terminal.

  • L'interface utilisateur de configuration contient quatre sections dans lesquelles vous fournissez l'API REST et les détails d'authentification de la tâche, fournissez des valeurs de paramètre facultatives dans la portée de la tâche et recherchez les erreurs et les avertissements.

    Les étapes de chaque section de la procédure suivante peuvent également être utilisées lors de la modification d'une tâche REST.

    1. Sur la page Tâches du projet ou du dossier dans lequel créer une tâche, sélectionnez Créer une tâche, puis REST. Si vous avez besoin d'aide pour trouver la page Tâches dans un projet ou un dossier, reportez-vous à Liste des tâches.
    2. Sur la page Créer une tâche REST, saisissez un nom et une description facultative.

      L'identificateur est une valeur générée par le système en fonction du nom. Vous pouvez modifier la valeur, mais une fois que vous avez créé et enregistré la tâche, vous ne pouvez plus mettre à jour l'identificateur.

    3. Cochez la case Désactiver l'exécution simultanée de la tâche si vous souhaitez interdire les exécutions simultanées de cette tâche.
    4. (Facultatif) Dans Projet ou dossier, cliquez sur Sélectionner, puis sélectionnez un autre projet ou dossier dans lequel enregistrer la tâche.
    5. Pour enregistrer la tâche pour la première fois, sélectionnez l'un des boutons suivants :
      • Créer : crée et enregistre la tâche. Vous pouvez poursuivre la création et la modification de la tâche.

      • Créer et fermer : permet de créer et d'enregistrer la tâche, de fermer la page et de revenir à la liste des tâches sur la page des détails du projet ou du dossier.

    6. Enregistrez régulièrement pendant que vous travaillez en sélectionnant l'un des boutons suivants :
      • Enregistrer : valide les modifications apportées depuis le dernier enregistrement. Vous pouvez poursuivre la modification après l'enregistrement.

      • Enregistrer et fermer : valide les modifications, ferme la page et retourne à la liste des tâches sur la page des détails du projet ou du dossier.

      • Enregistrer sous : valide les modifications (depuis le dernier enregistrement) et les enregistre dans une copie au lieu d'écraser la tâche en cours. Vous pouvez fournir un nom pour la copie et sélectionner un autre projet ou dossier pour la copie, ou enregistrer la copie dans le même projet ou dossier que la tâche existante.

    7. Dans la section Détails de l'API REST, sélectionnez Configurer.

      Sur la page Configurer les détails de l'API REST qui apparaît, indiquez les détails d'exécution de l'API REST et les critères de fin (condition de réussite) d'un appel REST réussi.

      1. Pour définir les détails d'exécution de l'API REST, procédez comme suit :
        1. Indiquez la méthode HTTP et l'URL REST.
        2. (Facultatif) Configurez les paramètres d'URL.
        3. Ajoutez un en-tête de demande REST.
        4. (Facultatif) Ajoutez un paramètre de tâche pour la valeur de l'en-tête REST.
        5. Pour une méthode HTTP POST ou PUT, ajoutez le corps de la demande.
        6. (Facultatif) Ajoutez un paramètre de tâche pour l'ensemble du corps de demande.
        7. Pour afficher l'URL REST que vous avez configurée, sélectionnez Afficher l'URL d'aperçu.
        8. Sélectionnez Suivant.
      2. Pour spécifier les critères de réussite de l'exécution de l'API REST, modifiez la condition de réussite par défaut fournie dans la section Conditions.
      3. Si l'API REST appelle une opération à long terme, en plus de la condition de réussite, cochez la case Configurer une condition d'interrogation et de terminaison pour un appel REST sans attente et indiquez les détails requis pour une configuration d'interrogation (comportement asynchrone). Reportez-vous à Fourniture de critères de fin à l'aide de l'interrogation.
      4. Sélectionnez Configurer.

        Vous revenez à la page Créer une tâche REST ou Tâche REST : <task name>.

    8. Dans la section Authentification, sélectionnez Configurer. Dans le panneau Configurer l'authentification qui apparaît, indiquez la méthode d'authentification pour exécuter l'adresse d'API REST. Par défaut, aucune méthode d'authentification n'est nécessaire.
    9. (Facultatif) Dans la section Paramètres, sélectionnez Configurer. Sur la page Paramètres de tâche REST qui apparaît, consultez et modifiez les valeurs des paramètres disponibles dans la portée de cette tâche REST.
    10. (Facultatif) Dans la section Valider la tâche, sélectionnez Valider.

      En cas d'erreurs ou d'avertissements, sélectionnez Afficher les messages. Corrigez toutes les erreurs avant de publier la tâche.

    11. Lorsque vous avez terminé la configuration de la tâche REST, sélectionnez Créer et fermer ou Enregistrer et fermer.
    Publication de la tâche REST vers une application dans Data Integration avant d'exécuter la tâche ou de programmer son exécution. Pour plus d'informations sur la publication, reportez-vous à Publication vers une application Data Integration.
  • Utilisez la commande oci data-integration task create-task-from-rest-task et les paramètres requis pour créer une tâche REST :

    oci data-integration task create-task-from-rest-task [OPTIONS]

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

  • Exécutez l'opération CreateTask avec le sous-type de ressource approprié pour créer une tâche REST.