Définition de critères d'achèvement à l'aide de la scrutation
Pour une tâche REST qui appelle une opération d'API REST de longue durée, cochez la case Configurer une condition de scrutation et d'arrêt pour un appel REST sans attente à l'étape Spécifier les critères d'achèvement afin de spécifier la configuration de scrutation pour identifier l'achèvement de l'appel REST.
En plus de la condition de réussite, la configuration de scrutation inclut une URL et une condition REST de scrutation, ainsi que des valeurs d'intervalle de scrutation et de temporisation de scrutation.
Vous pouvez éventuellement spécifier une configuration d'arrêt pour annuler l'opération d'API de longue durée.
Pour utiliser la réponse d'API de l'étape d'exécution dans la configuration de scrutation ou d'arrêt, créez des expressions, puis ajoutez les expressions nommées dans les URL de scrutation et d'arrêt, ainsi que les conditions de scrutation et de réussite.
Avant de configurer la scrutation ou l'arrêt, créez les expressions pour extraire les valeurs de réponse d'API dont vous avez besoin.
Voir aussi Scrutation dans les opérations de longue durée.
Les expressions permettent d'affecter une valeur ou une expression à une variable que vous pouvez ensuite utiliser lors de la configuration de critères d'achèvement.
Créez des expressions qui utilisent la réponse de l'API à l'étape d'exécution REST. Vous indiquez un nom pour l'expression lorsque vous la créez. Pour inclure l'expression nommée dans l'URL de scrutation ou d'arrêt, ou dans la condition de scrutation ou de réussite, utilisez la syntaxe #{expression_name}
.
Par exemple, si la tâche REST appelle l'opération d'API pour créer un projet à l'aide d'un nom de projet spécifique, la demande de scrutation peut vérifier la clé de projet pour déterminer si la scrutation continue ou s'arrête. Pour utiliser la clé de projet en tant que variable dans l'URL de scrutation, créez une expression qui extrait la clé des données utiles de la réponse de l'API et la convertit en valeur de type de données Chaîne ou JSON_TEXT.
Notez qu'une expression que vous créez ici ne peut pas être utilisée comme sortie de tâche REST dans d'autres opérateurs qui sont en aval de la tâche.
Pour ajouter une expression :
Vous pouvez modifier et supprimer des expressions que vous avez créées dans la scrutation.
Pour modifier ou supprimer une expression :
- Dans la page Configurer les détails de l'API REST, étape Indiquer les critères d'achèvement, développez la section Expressions.
- Dans le tableau Expressions, recherchez l'expression à modifier ou à supprimer.
-
Dans le menu Actions (
) de l'expression, sélectionnez Modifier ou Supprimer.
- Dans le panneau Modifier l'expression, effectuez les modifications, puis sélectionnez Enregistrer.
- Dans la boîte de dialogue Supprimer l'expression, vérifiez que l'expression nommée est celle que vous voulez supprimer, puis sélectionnez Supprimer.
Dans une opération d'API de longue durée, définissez la méthode HTTP et l'URL pour sonder le statut de l'appel REST.
Comme pour l'URL REST à l'étape d'exécution, vous pouvez inclure des paramètres dans l'URL de scrutation à l'aide de la syntaxe ${parameter_name}
.
En outre, vous pouvez inclure des expressions nommées à l'aide de la syntaxe #{expression_name}
. Créez les expressions dont vous avez besoin avant de configurer l'URL de scrutation.
Pour configurer la méthode et l'URL de scrutation :
La configuration de scrutation comprend une condition de scrutation, une valeur d'intervalle de scrutation et une valeur de temporisation de scrutation.
La condition de scrutation est une expression qui détermine si la scrutation s'arrête ou continue. Lorsque l'expression retourne la valeur Faux, la scrutation s'arrête.
Le service d'intégration de données émet un appel de sondage de façon répétée selon l'intervalle de sondage spécifié jusqu'à ce que la valeur de temporisation de sondage spécifiée soit atteinte, ou jusqu'à ce que la condition de sondage retourne la valeur Faux, selon ce qui se produit en premier.
Pour configurer la condition de scrutation :
- Dans la page Configurer les détails de l'API REST, étape Spécifier les critères d'achèvement, cochez la case Configurer une condition de scrutation et d'arrêt pour un appel REST sans attente.
-
Dans l'onglet Scrutation, section Conditions, effectuez les opérations suivantes :
-
Dans la section Conditions, sous Condition de programmation, entrez une valeur et sélectionnez une unité de mesure pour Intervalle de programmation et Temporisation de programmation.
- Temporisation de scrutation : Temps maximal autorisé pour qu'une scrutation répétée ait lieu selon l'intervalle spécifié. La valeur de temporisation doit être supérieure ou égale à 120 secondes mais inférieure ou égale à 30 jours.
- Intervalle de sondage : Durée d'attente avant l'envoi de la demande de sondage suivante. La valeur d'intervalle doit être supérieure ou égale à 60 secondes et inférieure à la valeur de temporisation spécifiée.
- Pour affecter un paramètre de tâche à la condition, sélectionnez Affecter un paramètre. Voir Paramétrage de la condition de scrutation.
Après avoir ajouté une condition de scrutation, vous pouvez affecter un paramètre de tâche à la condition.
Pour paramétrer la condition de scrutation dans une tâche REST :
Vous pouvez modifier la description et la valeur par défaut du paramètre de tâche de la condition de scrutation.
Pour modifier la condition de scrutation paramétrée :
- Dans la page Configurer les détails de l'API REST, allez à l'étape Spécifier les critères d'achèvement.
- Dans le bloc Conditions, sélectionnez Modifier le paramètre.
- Dans le panneau Modifier le paramètre, vous pouvez modifier uniquement la description et l'expression de la condition de scrutation. Vous ne pouvez pas modifier l'identificateur (nom) et le type de données.
- Sélectionnez Enregistrer les modifications.
La suppression du paramètre de condition supprime uniquement l'association du paramètre à la condition de scrutation spécifiée pour la tâche REST.
Pour annuler l'affectation du paramètre à la condition de scrutation :
Pour une tâche REST qui appelle une opération d'API REST de longue durée, vous pouvez spécifier les détails de l'API REST pour mettre fin à l'opération de longue durée.
Dans l'onglet Arrêt, définissez la méthode HTTP et l'URL pour mettre fin à l'appel REST.
Comme pour l'URL de scrutation, vous pouvez inclure des paramètres et des expressions dans l'URL d'arrêt à l'aide de la syntaxe ${parameter_name}
et #{expression_name}
. Créez les expressions dont vous avez besoin avant de configurer l'URL d'arrêt.
Pour configurer la méthode d'arrêt et l'URL :
La condition de réussite d'une tâche REST est une expression qui détermine l'achèvement réussi de l'appel d'API REST. La scrutation s'arrête lorsque la condition de réussite est satisfaite.
Par défaut, le service d'intégration de données fournit une condition de réussite pour une tâche REST. La condition de réussite par défaut est un code de statut HTTP de 200 ou supérieur, mais inférieur à 300. Elle est exprimée par l'expression suivante :
SYS.RESPONSE_STATUS >= 200 AND SYS.RESPONSE_STATUS < 300
L'expression de la condition de réussite référence la sortie de la réponse JSON à la demande REST définie à l'étape d'exécution.
Vous pouvez utiliser la condition de réussite par défaut ou écrire une expression de condition à l'aide des sorties du système ou extraire des valeurs de propriété JSON de la réponse.
Pour modifier la condition de réussite :