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 o AWS Step Functions Workflow Studio
As seções a seguir descrevem como trabalhar com o AWS Step Functions Workflow Studio no AWS Toolkit for Visual Studio Code. Para obter informações detalhadas sobre o AWS Step Functions Workflow Studio, consulte o tópico [Desenvolvimento de fluxos de trabalho](https://docs.aws.amazon.com//step-functions/latest/dg/developing-workflows.html) no Guia do *AWS Step Functions*desenvolvedor
## Abrir o Workflow Studio
A lista a seguir descreve os diferentes caminhos disponíveis para você abrir o Workflow Studio no VS Code.
**nota**
Para trabalhar com o Workflow Studio 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`. Para obter detalhes sobre como baixar ou criar uma nova definição de máquina de estado no AWS Kit de ferramentas, consulte as seções *Baixando máquinas* de *estado e Criando uma máquina* de estado no AWS Step Functions tópico [Trabalhando com](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/building-stepfunctions.html) deste Guia do Usuário.
+ No AWS Explorer, abra o menu de contexto para (clique com o botão direito do mouse) um `ASL` arquivo contendo uma definição de máquina de estado e escolha **Abrir no Workflow Studio**.
+ Em um arquivo `ASL` aberto contendo uma definição de máquina de estado, escolha o ícone **Abrir com o Workflow Studio** localizado ao lado das guias na janela do editor de código do VS Code.
+ Em um `ASL` arquivo aberto contendo uma definição de máquina de estado, escolha o CodeLens comando **Abrir com o Workflow Studio**, localizado na parte superior do arquivo.
+ Fechar e reabrir um arquivo `ASL` contendo uma definição de máquina de estado reabre automaticamente o arquivo no Workflow Studio, a menos que o Workflow Studio padrão seja desativado manualmente.
## Modo de design e modo de código
O Workflow Studio tem dois modos para trabalhar com seus arquivos `ASL` que contêm uma definição de máquina de estado: modo **Design** e modo **Código**. O modo **Design** oferece uma interface gráfica para visualizar fluxos de trabalho à medida que você cria protótipos. O modo de **Código** tem um editor de código integrado onde você pode visualizar, escrever e editar as definições `ASL` em seus fluxos de trabalho.
**nota**
Para obter informações detalhadas sobre cada uma das seções da interface do usuário nos modos Design e Código, consulte o tópico [Usando o Workflow Studio](https://docs.aws.amazon.com//step-functions/latest/dg/workflow-studio.html) no Guia do *AWS Step Functions*desenvolvedor. Nem todos os recursos do Workflow Studio estão disponíveis no AWS Toolkit, como o modo **Config**, por exemplo.
A interface do usuário do modo **Design** tem 7 seções principais, conforme rotulada e descrita na imagem a seguir.
1. Botões de modo: botões para alternar entre os modos **Design** e **Código**.
1. Botões utilitários — um conjunto de botões para realizar tarefas, como salvar fluxos de trabalho ou exportar definições `ASL` em um arquivo JSON ou YAML.
1. Barra de ferramentas de design — contém um conjunto de botões para realizar ações comuns, como desfazer, excluir e ampliar.
1. Navegador de estados: Navegador contendo drag-and-drop estados para sua tela de fluxo de trabalho. Os estados são organizados em guias e definidos como **Ações**, **Fluxo** e **Padrões**.
1. O gráfico do Canvas e do fluxo de trabalho: uma renderização visual do seu fluxo de trabalho na qual você pode eliminar, reorganizar e selecionar estados para configuração.
1. Painel do Inspector: Visualize e edite as propriedades de qualquer estado selecionado na tela. Dependendo do estado selecionado no gráfico do fluxo de trabalho da tela, as guias são preenchidas com opções específicas do estado para **Configuração**, **Entrada/saída**, **Variáveis** e **Tratamento de erros**.
1. Os links de Informações abrem um painel com informações contextuais quando você precisa de ajuda. Esses painéis também incluem links para tópicos relacionados no *AWS Step Functions*Developer Guide.
![\[O modo de design da interface do usuário do Workflow Studio no AWS kit de ferramentas\]](http://docs.aws.amazon.com/pt_br/toolkit-for-vscode/latest/userguide/images/SFNWFS022025.png)
## Usando testes de estado único durante o projeto
Na interface de estado de teste do Workflow Studio, você pode testar os estados individuais da sua máquina de estado. Isso inclui a capacidade de fornecer entradas de estado, definir variáveis e fazer substituições de ambas as AWS SAM CloudFormation definições.
Para saber mais sobre infraestrutura como código (IaC), definições de recursos e transformação de dados, consulte os tópicos Como [AWS SAM criar fluxos de trabalho do Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-sam-sfn.html) e Como [transformar dados com o Step JSONata Functions](https://docs.aws.amazon.com/step-functions/latest/dg/transforming-data.html) no Guia do desenvolvedor. *AWS Step Functions*
O procedimento a seguir descreve como abrir a interface do usuário do Workflow Studio.
**Abrindo a interface do usuário do estado de teste**
1. Na guia Modo de **design** no Workflow Studio, navegue até a tela e escolha um estado para abri-la no painel **Inspector**.
1. No painel **Inspector**, escolha o botão **Estado do teste**.
1. A interface do usuário **do estado de teste** é aberta no VS Code.
A interface do usuário do estado de teste tem 3 guias principais: **entrada de teste**, **argumentos e saída**, **definição de estado.** A guia **Entrada de teste** tem 3 campos adicionais que permitem que você forneça **entrada de estado**, defina **variáveis** e especifique **substituições de definição** a partir de seus CloudFormation modelos AWS SAM ou modelos. Na guia **Definição de estado**, você pode ajustar o fluxo de trabalho e testar novamente. Ao terminar de executar os testes, você poderá aplicar e salvar as alterações na definição da sua máquina de estado.
A captura de tela a seguir mostra a interface do usuário do estado de teste, que inclui uma definição de recursos de tópico.
![\[A interface do usuário do estado de teste do Workflow Studio no AWS kit de ferramentas\]](http://docs.aws.amazon.com/pt_br/toolkit-for-vscode/latest/userguide/images/SFNWFSteststate022025.png)
## Desabilitando o Workflow Studio por padrão
Por padrão, o Workflow Studio é o editor padrão para arquivos `ASL` que contêm uma definição de máquina de estado. Você pode desativar a configuração padrão modificando seu arquivo `settings.json` no diretório local `.vscode` . Se você desabilitar o Workflow Studio por padrão, ele ainda poderá ser acessado por meio dos métodos listados na seção *Abrindo o Workflow Studio*, localizada neste tópico.
Para editar seu arquivo `settings.json` pelo VS Code, conclua as etapas a seguir.
1. No VS Code, abra a **Paleta de comandos** pressionando **option\$1shift\$1p** (Mac) or **ctrl\$1shift\$1p** (Windows).
1. Na **Paleta de comandos** do VS Code, entre **Open User Settings (JSON)** no campo de pesquisa e escolha a opção quando ela for preenchida na lista.
1. No `settings.json` do editor, adicione a modificação a seguir ao seu arquivo.
```
{
"workbench.editorAssociations": {
// Use all the following overrides or a specific one for a certain file type
"*.asl.json": "default",
"*.asl.yaml": "default",
"*.asl.yml": "default"
}
}
```
1. Salve suas alterações no `settings.json` e atualize ou reinicie o VS Code.