Hacer referencia a datos en el flujo de trabajo

Hacer referencia a datos del tiempo de ejecución

El tiempo de ejecución es donde se almacenan los datos desencadenadores de una integración. La referencia para los datos de tiempo de ejecución es {{runtime}}.

Puedes hacer referencia a piezas de datos almacenadas dentro del tiempo de ejecución. Cuando haga referencia a estos datos, debe especificar el nombre del elemento individual.

Por ejemplo, si una hoja en Smartsheet activa un flujo de trabajo y necesitas hacer referencia al ID de la fila involucrada, la referencia podría verse así: {{runtime.event.rowId}}.

La estructura exacta y la convención de nomenclatura son diferentes según el desencadenador y el tipo de evento. 

Para asegurarse de usar la referencia correcta:

1. En Registro de ejecución, pasa el cursor sobre un objeto desencadenador. 
2. Seleccione Brandfolder Image .
3. En la lista que aparece, seleccione Copiar referencia de datos.

Brandfolder Image

Hacer referencia a datos de un estado

Puedes hacer referencia a un estado cuando se pasan datos de un flujo de trabajo padre. El formato de la referencia es {{states.state name.value}}.

Si desea hacer referencia a datos de un módulo debajo de un estado, el estado sigue siendo importante. En este caso, la estructura de la referencia sería {{states.state name.integration or utility name.module name}}.

Si un módulo puede generar varios valores de datos, agregue la ruta de estos datos específicos en la referencia (del mismo modo en que hace referencia a datos individuales de tiempo de ejecución).

Por ejemplo, el módulo Smartsheet: Obtener fila devuelve de forma predeterminada los datos que se muestran en la imagen a continuación. 

Brandfolder Image

Para hacer referencia al valor ingresado en la celda Dirección de la fila, la referencia sería:
{{states.GetRow.smartsheet.get_row.row.cells.Address.value}}.

Hacer referencia a datos de un flujo de trabajo secundario

Puede hacer referencia a datos de un flujo de trabajo secundario dentro del flujo de trabajo primario. Para ello, siga estos pasos:

1. Copia la referencia de datos que deseas usar del flujo de trabajo padre.
2. Agrega un módulo Ejecutar flujo de trabajo hijo dentro del flujo de trabajo padre y asígnale un nombre.

En el flujo de trabajo padre, en el módulo hijo:

3. Seleccione Valores de entidad hijo. 
4. Agrega una clave, el nombre para hacer referencia a los datos en el flujo de trabajo hijo.
5. Agrega el valor correspondiente, la referencia de datos que copiaste en el paso 1. Podría verse algo así como {{states.startstate.stringtools.compose_text}}.

un flujo de trabajo secundario.

3. Seleccione el módulo donde deseas hacer referencia a los datos del flujo de trabajo padre.
4. En el campo donde deseas hacer referencia a los datos del flujo de trabajo padre, ingresa {{runtime.entities.text}}, donde "texto" es la clave agregada en el paso 4. 

Si desea hacer referencia a {{runtime.entities.text}} como {{states.text.value}} dentro del flujo de trabajo secundario, debe crear un estado con el nombre "texto" en el flujo de trabajo secundario

Hacer referencia a datos de un flujo de trabajo secundario

Puede hacer referencia a datos de un flujo de trabajo secundario dentro del flujo de trabajo primario. Para hacerlo, la referencia de datos puede ser de la siguiente manera:

• states.{{state that runs the child}}.child.{{state in child}}.value.; o bien.
• states.{{state that runs the child}}.child.{{state in child}}.integration o utility.module.

Opciones para referencias de datos vacías

Cuando el siguiente paso de su flujo de trabajo depende de un valor específico, que puede existir o no, puede usar barras verticales (||) para manejar dos escenarios.

Por ejemplo, desea usar el valor de una celda de Smartsheet para determinar la ruta que toma el flujo de trabajo en una unión. Pero no puede estar seguro de que la celda siempre contenga un valor. 

Si la celda está vacía, el flujo de trabajo se detendrá cuando llegue a la unión. Puede agregar barras verticales (||) al final de la referencia de datos para evitar que esto pase. Si ese valor tiene datos, el flujo de trabajo utiliza la referencia a la izquierda de las barras. Si no existen datos en esa celda, el flujo de trabajo utiliza lo que está a la derecha de las barras.

Observe los dos casos posibles en esta referencia:
{{states.GetRow.smartsheet.get_row.row.cells.Address.value||116 George Street, Edinburgh, UK}}

1. En primer lugar, el flujo de trabajo intenta usar la dirección de la fila que obtuvo anteriormente: GetRow.smartsheet.get_row.row.cells.Address.value.
2. Sin embargo, si esa celda está en blanco, usará la dirección especificada después de las barras verticales: 116 George Street, Edinburgh, UK.

Consejos para usar barras verticales

Puede usar: 

• otra referencia de datos después de las barras verticales en lugar de un valor escrito; o bien
• varias barras verticales para manejar varios casos posibles diferentes.

Combinar referencias de datos y de texto

En la mayoría de los módulos, puede combinar referencias de datos y de texto escrito. Puede escribir las partes del correo electrónico que siempre deben ser las mismas y utilizar referencias de datos para las partes que no siempre pueden ser las mismas, como el nombre de un destinatario o una fecha.

Si creó el flujo de trabajo del clima en el artículo Iniciar un flujo de trabajo en blanco para el Servicio Meteorológico de EE. UU., es posible que haya notado que la URL utilizada en la llamada a la API para el Servicio Meteorológico de EE. UU. contenía dos referencias de datos.