Accéder au contenu principal Passer au contenu complémentaire

Simuler des événements futurs et adapter votre ordonnancement

Avant d'appliquer votre ordonnancement à une tâche, simulez les événements que cet ordonnancement peut déclencher et adaptez-le en fonction.

Avant de commencer

  • Générez des jetons d'accès :

    Une fois généré, un jeton de compte de service expire après 30 minutes. S'il expire, générez un nouveau jeton à l'aide de la méthode POST sur l'endpoint https://api.<env>.cloud.talend.com/security/oauth/token. Pour plus d'informations concernant la génération de ce jeton, consultez Générer un jeton de compte de service.

  • Vous devez connaître l'ID de l'ordonnancement pour lequel vous souhaitez simuler des événements.
  • Pour simuler les événements à venir, assurez-vous que l'utilisateur·trice ou le compte de service à utiliser pour émettre les appels d'API a l'autorisation VIEW sur au moins un espace de travail de l'environnement dans lequel vous devez simuler les événements et adapter les ordonnancements.

    Si l'ordonnancement adapté a été associé à une tâche ou un plan, l'autorisation VIEW est requise sur l'espace de travail auquel appartient la tâche ou le plan.

  • Pour adapter votre ordonnancement, c'est-à-dire mettre à jour les déclencheurs définis pour cet ordonnancement, l'utilisateur·trice ou le compte de service à utiliser doit avoir le rôle TMC_OPERATOR et l'autorisation EXECUTOR pour au moins un espace de travail dans l'environnement où créer l'ordonnancement.

    Si l'ordonnancement adapté a été associé à une tâche ou un plan, l'autorisation EXECUTOR est requise sur l'espace de travail auquel appartient la tâche ou le plan.

Procédure

  1. Émettez la requête suivante afin de simuler les événements à déclencher par votre ordonnancement.

    Exemple

    method: GET
    endpoint: https://api.<env>.cloud.talend.com/orchestration/schedules/<scheduleId>/events
    headers: {
          "Content-Type": "application/json",
          "Authorization": "Bearer <your_personal_access_token_or_service_account_token>"
              }
    payload: {
           "to": "1742567692000"
              }
    Le champ to (à) est utilisé pour spécifier, en millisecondes, l'horodatage de fin de la période durant laquelle vous simulez les événements à venir.
    Dans la réponse, chaque événement à venir est retourné avec son déclencheur, afin que vous puissiez facilement identifier le déclencheur à mettre à jour pour cet ordonnancement.
    [
      {
        “date”: “2022-06-22T10:04:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
      {
        “date”: “2022-06-22T10:09:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
      {
        “date”: “2022-06-23T10:04:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
      {
        “date”: “2022-06-23T10:09:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
      {
        “date”: “2022-06-24T10:04:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
      {
        “date”: “2022-06-24T10:09:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
      {
        “date”: “2022-06-25T10:04:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
      {
        “date”: “2022-06-25T10:09:00.000Z”,
        “sourceTriggerName”: “my_trigger_1"
      },
    ...
    ]

    Par exemple, si vous vous apercevez qu'un événement va être déclenché durant la maintenance du système, vous pouvez mettre à jour ce déclencheur pour qu'il démarre l'événement plus tôt ou plus tard.

  2. Émettez l'appel d'API suivant pour mettre à jour les déclencheurs d'un ordonnancement :

    Exemple

    method: PUT
    endpoint: https://api.<env>.cloud.talend.com/orchestration/schedules/<scheduleId>/triggers
    headers: {
          "Content-Type": "application/json",
          "Authorization": "Bearer <your_personal_access_token_or_service_account_token>"
              }
    payload: {
           "Trigger": {
               "name": "My unique trigger name",
               "startDate": "2022-06-17",
               "timeZone": "Europe/Kiev",
               "type": "ONCE",
               atTimes: {
                   "type": "AT_TIME",
                   "time": "11:00"
                        }
                       }
              }

    Cette requête met à jour le déclencheur du nom My unique trigger name en modifiant la date de démarrage de l'événement au 2022-06-17 (17 juin 2022). Les autres déclencheurs définis pour cet ordonnancement ne sont pas modifiés.

    Les mêmes prérequis s'appliquent pour la création et la mise à jour de déclencheurs. Lorsque vous envoyez la requête, une vérification automatique a lieu.

Résultats

Votre ordonnancement est à présent adapté pour déclencher les événements aux moments les plus appropriés.

Que faire ensuite

Il est prêt à être associé à une tâche pour déclencher les événements de cette tâche, comme planifié.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !