CLP - Uso de valores de uma planilha de controle – Centro de suporte

Para aproveitar os valores em uma Planilha de Controle para fluxos de trabalho em cadeia, você precisa ler e aplicar sistematicamente esses valores nos Comandos. Neste Caminho de Aprendizado Conectado, exploraremos como ler e usar valores de uma Planilha de Controle e utilizar um Grupo de Comandos para iterar por várias linhas de forma eficiente.

Caso de uso primário de negócios	Orquestração de fluxos de trabalho de relatórios a partir de um local centralizado Simplificando o gerenciamento do fluxo de trabalho para os usuários finais
Objetivo principal de aprendizado	Saiba como usar valores de uma planilha de controle em uma cadeia
Objetivos secundários de aprendizado	Aprender a usar comandos condicionais, iteradores JSON e o conector Handlebars
Pré-requisitos	Conclua o CLP \| Criando e lendo uma planilha de controle Configure os seguintes conectores: - JSON Handlebars
Modelo de suporte	CLP \| Uso de valores de uma planilha de controle

Etapa 1: Editar a cadeia existente

Navegue até o Construtor de cadeias e localize a cadeia CLP | Leitura de uma planilha de controle
Clique no botão de lápis para editar a cadeia
Clique em Configurações da cadeia no canto superior direito
- Renomeie a cadeia: CLP | Using Values from a Control Sheet (Usando valores de uma planilha de controle)
Salvar a corrente

Etapa 2: Converter a planilha de controle em JSON

Para utilizar efetivamente os valores em uma planilha de controle, converteremos a saída do comando Get Sheet Data do formato CSV para JSON. Essa conversão estabelece pares de valores-chave entre os cabeçalhos na planilha de controle e os valores correspondentes nas linhas abaixo de cada cabeçalho, permitindo uma iteração eficiente.

Adicione um comando CSV to JSON do conector JSON à tela Chain
Conecte o comando Get Sheet Data ao comando CSV to JSON
Clique duas vezes no comando para configurá-lo
- Dê um nome ao comando: Convert Control Sheet to JSON (Converter planilha de controle em JSON)
- Clique no campo Input File
  - No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Get Sheet Data (Obter dados da planilha)
  - Selecione a saída Data
- Deixe o campo delimitador como Vírgula (,)
- Salvar o comando

Etapa 3: Adicionar um grupo de comandos

Adicione um grupo de comandos à cadeia para ativar a iteração em cada linha da planilha de controle. Isso permite que você passe cada linha da planilha de controle pela série de comandos do grupo.

Adicione um grupo de comandos à tela Chain
Conecte o comando Convert Control Sheet to JSON à seção In do grupo de comandos
Clique duas vezes no grupo Command para configurá-lo
- Nomeie o grupo: Iterador de planilha de controle
- Navegue até a guia Iterators (Iteradores)
  - Ative o botão de alternância Iterations e clique no campo Iterations
    - No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Convert Control Sheet to JSON (Converter planilha de controle em JSON)
    - Selecione a saída JSON
- Salvar o comando

Agora que o Command foi configurado, ele iterará por cada linha da planilha de controle e fornecerá uma saída para cada linha.

Etapa 4: adicionar um comando condicional

Em uma planilha de controle, os usuários podem determinar se desejam que uma determinada linha seja executada em um fluxo de trabalho. Isso é aproveitado por meio da coluna ActiveFlag. Usaremos um Comando condicional para determinar se o fluxo de trabalho precisa continuar para cada linha na planilha de controle.

Adicione um Conditional Command Chain Event à tela Chain
Conecte o grupo Start dentro da planilha de controle Iterator Group ao comando Conditional
Clique duas vezes no comando para configurá-lo
- Dê um nome ao Command: Active Flag?
- Deixe a condição como AND e clique no botão + RULE
- Verifique novamente se o tipo de dados está definido como String e altere a operação para testar de Is Blank para =
- Clique no campo aberto no lado esquerdo do comando (o valor a ser testado)
  - No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Group Iterator (Iterador de grupo)
  - Selecione <> JSON File Iteration
  - Clique na pílula verde JSON File Iteration para transformar a variável
    - Clique em Select a Transformation (Selecionar uma transformação) e escolha Get Value from JSON (Obter valor de JSON)
    - Pressione o sinal verde +
    - No campo de valor, digite o cabeçalho ActiveFlag exatamente como está na planilha de controle e pressione Enter.
    - Selecione outra transformação e escolha Lowercase
    - Pressione o sinal verde +
    - Clique em Aceitar.

- De volta ao comando Conditional, no lado direito (o valor a ser comparado), digite a palavra true
  - Certifique-se de que isso esteja em minúsculas, pois a transformação de variável aplicada anteriormente torna o valor do sinalizador ativo todo em minúsculas.
Salvar o comando

Etapa 5: alimentar as saídas com um comando

Neste ponto, o iterador da planilha de controle está configurado para fornecer valores a qualquer Command existente no Group Start do Command Group. Aproveitaremos um comando Handlebars como espaço reservado para exibir os valores recuperados, que também podem ser usados iterativamente em comandos posteriores.

Adicione um comando Render Text Template do conector Handlebars à tela Chain
Conecte o comando Active Flag? Comando para o modelo de texto de renderização Comando
Clique duas vezes no comando para configurá-lo
- Nomeie o comando: Capture Control Sheet Values (Capturar valores da planilha de controle)
- No campo Template, digite as seguintes informações:
  - Top Row: Informações da folha de controle
  - Segunda linha: Nome do arquivo: <JSON>
    - Substitua o <JSON> do painel Select a Variable, clique na seta para baixo para expandir Group Iterator
    - Selecione <> JSON File Iteration

- - - Clique na pílula verde JSON File Iteration para transformar a variável
      - Clique em Select a Transformation (Selecionar uma transformação) e escolha Get Value from JSON (Obter valor de JSON)
      - Pressione o sinal verde +
      - No campo de valor, digite FileName exatamente como está na planilha de controle e pressione Enter.
      - Clique em Aceitar.

- Repita as etapas para a terceira, quarta e quinta linhas
  - Substitua o espaço reservado <JSON> pela variável da planilha de controle.
    - ID da tabela: <JSON>
      - Siga as mesmas etapas anteriores, mas use TableID em vez de FileName.
    - ID da planilha: <JSON>
      - Siga as mesmas etapas anteriores, mas use SpreadsheetID em vez de FileName.
    - Localização do arquivo: <JSON>
      - Siga as mesmas etapas anteriores, mas use FileLocation em vez de FileName.
Salvar o comando

Observação: Siga as etapas descritas para extrair qualquer cabeçalho e recuperar os valores de linha correspondentes de uma planilha de controle.

Etapa 6: Teste o exercício

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

Publicar a cadeia
Clique em Executar e selecione Run Chain
Após a conclusão da cadeia, clique no comando Capture Control Sheet Values para verificar o sucesso
- Deixe a cadeia ser totalmente concluída antes de clicar no comando
Você verá um campo que diz Value 1
- Se você clicar nesse campo, será mostrado que o Command processou três valores diferentes; esses valores são as três linhas de dados da planilha de controle.
Clique no campo Log para cada valor individual e verifique se ele corresponde aos valores da planilha de controle.