

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# ItemSelector (Peta)
<a name="input-output-itemselector"></a>

**Mengelola status dan mengubah data**  
Pelajari tentang [Melewati data antar status dengan variabel](workflow-variables.md) dan [Mengubah data dengan JSONata](transforming-data.md).

Secara default, input efektif untuk `Map` status adalah kumpulan item data individual yang ada dalam input status mentah. Dengan `ItemSelector` bidang tersebut, Anda dapat mengganti nilai item data sebelum diteruskan ke status. `Map` 

Untuk mengganti nilai, tentukan input JSON valid yang berisi kumpulan pasangan kunci-nilai. Pasangan dapat berupa nilai statis yang disediakan dalam definisi mesin status Anda, nilai yang dipilih dari input status menggunakan [jalur](amazon-states-language-paths.md), atau nilai yang diakses dari [objek Context](input-output-contextobject.md). 

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

**catatan**  
`ItemSelector`Bidang menggantikan `Parameters` bidang di dalam `Map` negara bagian. Jika Anda menggunakan `Parameters` bidang dalam definisi `Map` status Anda untuk membuat input khusus, kami sarankan Anda menggantinya dengan`ItemSelector`.

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, lihat[Salin CSV skala besar menggunakan Peta Terdistribusi](tutorial-map-distributed.md).