As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalhando com AWS Step Functions
<a name="building-stepfunctions"></a>

As seções a seguir descrevem como trabalhar com AWS Step Functions `Amazon State Language (ASL)` arquivos contendo definições de máquina de estado no AWS Toolkit. Para obter informações detalhadas sobre máquinas de AWS Step Functions estado, consulte o tópico [Saiba mais sobre máquinas de estado em Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-statemachines.html) no Guia do *AWS Step Functions*desenvolvedor.

## Visualizar máquinas de estado do Step Functions
<a name="starting-sfn-list"></a>

Para visualizar seus `ASL` arquivos existentes contendo definições de máquina de estado no AWS Toolkit Explorer, conclua as etapas a seguir.

1. No AWS Toolkit Explorer, expanda a região que contém o `ASL` arquivo que você deseja visualizar.

1. Expanda o título **Step Functions**.

1. Seus `ASL` arquivos são exibidos no AWS Explorer.

## Criar uma máquina de estado do Step Functions
<a name="starting-sfn-create"></a>

No AWS Toolkit, você pode criar uma nova máquina de estado Step Functions a partir de um arquivo ou usar um modelo. O procedimento a seguir descreve como criar uma máquina de estado do Step Functions usando um arquivo. Para obter detalhes sobre como criar uma máquina de estado SFN a partir de um modelo, consulte a seção *Modelos de máquina de estado* localizada abaixo, neste tópico do Guia do usuário.

**nota**  
Para trabalhar com Step Functions no VS Code, a extensão do seu arquivo `Amazon State Language` (ASL) que contém a definição da sua máquina de estado deve terminar com `asl.json`, `asl.yml`, ou `.asl.yaml`.  
Por padrão, os arquivos Step Functions relevantes são abertos no Workflow Studio. Para obter informações detalhadas sobre como trabalhar no Workflow Studio por meio do AWS kit de ferramentas, consulte o tópico [Trabalhando com o Workflow Studio](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/stepfunctions-workflowstudio.html) neste Guia do usuário.

1. No seu espaço de trabalho no VS Code, crie um novo arquivo.

1. Nomeie seu arquivo e especifique a extensão do arquivo como `asl.json`, `asl.yml`, ou`.asl.yaml`.

1. Após a criação, o AWS Toolkit abre o novo arquivo no AWS Step Functions Workflow Studio.

1. No **Workflow Studio**, escolha o botão **Salvar** no menu do utilitário para salvar seu novo arquivo `ASL`.

## Como criar uma máquina de estado Step Functions usando um modelo
<a name="templates-stepfunctions"></a>

No AWS Toolkit, você pode criar uma máquina de estado Step Functions a partir de um modelo. O processo de modelo cria um arquivo `ASL` que contém uma definição de máquina de estado, fornecendo um ponto de partida para seu projeto. O procedimento a seguir descreve como criar uma máquina de estado Step Functions a partir de um modelo no AWS Toolkit.

1. No AWS Toolkit Explorer, expanda a região na qual você deseja criar uma máquina de estado Step Functions.

1. Abra o menu de contexto para (clique com o botão direito do mouse) **Step Functions** e escolha **Criar uma nova máquina de estado Step Functions** para abrir o assistente **Selecionar um modelo inicial (1/2)** no VS Code.

1. No assistente **Selecionar um modelo inicial (1/2)**, escolha o tipo de modelo para sua máquina de estado Step Functions para continuar.

1. Na tela **Selecionar formato de modelo (2/2)**, escolha **YAML** ou **JSON** para seu formato de modelo.

1. Um novo `ASL` arquivo contendo sua definição de máquina de estado é aberto no editor de código do VS Code.

## Baixar uma máquina de estado do Step Functions
<a name="sfn-download"></a>

Para baixar uma máquina de estado do Step Functions armazenada remotamente na instância local do VS Code, conclua as etapas a seguir.

1. No AWS Toolkit Explorer, expanda a região que contém a máquina de estado Step Functions que você deseja baixar.

1. Expanda **Step Functions**, clique com o botão direito do mouse na máquina de estado Step Functions que você deseja baixar e escolha **Baixar definição**... .

1. Especifique um local para armazenar sua máquina de estado Step Functions localmente para continuar.

1. A máquina de estado do Step Functions é aberta no Workflow Studio quando o procedimento é concluído.

## Salvar alterações em uma máquina de estado do Step Functions
<a name="starting-sfn-update"></a>

O procedimento a seguir descreve como salvar as alterações feitas na máquina de estado do Step Functions.

**nota**  
As edições feitas no Workflow Studio são sincronizadas com seu arquivo local, mas permanecem sem serem salvas até que seu trabalho seja salvo no editor de código do VS Code ou no Workflow Studio. Se o arquivo local for modificado e salvo enquanto o Workflow Studio estiver aberto e não houver erros detectados no arquivo `ASL`, você receberá uma notificação de **sucesso** no Workflow Studio quando o salvamento for concluído. No entanto, se o arquivo local contiver dados inválidos `JSON` ou `YAML` você tentar salvá-lo, o arquivo local falhará ao sincronizar e você receberá uma notificação de **aviso** no Workflow Studio.

1. Em um arquivo `ASL` aberto contendo uma definição de máquina de estado no Workflow Studio, navegue até os **botões do Utilitário**.

1. Clique no botão **Salvar**.

1. O VS Code notifica você quando o arquivo foi salvo.

## Executar uma máquina de estado do Step Functions
<a name="starting-sfn-execute"></a>

O procedimento a seguir descreve como executar uma máquina de estado Step Functions no AWS Toolkit.

1. No AWS Toolkit Explorer, expanda a região que contém a máquina de estado Step Functions que você deseja executar.

1. Expanda o **Step Functions** e clique com o botão direito do mouse na máquina de estado do Step Functions que deseja executar.

1. No menu contextual, escolha **Iniciar execução** para iniciar o processo de lançamento.

1. O status do lançamento é exibido na janela **Saída do AWS Toolkit** no VS Code.

## Como trabalhar com trechos de código
<a name="building-stepfunctions-code-snippets"></a>

Os trechos de código são sugestões automatizadas que são geradas com base no código em que você está trabalhando. Para trabalhar com trechos de código com o Step Functions no kit de ferramentas, conclua as etapas a seguir.

**nota**  
Para trabalhar com trechos de código do Step Functions no VS Code, a extensão do seu `ASL` arquivo que contém a definição da sua máquina de estado deve terminar com `.asl.json`, `.asl.yml`, ou `.asl.yaml`.  
Por padrão, seus arquivos Step Functions relevantes são abertos no Workflow Studio.

1. No VS Code, abra um arquivo `ASL` contendo a definição da máquina de estado que você deseja modificar ou crie um novo arquivo `ASL`.

1. No Workflow Studio, alterne para o modo **Código** se você estiver no modo **Design**.

1. No editor de código do Workflow Studio, coloque o cursor na `"States"` propriedade.

1. Pressione **control \+ space** para abrir o menu de trechos de código, propriedades adicionais podem ser acessadas pressionando **control \+ space** e são baseadas no `"State"` `"Type"`.

1. Selecione o trecho de código desejado na lista.

## Validação de código
<a name="building-stepfunctions-code-completion"></a>

À medida que você trabalha no Step Functions no Workflow Studio, a validação de código identifica ativamente os erros e faz sugestões para o seguinte:
+ Propriedades ausentes
+ Valores incorretos
+ Estado não terminal
+ Estados inexistentes que forem indicados