Centro de suporte da Workiva

Etapa 1: Criar uma planilha de controle

Estaremos criando uma planilha de controle para armazenar variáveis usadas para carregar dados em uma tabela Wdata e, em seguida, atualizar as conexões para esses dados. Em vez de especificar essas variáveis como Runtime Inputs cada vez que a cadeia for executada, adicionaremos nossas variáveis a uma planilha de controle que a cadeia lerá e usará durante toda a execução. 

Embora essa planilha de controle demonstre o upload de vários arquivos para uma única tabela Wdata e a atualização de conexões em uma única planilha, o processo pode ser expandido para incluir várias tabelas e planilhas, bastando adicionar o ID exclusivo da tabela ou planilha à planilha de controle.

• Navegue até a plataforma Workiva para criar uma nova planilha
• Clique em Create e selecione Spreadsheet
• Nomeie a planilha: Planilha de controle CLP
  • Nomeie a primeira planilha: Folha de controle primário
• Na Planilha de controle primário, crie os seguintes cabeçalhos
  • ActiveFlag
    • Esta coluna especifica se o fluxo de trabalho precisa ser executado para essa linha na planilha de controle
  • Nome do arquivo
    • Essa coluna indica o nome do conjunto de dados como ele aparecerá na tabela Wdata
  • TableID
    • ID da tabela em Wdata na qual os dados serão carregados
  • SpreadsheetID
    • ID da planilha onde os dados serão atualizados
  • FileLocation
    • Localização do arquivo que será baixado
• Preencha a Planilha com os seguintes valores, preenchendo a coluna <TableID> com o ID da Tabela de Detalhes do Funcionário do CLP e a coluna <SpreadsheetID> com o ID da Planilha de Visão Geral do Funcionário do CLP, esses IDs foram criados em Connected Learning Paths anteriores, consulte os pré-requisitos para ver os Connected Learning Paths necessários.
  • Consulte este documento para obter ajuda para encontrar os IDs

ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

Etapa 2: Atualizar as permissões da planilha

Para garantir uma comunicação eficaz entre um comando Workiva e uma planilha, a concessão de API gerada deve estar associada a um usuário que possua permissões de proprietário ou editor na planilha.

• Na planilha de controle CLP Spreadsheet, clique em File na faixa de opções na parte superior
• Clique em Permissions (Permissões) e, em seguida, em Spreadsheet (Planilha)
  • Forneça acesso a qualquer usuário da Workiva que esteja associado ao API Grant configurado na Workiva Connection

Etapa 3: Criar uma corrente

Para usar as variáveis que criamos na planilha de controle, criaremos uma cadeia que lê a partir dela. Como sempre usaremos a mesma planilha e folha, configuraremos variáveis de cadeia para armazenar esses detalhes para acesso consistente.

• Navegue até o Criador de cadeias
• Crie uma nova cadeia
  • Nomeie a cadeia: CLP | Leitura de 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 como a seguir:
  • Variável 1:
    • Tipo: Variável em cadeia (cv)
    • Nome: cv-ID da planilha de controle
    • Valor: insira o ID da planilha de controle do CLP
      • Para encontrar o ID da planilha, acesse CLP Control Sheet Spreadsheet
        • No URL, selecione o ID da planilha, que se encontra depois de "spreadsheet/" e antes de "/sheet"
        • Por exemplo, a ID da planilha está em negrito aqui: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13 
  • Variável 2:
    • Tipo: Variável em cadeia (cv)
    • Nome: cv-Nome da planilha de controle
    • Valor: Folha de controle primária
• Salvar a corrente

Etapa 4: obter dados da planilha

Usamos o comando Get Sheet Data para iniciar a cadeia. Isso nos permite recuperar informações da planilha de controle para alimentar a cadeia.

• Adicione um comando Get Sheet Data do conector Workiva à área de início da cadeia
• Clique duas vezes no comando 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 (Cadeia)
    • 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 cv-Control Sheet Name Chain Variable 
  • Region: sinta-se à vontade para especificar uma região. Se você deixar como ":", o comando recuperará os dados de toda a planilha
• Salvar o comando

Etapa 5: Teste o exercício

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

• Publicar a cadeia
• Clique em Executar e selecione Run Chain
• Quando a cadeia for concluída, clique no nó Get Sheet Data para verificar o sucesso
  • O comando deve fornecer uma saída .csv dos dados na planilha especificada dentro da planilha; você verá o .csv clicando no ícone de olho

Saiba mais sobre o uso de planilhas de controle concluindo o próximo caminho: Usando valores de uma planilha de controle!