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 d'un 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
-
É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.
-
É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é.