View a markdown version of this page

Lavorare con AWS Step Functions - AWS Toolkit per VS Code
Visualizzazione delle macchine a stati Step FunctionsCreazione di una macchina a stati Step FunctionsCreazione di una macchina a stati Step Functions da un modelloScaricamento di una macchina a stati Step FunctionsSalvataggio delle modifiche su una macchina a stati Step FunctionsEsecuzione di una macchina a stati Step FunctionsLavorare con frammenti di codiceConvalida del codice

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 Informazioni sulle macchine a stati in Step Functions nella Guida per gli AWS Step Functions sviluppatori.

Visualizzazione delle macchine a stati Step Functions

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.

  2. Espandi l'intestazione Step Functions.

  3. ASLI tuoi file vengono visualizzati in AWS Explorer.

Creazione di una macchina a stati Step Functions

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.jsonasl.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 Utilizzo di Workflow Studio in questa Guida per l'utente.

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

  2. Assegna un nome al file e specifica l'estensione del file comeasl.json,asl.yml, o.asl.yaml.

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

  4. 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

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.

  2. 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.

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

  4. Dalla schermata Seleziona il formato del modello (2/2), scegli YAML o JSON per il formato del modello.

  5. 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

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.

  2. 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... .

  3. Specificate una posizione in cui memorizzare localmente la macchina a stati Step Functions per procedere.

  4. 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

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.

  2. Seleziona il pulsante Save (Salva).

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

Esecuzione di una macchina a stati Step Functions

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.

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

  3. Dal menu contestuale, scegli Avvia esecuzione per avviare il processo di avvio.

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

Lavorare con frammenti di codice

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.

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

  3. Dall'editor di codice di Workflow Studio, posiziona il cursore nella "States" proprietà.

  4. control + spacePremi per aprire il menu dei frammenti di codice, è possibile accedere alle proprietà aggiuntive premendo control + space e si basano su. "State" "Type"

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

Convalida del codice

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