ItemsPath - AWS Step Functions

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.

ItemsPath

Utilisez le ItemsPath champ pour sélectionner un tableau dans une entrée JSON fournie à un Map état. L'Mapétat répète un ensemble d'étapes pour chaque élément du tableau. Par défaut, l'Mapétat est défini sur$, ce qui permet de sélectionner la totalité de l'entrée. ItemsPath Si l'entrée de l'Mapétat est un tableau JSON, il exécute une itération pour chaque élément du tableau, en transmettant cet élément à l'itération en tant qu'entrée.

Note

Vous ne pouvez l'utiliser ItemsPath dans l'état Distributed Map que si vous utilisez une entrée JSON transmise à partir d'un état précédent dans le flux de travail.

Vous pouvez utiliser le ItemsPath champ pour spécifier un emplacement dans l'entrée qui pointe vers le tableau JSON utilisé pour les itérations. La valeur de ItemsPath doit être un chemin de référence, et ce chemin doit pointer vers un tableau JSON. Par exemple, imaginons l’entrée d’un état Map qui inclut deux tableaux, comme dans l'exemple suivant.

{
  "ThingsPiratesSay": [
    {
      "say": "Avast!"
    },
    {
      "say": "Yar!"
    },
    {
      "say": "Walk the Plank!"
    }
  ],
  "ThingsGiantsSay": [
    {
      "say": "Fee!"
    },
    {
      "say": "Fi!"
    },
    {
      "say": "Fo!"
    },
    {
      "say": "Fum!"
    }
  ]
}

Dans ce cas, vous pouvez spécifier le tableau à utiliser pour les itérations Map d'état en le sélectionnant avecItemsPath. La définition de machine à états suivante spécifie le ThingsPiratesSay tableau dans l'entrée à l'ItemsPathaide de .It exécute ensuite une itération de l'état de SayWord passe pour chaque élément du ThingsPiratesSay tableau.

{
  "StartAt": "PiratesSay",
  "States": {
    "PiratesSay": {
      "Type": "Map",
      "ItemsPath": "$.ThingsPiratesSay",
      "ItemProcessor": {
         "StartAt": "SayWord",
         "States": {
           "SayWord": {
             "Type": "Pass",
             "End": true
           }
         }
      },
      "End": true
    }
  }
}

Lors du traitement d'une entrée, l'Mapétat s'applique ItemsPath ensuite InputPath. Il fonctionne sur l'entrée effective de l'état après avoir InputPath filtré l'entrée.

Pour plus d'informations sur les états Map, consultez les sections suivantes.