Centro de suporte da Workiva

Agora é hora de reunir tudo em um fluxo de trabalho de relatórios centralizado, onde processaremos novos dados e atualizaremos as conexões que dependem desses dados usando uma única cadeia. Neste Caminho de Aprendizagem Conectada, usaremos as variáveis da nossa planilha de controle para executar fluxos de trabalho que preparam nossos dados enquanto atualizam a planilha de controle com um status, fornecendo aos usuários empresariais mais visibilidade sobre quando os fluxos de trabalho foram concluídos mais recentemente.

Etapa 1: Atualizar planilha de controle para incluir registro

Para notificar os usuários finais sobre o status e a atualização mais recente dos processos executados pela Planilha de Controle, precisamos de um local para armazenar os detalhes de quando o fluxo de trabalho foi executado e o status desse fluxo de trabalho. Salvaremos essas informações na planilha de controle.

• Na plataforma Workiva, navegue até Planilha de controle CLP Planilha
• Adicione duas novas colunas após a coluna FileLocation com os seguintes cabeçalhos:
  • Status
  • Carimbo de hora
• Não adicione nenhum valor abaixo dos cabeçalhos dessas colunas

Etapa 2: Editar a cadeia existente

• Navegue até o Chain Builder e localize o Chain CLP | Usando valores 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 
  • Renomear a Cadeia: CLP | Executando Processos e Registrando Resultados em uma Planilha de Controle
  • Em Variáveis de Cadeia, clique no sinal de mais duas vezes para criar duas Variáveis de Cadeia e configurá-las conforme abaixo:
    
    • Tipo: Cadeia Variável (cv)
      
      • Nome: cv-Status Coluna Letra
      • Valor: a letra da coluna na qual o cabeçalho Status foi criado
        • No exemplo fornecido, o valor é F
    • Tipo: Cadeia Variável (cv)
      
      • Nome: cv-Carimbo de hora Coluna Letra
      • Valor: a letra da coluna na qual o cabeçalho Time Stamp foi criado
        • No exemplo fornecido, o valor é G
  • A cadeia agora deve ter quatro variáveis de cadeia
• Salvar a corrente

Etapa 3: Comando Adicionar Números de Linha

Usaremos o comando Adicionar números de linha para adicionar automaticamente números de linha à planilha de controle. Isso nos permitirá determinar onde o registro deve ocorrer dentro da planilha de controle.

• Clique duas vezes no link entre o comando Obter dados da planilha e o comando Converter planilha de controle em JSON
  • Quebre o link clicando no botão Excluir 
     
• Adicione um comando Adicionar números de linha do conector Transformação tabular à tela Cadeia
• Conecte o comando Obter dados da planilha ao comando Adicionar números de linha
• Conecte o comando Adicionar números de linha ao comando Converter planilha de controle em JSON
  
• Clique duas vezes no comando Adicionar números de linha para configurá-lo
  • Clique no campo Arquivo de entrada
    • No painel Selecionar uma variável , clique na seta para baixo para expandir Obter dados da planilha
    • Selecione a saída Dados do comando Obter dados da planilha
• Salvar o comando

• Agora que adicionamos números de linha ao conjunto de dados, precisamos atualizar os comandos subsequentes para usar os dados transformados. Nesse caso, o comando CSV para JSON precisa ser atualizado.
  • Clique duas vezes no comando Converter planilha de controle em JSON para atualizá-lo
    • Clique no campo Arquivo de entrada e exclua a saída Obter dados da planilha
      • No painel Selecionar uma variável , clique na seta para baixo para expandir Adicionar números de linha
      • Selecione a saída Adicionar números de linha do comando Adicionar números de linha
  • Salvar o comando

Etapa 4: Execute o processo para carregar dados para o Wdata

Agora usaremos as variáveis da nossa planilha de controle para executar um processo que carrega os dados em uma tabela Wdata. Faremos isso usando um evento Run Chain que inicia a cadeia Upload Data to Wdata a partir do Uploading Data to a Table Path.

• Agora que conseguimos visualizar usando variáveis de uma planilha de controle usando Handlebars, não precisamos mais do comando Handlebars
  • Passe o mouse sobre o comando Handlebars e clique na lixeira para excluir
    
    • Confirme a exclusão do comando clicando em Excluir
• Adicione um evento Run Chain à tela Chain
• Conecte o comando condicional Active Flag ao evento Run Chain
• Clique duas vezes no comando para configurá-lo
  • Nomeie o comando: Executar cadeia - Carregar dados para Wdata
  • Clique no menu suspenso Cadeia e selecione Cadeia CLP | Carregar dados para uma tabela
  • Configure as entradas de tempo de execução usando variáveis da planilha de controle:
    • Clique no campo ID da tabela
      • No painel Selecionar uma variável , clique na seta para baixo para expandir Iterador de grupo
      • Selecione <> Iteração do arquivo JSON
      • Clique na pílula verde JSON File Iteration para transformar a variável
        • Clique em Selecionar uma transformação e escolha Obter valor de JSON
        • Pressione o sinal verde +
        • No campo valor digite TableID exatamente como está na planilha de controle e pressione Enter
        • Clique em Aceitar

• • • Clique no campo Nome do arquivo 
      • Siga os mesmos passos acima para usar a variável da planilha de controle, usando o campo FileName em vez de TableID
    • Clique no campo Localização do arquivo
      • Siga os mesmos passos acima para usar a variável da planilha de controle, usando o campo FileLocation em vez de TableID
• Salvar o comando

Etapa 5: Execute o processo para atualizar as conexões

Em seguida, usaremos as variáveis da nossa planilha de controle para executar um processo que atualiza os dados em nossas planilhas de relatórios, disponibilizando os dados recém-carregados aos usuários finais. Faremos isso usando um evento Run Chain que inicia a Refresh List of Connections Chain a partir do Refresh List of Connections Path.

• Adicione um evento Run Chain à tela Chain
• Conecte o Run Chain - Carregar dados para o evento Wdata Chain ao Run Chain Event
• Clique duas vezes no comando para configurá-lo
  • Nomeie o comando: Executar cadeia - Atualizar conexões
  • Clique no menu suspenso Cadeia e selecione Cadeia CLP | Atualizar lista de conexões
  • Configure as entradas de tempo de execução usando variáveis da planilha de controle:
    • Clique no campo ID da planilha
      • No painel Selecionar uma variável , clique na seta para baixo para expandir Iterador de grupo
      • Selecione <> Iteração do arquivo JSON
      • Clique na pílula verde JSON File Iteration para transformar a variável
        • Clique em Selecionar uma transformação e escolha Obter valor de JSON
        • Pressione o sinal verde +
        • No campo de valor digite SpreadsheetID exatamente como está na planilha de controle e pressione Enter
        • Clique em Aceitar

• Salvar o comando

Etapa 6: preencher o comando Status e Time Stamp

Agora adicionaremos os comandos que serão usados para gerar e preencher os valores que serão retornados à planilha de controle para indicar que os fluxos de trabalho foram bem-sucedidos. O primeiro passo para fazer isso é criar o arquivo com o status e a hora.

• Adicione um comando Criar arquivo do conector Utilitários de arquivo à tela Chain
• Conecte o evento Run Chain - Refresh Connections Chain ao comando Create File
• Clique duas vezes no comando para configurá-lo
  • Nomeie o comando: Preencher status e carimbo de data/hora
  • No campo Texto , digite as seguintes informações: 

Upload e atualização de dados concluídos,(*<System.DateTime> *)

• • • Substitua o espaço reservado (*System.DateTime*) pela variável de tempo de execução apropriada, isso extrairá programaticamente a data e a hora de Chains
      • No painel Selecione uma variável à esquerda, expanda Tempo de execução
      • Selecione o valor System.DateTime
• Salvar o comando

Etapa 7: Escreva de volta para a planilha de controle

Agora usaremos o comando Gravar Dados da Planilha para gravar as informações preenchidas no comando anterior de volta na planilha de controle. Isso dará aos nossos usuários finais visibilidade do processo, mostrando o status do carregamento e atualização dos dados, e a data em que foram atualizados.

• Adicione um comando Write Sheet Data do Workiva Connector à tela Chain 
• Vincule o comando Preencher status e carimbo de data/hora ao comando Gravar dados da planilha 
• Clique duas vezes no comando para configurá-lo
  • Clique no campo ID da planilha
    • No painel Selecionar uma variável, clique na seta para baixo para expandir Cadeia
    • Selecione a variável de cadeia cv-Control Spreadsheet ID
  • Clique no campo ID/Nome da planilha
    • No painel Selecionar uma variável, clique na seta para baixo para expandir Cadeia
    • Selecione a variável de cadeia cv-Control Sheet Name 
  • Clique no campo Arquivo de Dados
    • No painel Selecionar uma variável , clique na seta para baixo para expandir Preencher status e registro de data e hora
    • Selecione a saída Arquivo criado
  • O campo Região será preenchido com uma combinação de Variáveis de Cadeia e saída JSON para informar à Cadeia a célula específica na planilha de controle para gravar na iteração atual:
    • Clique no campo Região e preencha com o seguinte: 
       
    • cv-Status Column Letter - variável encontrada no painel Variáveis em Variáveis de Cadeia
    • Iteração do arquivo JSON - estamos usando o número da linha da iteração, mais 1, para especificar a região para gravar os dados, adicionamos um para contabilizar a linha do cabeçalho
      • No painel Selecionar uma variável, clique na seta para baixo para expandir Iterador de grupo
      • Selecione <> Iteração do arquivo JSON
      • Clique na pílula verde JSON File Iteration para transformar a variável
        • Clique em Selecionar uma transformação e escolha Obter valor de JSON
        • Pressione o sinal verde +
        • No campo de valor digite Número da linha e pressione Enter
        • Selecione outra transformação e escolha Analisar Número
        • Clique no sinal verde +
        • Selecione outra transformação e escolha Adicionar
        • Clique no sinal verde +
        • No campo de valor digite 1
        • Clique em Aceitar
          
    • Insira dois pontos após a primeira iteração do arquivo JSON :
    • cv-Time Stamp Column Letter - variável encontrada no painel Variáveis em Variáveis de Cadeia
    • Iteração do arquivo JSON - estamos usando o número da linha da iteração, mais 1, para especificar a região para gravar os dados, adicionamos um para contabilizar a linha do cabeçalho 
      • Siga os mesmos passos acima para a segunda iteração do arquivo JSON

• Salvar o comando

Etapa 8: 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, verifique se o fluxo de trabalho foi concluído verificando o seguinte:

A cadeia foi executada com sucesso:

Dados enviados com sucesso para a Tabela de Detalhes de Funcionários do CLP:

Conexões atualizadas com sucesso na Planilha de Visão Geral de Funcionários do CLP:

Registro adicionado com sucesso à Planilha de Controle Primário:

Parabéns! Você automatizou com sucesso um fluxo de trabalho que baixa dados da origem, carrega os dados em uma tabela e atualiza as conexões que usam esses dados. Este fluxo de trabalho utilizou valores de uma planilha de controle para determinar a fonte de dados, o destino de upload no Workiva e as conexões a serem atualizadas. Aplique esses princípios aos seus próprios processos para minimizar o esforço manual e fornecer aos usuários finais insights sobre a conclusão.

Desafie-se ainda mais adicionando o registro de falhas à sua planilha de controle, completando o próximo caminho: Registrando falhas em uma planilha de controle!