Centro de suporte da Workiva

Nesta trilha de aprendizagem conectada, criaremos uma cadeia que ilustra como contabilizar dinamicamente um ano bissexto.

Etapa 1: Criar uma corrente

• No módulo de cadeias em seu espaço de trabalho, selecione o ambiente DEV
• Adicionar uma nova corrente
  • Dê um nome à cadeia, CLP | Variable Transformation | Parsing Date and Time.
  • Adicionar descrição: O modelo Connected Learning Path Chain ilustra como uma entrada de tempo de execução para o mês e o ano pode gerar dinamicamente vários formatos de chave de período e levar em conta os anos bissextos.Esse modelo usa a Transformação de variáveis para reformatar as datas e calcular a chave do período final enquanto contabiliza dinamicamente os anos bissextos.
• Salvar a corrente

Etapa 2: Adicionar uma entrada de tempo de execução

As entradas de tempo de execução ilustram como uma cadeia pode solicitar valores durante a execução. Essa é uma maneira valiosa de fazer com que as cadeias possam ser usadas em vários processos.

• Crie o comando
  • Adicionar entradas de tempo de execução ao nó Start
    Use a barra de pesquisa para procurar por "runtime". Em seguida, clique duas vezes para carregar automaticamente o comando no círculo Start.
  • Clique em Add Input e selecione DropdownField.
  • Configure o DropdownField com o seguinte:
    

    Nome de exibição	Mês
    Necessário	Verificado
    Descrição	Selecione o mês atual

  • Clique em Add Option
  • Configure a opção com o seguinte:
    

    Valor	{"display":"January","value":"01-01"}
    Nome de exibição	Janeiro
    Padrão	Não verificado

• Preencha o campo suspenso
  • Adicione opções para os onze meses restantes do ano. Atualize o valor e os nomes de exibição de acordo
    • Exemplo: {"display":"February","value":"02-01"}
• Adicione um NumberField Runtime Input
  • Depois de concluir a entrada Dropdown Field, adicione um NumberField Input
  • Configure o NumberField com o seguinte:
    

    Nome de exibição	Ano
    Necessário	Verificado
    Descrição	Insira o ano atual no formato YYYY
    Valor padrão	<deixar em branco>
    Valor mínimo (verificado)	2000
    Valor máximo (verificado)	2050

• Salvar a entrada de tempo de execução

Etapa 3: adicionar um comando para criar uma chave de período

Usamos o conector Handlebars para pegar os valores especificados nas entradas de tempo de execução e criar uma chave de período no formato AAAA-MM-DD.

• Adicione um comando Render Text Template do conector Handlebars à cadeia
• Conecte o nó inicial (entradas de tempo de execução) ao comando Render Text Template
• Editar o comando
  • Nomeie o comando: Render Text Template - Create Period Key (Renderizar modelo de texto - Criar chave de período)
  • No parâmetro Template, digite o seguinte:
    

    {{Year}}-{{Period}}

  • Na seção Variables (Variáveis), adicione duas variáveis clicando duas vezes no botão Add (Adicionar ) na seção Variables (Variáveis )
  • Para a primeira variável, especifique o Nome da variável como Year
    • Observação: os nomes das variáveis diferenciam maiúsculas de minúsculas
  • Clique no campo Value
    • No painel Variável, expanda Trigger ➡ Runtime Inputs e selecione Year
  • Na segunda variável, especifique o nome como Period
  • Clique no campo Value
    • No painel Variable (Variável), expanda Trigger ➡ Runtime Inputs (Entradas de tempo de execução) e selecione Month (Mês).
    • Clique na variável Month (conforme indicado pela bolha) que foi atribuída ao valor
    • Clique no menu suspenso Select transformation (Selecionar transformação )
      • Selecione Parse text as JSON (Analisar texto como JSON)
      • Clique no símbolo de mais (+)
      • Clique novamente no menu suspenso Select transformation
        • Selecione Get Value from JSON (Obter valor de JSON)
        • Clique no símbolo de mais
      • Em Obter valor de JSON ,
        • Na lista suspensa da coluna Output, selecione "T"
          • Observação: T é a variável de mês que foi estabelecida na etapa anterior.
        • No campo da coluna Value (Valor), digite "value" e pressione a tecla Enter
          • Observação: o valor do texto deve estar em minúsculas e aparecerá como uma bolha cinza depois que você pressionar a tecla Enter
      • Clique em Aceitar.
• Salvar o comando

Etapa 4: Adicionar um comando para executar operações com datas

Usamos o Conector Handlebars para realizar várias operações de data, inclusive cálculo e reformatação de datas.

• Adicione um comando Render Text Template do conector Handlebars à cadeia
• Conecte o comando Render Text Template - Create Period Key ao comando Render Text Template
• Editar o comando
  • Nomeie o comando: Render Text Template - Date Parsing (Renderizar modelo de texto - Análise de data)
  • No parâmetro Template, digite o seguinte:

Período de tempo selecionado: 

  Mês: {{Month_Name}} 

Ano:

  Chave do período: {{Period_Key}} 

  Chave do período de fim do mês: {{EOM_Key}}

• • Na seção Parâmetro do modelo
    • Clique depois de Year
    • Em seguida, expanda o Trigger ➡ Runtime Inputs e selecione Year (Ano).

Etapa 5: seção Variables (Variáveis)

• Adicione três variáveis clicando no botão Add (Adicionar) na seção Variables (Variáveis)
  • Para a primeira variável:
    • Especifique o primeiro nome da variável como Month_Name
      • Clique no campo Value (Valor)
        • No painel Variável, expanda Trigger ➡ Runtime Inputs e selecione Month
      • Clique na bolha da variável Month no campo Value (Valor)
        • Clique no menu suspenso Select transformation (Selecionar transformação )
          • Selecione Parse text as JSON e clique no símbolo de mais (+)
        • Clique no menu suspenso Select transformation novamente
          • Selecione Get Value from JSON e clique no símbolo de mais (+)
            • Na linha Get Value from JSON, selecione T no menu suspenso Output (Saída)
            • Na mesma linha Get Value from JSON, digite e exiba no campo Value e pressione a tecla Enter
            • Clique em Aceitar.

• Para a segunda variável:
  • Especifique o nome da variável como Period_Key
    • Clique no campo Value
      • No painel Variável, expanda Render Text Template - Create Period Key (Modelo de texto renderizado - Criar chave de período)
        • Selecione Rendered Text
    • Clique no balão da variável Rendered Text no campo Value
      • Clique no menu suspenso Select transformation e selecione Parse Date / Time, e clique no botão mais (+)
      • Na primeira caixa suspensa, digite %Y-%m-%d e não se esqueça de pressionar Enter
      • No campo Formato da data de saída, digite %m/%d/%Y
      • No menu suspenso Input date timezone (Fuso horário da data de entrada), digite UTC e selecione o fuso horário (UTC) Dublin, Edinburgh, Lisbon, London
      • Repita a seleção de UTC para o campo Output date timezone (Fuso horário da data de saída)
      • Clique em Aceitar.

• Para a terceira variável:
  • Especifique o nome da variável como EOM_Key
    • Clique no campo Value (Valor). No painel Variável, expanda Render Text Template - Create Period Key e selecione Rendered Text
    • Clique na variável Rendered Text que foi atribuída ao valor
      • Clique no menu suspenso Select transformation e selecione Add / Subtract Date and Time, e clique no símbolo de mais (+)
        • Na caixa suspensa Format (Formato), digite %Y-%m-%d e não se esqueça de pressionar Enter
        • No menu suspenso Operação, selecione Add
        • No campo Valor, digite 1
        • No menu suspenso Unit (Unidade), selecione Month (Mês)
      • Adicione mais um Add / Subtract Date e transformação de hora
        • Na caixa suspensa Format (Formato), digite %Y-%m-%d e certifique-se de pressionar Enter
        • No menu suspenso Operation (Operação), selecione Subtract (Subtrair)
        • No campo Valor, digite 1
        • Na lista suspensa Unit, selecione Day
      • Campo de fuso horário da data de saída
      • Clique em Aceitar.
• Salvar o comando

Etapa 6: Teste a corrente

Agora que a cadeia está concluída, podemos testar o resultado.

• Publicar a cadeia
• Clique em Execute e selecione Run With Inputs
• No menu suspenso Month, selecione February. Na entrada Year (Ano), digite 2024
• Clique em Iniciar. Analise os resultados da cadeia na guia Log do comando Render Text Template - Create Period Key
  • Verifique a chave End of Month Period, ou seja, um ano bissexto

• Execute a cadeia novamente usando fevereiro, mas digite 2025 como o ano para essa execução
  • Confirme que o mês terminou no dia correto, ou seja, não em um ano bissexto

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