Passer l'état du flux de travail - AWS Step Functions
Exemple d'état de passe (JSONPath)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Passer l'état du flux de travail

Gestion de l'état et transformation des données

Découvrez comment transmettre des données entre états avec des variables et transformer des données avec JSONata.

Un état Pass ("Type": "Pass") transmet simplement son entrée à sa sortie, sans qu'aucun travail ne soit effectué. Les états Pass sont utiles lors de la construction et du débogage des machines d'état.

Vous pouvez également utiliser un Pass état pour transformer l'entrée d'état JSON à l'aide de filtres, puis transmettre les données transformées à l'état suivant dans vos flux de travail. Pour plus d'informations sur la transformation des entrées, consultezManipulation des paramètres dans les flux de travail Step Functions.

Outre les champs d'état courants, les états Pass autorisent les champs suivants.

Assign(Facultatif, JSONata uniquement)

Collection de paires clé-valeur pour attribuer des données à des variables. Pour de plus amples informations, veuillez consulter Transmission de données entre états à l'aide de variables.

Output(Facultatif, JSONata uniquement)

Utilisé pour spécifier et transformer la sortie de l'état. Lorsqu'elle est spécifiée, la valeur remplace l'état par défaut de sortie.

Le champ de sortie accepte n'importe quelle valeur JSON (objet, tableau, chaîne, nombre, booléen, nul). Toute valeur de chaîne, y compris celles contenues dans des objets ou des tableaux, sera évaluée comme JSONata si elle était entourée de {% %} caractères.

Output accepte également directement une JSONata expression, par exemple : « Output » : « {% jsonata expression %} »

Pour de plus amples informations, veuillez consulter Transformer les données avec JSONata in Step Functions.

Result(Facultatif, JSONPath uniquement)

Fait référence à la sortie d'une tâche virtuelle transmise à l'état suivant. Si vous incluez le ResultPath champ dans la définition de votre machine à états, Result il est placé comme spécifié par ResultPath et transmis à l'état suivant.

ResultPath(Facultatif, JSONPath uniquement)

Spécifie où placer la sortie (par rapport à l'entrée) de la tâche virtuelle spécifiée dansResult. Les entrées sont ensuite filtrées telles que spécifiées par le champ OutputPath (s'il est présent) avant d'être utilisées comme sortie de l'état. Pour de plus amples informations, veuillez consulter Traitement des entrées et des sorties dans Step Functions.

Parameters(Facultatif, JSONPath uniquement)

Crée une collection de paires clé-valeur qui seront transmises en entrée. Vous pouvez spécifier Parameters une valeur statique ou effectuer une sélection dans l'entrée à l'aide d'un chemin. Pour de plus amples informations, veuillez consulter Manipulation des paramètres dans les flux de travail Step Functions.

Exemple d'état de passe (JSONPath)

Voici un exemple d'un état Pass qui injecte certaines données fixes dans la machine d'état, probablement à des fins de test.

"No-op": {
  "Type": "Pass",
  "Result": {
    "x-datum": 0.381018,
    "y-datum": 622.2269926397355
  },
  "ResultPath": "$.coords",
  "End": true
}

Supposons que l'entrée de cet état soit le suivant.

{
  "georefOf": "Home"
}

La sortie serait celle-ci.

{
  "georefOf": "Home",
  "coords": {
    "x-datum": 0.381018,
    "y-datum": 622.2269926397355
  }
}