Centro de suporte da Workiva

Agora é hora de reunir tudo em um fluxo de trabalho de relatório centralizado, no qual processaremos novos dados e atualizaremos as conexões que dependem desses dados usando uma única cadeia. Neste Connected Learning Path, usaremos as variáveis de 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 de negócios mais visibilidade sobre quando os fluxos de trabalho foram concluídos mais recentemente.

Etapa 1: Atualizar a planilha de controle para incluir o 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 sobre quando o fluxo de trabalho foi executado e o status desse fluxo. Salvaremos essas informações na planilha de controle.

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

Etapa 2: Editar a cadeia existente

• Navegue até o Criador de cadeias e localize a cadeia CLP | Uso de valores de uma planilha de controle
• Clique no botão de lápis para editar a cadeia
• Clique em Chain Settings (Configurações da cadeia) no canto superior direito 
  • Renomeie a cadeia: CLP | Execução de processos e registro de resultados em uma planilha de controle
  • Em Variáveis de cadeia, clique duas vezes no sinal de mais para criar duas variáveis de cadeia e configurá-las conforme abaixo:
    
    • Tipo: Variável em cadeia (cv)
      
      • Nome: cv-Status Column Letter
      • Valor: a letra da coluna em que o cabeçalho Status foi criado
        • No exemplo fornecido, o valor é F
    • Type (Tipo): Chain Variable (cv)
      
      • Nome: cv-Time Stamp Column Letter
      • Valor: a letra da coluna em que o cabeçalho Time Stamp foi criado
        • No exemplo fornecido, o valor é G
  • A cadeia deve ter agora quatro variáveis de cadeia
• Salvar a corrente

Etapa 3: Comando Add Row Numbers (Adicionar números de linha)

Usaremos o comando Add Row Numbers 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 Get Sheet Data e o comando Convert Control Sheet to JSON
  • Quebre o link clicando no botão Excluir
    
• Adicione um comando Add Row Numbers do conector Tabular Transformation à tela Chain
• Conecte o comando Get Sheet Data (Obter dados da planilha) ao comando Add Row Numbers (Adicionar números de linha)
• Conecte o comando Add Row Numbers (Adicionar números de linha) ao comando Convert Control Sheet to JSON (Converter planilha de controle em JSON)
  
• Clique duas vezes no comando Add Row Numbers para configurá-lo
  • 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 do comando Get Sheet Data
• Salvar o comando

• Agora que adicionamos os 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 Convert Control Sheet to JSON para atualizá-lo
    • Clique no campo Input File e exclua o Get Sheet Data Output
      • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Add Row Numbers (Adicionar números de linha)
      • Selecione a saída Add Row Numbers do comando Add Row Numbers
  • Salvar o comando

Etapa 4: executar o processo para carregar os dados no 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 dá início à cadeia Upload Data to Wdata em Uploading Data to a Table Path.

• Agora que conseguimos visualizar o uso de variáveis de uma planilha de controle usando o 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 Delete
• Adicione um evento Run Chain à tela Chain (Cadeia de execução)
• Conecte o comando condicional Active Flag ao evento Run Chain
• Clique duas vezes no comando para configurá-lo
  • Dê um nome ao comando: Run Chain - Upload Data to Wdata (Executar cadeia - Carregar dados para Wdata)
  • Clique no menu suspenso Chain e selecione a Chain CLP | Upload Data to a Table
  • Configure as entradas de tempo de execução usando variáveis da planilha de controle:
    • Clique no campo Table ID
      • 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 TableID exatamente como está na planilha de controle e pressione Enter
        • Clique em Aceitar.

• • • Clique no campo File Name
      • Siga as mesmas etapas acima para usar a variável da planilha de controle, usando o campo FileName em vez de TableID
    • Clique no campo File Location
      • Siga as mesmas etapas acima para usar a variável da planilha de controle, usando o campo FileLocation em vez de TableID
• Salvar o comando

Etapa 5: executar 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 cadeia Refresh List of Connections (Atualizar lista de conexões) a partir do caminho Refresh List of Connections (Atualizar lista de conexões).

• Adicione um evento Run Chain à tela Chain (Cadeia de execução)
• Conecte o evento Run Chain - Upload Data to Wdata Chain Event ao evento Run Chain Event
• Clique duas vezes no comando para configurá-lo
  • Dê um nome ao comando: Run Chain - Refresh Connections (Executar cadeia - Atualizar conexões)
  • Clique no menu suspenso Chain e selecione a Chain CLP | Refresh List of Connections
  • Configure as entradas de tempo de execução usando variáveis da planilha de controle:
    • Clique no campo Spreadsheet ID
      • 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 SpreadsheetID exatamente como está na planilha de controle e pressione Enter
        • Clique em Aceitar.

• Salvar o comando

Etapa 6: Comando Populate Status and Time Stamp (preencher status e carimbo de data/hora)

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. A primeira etapa para fazer isso é criar o arquivo com o status e a hora.

• Adicione um comando Create File do conector de utilitários de arquivo à tela Cadeia
• Conecte o evento em cadeia Run Chain - Refresh Connections ao comando Create File
• Clique duas vezes no comando para configurá-lo
  • Nomeie o comando: Populate Status & Time Stamp
  • No campo Text, 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 das cadeias
      • No painel Select a Variable à esquerda, expanda Runtime
      • Selecione o valor System.DateTime
• Salvar o comando

Etapa 7: Gravar de volta na planilha de controle

Agora, usaremos o comando Write Sheet Data 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 da 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 Populate Status & Time Stamp ao comando Write Sheet Data
• Clique duas vezes no Command para configurá-lo
  • Clique no campo Spreadsheet ID (ID da planilha)
    • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Chain
    • Selecione a variável cv-Control Spreadsheet ID Chain Variable 
  • Clique no campo Sheet ID/Name (ID/nome da planilha)
    • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Chain (Cadeia)
    • Selecione a variável de cadeia cv-Control Sheet Name  
  • Clique no campo Data File (Arquivo de dados)
    • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Populate Status & Time Stamp (Popular status e carimbo de data/hora)
    • Selecione a saída Created File
  • 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 na qual escrever para a iteração atual:
    • Clique no campo Region e preencha com o seguinte:
      
    • cv-Status Column Letter - variável encontrada no painel Variables em Chain Variables
    • Iteração de arquivo JSON - estamos usando o número de linha da iteração, mais 1, para especificar a região na qual gravar os dados, adicionamos um para contabilizar a linha de cabeçalho
      • 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 Row Number e pressione Enter
        • Selecione outra transformação e escolha Parse Number
        • 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 Variables em Chain Variables
    • Iteração do arquivo JSON - estamos usando o número da linha da iteração, mais 1, para especificar a região na qual gravar os dados, adicionamos um para contabilizar a linha do cabeçalho 
      • Siga as mesmas etapas 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
• Depois que a cadeia for concluída, verifique se o fluxo de trabalho foi concluído verificando o seguinte:

A cadeia foi executada com êxito:

Os dados foram carregados com sucesso para a CLP Employee Detail Table:

Conexões atualizadas com sucesso na planilha CLP Employee Overview Spreadsheet:

Registro em log adicionado com sucesso à Planilha de controle primário:

Parabéns! Você automatizou com êxito um fluxo de trabalho que faz download de dados da fonte, carrega os dados em uma tabela e atualiza as conexões que usam esses dados. Esse fluxo de trabalho utilizou valores de uma planilha de controle para determinar a fonte de dados, o destino do 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 de conclusão.

Desafie-se ainda mais adicionando o registro de falhas à sua planilha de controle ao concluir o próximo caminho: Registro de falhas em uma planilha de controle!