

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwenden des Inline-Map-Status zur Wiederholung einer Aktion in Step Functions
<a name="tutorial-map-inline"></a>

Dieses Tutorial hilft Ihnen bei den ersten Schritten mit der Verwendung des `Map` Status im Inline-Modus. Sie verwenden den *Inline-Map-Status* in Ihren Workflows, um wiederholt eine Aktion auszuführen. Weitere Informationen zum Inline-Modus finden Sie unter [Zuordnen des Status im Inline-Modus](state-map-inline.md).

In diesem Tutorial verwenden Sie den *Inline-Map-Status*, um wiederholt Universally Unique Identifiers (v4-UUID) der Version 4 zu generieren. Sie beginnen mit der Erstellung eines Workflows, der zwei [Workflow-Status übergeben](state-pass.md) Status und einen *Inline Map-Status* im Workflow Studio enthält. Anschließend konfigurieren Sie die Eingabe und Ausgabe, einschließlich des Eingabe-JSON-Arrays für den `Map` Status. Der `Map` Status gibt ein Ausgabearray zurück, das die Version 4 enthält, die für jedes Element im Eingabearray UUIDs generiert wurde.

## Schritt 1: Erstellen Sie den Workflow-Prototyp
<a name="use-inline-map-create-workflow"></a>

In diesem Schritt erstellen Sie den Prototyp für Ihren Workflow mit Workflow Studio. Workflow Studio ist ein visueller Workflow-Designer, der in der Step Functions-Konsole verfügbar ist. Sie wählen die erforderlichen Status auf der Registerkarte **Flow** aus und verwenden die Drag-and-Drop-Funktion von Workflow Studio, um den Workflow-Prototyp zu erstellen.

1. Öffnen Sie die [Step Functions Functions-Konsole](https://console.aws.amazon.com/states/home), wählen Sie im Menü **State Machines** und dann **Create State Machine** aus.

1. Wählen Sie „**Aus leerem Feld erstellen“**.

1. Geben Sie Ihrem Zustandsmaschine einen Namen und wählen Sie dann **Weiter**, um Ihren Zustandsmaschine in Workflow Studio zu bearbeiten.

1. Ziehen Sie auf der Registerkarte **Flow** einen **Pass-Status** und legen Sie ihn in den leeren Status mit der Bezeichnung **Drag First state here** ab.

1. Ziehen Sie einen **Kartenstatus** und legen Sie ihn unter den Status **Pass ab**. Benennen Sie den **Kartenstatus** um in**Map demo**.

1. Ziehen Sie einen zweiten **Pass-Status** und legen Sie ihn innerhalb des **Map-Demo-Status** ab.

1. Benennen Sie den zweiten **Pass-Status** in um**Generate UUID**.

## Schritt 2: Eingabe und Ausgabe konfigurieren
<a name="use-inline-map-configure-io"></a>

In diesem Schritt konfigurieren Sie Eingabe und Ausgabe für alle Status in Ihrem Workflow-Prototyp. Zunächst fügen Sie mithilfe des ersten **Pass-Status** einige feste Daten in den Workflow ein. Dieser **Pass-Status** gibt diese Daten als Eingabe an den **Map-Demo-Status** weiter. In dieser Eingabe geben Sie den Knoten an, der das Eingabearray enthält, über das der **Map-Demostatus** iteriert werden soll. Dann definieren Sie den Schritt, den der **Map-Demostatus** wiederholen soll, um die Version 4 UUIDs zu generieren. Schließlich konfigurieren Sie die Ausgabe so, dass sie bei jeder Wiederholung zurückkehrt.

1. Wählen Sie den ersten **Pass-Status** in Ihrem Workflow-Prototyp aus. Geben Sie auf der Registerkarte **Ausgabe** unter **Ergebnis** Folgendes ein:

   ```
   {
     "foo": "bar",
     "colors": [
       "red",
       "green",
       "blue",
       "yellow",
       "white"
     ]
   }
   ```

1. Wählen Sie den **Map-Demostatus** und gehen Sie auf der Registerkarte **Konfiguration** wie folgt vor:

   1. Wählen Sie „**Pfad zum Artikelarray angeben**“ aus.

   1. Geben Sie den folgenden [Referenzpfad](amazon-states-language-paths.md#amazon-states-language-reference-paths) an, um den Knoten auszuwählen, der das Eingabe-Array enthält: 

      ```
      $.colors
      ```

1. Wählen Sie den Status **UUID generieren** und gehen Sie auf der Registerkarte **Eingabe** wie folgt vor:

   1. Wählen Sie „**Eingabe mit Parametern transformieren**“.

   1. Geben Sie die folgende JSON-Eingabe ein, um die Version v4 UUIDs für jedes der Eingabe-Array-Elemente zu generieren. Sie verwenden die `States.UUID` systeminterne Funktion, um die zu generieren. UUIDs

      ```
      {
        "uuid.$": "States.UUID()"
      }
      ```

1. Wählen Sie für den Status „**UUID generieren**“ die Registerkarte „**Ausgabe**“ und gehen Sie wie folgt vor:

   1. Wählen Sie „**Ausgabe filtern** mit“. OutputPath

   1. Geben Sie den folgenden Referenzpfad ein, um den JSON-Knoten auszuwählen, der die Ausgabe-Array-Elemente enthält: 

      ```
      $.uuid
      ```

## Schritt 3: Automatisch generierte Definition überprüfen und speichern
<a name="use-inline-map-review-asl-def"></a>

Wenn Sie Status aus dem **Flow-Bedienfeld** auf die Arbeitsfläche ziehen und dort ablegen, erstellt Workflow Studio automatisch die [Amazon States Language](concepts-amazon-states-language.md) (ASL) -Definition Ihres Workflows in Echtzeit. Sie können diese Definition nach Bedarf bearbeiten.

1. (Optional) Wählen Sie im [Inspektor-Panel](workflow-studio.md#workflow-studio-components-formdefinition) Fenster **Definition** aus, um die automatisch generierte Amazon States-Sprachdefinition Ihres Workflows anzuzeigen.
**Tipp**  
Sie können die ASL-Definition auch im Workflow Studio einsehen. [Code-Editor](workflow-studio.md#wfs-interface-code-editor) Im Code-Editor können Sie auch die ASL-Definition Ihres Workflows bearbeiten.

   Das folgende Beispiel zeigt die automatisch generierte Amazon States-Sprachdefinition für Ihren Workflow.

   ```
   {
       "Comment": "Using Map state in Inline mode",
       "StartAt": "Pass",
       "States": {
         "Pass": {
           "Type": "Pass",
           "Next": "Map demo",
           "Result": {
             "foo": "bar",
             "colors": [
               "red",
               "green",
               "blue",
               "yellow",
               "white"
             ]
           }
         },
         "Map demo": {
           "Type": "Map",
           "ItemsPath": "$.colors",
           "ItemProcessor": {
             "ProcessorConfig": {
               "Mode": "INLINE"
             },
             "StartAt": "Generate UUID",
             "States": {
               "Generate UUID": {
                 "Type": "Pass",
                 "End": true,
                 "Parameters": {
                   "uuid.$": "States.UUID()"
                 },
                 "OutputPath": "$.uuid"
               }
             }
           },
           "End": true
         }
       }
     }
   ```

1. Geben Sie einen Namen für Ihren State Machine an. Wählen Sie dazu das Bearbeitungssymbol neben dem Standardnamen der Zustandsmaschine von **MyStateMachine**. Geben Sie dann **unter State Machine Configuration** einen Namen in das Feld **State Machine Name** ein.

   Geben Sie für dieses Tutorial den Namen **InlineMapDemo** ein.

1. (Optional) Geben Sie unter **State-Machine-Konfiguration** weitere Workflow-Einstellungen an, z. B. den Zustandsmaschinentyp und seine Ausführungsrolle.

   Behalten Sie für dieses Tutorial alle Standardauswahlen in der **State-Machine-Konfiguration** bei.

1. Wählen **Sie im Dialogfeld zur Bestätigung der Rollenerstellung** die Option **Bestätigen** aus, um fortzufahren.

   Sie können auch **Rolleneinstellungen anzeigen** wählen, um zur **State-Machine-Konfiguration** zurückzukehren.
**Anmerkung**  
Wenn Sie die von Step Functions erstellte IAM-Rolle löschen, kann Step Functions sie später nicht mehr neu erstellen. Ebenso kann Step Functions ihre ursprünglichen Einstellungen später nicht wiederherstellen, wenn Sie die Rolle ändern (z. B. indem Sie Step Functions aus den Principals in der IAM-Richtlinie entfernen). 

## Schritt 4: Führen Sie die Zustandsmaschine aus
<a name="use-inline-map-sm-run"></a>

State-Machine-Ausführungen sind Instanzen, in denen Sie Ihren Workflow ausführen, um Aufgaben auszuführen.

1. Wählen Sie auf der **InlineMapDemo**Seite **Ausführung starten** aus.

1. Gehen **Sie im Dialogfeld Ausführung starten** wie folgt vor:

   1. (Optional) Geben Sie einen benutzerdefinierten Ausführungsnamen ein, um den generierten Standard zu überschreiben.
**Nicht-ASCII-Namen und Protokollierung**  
Step Functions akzeptiert Namen für Zustandsmaschinen, Ausführungen, Aktivitäten und Labels, die Nicht-ASCII-Zeichen enthalten. Da solche Zeichen Amazon CloudWatch daran hindern, Daten zu protokollieren, empfehlen wir, nur ASCII-Zeichen zu verwenden, damit Sie die Step Functions Functions-Metriken verfolgen können.

   1. (Optional) Geben Sie im **Eingabefeld Eingabewerte** im JSON-Format ein, um Ihren Workflow auszuführen.

   1. Wählen Sie **Start execution (Ausführung starten)** aus.

   1. Die Step Functions Functions-Konsole leitet Sie zu einer Seite weiter, die mit Ihrer Ausführungs-ID betitelt ist, die als Seite mit den *Ausführungsdetails* bezeichnet wird. Sie können die Ausführungsergebnisse im Verlauf und nach Abschluss des Workflows überprüfen.

      Um die Ausführungsergebnisse zu überprüfen, wählen Sie in der **Diagrammansicht** einzelne Status und anschließend die einzelnen Registerkarten im [Einzelheiten zu den Schritten](concepts-view-execution-details.md#exec-details-intf-step-details) Bereich aus, um die Details der einzelnen Status, einschließlich Eingabe, Ausgabe und Definition, anzuzeigen. Einzelheiten zu den Ausführungsinformationen, die Sie auf der Seite mit den *Ausführungsdetails* einsehen können, finden Sie unter[Überblick über die Ausführungsdetails](concepts-view-execution-details.md#exec-details-interface-overview).

   Um die Eingabe und Ausgabe der Ausführung anzuzeigen side-by-side, wählen Sie **Eingabe und Ausgabe der Ausführung**. Sehen Sie sich unter **Ausgabe** das vom `Map` Status zurückgegebene Ausgabearray an. Im Folgenden finden Sie ein Beispiel für das Ausgabe-Array:

   ```
   [
     "a85cbc7b-4e65-4ac2-97af-80ed504adc1d",
     "b05bca11-d481-414e-aa9a-88285ec6590d",
     "f42d59f7-bd32-480f-b270-caddb518ce2a",
     "15f18616-517d-4b69-b7c3-bf22222d2efd",
     "690bcfee-6d58-408c-a6b4-1995ccafdbd2"
   ]
   ```