Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Trabajando con AWS Step Functions
En las siguientes secciones se describe cómo trabajar con AWS Step Functions `Amazon State Language (ASL)` archivos que contienen definiciones de máquinas de estados en el AWS kit de herramientas. Para obtener información detallada sobre las máquinas de AWS Step Functions estado, consulte el tema [Más información sobre las máquinas de estado en Step Functions](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-statemachines.html) de la Guía para *AWS Step Functions*desarrolladores.
## Visualización de máquinas de estado de Step Functions
Para ver los `ASL` archivos existentes que contienen definiciones de máquinas de estado en el explorador del AWS kit de herramientas, complete los siguientes pasos.
1. En el explorador del AWS kit de herramientas, expanda la región que contiene el `ASL` archivo que desea ver.
1. Expanda el encabezado **Step Functions**.
1. Los `ASL` archivos se muestran en el AWS Explorador.
## Creación de una máquina de estado de Step Functions
En el AWS kit de herramientas, puede crear una nueva máquina de estados de Step Functions a partir de un archivo o puede usar una plantilla. En el procedimiento siguiente se describe cómo crear una máquina de estado de Step Functions a partir de un archivo. Para obtener más información sobre cómo crear una máquina de estado de SFN; a partir de una plantilla, consulte la sección *Plantillas de máquina de estado* que se encuentra más abajo, en este tema de la Guía del usuario.
**nota**
Para trabajar con Step Functions en VS Code, la extensión del archivo `Amazon State Language`(ASL) que contiene la definición de máquina de estado debe terminar en `asl.json`, `asl.yml` o `.asl.yaml`.
De forma predeterminada, los archivos de Step Functions pertinentes se abren en el Diseñador de flujo de trabajo. Para obtener información detallada sobre cómo trabajar en Workflow Studio mediante el AWS kit de herramientas, consulte el tema Cómo [trabajar con Workflow Studio](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/stepfunctions-workflowstudio.html) de esta Guía del usuario.
1. En el espacio de trabajo de VS Code, cree un archivo.
1. Asígnele un nombre y especifique la extensión de archivo como `asl.json`, `asl.yml` o`.asl.yaml`.
1. Tras la creación, el AWS kit de herramientas abre el nuevo archivo en AWS Step Functions Workflow Studio.
1. En **Diseñador de flujo de trabajo**, elija el botón **Guardar** del menú de utilidades para guardar el nuevo archivo de `ASL`.
## Creación de una máquina de estado de Step Functions a partir de una plantilla
En el AWS kit de herramientas, puede crear una máquina de estados de Step Functions a partir de una plantilla. El proceso de plantilla crea un archivo de `ASL` que contiene una definición de máquina de estado, lo que proporciona un punto de partida para el proyecto. El siguiente procedimiento describe cómo crear una máquina de estados de Step Functions a partir de una plantilla del AWS kit de herramientas.
1. Desde el explorador del AWS kit de herramientas, expanda la región en la que desee crear una máquina de estados de Step Functions.
1. Abra el menú contextual (con el botón derecho) de **Step Functions** y elija **Crear una máquina de estado de Step Functions** para abrir el asistente **Select a starter template (1/2)** en VS Code.
1. En el asistente **Select a starter template (1/2)**, elija el tipo de plantilla para la máquina de estado de Step Functions a fin de continuar.
1. En la pantalla **Select template format (2/2)**, elija **YAML** o **JSON** como formato de plantilla.
1. Se abrirá un nuevo archivo de `ASL` que contiene la definición de máquina de estado en el editor de VS Code.
## Descarga de una máquina de estado de Step Functions
Para descargar una máquina de estado de Step Functions almacenada de forma remota en su instancia local de VS Code, complete los siguientes pasos:
1. Desde el explorador de AWS kits de herramientas, expanda la región que contiene la máquina de estados Step Functions que desee descargar.
1. Expanda **Step Functions** y, a continuación, haga clic con el botón derecho en la máquina de estado de Step Functions que desea descargar y elija **Descargar definición…**.
1. Especifique una ubicación donde almacenar la máquina de estado de Step Functions de forma local para continuar.
1. La máquina de estado de Step Functions se abre en el Diseñador de flujo de trabajo una vez completado el procedimiento.
## Cómo guardar cambios en una máquina de estado de Step Functions
En el procedimiento siguiente se describe cómo guardar los cambios realizados en la máquina de estado de Step Functions.
**nota**
Las ediciones realizadas en el Diseñador de flujo de trabajo se sincronizan con el archivo local, pero no se guardan hasta que el trabajo se guarde en el editor de VS Code o el Diseñador de flujo de trabajo. Si el archivo local se modifica y se guarda mientras el Diseñador de flujo de trabajo está abierto y no se detectan errores en el archivo de `ASL`, recibirá la notificación **Correcto** en el Diseñador de flujo de trabajo cuando se haya completado el proceso de guardado. Sin embargo, si el archivo local contiene `JSON` o `YAML` no válido e intenta guardarlo, dicho archivo no se sincroniza y recibirá la notificación **Advertencia** en el Diseñador de flujo de trabajo.
1. En un archivo de `ASL` abierto que contenga una definición de máquina de estado en el Diseñador de flujo de trabajo, diríjase a los **botones de utilidades**.
1. Seleccione el botón **Guardar**.
1. VS Code le avisará una vez que se haya guardado el archivo.
## Ejecución de una máquina de estado de Step Functions
El siguiente procedimiento describe cómo ejecutar una máquina de estados Step Functions en el AWS kit de herramientas.
1. En el explorador del AWS kit de herramientas, expanda la región que contiene la máquina de estados Step Functions que desee ejecutar.
1. Expanda **Step Functions** y, a continuación, haga clic con el botón derecho en la máquina de estado de Step Functions que desea ejecutar.
1. En el menú contextual, elija **Iniciar la ejecución** para iniciar el proceso de lanzamiento.
1. El estado del lanzamiento se muestra en la ventana de **Salida del kit de herramientas de AWS ** en VS Code.
## Uso de fragmentos de código
Los fragmentos de código son sugerencias automatizadas que se generan en función del código en el que está trabajando. Para trabajar con fragmentos de código con Step Functions en el kit de herramientas, complete los siguientes pasos.
**nota**
Para trabajar con fragmentos de código de Step Functions en VS Code, la extensión del archivo de `ASL` que contiene la definición de máquina de estado debe terminar en `.asl.json`, `.asl.yml` o `.asl.yaml`.
De forma predeterminada, los archivos de Step Functions pertinentes se abren en el Diseñador de flujo de trabajo.
1. En VS Code, abra un archivo de `ASL` que contenga la definición de máquina de estado que desea modificar o bien cree un archivo de `ASL`.
1. En el Diseñador de flujo de trabajo, cambie al modo **Código** si está en el modo **Diseño**.
1. En el editor de código del Diseñador de flujo de trabajo, coloque el cursor en la propiedad `"States"`.
1. Pulse **control \$1 space** para abrir el menú de fragmentos de código; para acceder a propiedades adicionales basadas en los valores `"State"` `"Type"`, pulse **control \$1 space**.
1. Elija el fragmento de código que desee de la lista.
## Validación de código
Mientras trabaja en Step Functions en el Diseñador de flujo de trabajo, la validación de código identifica los errores de forma activa y hace sugerencias respecto a lo siguiente:
+ Propiedades que faltan
+ Valores incorrectos
+ Estado no terminal
+ Estados inexistentes a los que se señala