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.
Gestion de l'état à l'aide de variables et JSONata
Step Functions a récemment ajouté des variables et JSONata permet de gérer l'état et de transformer les données.
Pour en savoir plus, consultez le billet de blog Simplifier l'expérience des développeurs à l'aide de variables et JSONata
Lorsqu'une exécution de Step Functions reçoit une entrée JSON, elle transmet ces données au premier état du flux de travail en tant qu'entrée.
Avec JSONata, vous pouvez récupérer les entrées d'état depuis$states.input
. Les exécutions de vos machines à états fournissent également ces données d'entrée initiales dans leObjet Contexte. Vous pouvez récupérer l'entrée de la machine à états d'origine à tout moment de votre flux de travail à partir de$states.context.Execution.Input
.
Lorsque les états sortent, leur sortie est disponible pour l'état suivant dans votre machine à états. Vos entrées d'état seront transmises en tant que sortie d'état par défaut, sauf si vous modifiez l'état de sortie. Pour les données dont vous pourriez avoir besoin ultérieurement, pensez à les stocker dans des variables. Pour plus d’informations, consultez Transmission de données entre états à l'aide de variables.
QueryLanguage recommandation
Pour les nouvelles machines à états, nous recommandons le langage de JSONata requête. Dans les machines d'état qui ne spécifient pas de langue de requête, la machine d'état utilise par défaut la valeur par défaut JSONPath pour des raisons de rétrocompatibilité. Vous devez choisir de l'utiliser JSONata pour vos machines d'État ou pour des États individuels.
Traitement des entrées et des sorties avec JSONata
JSONata Les expressions vous permettent de sélectionner et de transformer des données. Sur le Arguments
terrain, vous pouvez personnaliser les données envoyées à l'action. Le résultat peut être transformé en sortie d'état personnalisée Output
sur le terrain. Vous pouvez également stocker des données dans des variables Assign
sur le terrain. Pour plus d'informations, consultez la section Transformation des données avec JSONata.
Le schéma suivant montre comment les informations JSON passent par l'état d'une JSONata tâche.

Traitement des entrées et des sorties avec JSONPath
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.
Pour les machines à états qui l'utilisent JSONPath, les champs suivants contrôlent le flux de données d'un état à l'InputPath
autre :Parameters
,ResultSelector
,ResultPath
, etOutputPath
. Chaque JSONPath champ peut manipuler le JSON au fur et à mesure qu'il passe par chaque état de votre flux de travail.
JSONPath les champs peuvent utiliser des chemins pour sélectionner des parties du JSON à partir de l'entrée ou du résultat. Un chemin est une chaîne, commençant par$
, qui identifie les nœuds dans le texte JSON. Les chemins Step Functions utilisent JsonPath
Le schéma suivant montre comment les informations JSON passent par l'état d'une JSONPath tâche. InputPath
Sélectionne les parties de l'entrée JSON à transmettre à la tâche de l'Task
état (par exemple, une AWS Lambda fonction). Vous pouvez ajuster les données qui sont envoyées à votre action Parameters
sur le terrain. EnsuiteResultSelector
, vous pouvez sélectionner des parties du résultat de l'action à reporter. ResultPath
sélectionne ensuite la combinaison de l'entrée d'état et des résultats de la tâche à transmettre à la sortie. OutputPath
peut filtrer la sortie JSON pour limiter davantage les informations transmises à la sortie.

Rubriques
Accès aux données d'exécution depuis l'objet Context dans Step Functions
Manipulation des paramètres dans les flux de travail Step Functions
Exemple : manipulation de données d'état à l'aide de chemins dans les flux de travail Step Functions
Spécification de la sortie d'état à l'aide ResultPath de in Step Functions
Mappez les champs d'entrée et de sortie d'état dans Step Functions