Fourniture de critères de fin
Indiquez la condition qui détermine les critères de succès de l'exécution REST.
Une condition de réussite est requise pour terminer un appel REST, que l'API appelle une opération à courte durée d'exécution ou à longue durée d'exécution.
Afin de définir la fin de l'appel REST pour une opération à longue durée d'exécution à l'aide de l'interrogation, reportez-vous également à Fourniture de critères de fin à l'aide de l'interrogation.
Les fonctions de chaîne et d'opérateur de base sont prises en charge dans les conditions de réussite et d'interrogation.
L'expression d'une condition de réussite ou d'interrogation peut inclure uniquement les fonctions telles qu'indiquées dans la section suivante. Pour extraire des valeurs de structures JSON, utilisez la fonction json_path
.
Arithmétique de base |
|
Booléenne de base |
|
Comparaison de base |
|
NULL de base |
|
Chaîne de base |
|
Date/heure de base |
|
Fonction json_path |
Pour les éléments de syntaxe JSONPath, reportez-vous à :
Par exemple, pour extraire la valeur de statut en cours de la réponse suivante, utilisez la syntaxe :
|
La condition de réussite d'une tâche REST est une expression qui détermine la réussite de l'appel d'API REST. L'interrogation s'arrête lorsque la condition de réussite est remplie.
Par défaut, Data Integration 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 supérieur ou égal à 200, mais inférieur à 300, écrit sous la forme de l'expression suivante :
SYS.RESPONSE_STATUS >= 200 AND SYS.RESPONSE_STATUS < 300
L'expression de condition de réussite référence la sortie dans la réponse JSON reçue de la demande REST définie dans 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 système ou des valeurs de propriété JSON extraites de la réponse.
Pour modifier la condition de réussite, procédez comme suit :
Vous pouvez affecter un paramètre de tâche à la condition de réussite dans une tâche REST.
La procédure suivante peut également être utilisée pour paramétrer une condition d'interrogation.
Pour paramétrer une condition :
Vous pouvez modifier la description et la valeur par défaut du paramètre de tâche pour la condition de réussite.
La procédure suivante peut également être utilisée pour modifier le paramètre de condition d'interrogation.
Pour modifier la condition paramétrée :
La suppression du paramètre de condition enlève uniquement l'association du paramètre à la condition de réussite spécifiée pour la tâche REST.
La procédure suivante peut également être utilisée pour supprimer le paramètre de condition d'interrogation.
Pour annuler l'affectation du paramètre à la condition, procédez comme suit :