Iniciar un flujo de trabajo en blanco para el Servicio Meteorológico de EE. UU.

Puede utilizar el Servicio Meteorológico de EE. UU. para obtener pronósticos, ya que no necesita una cuenta para acceder a sus datos meteorológicos.

Para obtener el pronóstico, debe realizar dos llamadas API al Servicio Meteorológico de EE. UU.:

• Una para localizar el punto de cuadrícula de una ubicación geográfica.
• Una segunda para obtener el pronóstico de esa cuadrícula identificada. 

No es necesario estar familiarizado con las llamadas a la API para seguir los pasos de esta guía, que proporciona todo lo que necesita para completar el flujo de trabajo.

Estos son los pasos para crear el flujo de trabajo:

1. Crear el flujo de trabajo
2. Crear la hoja
3. Autenticar con Smartsheet y configurar el desencadenador
4. Configurar el módulo Get Row (Obtener fila)
5. Configurar la unión
6. Configurar la primera llamada API
7. Configurar la segunda llamada API
8. Configurar el módulo Update Row (Actualizar fila)

Paso 1: Crear el flujo de trabajo

1. En Bridge, seleccione Nuevo flujo de trabajo en el panel Flujos de trabajo.

2. Asigne un nombre a su flujo de trabajo y seleccione Crear nuevo. 

   Todos los flujos de trabajo comienzan con un desencadenador y un estado.

Paso 2: Crear la hoja

Antes de configurar el desencadenador en Bridge, necesita una hoja de Smartsheet con al menos los siguientes nombres y tipos de columna:

La columna Pronóstico del tiempo puede ser su columna primaria o una columna de texto regular. 

1.  En la primera celda de la columna Hoy, pegue la siguiente fórmula: =IF (Date@row = TODAY (), true, false)
2. Seleccione Intro. Esto marca la casilla de verificación si el conjunto de datos en la columna Fecha es la fecha de hoy, que puede usar para desencadenar su flujo de trabajo en Bridge.
3. Haga clic con el botón derecho del mouse en la celda con la fórmula y seleccione Convertir en fórmula de columna. Esto garantiza que todas las filas nuevas agregadas a la hoja utilicen esa fórmula en la columna Today (Hoy).
4. Guarde la hoja.
5. Antes de regresar al diseñador en Bridge, copie el ID de la hoja. Puede encontrar el ID de la hoja yendo a Archivo > Propiedades.

Paso 3: Configurar el desencadenador

En el diseñador, seleccione el desencadenador en la parte superior del flujo de trabajo. Esto abre un panel en el lado derecho del diseñador donde puede configurar el tipo de desencadenador que desea utilizar. 

Dado que el flujo de trabajo debe ser activado por un evento en Smartsheet, el tipo de desencadenador utilizado es un desencadenador de integración. En el panel, seleccione página de Integraciones bajo la sección Integraciones.

Brandfolder Image

Esto abre una nueva pestaña con la página Integraciones. 

1. Encuentre Smartsheet y seleccione el logo. 
2. Seleccione Continuar. 
3. Seleccione Autenticar.
4. En la ventana emergente, seleccione Permitir.

Si la autenticación es exitosa, la ventana cambia a la pestaña Desencadenadores.

Brandfolder Image

Expanda la sección Desencadenadores y seleccione la fila con el ícono más :

1. En el campo ID de hoja, pegue el ID de hoja que copió cuando creó la hoja. Si sabe que el nombre de la hoja es único, escríbalo.
2. Seleccione Cuando se modifican los valores de las columnas en la lista desplegable Tipo de evento.
3. En el campo que se agrega cuando selecciona el Tipo de evento, escriba el nombre de la columna Hoy.

4. En la lista desplegable Seleccionar flujo de trabajo, elija el flujo de trabajo que creó anteriormente y seleccione Guardar.

   Puede darse cuenta de que el desencadenador se configuró correctamente porque la ventana emergente se recarga y colapsa la sección Desencadenadores.

5. Cierre la pestaña y regrese al diseñador.

Errores cuando guarda el desencadenador

Si recibe un mensaje de error al guardar un desencadenador, revise los siguientes elementos:

• Asegúrese de escribir el nombre de la columna exactamente como lo hizo en la hoja. 
• Si escribió el nombre de la hoja en lugar de usar el ID de la hoja, verifique que lo escribió igual. 
• Si usted no es el propietario de la hoja, verifique los permisos de la hoja para asegurarse de que tiene acceso.
• Si ya hay otros desencadenadores configurados, un desencadenador diferente puede causar un problema. Revise los otros desencadenadores para asegurarse de que uno de ellos no haya tenido cambios en los permisos o que la hoja a la que se hace referencia en el desencadenador aún exista.

Paso 4: Configurar el módulo Get Row (Obtener fila)

Ha configurado el desencadenador para ejecutar el flujo de trabajo al cambiar la columna Hoy; esta acción ahora envía información básica a Bridge. Para el primer paso de su flujo de trabajo, debe recuperar parte de esta información inicial: 

1. Establezca la celda de fecha en la primera fila con la fecha de hoy. Esto marca automáticamente la casilla en la columna Hoy debido a la fórmula que ingresó anteriormente. 
2. Guarde la hoja y regrese al diseñador en Bridge.
3. Abra la Registro de ejecución. Seleccione Actualizar, debería aparecer una ejecución con el estado Completado.
4. Para mostrar los datos iniciales enviados a Bridge desde Smartsheet, seleccione la ejecución, expanda la fila Desencadenador, y luego la fila Evento. 
5. Pase el cursor sobre rowId en los datos del desencadenador y seleccione el ícono más para ver una lista desplegable. 

6. En el menú desplegable, seleccione Copiar referencia de datos. De esta manera, se copia una referencia al ID de fila que cambió al portapapeles.

   Al usar la referencia en lugar de la fuente JSON, el flujo de trabajo siempre obtiene la fila cambiada en lugar de observar siempre la misma fila. Esto es importante ya que el cambio de fila difiere entre cada ejecución del flujo de trabajo. 

Brandfolder Image

Actualizar el estado y agregar un módulo

1. Seleccione el estado gris y cambie el campo Nombre a Obtener fila.

   Se recomienda asignar un nombre a los estados según lo que hagan los módulos que se muestran debajo de ellos para facilitar la lectura de sus flujos de trabajo.

2. Busque el módulo Obtener fila en el menú de la izquierda. Utilice el campo de búsqueda o búsquelo expandiendo Integraciones > Smartsheet > Obtener fila.
3. Arrastre el módulo al flujo de trabajo debajo del estado gris. Se abrirá automáticamente un panel para configurar el módulo. 
4. En el ID de fila campo, pegue la referencia que copió de rowId en el Registro de ejecución. El valor pegado debe ser {{runtime.event.rowId}}.
5. Para obtener el ID de la hoja, abra el Registro de Ejecución nuevamente y expanda los datos del desencadenador para encontrarlo. Copie la referencia al ID de la hoja como lo hizo con el ID de fila anteriormente, seleccionando el ícono más .
6. Seleccione el módulo Obtener fila de nuevo y péguelo en la referencia en el campo Hoja. El valor pegado debe ser {{runtime.sheetID}}.

7. Seleccione Guardar en la parte superior de la página.

   Brandfolder Image

   

Paso 5: Configurar la unión

Necesita determinar si el cambio en la casilla de verificación de la hoja se debió a que la casilla estaba marcada o desmarcada. Se debe ignorar una casilla no marcada; sin embargo, si la casilla cambia a marcada, significa que la fecha establecida en la columna Fecha es la fecha de hoy y desea obtener el pronóstico del tiempo.

Para hacerlo, debe hacer referencia a la celda con la casilla de verificación:

1. Regrese a la hoja y cambie la fecha de la fila que agregó anteriormente para desmarcar la casilla. Luego, guarde la hoja.
2. En Bridge, vuelva a abrir el Registro de Ejecución y seleccione Todas las ejecuciones en la parte superior izquierda del panel. Actualice la lista para ver una nueva ejecución completada en la parte superior. 
3. Abra esta nueva ejecución y amplíe el paso Smartsheet: Obtener fila para revelar los datos de la fila.
4. En fila > celdas > Hoy, puede ver que el valor es falso. Esto le indica que la casilla de verificación de la columna Hoy no estaba marcada en la fila que cambió. 
5. Con el menú desplegable, copie la referencia de datos de este valor.

Agregar una unión condicional coincidente

El siguiente paso es agregar una unión para verificar si el valor coincide con los valores de texto verdadero (marcada) o falso (desmarcada). 

1. En el campo de búsqueda, escriba Coincidencia o expanda Utilidades > Uniones Condicionales > Coincidencia para encontrar la unión. 
2. Arrastre la unión debajo del módulo Obtener fila y asígnele el nombre Fecha de hoy.

Esta unión consta de tres componentes: la unión en sí y dos estados de marcador de posición. Puede encontrar más estados para arrastrar al flujo de trabajo en la parte superior del menú de la izquierda debajo de Elementos anclados > Nuevo estado.

Agregar estados a la unión

1. Arrastre un nuevo estado al marcador de posición éxito y asígnele el nombre verdadero. 
2. Arrastre otro nuevo estado al marcador de posición fallo y asígnele el nombre falso.

Agregar la referencia de datos a la unión

1. Seleccione la unión Fecha de hoy para abrir el panel de configuración. 
2. Pegue la referencia que copió anteriormente en el campo Primer Valor.
   El valor pegado debe ser {{states.Get Row.smartsheet.get_row.row.cells.Today.value}}
3. En el campo Segundo Valor, escriba la palabra true. 

4. Guarde lo que creó hasta ahora.

   Brandfolder Image

   

Paso 6: Configurar la primera llamada API

Configurar un perfil para sus llamadas a la API

Para recuperar datos de pronóstico del tiempo, primero debe crear un perfil para sus llamadas a la API del Servicio Meteorológico de EE. UU. Los perfiles son una forma de guardar información esencial para las API del sistema a las que desea conectar sus flujos de trabajo.

1. En su cuenta de Bridge, navegue a la pestaña Integraciones.
2. Seleccione la utilidad Call API.

3. Seleccione Continuar > Agregar a Perfiles.

   Brandfolder Image

   

    

4. Asigne un nombre a su perfil. Cada nombre de perfil debe ser único. Por ejemplo: Clima de EE. UU.
5. En el campo URL base, ingrese https://api.weather.gov.
6. Expanda el menú desplegable Encabezados:
   • En el campo Clave N.º 1, ingrese User-Agent.

   • En el campo Valor N.º 1 , ingrese el nombre de su empresa y el correo electrónico, separados por una coma.

     El Servicio Meteorológico de EE. UU. requiere esto para que puedan contactarlo si observan actividades o comportamientos inesperados en sus registros.

7. Guarde el perfil.
8. Vuelva al flujo de trabajo.

Configurar el módulo Make API Call (Realizar llamada a API) en su flujo de trabajo

La primera llamada a la API identifica el punto de cuadrícula de una ubicación ingresada en la hoja.

1. Utilice el campo de búsqueda para encontrar el módulo Hacer Llamada a la API o expanda Utilidades > Funciones de Utilidad > Hacer Llamada a la API.
2. Arrástrelo al flujo de trabajo debajo del estado true.
3. En el módulo Make API Call (Realizar llamada a API), seleccione el perfil que acaba de crear en el menú desplegable.
4. En el campo Punto final, incluya los siguientes puntos: points/{{states.Get Row.smartsheet.get_row.row.cells.Longitude.value}},{{states.Get Row.smartsheet.get_row.row.cells.Latitude.value}}.
5. Configure el Método como GET.

6. Guarde el flujo de trabajo.

   Brandfolder Image

   

Referencias de datos para la llamada a la cuadrícula

La URL anterior se crea para usted, ya que comprender cómo funcionan las solicitudes de API es opcional para esta guía. Esta URL hace referencia a los valores de longitud y latitud de la fila que desencadenó el flujo de trabajo.

Si desea obtener estos, debe activar el flujo de trabajo nuevamente. Esta vez, debe asegurarse de que la casilla de verificación esté marcada. Agregue información a una nueva fila en lugar de usar la primera, y asegúrese de establecer la fecha en la fecha de hoy para que el flujo de trabajo se desplace por la rama izquierda de la unión.

Coordenadas

El Servicio Meteorológico de EE. UU. requiere un máximo de cuatro posiciones decimales para las coordenadas.

Paso obligatorio

Sería mejor tener coordenadas para ingresarlas en los campos Longitud y Latitud. Por ejemplo, puede usar 47.6174 y -122.2001 para conocer el clima de la oficina de Bellevue de Smartsheet.

Paso 7: Configurar la segunda llamada API

La segunda llamada a la API obtiene el pronóstico del Servicio Meteorológico de EE. UU. en función de los puntos de cuadrícula ubicados anteriormente. Para configurarlo, agregue un nuevo estado y otro módulo Make API Call (Realizar llamada a API) al flujo de trabajo. 

1. Arrastre y suelte un nuevo estado desde los elementos anclados en la parte superior del menú de la izquierda, y asígnele el nombre Obtener pronóstico.
2. Arrastre otro módulo Make API Call debajo del nuevo estado.
3. En el módulo Make API Call (Realizar llamada a API), seleccione el perfil que acaba de crear en el menú desplegable.
4. En el campo Punto final, incluya lo siguiente: gridpoints/{{states.true.call_api.make_api_call.response.properties.gridId}}/{{states.true.call_api.make_api_call.response.properties.gridX}},{{states.true.call_api.make_api_call.response.properties.gridY}}/forecast
5. Configure el Método como GET.

6. Guarde el flujo de trabajo.

   Brandfolder Image

   

Referencias de datos para la llamada al pronóstico

Si desea las referencias de datos utilizadas en el extremo anterior, desencadene el flujo de trabajo nuevamente. Asegúrese de que la fila modificada o agregada tenga la fecha de hoy, para que la casilla de verificación cambie a marcada.

Cuando haya creado la nueva fila y guardado la hoja, busque la última ejecución en el Registro de ejecución y expanda el paso anterior: Llamar a API: Realizar llamada a API. En Salida > Propiedades, localice los campos gridId, gridX, y gridY. Luego, puede usar estas referencias en la URL para llamar al servicio meteorológico.

Paso 8: Configurar el módulo Actualizar fila

Ahora que puede obtener datos meteorológicos con el flujo de trabajo, el último paso es actualizar la hoja con el pronóstico.

Agregar los ID de hoja y de la fila

1. Active el flujo de trabajo nuevamente. Asegúrese de que la fila modificada o agregada tenga la fecha de hoy, para que la casilla de verificación cambie a marcada.
2. Agregue otro estado debajo del último módulo de llamada a la API y asígnele el nombre Actualizar fila.
3. Busque el módulo Actualizar fila o expanda Integraciones > Smartsheet > Actualizar fila.
4. Desde el Registro de ejecución, expanda el desencadenador de la última ejecución y localice los valores del ID de hoja y el ID de fila .
5. Utilice las referencias de datos para establecer los campos de ID de hoja y ID de fila para el módulo Actualizar fila.

Agregar la referencia de datos detallados del pronóstico

1. Regrese al Registro de ejecución y expanda el último paso (el último de los dos módulos Make API Call [Realizar llamada a API]). Los datos del Servicio Meteorológico de EE. UU., incluidos los pronósticos del clima a siete días, proporcionan una variedad de información. y la fecha es 
2. Busque el clima actual en Output (Salida) > Properties (Propiedades) > Periods (Períodos) > 0.
3. Para este flujo de trabajo, debe usar la referencia del pronóstico detallado. Copie la referencia de datos. 
4. Abra de nuevo el módulo Update Row (Actualizar fila) y expanda la sección Cells (Celdas) . 
5. Pegue la referencia en el campo Value # (Valor N.º) . El valor pegado debe ser: {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast}} 
6. Ingrese la columna Pronóstico del clima en el campo Key #1.
7. Guarde el flujo de trabajo.

Si quiere asegurarse de que el flujo de trabajo no falle si el Servicio Meteorológico de EE. UU. no puede devolver información, puede ajustar la referencia de datos en el campo Value # (Valor N.º) a: {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast||Unable to fetch weather data}}
Esto garantiza que el módulo actualice la fila con el texto detrás del símbolo '||' si no hay datos en el pronóstico detallado.

Brandfolder Image

Flujo de trabajo completado

El flujo de trabajo se ejecuta cada vez que agrega una nueva fila (ya sea hacia la izquierda o hacia la derecha de la unión). También se ejecuta cada vez que hoy, la fecha establecida en una fila existente. La columna Pronóstico del clima de su hoja se completa automáticamente si el flujo de trabajo desciende por la rama izquierda de la unión o si la casilla Hoy está marcada.