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á.
# Criar um fluxo de trabalho com o Workflow Studio no Step Functions
Aprenda a criar, editar e executar fluxos de trabalho usando o Step Functions Workflow Studio. Depois que o fluxo de trabalho estiver pronto, você poderá salvá-lo, executá-lo e exportá-lo.
**Topics**
+ [Criar uma máquina de estado](#workflow-studio-components-create)
+ [Projetar um fluxo de trabalho](#workflow-studio-build)
+ [Executar o fluxo de trabalho](#workflow-studio-components-create-run)
+ [Editar o fluxo de trabalho](#workflow-studio-components-create-edit)
+ [Exportar o fluxo de trabalho](#workflow-studio-components-create-export)
+ [Criar um protótipo de fluxo de trabalho com espaços reservados](#workflow-studio-components-create-prototype)
## Criar uma máquina de estado
No Workflow Studio, é possível escolher um modelo inicial ou um modelo em branco para criar um fluxo de trabalho.
Um modelo inicial é um projeto de ready-to-run amostra que cria automaticamente o protótipo e a definição do fluxo de trabalho e implanta todos os AWS recursos relacionados que seu projeto precisa para você. Conta da AWS Você pode usar esses projetos iniciais para implantá-los e executá-los como estão ou usar os protótipos de fluxo de trabalho para se basear neles. Para obter mais informações sobre os modelos iniciais, consulte [Implantar uma máquina de estado usando um modelo inicial para o Step Functions](starter-templates.md).
Com um modelo em branco, você pode usar o modo [Design](workflow-studio.md#wfs-interface-design-mode) ou [Código](workflow-studio.md#wfs-interface-code-mode) para criar o fluxo de trabalho personalizado.
### Criar uma máquina de estado usando um modelo inicial
1. Abra o [console do Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/) e clique em **Criar máquina de estado**.
1. Na caixa de diálogo **Escolher um modelo**, faça o seguinte para escolher um projeto de exemplo:
+ Digite **Task Timer** na caixa Pesquisa por palavra-chave e escolha **Temporizador de tarefas** nos resultados da pesquisa.
+ Navegue pelos exemplos de projetos listados em **Tudo** no painel direito e escolha **Task Timer**.
1. Escolha **Próximo** para continuar.
1. Escolha como usar o modelo:
1. Escolha **Usar modelo** para continuar com a seleção.
1. **Executar uma demonstração**: cria uma máquina de estado somente leitura. Após a revisão, você pode criar o fluxo de trabalho e todos os recursos relacionados.
1. **Comece a criar**: fornece uma definição de fluxo de trabalho editável que você pode revisar, personalizar e implantar com seus próprios recursos. (Recursos relacionados, como perfis ou filas, **não** serão criados automaticamente.)
### Crie um fluxo de trabalho usando um modelo em branco
Quando quiser começar em uma tela limpa, crie um fluxo de trabalho com um modelo em branco.
1. Abra o [console do Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/).
1. Escolha **Criar uma máquina de estado**.
1. Selecione **Criar do zero**.
1. Nomeie sua máquina de estado e clique em **Continuar** para editá-la no Workflow Studio.
Agora você pode começar a projetar o fluxo de trabalho no [Modo de design](workflow-studio.md#wfs-interface-design-mode) ou escrever a definição de fluxo de trabalho no [Modo de código](workflow-studio.md#wfs-interface-code-mode).
1. Escolha **Configuração** para gerenciar a configuração do fluxo de trabalho no [Modo de configuração](workflow-studio.md#wfs-interface-config-mode). Por exemplo, forneça um nome para o fluxo de trabalho e escolha o tipo.
## Projetar um fluxo de trabalho
Quando você souber o nome do estado que deseja adicionar, use a caixa de pesquisa na parte superior dos [Navegador de estados](workflow-studio.md#workflow-studio-components-states) para encontrá-lo. Caso contrário, procure o estado de que você precisa no navegador e adicione-o à tela.
É possível reordenar estados no fluxo de trabalho arrastando-os para um local diferente no fluxo de trabalho. Quando você arrasta um estado para a tela, é exibida uma linha para mostrar onde o estado será inserido no fluxo de trabalho, conforme mostrado na seguinte captura de tela:
Depois que um estado é colocado na tela, o código é gerado automaticamente e adicionado à definição de fluxo de trabalho. Para ver a definição, ative o botão **Definição** no [painel Inspector.](workflow-studio.md#workflow-studio-components-formdefinition) É possível escolher [Modo de código](workflow-studio.md#wfs-interface-code-mode) para editar a definição com o editor de código incorporado.
Depois de soltar um estado na tela, configure-o no painel [Painel Inspetor](workflow-studio.md#workflow-studio-components-formdefinition) à direita. Esse painel contém as guias **Configuração**, **Entrada**, **Saída** e **Tratamento de erros** para cada estado ou ação de API que você coloca na tela. Você configura os estados incluídos nos fluxos de trabalho na guia **Configuração**.
Por exemplo, a guia **Configuração** da ação de API Invocação do Lambda consiste nas seguintes opções:
+ **Nome do estado**: é possível identificar o estado com um nome personalizado ou aceitar o nome padrão gerado.
+ A **API** mostra a ação de API usada pelo estado.
+ **Tipo de integração**: é possível escolher o tipo de integração de serviços usado para chamar ações de API em outros serviços.
+ O **Nome da função** fornece opções para:
+ **Inserir o nome da função**: você pode inserir o nome da função ou o ARN.
+ **Obter nome da função em runtime a partir da entrada de estado**: você pode usar essa opção para obter dinamicamente o nome da função da entrada de estado com base no caminho especificado.
+ **Selecionar o nome da função**: você pode selecionar diretamente das funções disponíveis na conta e região.
+ **Carga útil**: é possível optar por usar a entrada de estado, um objeto JSON ou nenhuma carga útil para passar como carga útil para a função do Lambda. Se você escolher JSON. poderá incluir valores estáticos e valores selecionados na entrada de estado.
+ (Opcional) Alguns estados terão a opção de selecionar **Aguardar a conclusão da tarefa** ou **Aguardar o retorno da chamada**. Quando disponíveis, é possível escolher um dos seguintes [padrões de integração de serviço](connect-to-resource.md):
+ **Nenhuma opção selecionada**: o Step Functions usará o padrão de integração [Resposta de solicitação](connect-to-resource.md#connect-default). O Step Functions aguardará uma resposta HTTP e, em seguida, avançará para o próximo estado. O Step Functions não esperará a conclusão de um trabalho. Quando nenhuma opção estiver disponível, o estado usará esse padrão.
+ **Aguardar a conclusão da tarefa**: o Step Functions usará o padrão de integração [Executar um trabalho (.sync)](connect-to-resource.md#connect-sync).
+ **Aguardar o retorno de chamada**: o Step Functions usará o padrão de integração [Aguardar um retorno de chamada com um token de tarefa](connect-to-resource.md#connect-wait-token).
+ (Opcional) Para acessar recursos configurados de forma diferente Contas da AWS em seus fluxos de trabalho, o Step Functions fornece acesso [entre contas](concepts-access-cross-acct-resources.md). O **perfil do IAM para acesso entre contas** fornece opções para:
+ **Fornecer o ARN do perfil do IAM**: especifique o perfil do IAM que contém as permissões apropriadas de acesso aos recursos. Esses recursos estão disponíveis em uma conta de destino, Conta da AWS para a qual você faz chamadas entre contas.
+ **Obtenha o ARN do perfil do IAM em runtime a partir da entrada do estado**: especifique um caminho de referência para um par de valores-chave existente na entrada JSON do estado que contém o perfil do IAM.
+ O **próximo estado** permite que você selecione o próximo estado para o qual deseja fazer a transição.
+ (Opcional) O campo **Comentário** não afetará o fluxo de trabalho, mas você poderá usá-lo para anotar o fluxo de trabalho.
Alguns estados terão mais opções de configuração genéricas. Por exemplo, a configuração de estado `RunTask` do Amazon ECS contém um campo `API Parameters` preenchido com valores de espaço reservado. Para esses estados, você pode substituir os valores do espaço reservado por configurações adequadas às suas necessidades.
**Como excluir um estado**
É possível pressionar backspace, clicar com o botão direito do mouse e escolher **Excluir estado** ou escolher **Excluir** na [barra de ferramentas Design](workflow-studio.md#wfs-interface-design-mode).
## Executar o fluxo de trabalho
Quando o fluxo de trabalho estiver pronto para começar, você poderá executá-lo e visualizar a execução no [console do Step Functions](https://console.aws.amazon.com/states/home).
**Para executar um fluxo de trabalho no Workflow Studio**
1. No modo **Design**, **Código** ou **Configuração**, escolha **Executar**.
A caixa de diálogo **Iniciar execução** é aberta em uma nova guia.
1. Na caixa de diálogo **Iniciar execução**, faça o seguinte:
1. (Opcional) Insira um nome de execução personalizado para substituir o padrão gerado.
**Nomes e registro em log não ASCII**
O Step Functions aceita nomes de máquina de estado, execuções, atividades e rótulos que contenham caracteres não ASCII. Como esses caracteres impedirão que a Amazon CloudWatch registre dados, recomendamos usar somente caracteres ASCII para que você possa acompanhar as métricas do Step Functions.
1. (Opcional) No campo **Entrada**, insira os valores de entrada no formato JSON para executar o fluxo de trabalho.
1. Selecione **Iniciar execução**.
1. O console do Step Functions direciona você para uma página na qual o título é o ID da execução, conhecida como a página de *Detalhes da execução*. Você pode revisar os resultados da execução tanto à medida que o fluxo de trabalho avança quanto após a conclusão.
Para revisar os resultados da execução, escolha estados individuais na **Exibição em gráfico** e, em seguida, escolha as guias individuais no painel [Detalhes da etapa](concepts-view-execution-details.md#exec-details-intf-step-details) para visualizar os detalhes de cada estado, incluindo entrada, saída e definição, respectivamente. Para obter detalhes sobre as informações de execução que você pode visualizar na página *Detalhes da execução*, consulte [Visão geral dos detalhes da execução](concepts-view-execution-details.md#exec-details-interface-overview).
## Editar o fluxo de trabalho
Você pode editar visualmente um fluxo de trabalho existente no [Modo de design](workflow-studio.md#wfs-interface-design-mode) do Workflow Studio.
No [console do Step Functions](https://console.aws.amazon.com/states/home), escolha o fluxo de trabalho que você deseja editar na página **Máquinas de estado**. O fluxo de trabalho é aberto no modo **Design** do Workflow Studio.
Também é possível editar a definição de fluxo de trabalho em [Modo de código](workflow-studio.md#wfs-interface-code-mode). Escolha o botão **Código** para visualizar ou editar a definição do fluxo de trabalho no Workflow Studio.
**nota**
Se você encontrar erros no fluxo de trabalho, deverá corrigi-los no modo **Design**. Você não pode alternar para o modo **Código** ou **Configuração** se houver algum erro no fluxo de trabalho.
Ao salvar as alterações no fluxo de trabalho, você também tem a opção de publicar uma nova **versão**. Com as versões, é possível optar por executar as versões originais ou alternativas do fluxo de trabalho. Para saber mais sobre o gerenciamento de fluxos de trabalho com versões, consulte [Versões da máquina de estado nos fluxos de trabalho do Step Functions](concepts-state-machine-version.md)
## Exportar o fluxo de trabalho
Você pode exportar a definição da [Amazon States Language](concepts-amazon-states-language.md) (ASL) do fluxo de trabalho e o gráfico do fluxo de trabalho:
1. Escolha o fluxo de trabalho no [console do Step Functions](https://console.aws.amazon.com/states/home).
1. Na página *Detalhes da máquina de estado*, escolha **Editar**.
1. Escolha o botão suspenso **Ações** e realize uma das seguintes ações, ou ambas:
+ Para exportar o gráfico do fluxo de trabalho para um arquivo SVG ou PNG, em **Exportar gráfico**, selecione o formato desejado.
+ Para exportar a definição do fluxo de trabalho como um arquivo JSON ou YAML, em **Exportar definição**, selecione o formato desejado.
## Criar um protótipo de fluxo de trabalho com espaços reservados
É possível usar o Workflow Studio ou o [Workflow Studio no Infrastructure Composer](use-wfs-in-app-composer.md) para criar protótipos de novos fluxos de trabalho que contêm *recursos de espaço reservado* que são chamados de recursos que ainda não existem.
Como criar um protótipo de fluxo de trabalho:
1. Faça login no [console do Step Functions](https://console.aws.amazon.com/states/home?region=us-east-1#/).
1. Escolha **Criar uma máquina de estado**.
1. Selecione **Criar do zero**.
1. Nomeie sua máquina de estado e clique em **Continuar** para editá-la no Workflow Studio.
1. O [modo Design](workflow-studio.md#wfs-interface-design-mode) do Workflow Studio é aberto. Crie o fluxo de trabalho no Workflow Studio. Para incluir recursos de espaço reservado:
1. Escolha o estado para o qual você deseja incluir um recurso de espaço reservado e, em seguida, em **Configuração**:
+ Para os estados Invocação Lambda, escolha o **Nome da função** e, em seguida, escolha **Inserir nome da função**. Você também pode inserir um nome personalizado para sua função.
+ Para os estados de envio de mensagens do Amazon SQS, escolha o **URL da fila** e, em seguida, escolha **Inserir URL da fila**. Insira um URL de fila do espaço reservado.
+ Para os estados de publicação do Amazon SNS, em **Tópico**, escolha um ARN de tópico.
+ Para todos os outros estados listados em **Ações**, você pode usar a configuração padrão.
**nota**
Se você encontrar erros no fluxo de trabalho, deverá corrigi-los no modo **Design**. Você não pode alternar para o modo **Código** ou **Configuração** se houver algum erro no fluxo de trabalho.
1. (Opcional) Para visualizar a definição de ASL gerada automaticamente do fluxo de trabalho, escolha **Definição.**
1. (Opcional) Para atualizar a definição do fluxo de trabalho no Workflow Studio, escolha o botão **Código**.
**nota**
Se você encontrar erros na definição de fluxo de trabalho, deverá corrigi-los no modo **Código**. Você não pode alternar para o modo **Design** ou **Código** se houver algum erro na definição do fluxo de trabalho.
1. (Opcional) Para editar o nome da máquina de estado, escolha o ícone de edição ao lado do nome padrão da máquina de estado **MyStateMachine**e especifique um nome na caixa **Nome da máquina de estado**.
Você também pode alternar para o [Modo de configuração](workflow-studio.md#wfs-interface-config-mode) para editar o nome da máquina de estado padrão.
1. Especifique outras configurações do fluxo de trabalho, como o tipo de máquina de estado e o perfil de execução.
1. Escolha **Criar**.
Agora você criou um novo fluxo de trabalho com recursos de espaço reservado que podem ser usados para criar protótipos. Você pode [exportar](#workflow-studio-components-create-export) a definição do fluxo de trabalho e o gráfico do fluxo de trabalho.
+ Para exportar a definição de fluxo de trabalho como um arquivo JSON ou YAML, no modo **Design** ou **Código**, escolha o botão suspenso **Ações**. Em seguida, em **Exportar definição**, selecione o formato que você deseja exportar. Você pode usar essa definição exportada como o ponto de partida para o desenvolvimento local com o [AWS Toolkit for Visual Studio Code](https://docs.aws.amazon.com/toolkit-for-vscode/latest/userguide/building-stepfunctions.html).
+ Para exportar o gráfico do fluxo de trabalho para um arquivo SVG ou PNG, no modo **Design** ou **Código**, escolha o botão suspenso **Ações**. Em seguida, em **Exportar definição**, selecione o formato que você deseja.