|
Os tipos de arquivos clássicos não estarão mais disponíveis para uso a partir de janeiro de 2021. Você pode fazer a transição de seus arquivos clássicos ou baixar um PDF. Saber mais

Centro de suporte da Workiva

CLP - Transformação do Handlebars

CLP - Transformação do Handlebars

  • Última atualização em

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.

Objetivo principal de aprendizado Recursos de comando do Handlebars
Objetivos secundários de aprendizado Conector de correntes Workiva
Pré-requisitos Configurar a conexão do conector de guidão .
Configure a conexão Workiva Cadeias Connector.
Modelo de suporte CLP | Configuração do guidão

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
    image (79).png

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
    image (80).png

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
    2023-08-16_12-49-57.gif

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
    image (48).png

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
    image (49).png

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
    image (50).png

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
      image (51).png

    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:
      image (52).png

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

      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).
      2023-08-10_16-56-22.gif

    Saiba mais

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

Neste Caminho de Aprendizado Conectado, criaremos uma cadeia que ilustra como aproveitar o Conector Handlebars para a...