

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

Le sezioni seguenti descrivono come lavorare con AWS Step Functions `Amazon State Language (ASL)` i file contenenti le definizioni delle macchine a stati nel AWS Toolkit. Per informazioni dettagliate sulle macchine a AWS Step Functions stati, consulta l'[argomento ](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-statemachines.html) Informazioni sulle macchine a stati in Step Functions 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, completate i seguenti passaggi.

1. Dal AWS Toolkit Explorer, espandete l'area che contiene il `ASL` file da 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 da un modello, consultate la * sezione Modelli di macchine a * stati riportata di seguito, in questo argomento della Guida per l'utente.

**Nota**  
Per utilizzare 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, consulta l'[argomento ](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/stepfunctions-workflowstudio.html) Utilizzo di Workflow Studio 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, ** scegli il ** pulsante ** Salva dal menu delle 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 una definizione di 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. Dal AWS Toolkit Explorer, espandete la regione in cui desiderate creare una macchina a stati Step Functions.

1. Apri il menu contestuale per (fai clic con il pulsante destro del mouse) ** Step Functions ** e scegli ** Crea una nuova macchina ** a stati Step Functions per aprire la ** procedura guidata ** Select a starter template (1/2) in VS Code.

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

1. Dalla ** schermata ** Seleziona il formato del modello (2/2), scegli ** YAML ** o ** JSON ** per il 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 nell'istanza locale di VS Code, completa i passaggi seguenti.

1. Da AWS Toolkit Explorer, espandi la regione 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 memorizzare 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 su 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 non salvate 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 sono stati rilevati errori nel `ASL` file, riceverai una ** notifica di ** successo in Workflow Studio, al termine del salvataggio. Tuttavia, se il file locale non è valido `JSON` o `YAML` si tenta di salvarlo, la sincronizzazione del file locale non viene completata e si riceve una ** notifica di ** avviso in Workflow Studio.

1. Da un `ASL` file aperto contenente una definizione di macchina a stati in Workflow Studio, accedi 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. Dal AWS Toolkit Explorer, espandete l'area contenente la macchina a stati Step Functions che desiderate 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, scegli ** Avvia esecuzione ** per avviare il processo di avvio.

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

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

Gli snippet 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 passaggi seguenti.

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

1. Da VS Code, aprite un `ASL` file contenente la definizione della macchina a stati che desiderate modificare o create 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 nella `"States"` proprietà.

1. **control \+ space**Premi per aprire il menu dei frammenti di codice, è possibile accedere alle proprietà aggiuntive premendo **control \+ 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 lavorate 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