Hacer referencia a datos en el flujo de trabajo

Existen diferentes ubicaciones donde se almacenan los datos en Bridge:

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 de los datos de tiempo de ejecución es {{runtime}}.

Existe una serie de datos almacenados en el tiempo de ejecución a los que puede hacer referencia. Cuando haga referencia a estos datos, debe especificar el nombre del elemento individual.

Por ejemplo, si una hoja de Smartsheet es el desencadenador de un flujo de trabajo, es muy probable que deba hacer referencia al ID de la fila implicada. La referencia puede ser de la siguiente manera: {{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 Run Log, pase el cursor sobre un objetivo desencadenador. 
2. Seleccione .
3. En la lista que aparece, seleccione Copy Data Reference.

Hacer referencia a datos de un estado

Con frecuencia, se hace referencia a un estado cuando los datos se transfieren desde un flujo de trabajo primario. 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: Get Row devuelve de forma predeterminada los datos que se muestran en la imagen a continuación. 

Para citar el valor ingresado en la celda Dirección de la fila, la referencia sería la siguiente:
{{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 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 del flujo de trabajo depende de un valor específico, que puede existir o no, puede usar barras verticales (||) para gestionar dos casos.

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. Sin embargo, no sabe con seguridad si la celda siempre contendrá 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 la celda contiene datos, el flujo de trabajo utilizará la referencia a la izquierda de las barras. Si no existen datos en esa celda, el flujo de trabajo utilizará la referencia 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 intentará 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 lo siguiente: 

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

Combinar referencias de datos y de texto

En la mayoría de los módulos, puede combinar referencias de datos y de texto escrito. Por ejemplo, si utiliza la integración SendGrid para enviar correos electrónicos, puede escribir las partes del correo que siempre deben ser las mismas. Luego, puede usar referencias de datos para aquellas que no siempre se repiten, como el nombre del destinatario.

Si creó el flujo de trabajo del clima en el artículo Start a Blank Workflow for US Weather Service (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.