Centro de suporte da Workiva

Neste Caminho de Aprendizado Conectado, criaremos uma cadeia que ilustra como aproveitar o Conector Handlebars para analisar dados de uma resposta HTTP e criar modelos de variáveis que podem ser usados em uma cadeia.

Etapa 1: Criar uma corrente

1. Adicionar uma nova corrente
2. Nomear a cadeia CLP | Configuração do guidão.
3. Criar uma variável de cadeia Insira os seguintes valores para o nome e o valor da variável:
   • Nome da variável: cv-AllStations
   • Valor da variável: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
4. Salvar a corrente
   

Etapa 2: Recuperar dados JSON

Esta etapa usa o Conector HTTP para recuperar dados relacionados ao Citibike no formato JSON de um local da Web.

1. Adicione um comando GET do conector HTTP ao nó Start.

2. Para configurar o comando, você deve usar os seguintes valores:

   Nome	GET - Todas as estações
   Nome do usuário	<deixar em branco>
   Senha	<deixar em branco>
   Certificado da CA	<deixar em branco>
   Certificado	<deixar em branco>
   Chave privada do certificado	<deixar em branco>
   Mostrar resposta	Verificado
   URL	cv-AllStations Chain Variable
   Cadeia de consulta	<deixar em branco>
   Tipo de conteúdo	aplicativo/json
   Resposta	<deixar em branco>

3. Salvar o comando
   

Etapa 3: Iterar pelos dados JSON

Use o comando Handlebars - Render Text template para iterar pelos dados da estação do CitiBike a fim de fornecer uma formatação que combine os dados de cada estação individual.

1. Adicione o comando Handlebars - Render Text Template à tela Cadeias.
2. Conecte o comando GET - All Stations ao comando Handlebars - Render Text Template.
3. Clique duas vezes no comando para editá-lo. Você pode usar o nome do comando: RTT - Parsing JSON Response .
   1. Você pode nomear o comando: RTT - Analisando a resposta JSON.
   2. Adicione uma variável JSON e dê a ela o nome de citibikeData.
   3. Para o campo Value, use a variável Response do comando Get - All Stations.

   4. Preencha o campo de modelo com o seguinte valor:

      {{#each citibikeData.data.stations}} {{@index}} | {{name}} | {{capacity}} {{/each}}

      Isso permitirá que o comando itere pela resposta JSON, usando um caminho raiz de data.stations para fornecer valores de texto de cada chave: ("name", "capacity"). Além disso, você adicionará um valor index para cada linha processada.

4. Salvar o comando
   

Etapa 4: Modelagem de variáveis de tempo de execução

Use o comando Handlebars - Render Text Template para modelar variáveis. Isso permitirá que a cadeia renderize um modelo de texto que fornece contexto em diferentes componentes da cadeia com base em seu tempo de execução.

1. Adicione o comando Handlebars - Render Text Template à tela Cadeias.
2. Conecte o comando GET - All Stations ao comando Handlebars - Render Text Template.
3. Clique duas vezes no comando para editá-lo, usando os valores a seguir:
   1. Nomear o comando: RTT - Templatizing Variables (RTT - Modelagem de variáveis).
   2. Adicione e preencha as seguintes informações para a seção variables:
      Os campos Value serão preenchidos no menu suspenso Runtime do painel de variáveis à esquerda.
      • Variável 1
        • Nome da variável: Chain-Env
        • Valor: <Chain.Enviroment> (Variável de tempo de execução)
      • Variável 2
        • Nome da variável: Chain-Exec-Time
        • Valor: <Chain.ExecutionDateTime> (Variável de tempo de execução)
      • Variável 3
        • Nome da variável: System-RunTime-Month
        • Valor: <System.DateTime> (Runtime Variable)
          1. Clique na variável de tempo de execução <System.DateTime> para transformar a variável.
          2. Em Selecione Transformation, escolha Parse Date/Time e clique em "+".
          3. No primeiro campo de valor, escolha "ISO Extended (Platform Standard)".
          4. No campo Output date format (Formato da data de saída ), digite "%m".
          5. No campo Input date timezone (fuso horário da data de entrada), escolha "UTC (Etc/UTC)".
          6. No campo Output date timezone (fuso horário da data de saída), escolha "UTC (Etc/UTC)".
          7. Clique em Aceitar.
      • Variável 4
        • Nome da variável: System-RunTime-Year
        • Valor: <System.DateTime> (Variável de tempo de execução)
          1. Clique na variável de tempo de execução <System.DateTime> para transformar a variável
          2. Em Selecione a transformação, escolha Parse Date/Time e clique em "+".
          3. No primeiro campo de valor, escolha "ISO Extended (Platform Standard)".
          4. No campo Output date format (Formato da data de saída), digite "%Y".
          5. No campo Input date timezone (fuso horário da data de entrada), escolha "UTC (Etc/UTC)".
          6. No campo Output date timezone (fuso horário da data de saída), escolha "UTC (Etc/UTC)".
          7. Clique em Aceitar.
   3. Preencha o campo do modelo com os seguintes valores:
      • Ambiente da cadeia: {{Chain-Env}}
      • Data de execução da cadeia: {{Chain-Exec-Time}}
      • Mês-ano do tempo de execução do sistema: {{System-RunTime-Month}}-{{System-RunTime-Year}}
4. Salvar o comando
   

Etapa 5: Templatização de variáveis de espaço de trabalho - Obter espaços de trabalho

Use Handlebars - Render Text Template para criar modelos de componentes de um espaço de trabalho. Com isso, você poderá renderizar um modelo de texto que fornece o contexto de diferentes componentes do espaço de trabalho em que a cadeia está localizada.

1. Adicione o comando Get Workspaces do conector Workiva Cadeias à tela Cadeias.
2. Conecte o comando GET - All Stations ao comando Get Workspaces.
3. Clique duas vezes no comando para editá-lo e confirme se a conexão está correta.
4. Salvar o comando
   

Etapa 6: Modelagem de variáveis de espaço de trabalho - RTT - WorkspaceID

1. Adicione o comando Handlebars - Render Text Template à tela Cadeias.
2. Conecte o comando Get Workspaces ao comando Handlebars - Render Text Template.
3. Clique duas vezes no comando para editá-lo. Você pode editar o nome do comando.
   • Dê um nome ao comando RTT - WorkspaceID.

   • Digite o seguinte valor no campo Template:

     {{#each workspaces}} {{#if (equal name "<(chain.workspace)>") }} {{id}}{{/if}}{{/each}}

4. Selecione a variável <Chain.Workspace> na seção de variáveis de tempo de execução no painel esquerdo
5. No campo JSON Variables, insira as seguintes informações:
   • Nome da variável: espaços de trabalho|workspace
   • Valor variável:: <Espaços de trabalho|workspaces> Você pode adicionar o comando Get Environments do conector de cadeias da Workiva à tela Chain.
6. Expanda a variável Get Workspaces no painel de variáveis à esquerda e selecione Workspaces.
7. Salvar o comando
   

Etapa 7: Templatizing Workspace Variables - Get Environments (Templatizar variáveis do espaço de trabalho - Obter ambientes)

1. Adicione o comando Get Environments do conector Workiva Cadeias à tela Cadeias.
2. Conecte o comando RTT - WorkspaceID ao comando Get Environments.
3. Clique duas vezes no comando para editá-lo e insira a variável Rendered Text do comando RTT-WorkspaceID no campo ID do espaço de trabalho|workspace.
4. Salvar o comando
   

Etapa 8: Modelagem de variáveis de espaço de trabalho - RTT - EnvironmentID

1. Adicione o comando Handlebars - Render Text Template à tela Cadeias.
2. Conecte o comando Get Environments ao comando Handlebars - Render Text Template.

3. Clique duas vezes nesse comando para editá-lo, usando os valores a seguir:

   1. Nomear o Comando: RTT - EnvironmentID.

   2. Digite o seguinte valor no campo Template:

      {{#each environments}} {{#if (equal name "<(chain.environment)>") }} {{id}}{{/if}}{{/each}}

      O endereço <Chain.Environment> é uma variável Runtime e pode ser localizado no painel esquerdo.

   3. No campo JSON variables, insira as seguintes informações:
      • Nome da variável: environments
      • Valor da variável: <Environments>
        Esse valor é localizado no painel de variáveis à esquerda sob o comando Get Environments.
   4. Salvar o comando
      

   Etapa 9: Teste o exercício

   1. Publicar a cadeia
   2. Clique em Executar e selecione Run Chain
   3. Depois que a cadeia tiver sido executada:
      Confirme que todos os nós foram executados com sucesso clicando no comando RTT - Parsing JSON Response e verificando se as primeiras linhas da saída são as seguintes:
      

   4. Clique no comando RTT - Templatizing Variables executado e verifique se o texto renderizado está correto na guia "Logs".
      

      Nota: Esses valores serão alterados de acordo com o ambiente em que a Cadeia for executada e quando ela for executada.

   5. Clique no nó RTT - Environment ID e selecione a guia Outputs.
   6. Confirme se um valor foi preenchido para a variável de texto renderizado (novamente, esse resultado variará dependendo do ambiente em que você estiver).
      

   Saiba mais

   Para saber mais sobre transformação de dados usando cadeias, confira Connected Learning Paths - Transformation Introduction!