Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Lavorare con AWS Step Functions
<a name="building-stepfunctions"></a>

Le sezioni seguenti descrivono come lavorare con AWS Step Functions `Amazon State Language (ASL)` i file contenenti definizioni di macchine a stati nel AWS Toolkit. Per informazioni dettagliate sulle macchine a AWS Step Functions stati, consulta l'argomento [Informazioni sulle macchine a stati in Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-statemachines.html) nella Guida per gli *AWS Step Functions*sviluppatori.

## Visualizzazione delle macchine a stati Step Functions
<a name="starting-sfn-list"></a>

Per visualizzare i `ASL` file esistenti contenenti le definizioni delle macchine a stati in AWS Toolkit Explorer, completare i seguenti passaggi.

1. Da AWS Toolkit Explorer, espandi l'area che contiene il `ASL` file che desideri visualizzare.

1. Espandi l'intestazione **Step Functions**.

1. `ASL`I tuoi file vengono visualizzati in AWS Explorer.

## Creazione di una macchina a stati Step Functions
<a name="starting-sfn-create"></a>

Nel AWS Toolkit, è possibile creare una nuova macchina a stati Step Functions da un file oppure utilizzare un modello. La procedura seguente descrive come creare una macchina a stati Step Functions da un file. Per informazioni dettagliate sulla creazione di una macchina a stati SFN a partire da un modello, consultate la sezione *Modelli di macchine a stati (State machine templates*) riportata di seguito, in questo argomento della Guida per l'utente.

**Nota**  
Per lavorare con Step Functions in VS Code, l'estensione del file `Amazon State Language` (ASL) che contiene la definizione della macchina a stati deve terminare con `asl.json``asl.yml`, o`.asl.yaml`.  
Per impostazione predefinita, i file Step Functions pertinenti vengono aperti in Workflow Studio. Per informazioni dettagliate sull'utilizzo di Workflow Studio tramite il AWS Toolkit, consultate l'argomento [Utilizzo di Workflow Studio](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/stepfunctions-workflowstudio.html) in questa Guida per l'utente.

1. Dal tuo spazio di lavoro in VS Code, crea un nuovo file.

1. Assegna un nome al file e specifica l'estensione del file come `asl.json``asl.yml`, o`.asl.yaml`.

1. Al momento della creazione, il AWS Toolkit apre il nuovo file in AWS Step Functions Workflow Studio.

1. Da **Workflow Studio**, scegliete il pulsante **Salva** dal menu dell'utilità per salvare il nuovo `ASL` file.

## Creazione di una macchina a stati Step Functions da un modello
<a name="templates-stepfunctions"></a>

Nel AWS Toolkit, è possibile creare una macchina a stati Step Functions da un modello. Il processo di creazione del modello crea un `ASL` file che contiene la definizione di una macchina a stati, che fornisce un punto di partenza per il progetto. La procedura seguente descrive come creare una macchina a stati Step Functions da un modello nel AWS Toolkit.

1. Da AWS Toolkit Explorer, espandi la regione in cui desideri creare una macchina a stati Step Functions.

1. Apri il menu contestuale per (tasto destro) **Step Functions** e scegli **Crea una nuova macchina a stati Step Functions** per aprire la procedura guidata **Seleziona un modello di avvio (1/2)** in VS Code.

1. Dalla procedura guidata **Seleziona un modello di partenza (1/2)**, scegli il tipo di modello per la tua macchina a stati Step Functions per procedere.

1. Dalla schermata **Seleziona il formato del modello (2/2)**, scegli **YAML** o **JSON** come formato del modello.

1. Un nuovo `ASL` file contenente la definizione della macchina a stati viene aperto nell'editor VS Code.

## Scaricamento di una macchina a stati Step Functions
<a name="sfn-download"></a>

Per scaricare una macchina a stati Step Functions archiviata in remoto sull'istanza locale di VS Code, completa i seguenti passaggi.

1. Da AWS Toolkit Explorer, espandi l'area che contiene la macchina a stati Step Functions che desideri scaricare.

1. Espandi **Step Functions**, quindi fai clic con il pulsante destro del mouse sulla macchina a stati Step Functions che desideri scaricare e scegli **Scarica definizione...** .

1. Specificate una posizione in cui archiviare localmente la macchina a stati Step Functions per procedere.

1. La macchina a stati Step Functions si apre in Workflow Studio al termine della procedura.

## Salvataggio delle modifiche a una macchina a stati Step Functions
<a name="starting-sfn-update"></a>

La procedura seguente descrive come salvare le modifiche apportate alla macchina a stati Step Functions.

**Nota**  
Le modifiche apportate in Workflow Studio vengono sincronizzate con il file locale, ma rimangono invariate finché il lavoro non viene salvato nell'editor VS Code o Workflow Studio. Se il file locale viene modificato e salvato mentre Workflow Studio è aperto e non vengono rilevati errori nel `ASL` file, al termine del salvataggio riceverai una notifica di operazione **riuscita** in Workflow Studio. Tuttavia, se il file locale contiene un file non valido `JSON` o `YAML` si tenta di salvare, la sincronizzazione del file locale non riesce e si riceve una notifica di **avviso** in Workflow Studio.

1. Da un `ASL` file aperto contenente la definizione di una macchina a stati in Workflow Studio, accedete ai **pulsanti Utility**.

1. Seleziona il pulsante **Save** (Salva).

1. VS Code ti avvisa quando il file è stato salvato.

## Esecuzione di una macchina a stati Step Functions
<a name="starting-sfn-execute"></a>

La procedura seguente descrive come eseguire una macchina a stati Step Functions nel AWS Toolkit.

1. Da AWS Toolkit Explorer, espandi l'area contenente la macchina a stati Step Functions che desideri eseguire.

1. Espandi **Step Functions**, quindi fai clic con il pulsante destro del mouse sulla macchina a stati Step Functions che desideri eseguire.

1. Dal menu contestuale, scegliete **Avvia esecuzione** per avviare il processo di avvio.

1. Lo stato del lancio viene visualizzato nella finestra **AWS Toolkit Output** in VS Code.

## Lavorare con frammenti di codice
<a name="building-stepfunctions-code-snippets"></a>

I frammenti di codice sono suggerimenti automatici generati in base al codice su cui stai lavorando. Per utilizzare frammenti di codice con Step Functions nel toolkit, completa i seguenti passaggi.

**Nota**  
Per lavorare con i frammenti di codice Step Functions in VS Code, l'estensione del `ASL` file che contiene la definizione della macchina a stati deve terminare con `.asl.json``.asl.yml`, o. `.asl.yaml`  
Per impostazione predefinita, i file Step Functions pertinenti vengono aperti in Workflow Studio.

1. Da VS Code, apri un `ASL` file contenente la definizione della macchina a stati che desideri modificare o crea un nuovo `ASL` file.

1. Da Workflow Studio, passa alla modalità **Codice** se sei in modalità **Progettazione**.

1. Dall'editor di codice di Workflow Studio, posiziona il cursore sulla `"States"` proprietà.

1. Premi **control \$1 space** per aprire il menu dei frammenti di codice, è possibile accedere alle proprietà aggiuntive premendo **control \$1 space** e si basano su. `"State"` `"Type"`

1. Scegli il frammento di codice che desideri dall'elenco.

## Convalida del codice
<a name="building-stepfunctions-code-completion"></a>

Mentre lavori su Step Functions in Workflow Studio, la convalida del codice identifica attivamente gli errori e fornisce suggerimenti per quanto segue:
+ Proprietà mancanti
+ Valori errati
+ Stato non terminale
+ Stati inesistenti verso i quali è stato eseguito il puntamento