Centro de suporte da Workiva

Você pode simplificar ainda mais o gerenciamento de dados combinando etapas na mesma cadeia. Neste Caminho de Aprendizado Conectado, você conhecerá a melhor maneira de substituir dados em uma tabela Wdata, que é um processo de duas etapas usando uma cadeia.

Etapa 1: Executar a cadeia

1. Navegue até a cadeia CLP | Carregar dados em uma tabela.
2. Clique em Execute e, em seguida, selecione Run With Inputs.
3. Insira valores para as entradas de tempo de execução:
   • ID da tabela - ID da tabela de detalhes do funcionário do CLP
     Consulte este documento para obter ajuda para localizar o ID.
   • Nome do arquivo - qualquer nome que você queira dar ao arquivo; neste exemplo, estamos chamando o arquivo de "Employee Detail" (Detalhe do funcionário).
   • Localização do arquivo - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
4. Clique em Iniciar.
5. Depois que a Cadeia for concluída, clique no nó Importar arquivo para a tabela para verificar o sucesso.
   Agora há dados disponíveis na Tabela de detalhes do funcionário do CLP, que serão substituídos pelo conjunto de dados atualizado, usando uma única cadeia para excluir os dados antigos e carregar os novos dados.

Etapa 2: Criar uma corrente

1. Adicionar uma nova corrente
2. Dê um nome à cadeia: CLP | Substituir dados em uma tabela.
3. Salvar a corrente

Etapa 3: Entradas de tempo de execução

Usamos o comando Runtime Inputs para iniciar a cadeia. Isso nos permite especificar o nome do arquivo e o ID da tabela para a qual o arquivo será importado quando executarmos a cadeia.

1. Adicione um comando Runtime Inputs a partir de eventos de acionamento em cadeia na área Start.
2. Edite o evento da cadeia Runtime Inputs clicando duas vezes no comando.
   Adicione as três entradas abaixo:
   • Entrada 1:
     • Type: TextField
     • Nome de exibição: Table ID (ID da tabela)
     • Obrigatório: Verificado
   • Entrada 2:
     • Type: TextField
     • Nome de exibição: Nome do arquivo
     • Obrigatório: Verificado
   • Entrada 3:
     • Type: TextField
     • Nome da tela: File Location (Localização do arquivo)
     • Obrigatório: Verificado
3. Salvar o comando

Etapa 4: Listar arquivos

Para excluir o arquivo antigo da tabela, você precisará do ID do arquivo. Para localizar programaticamente o FileID, usaremos o comando List Files. Esse comando usa o ID da tabela para pesquisar todos os arquivos dentro dessa tabela e nos fornece uma saída dos arquivos, bem como informações sobre esses arquivos, inclusive o ID do arquivo.

1. Adicione um comando List Files à tela Chain
2. Conecte o evento em cadeia Runtime Inputs ao comando List Files.
3. Clique duas vezes no comando para configurá-lo. E clique no campo Table ID.
4. No painel esquerdo Variables, clique na seta para baixo para expandir Trigger.
   1. Clique na seta para baixo para expandir Runtime Inputs.
   2. Selecione TableID.
5. Salvar o comando

Etapa 5: Desimportar arquivo da tabela

Da mesma forma que carregar dados em uma tabela, excluir dados de uma tabela é um processo de duas etapas. Para definir o arquivo como em estágio, ele precisará ser desimportado. Para definir o arquivo como em estágio, ele precisará ser desimportado. Usaremos o comando Un-Import File from Table para preparar o conjunto de dados a ser excluído.

1. Adicione um comando Un-import File from Table à tela Cadeias.
2. Conecte o comando List Files ao comando Un-import File from Table.
3. Clique duas vezes no comando para configurá-lo.
   1. Clique no campo Table ID.
      1. No painel esquerdo Variables, clique na seta para baixo para expandir Trigger.
      2. Clique na seta para baixo para expandir Runtime Inputs.
      3. Selecione TableID.
   2. Clique no campo File ID.
      1. No painel de variáveis à esquerda, clique na seta para baixo para expandir List Files.
      2. Selecione Files List.
      3. Clique em List Files - Files List variable para transformar a variável.
         1. Clique em Select Transformation e, em seguida, selecione Get Value from JSON.
         2. Clique no sinal de mais para adicionar a transformação variável.
         3. No campo Valor, digite '0' e pressione Insira.
         4. Depois que =0 aparecer, digite 'id' e pressione Insira novamente.
            A variável agora lerá a saída JSON do comando List Files e encontrará o ID do primeiro arquivo na tabela.

            Dica! Preste atenção especial às maiúsculas e minúsculas ao analisar valores JSON.

         5. Clique em Aceitar.
            
   3. Salve o comando.
      

    

   Etapa 6: Download do arquivo

   Em seguida, você pode excluir o arquivo escondido provisoriamente da tabela ou preparar o novo arquivo para ser carregado. Recomendamos que você carregue um novo arquivo depois de desimportar o arquivo antigo para garantir que o processo seja bem-sucedido antes que qualquer dado seja oficialmente excluído.

   Para preparar o novo arquivo para ser carregado, primeiro você terá de fazer o download do arquivo usando o comando HTTP Request Get. Hospedamos um arquivo on-line para que você possa fazer o download da cadeia e demonstrar o download de arquivos da nuvem.

   1. Adicione um comando Get do conector HTTP Request à tela Cadeias.
   2. Conecte o comando Un-import File from Table ao comando Get.
   3. Clique duas vezes no comando para que você o configure.
      
      1. Clique no campo URL.
         1. No painel esquerdo Select a Variable, clique na seta para baixo para expandir Trigger.
         2. Clique na seta para baixo para expandir Runtime Inputs.
         3. Selecione File Location.
      2. Atualize o campo Content type para: application/csv.
   4. Salve o comando.

   

   Etapa 7: Criar arquivo

   Assim como fizemos em Upload Data to Table Connected Learning Path, seguiremos o processo de duas etapas para fazer upload de dados para as tabelas Wdata. O arquivo precisará primeiro ser criado no status Staged antes de ser importado para uso final. Usaremos o comando Create File para criar o arquivo dentro da tabela Wdata no status Staged, indicando que ele foi criado, mas ainda não foi importado como um conjunto de dados.

   1. Adicione um comando Create File do Workiva Connector à tela Cadeias.
   2. Conecte o comando Get ao comando Create File.
   3. Clique duas vezes no comando para configurá-lo.
      
      1. Clique no campo Table ID.
         1. No painel esquerdo Select a Variable, clique na seta para baixo para expandir Trigger.
         2. Clique na seta para baixo para expandir Runtime Inputs.
         3. Selecione Table ID.
      2. Clique no campo File (Arquivo ).
         1. No painel esquerdo Select a Variable, clique na seta para baixo para expandir GET.
         2. Selecione Response.
      3. Clique no campo Name.
         1. No painel esquerdo Select a Variable , clique na seta para baixo para expandir Trigger.
         2. Clique na seta para baixo para expandir Runtime Inputs.
         3. Selecione File Name.
         4. No painel esquerdo Select a Variable , clique na seta para baixo para expandir Runtime.
         5. Selecione Chain.ExecutionDateTime.
         6. Digite ".csv" depois de suas duas variáveis.
            A variável Cadeias.ExecutionDateTime é usada para mostrar quando o arquivo foi gerado e para garantir que cada arquivo tenha um nome exclusivo.

   

   Etapa 8: Importar arquivo para a tabela

   A próxima etapa do processo de carregar arquivos para as tabelas do Wdata é importar os dados, tornando-os utilizáveis em consultas. Essa etapa pega o arquivo preparado e o importa para a tabela designada como um conjunto de dados.

   1. Adicione um comando Import File into Table do Workiva Connector à tela Cadeias.
   2. Conecte o comando Create File ao comando Import File into Table.
   3. Clique duas vezes no comando para configurá-lo.
      
      • Para o campo Table ID:
        1. No painel esquerdo Select a Variable , clique na seta para baixo para expandir Trigger.
        2. Clique na seta para baixo para expandir Runtime Inputs.
        3. Selecione Table ID.
      • Para o campo File ID.
        1. No painel esquerdo Select a Variable , clique na seta para baixo para expandir Create File.
        2. Selecione Result.
        3. Clique em Criar arquivo - Resultado para transformá-lo.
           1. Na lista suspensa Select Transformation, selecione Get Value from JSON.
           2. Clique no botão + (mais).
           3. No campo Valor, digite "id" e pressione Insira.
           4. Clique em Aceitar.
   4. Salvar o comando

   

   Etapa 9: Excluir arquivo

   Agora que os novos dados foram carregados e estão prontos para uso e o conjunto de dados antigo foi preparado, a etapa final é excluir oficialmente os dados antigos. Esta etapa usa o comando Delete File para excluir o conjunto de dados da tabela.

   1. Adicione um comando Delete File do Workiva Connector à tela Chain
   2. Conecte o comando Import File into Table ao comando Delete File
   3. Clique duas vezes no comando para configurá-lo.
      Para garantir que estamos excluindo o mesmo arquivo que desimportamos, geraremos o ID do arquivo da mesma forma que fizemos para o comando Un-import File from Table:
      • No campo File ID:
        1. No painel esquerdo Variáveis, clique na seta para baixo para expandir List Files.
        2. Selecione Files List.
        3. Clique na variável List Files - Files List para transformar a variável.
           1. Clique em Select Transformation e, em seguida, selecione Get Value from JSON.
           2. Clique no sinal de mais (+) para adicionar a transformação variável.
              1. No campo Valor, digite '0' e pressione Insira.
              2. Depois que =0 for exibido, digite 'id' e pressione Digite novamente.
                 A variável agora lerá a saída JSON do comando List Files e encontrará o ID do primeiro arquivo na tabela.

                 Dica! Preste atenção especial às letras maiúsculas e minúsculas ao analisar valores JSON.

              3. Clique em Aceitar
                 .
              4. Salve the Command.xx
                 

               

              Etapa 10: Testar o exercício

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

              1. Clique em Execute e, em seguida, selecione Run With Inputs.
              2. Adicione valores para suas entradas de tempo de execução.
                 • Table ID - ID da tabela de detalhes do funcionário do CLP
                   Consulte este documento para obter ajuda para localizar o ID.
                 • Nome do arquivo - qualquer nome que você queira dar ao arquivo; neste exemplo, estamos chamando o arquivo de "Employee Detail".
                 • Localização do arquivo - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
              3. Clique em Iniciar.
                 • Você pode verificar se os dados foram substituídos na tabela navegando até a tabela no Wdata e revisando os conjuntos de dados no painel à direita. A cadeia deve ter removido com sucesso o arquivo antigo e substituído pelo novo arquivo na tabela.
                 • Você pode verificar se os dados foram substituídos em sua tabela navegando até a tabela no Wdata e revisando os conjuntos de dados no painel à direita.

              

              

              Para saber mais sobre como usar as cadeias para simplificar a coleta de dados, confira o restante dos caminhos de centralização de dados em !