ItemSelector (Peta)

Mengelola status dan mengubah data

Pelajari tentang Melewati data antar status dengan variabel dan Mengubah data dengan JSONata.

Secara default, input efektif untuk Map status adalah kumpulan item data individual yang ada dalam input status mentah. ItemSelectorBidang ini memungkinkan Anda mengganti nilai item data sebelum diteruskan ke status. Map Untuk mengganti nilai, tentukan input JSON valid yang berisi kumpulan pasangan kunci-nilai. Pasangan ini dapat berupa nilai statis yang disediakan dalam definisi mesin status Anda, nilai yang dipilih dari input status menggunakan jalur, atau nilai yang diakses dari objek Context.

Jika Anda menentukan pasangan kunci-nilai menggunakan jalur atau objek Konteks, nama kunci harus diakhiri. .$

catatan

ItemSelectorBidang menggantikan Parameters bidang di dalam Map negara bagian. Jika Anda menggunakan Parameters bidang dalam definisi Map status Anda untuk membuat input khusus, kami sangat menyarankan Anda menggantinya denganItemSelector.

Anda dapat menentukan ItemSelector bidang dalam status Peta Sebaris dan status Peta Terdistribusi.

Misalnya, pertimbangkan input JSON berikut yang berisi array tiga item dalam imageData node. Untuk setiap iterasi Map status, item array diteruskan ke iterasi sebagai input.

[
  {
    "resize": "true",
    "format": "jpg"
  },
  {
    "resize": "false",
    "format": "png"
  },
  {
    "resize": "true",
    "format": "jpg"
  }
]

Menggunakan ItemSelector bidang, Anda dapat menentukan input JSON kustom untuk mengganti input asli seperti yang ditunjukkan pada contoh berikut. Step Functions kemudian meneruskan input kustom ini ke setiap iterasi Map status. Masukan kustom berisi nilai statis untuk size dan nilai data objek Konteks untuk Map status. Objek $$.Map.Item.Value Konteks berisi nilai setiap item data individu.

{
  "ItemSelector": {
    "size": 10,
    "value.$": "$$.Map.Item.Value"
  }
}

Contoh berikut menunjukkan masukan yang diterima oleh satu iterasi dari status Peta Inline:

{
  "size": 10,
  "value": {
    "resize": "true",
    "format": "jpg"
  }
}

Tip

Untuk contoh lengkap status Peta Terdistribusi yang menggunakan ItemSelector bidang, lihatSalin CSV skala besar menggunakan Peta Terdistribusi.