Iniciar um fluxo de trabalho em branco para o serviço meteorológico dos EUA

Você pode usar o serviço meteorológico dos EUA para obter previsões, pois não precisa de uma conta para acessar os dados meteorológicos.

Para obter a previsão, você deve fazer duas chamadas à API para o serviço meteorológico dos EUA:

• Uma para localizar o ponto de aderência de uma localização geográfica.
• outra para obter a previsão para essa grade identificada. 

Você não precisa conhecer muito sobre chamadas à API para seguir as etapas deste guia, que fornece tudo o que você precisa para concluir o fluxo de trabalho.

Confira as etapas para criar o fluxo de trabalho:

1. Crie o fluxo de trabalho
2. Crie a planilha
3. Faça a autenticação com o Smartsheet e configure o acionador
4. Configure o Get Row (Obter linha)
5. Configure a junção
6. Configure a primeira chamada à API
7. Configure a segunda chamada à API
8. Configure a linha de atualização

Etapa 1: criar o fluxo de trabalho

1. No Bridge, selecione Novo Fluxo de Trabalho no painel Workflows .

2. Dê um nome ao fluxo de trabalho e selecione Criar Novo. 

   Todos os fluxos de trabalho começam com um acionador e um estado.

Etapa 2: criar a planilha

Antes de configurar o acionador no Bridge, você precisa de uma planilha do Smartsheet com pelo menos os seguintes nomes e tipos de coluna:

A coluna Previsão do Tempo pode ser a sua Coluna Principal ou uma coluna de texto regular. 

1.  Na primeira célula da coluna Hoje, cole a seguinte fórmula: =IF (Date@row = TODAY (), true, false)
2. Selecione Enter. Essa ação marcará a caixa de seleção se o conjunto de dados na coluna Data for a data de hoje, que você pode usar para acionar seu fluxo de trabalho no Bridge.
3. Clique com o botão direito do mouse na célula com a fórmula e selecione Converter em fórmula da coluna. Essa ação garante que todas as novas linhas adicionadas à planilha usem essa fórmula na coluna Today (Hoje).
4. Salve a planilha.
5. Antes de retornar ao Designer no Bridge, copie o ID da planilha. Você pode encontrar o ID da planilha indo em Arquivo > Propriedades.

Etapa 3: configurar o acionador

No Designer, selecione o Trigger (Acionador) na parte superior do fluxo de trabalho. Essa ação abre um painel no lado direito do Designer onde você pode configurar o tipo de acionador que deseja usar. 

Como o fluxo de trabalho deve ser acionado por um evento no Smartsheet, o tipo de acionador usado é um Integration Trigger (Acionador de integração). No painel, selecione Integrations Page (Página Integrações) na seção Integrations (Integrações).

Brandfolder Image

Essa ação abre uma nova guia com a página Integrations (Integrações). 

1. Encontre o Smartsheet e selecione o logotipo. 
2. Selecione Continuar. 
3. Selecione Authenticate (Autenticar).
4. Na janela pop-up, selecione Allow (Permitir).

Se a autenticação for bem-sucedida, a janela muda para a guia Triggers (Acionadores).

Brandfolder Image

Expanda a seção Triggers (Acionadores) e selecione a linha com o ícone de adição :

1. No campo Sheet ID (ID da planilha), cole o ID da planilha que você copiou ao criá-la. Se você sabe que o nome da planilha é único, digite-o.
2. Selecione When Column Values Are Changed (Quando os valores da coluna são alterados) na lista suspensa Event Type (Tipo de evento).
3. No campo que é adicionado quando você seleciona o Event Type (Tipo de evento), digite o nome da coluna Today (Hoje).

4. Na lista suspensa Select Workflow (Selecionar fluxo de trabalho), escolha o fluxo de trabalho que você criou anteriormente e selecione Save (Salvar).

   Você pode dizer que o acionador foi configurado com sucesso porque o pop-up recarrega e recolhe a seção Triggers (Acionadores).

5. Feche a guia e volte ao designer.

Erros ao salvar o acionador

Se você receber uma mensagem de erro ao salvar um acionador, revise os seguintes itens:

• Certifique-se de digitar o nome da coluna exatamente como consta na planilha. 
• Se você digitou o nome da planilha em vez de usar o ID da planilha, verifique se escreveu da mesma forma. 
• Se você não for o proprietário da planilha, verifique as permissões da planilha para garantir que você tenha acesso.
• Se outros acionadores já estiverem configurados, um acionador diferente pode causar um problema. Revise os outros acionadores para garantir que um deles não teve as permissões alteradas ou que a planilha referenciada no acionador ainda exista.

Etapa 4: configurar o Get Row (Obter linha)

Você configurou o acionador para executar o fluxo de trabalho ao alterar a coluna Hoje; essa ação agora envia algumas informações básicas para o Bridge. Para a primeira etapa do seu fluxo de trabalho, você deve recuperar algumas dessas informações iniciais: 

1. Defina a célula de data na primeira linha como a data de hoje. Isso marca automaticamente a caixa na coluna Hoje devido à fórmula que você inseriu anteriormente. 
2. Salve a planilha e volte para o designer no Bridge.
3. Abra o Registro de Execução. Selecione Atualizar, uma execução deve aparecer com o status Concluído.
4. Para revelar os dados iniciais enviados para o Bridge a partir do Smartsheet, selecione a execução, expanda a linha Acionador, e depois a linha Evento. 
5. Passe o mouse sobre rowId nos dados do acionador e selecione o ícone de mais para revelar uma lista suspensa. 

6. Na lista suspensa, selecione Copiar Referência de Dados. Essa ação copia uma referência no ID da linha que foi alterada para a área de transferência.

   Usando a referência em vez da fonte JSON, o fluxo de trabalho sempre obtém a linha alterada em vez de sempre olhar para a mesma linha. Isso é importante, pois a linha que muda difere entre cada execução do fluxo de trabalho. 

Brandfolder Image

Atualizar o estado e adicionar um módulo

1. Selecione o estado cinza e altere o campo Nome para Obter Linha.

   É uma boa prática nomear os estados de acordo com o que os módulos abaixo deles fazem para facilitar a leitura dos seus fluxos de trabalho.

2. Encontre o módulo Obter Linha no menu à esquerda. Use o campo de pesquisa ou encontre-o expandindo Integrações > Smartsheet > Obter Linha.
3. Arraste o módulo para o fluxo de trabalho sob o estado cinza. Um painel para configurar o módulo é aberto automaticamente. 
4. No campo ID da Linha , cole a referência que você copiou do rowId no Registro de Execução. O valor colado deve ser {{runtime.event.rowId}}.
5. Para obter o ID da planilha, abra o Run Log (Registro de execução) novamente e expanda os dados do gatilho para encontrá-lo. Copie a referência no ID da planilha como você fez no ID da linha anteriormente, selecionando o ícone mais .
6. Selecione o módulo Get Row (Obter linha) novamente e cole-o na referência no campo Sheet (Planilha). O valor colado deve ser {{runtime.sheetID}}.

7. Selecione Salvar na parte superior da página.

   Brandfolder Image

   

Etapa 5: configurar a junção

Você precisa determinar se a alteração na caixa de seleção na planilha foi porque a caixa foi marcada ou desmarcada. Uma caixa desmarcada deve ser ignorada; no entanto, se a caixa mudar para marcada, isso significa que a data definida na coluna Data é a data de hoje e você deseja coletar a previsão do tempo.

Para isso, faça referência à célula com a caixa de seleção:

1. Volte para a planilha e altere a data na linha que você adicionou anteriormente para desmarcar a caixa. Depois disso, salve a planilha.
2. No Bridge, abra o Run Log (Registro de execução) novamente e selecione Todas as execuções no canto superior esquerdo do painel. Atualize a lista para ver uma nova execução concluída no topo. 
3. Abra essa nova execução e expanda a etapa Smartsheet: Get Row (Obter linha) para revelar os dados da linha.
4. Em linha > células > Hoje, você pode ver que o valor é false (falso). Isso indica que a caixa de seleção na coluna Hoje estava desmarcada na linha que foi alterada. 
5. Usando o menu suspenso, copie a referência de dados desse valor.

Adicionar uma junção condicional de correspondência

O próximo passo é adicionar uma junção para verificar se o valor corresponde aos valores de texto true (verdadeiro) (marcada) ou false (falso) (desmarcada). 

1. No campo de pesquisa, digite Corresponder ou expanda Utilitários > Junções Condicionais > Corresponder para encontrar a junção. 
2. Arraste a junção para baixo do módulo Get Row (Obter linha) e nomeie-a como Data de Hoje.

Essa junção consiste em três componentes: a junção em si e dois estados de recurso temporário. Você pode encontrar mais estados para arrastar para o fluxo de trabalho na parte superior do menu à esquerda em Itens fixados > Novo Estado.

Adicionar estados à junção

1. Arraste um novo estado para o recurso temporário sucesso e nomeie-o como true (verdadeiro). 
2. Arraste outro novo estado para o recurso temporário falha e nomeie-o como false (falso).

Adicionar a referência de dados à junção

1. Selecione a junção Today's Date (Data de hoje) para abrir o painel de configuração. 
2. Cole a referência que você copiou anteriormente no campo Primeiro Valor.
   O valor colado deve ser {{states.Get Row.smartsheet.get_row.row.cells.Today.value}}
3. No campo Segundo Valor, digite a palavra true (verdadeiro). 

4. Salve o que você criou até agora.

   Brandfolder Image

   

Etapa 6: configurar a primeira chamada à API

Configurar um perfil para suas chamadas à API

Para recuperar dados de previsão do tempo, você deve primeiro criar um perfil para suas chamadas à API para o serviço meteorológico dos EUA. Os perfis são uma forma de salvar informações essenciais para as APIs do sistema às quais você deseja conectar seus fluxos de trabalho.

1. Na sua conta do Bridge, acesse a guia Integrações.
2. Selecione o utilitário Call API (Chamar API).

3. Selecione Continuar > Adicionar a Perfis.

   Brandfolder Image

   

    

4. Dê um nome ao perfil. Cada nome de perfil deve ser único. Por exemplo: US Weather (Meteorologia dos EUA).
5. No campo Base URL (URL base), insira https://api.weather.gov.
6. Expanda o menu suspenso Headers (Cabeçalhos):
   • No campo Key #1 (1ª chave), insira User-Agent (Usuário-Agente).

   • No campo Value #1 (1º valor), digite o nome da sua empresa e o e-mail, separados por vírgula.

     O serviço meteorológico dos EUA exige isso para que eles possam entrar em contato com você se virem atividades ou comportamentos inesperados em seus registros.

7. Salve o perfil.
8. Retorne ao fluxo de trabalho.

Configurar o módulo Make API Call (Fazer chamada à API) no fluxo de trabalho

A primeira chamada à API identifica o ponto de grade de um local inserido na planilha.

1. Use o campo de pesquisa para encontrar o módulo Fazer Chamada à API ou expanda Utilitários > Funções de Utilidade > Fazer Chamada à API.
2. Arraste-o até o fluxo de trabalho com o estado true (verdadeiro).
3. No módulo Make API Call (Fazer chamada à API), selecione o perfil criado no menu suspenso.
4. No campo Endpoint (Ponto de Acesso), inclua os seguintes pontos: points/{{states.Get Row.smartsheet.get_row.row.cells.Longitude.value}},{{states.Get Row.smartsheet.get_row.row.cells.Latitude.value}}.
5. Defina o Method (Método) como GET (OBTER).

6. Salve o fluxo de trabalho.

   Brandfolder Image

   

Referências de dados para a chamada de grade

O URL acima foi criado para você, pois entender como as solicitações à API funcionam é opcional para este guia. Esse URL faz referência aos valores de longitude e latitude na linha que acionou o fluxo de trabalho.

Se você quiser obter esses, deve acionar o fluxo de trabalho novamente. Desta vez, você precisa verificar se a caixa de seleção está marcada. Adicione informações em uma nova linha em vez de usar a primeira, e certifique-se de definir a data como hoje para que o fluxo de trabalho desça pela ramificação esquerda da junção.

Coordenadas

O serviço meteorológico dos EUA requer até quatro casas decimais para as coordenadas.

Etapa necessária

Seria melhor ter coordenadas para inseri-las nos campos Longitude e Latitude . Por exemplo, você pode usar 47.6174 e -122.2001 para obter o clima do escritório do Smartsheet em Bellevue.

Etapa 7: configurar a segunda chamada à API

A segunda chamada à API recupera a previsão do serviço meteorológico dos EUA com base nos pontos de grade localizados anteriormente. Para configurar isso, adicione um novo estado e outro módulo Make API Call ao fluxo de trabalho. 

1. Arraste e solte um novo estado dos itens fixados na parte superior do menu à esquerda e nomeie-o como Get Forecast. 
2. Arraste outro módulo Make API Call sob o novo estado.
3. No módulo Make API Call (Fazer chamada à API), selecione o perfil que acabou de ser criado no menu suspenso.
4. No campo Endpoint, inclua o seguinte: 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. Defina o Método como GET.

6. Salve o fluxo de trabalho.

   Brandfolder Image

   

Referências de dados para a chamada de previsão

Se você quiser as referências de dados usadas no ponto de extremidade acima, acione o fluxo de trabalho novamente. Certifique-se de que a linha alterada ou adicionada tenha a data de hoje, para que a caixa de seleção seja marcada.

Depois de criar a nova linha e salvar a planilha, encontre a última execução no Run Log e expanda a etapa anterior: Call API: Make API Call. Em Output > properties, localize os campos gridId, gridX, e gridY. Em seguida, você pode usar essas referências no URL para chamar o serviço meteorológico.

Etapa 8: configurar o módulo Update Row

Agora que você pode obter dados meteorológicos com o fluxo de trabalho, a última etapa é atualizar a planilha com a previsão.

Adicionar a planilha e os IDs da linha

1. Acione o fluxo de trabalho novamente. Certifique-se de que a linha alterada ou adicionada tenha a data de hoje, para que a caixa de seleção seja marcada.
2. Adicione outro estado sob o último módulo de chamada de API e nomeie-o como Update Row. 
3. Pesquise o módulo Update Row ou expanda Integrations > Smartsheet > Update Row.
4. No Run Log, expanda o Trigger da última execução e localize os valores de ID da planilha e da linha .  
5. Use as referências de dados para definir os campos de ID da planilha e ID da linha para o módulo Update Row.

Adicionar a referência de dados de previsão detalhada

1. Volte para o Run Log e expanda a última etapa (a última dos dois módulos Make API Call). Os dados do Serviço Meteorológico dos EUA, incluindo previsões do tempo para sete dias, fornecem uma variedade de informações. e a data é 
2. Encontre o clima atual em Output (Saída) > properties (propriedades) > periods (períodos) > 0.
3. Neste fluxo de trabalho, você deseja usar a referência da previsão detalhada. Copie a referência de dados. 
4. Abra o módulo Update Row (Atualizar linha) novamente e expanda a seção Cells (Células) . 
5. Cole a referência no campo Value # (Nº do valor) . O valor colado deve ser: {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast}} 
6. Insira a coluna Weather Forecast (Previsão do tempo) no campo Key #1.
7. Salve o fluxo de trabalho.

Se você quiser garantir que o fluxo de trabalho não falhe se o Serviço Meteorológico dos EUA não puder retornar informações, poderá ajustar a referência de dados no campo Value # (Nº do valor) para: {{states.Get Forecast.call_api.make_api_call.response.properties.periods.0.detailedForecast||Unable to fetch weather data}}
Isso garante que o módulo atualize a linha com o texto após o símbolo '||' se não houver dados na previsão detalhada.

Brandfolder Image

Fluxo de trabalho concluído

Seu fluxo de trabalho é executado sempre que você adiciona uma nova linha (descendo o ramo esquerdo ou direito da junção). Ele também é executado sempre que hoje, a data definida em uma linha existente. A coluna Weather Forecast (Previsão do tempo) na sua planilha será preenchida automaticamente se o fluxo de trabalho descer pela ramificação esquerda da junção ou se a caixa Today (Hoje) estiver marcada.