Com uma solução conectada à Workiva, há várias maneiras de atualizar os dados em uma planilha da Workiva. Ao usar o Wdata, uma conexão de entrada pode ser criada para atualizar os dados em uma planilha a partir de uma consulta Wdata. Neste artigo, exploraremos o uso de cadeias para atualizar dados em uma planilha usando os comandos Write Sheet Data e Overwrite Sheet Data.
Entradas de comando comuns
Os comandos Write Sheet Data e Overwrite Sheet Data têm várias entradas que são as mesmas em ambos os comandos.
| Entrada | Finalidade |
| ID da planilha | O ID da planilha da Workiva na qual os dados serão gravados. |
| ID/nome da planilha |
O nome ou ID da planilha dentro da planilha na qual os dados são gravados. Os nomes são CASE-SENSITIVE. |
| Arquivo de dados |
O arquivo que contém dados delimitados que devem ser gravados na planilha. CSV é o formato de arquivo mais comum, mas há suporte para outros delimitadores. Os dados JSON devem ser convertidos em um formato delimitado para que você possa usar esse comando. |
| Delimitador |
O delimitador de arquivo. A vírgula (,) é a mais comum, mas qualquer delimitador é compatível, inclusive ponto e vírgula (;), pipe (|) ou tabulação (\t). Certifique-se de que os campos cujos dados contenham o delimitador especificado estejam entre aspas duplas. Por exemplo, em um arquivo delimitado por vírgulas: Workiva, "Ames, IA, USA",WK |
| Região (Write Sheet Data) / Start Cell (Overwrite Sheet Data) |
O endereço inicial da célula em que os dados serão gravados. Informações adicionais sobre valores válidos de são encontradas na seção específica de cada comando abaixo. |
| Use async |
Quando marcado, o Command executará uma atualização assíncrona da planilha. Isso significa que a cadeia prosseguirá para a próxima operação enquanto a operação de atualização da planilha ainda estiver sendo executada na plataforma. Essa opção é recomendada para grandes conjuntos de dados, mas somente se as operações em cadeia subsequentes não dependerem da atualização da planilha. |
| Usar a API da plataforma |
Quando marcada, o Command usa a API da plataforma para realizar a atualização, em vez da API herdada da planilha. A API da plataforma é recomendada, pois é a mais nova das APIs e continua a ser aprimorada com recursos adicionais. |
Gravar dados da planilha
O comando Write Sheet Data é mais bem utilizado quando você precisa atualizar regiões específicas em uma planilha e, ao mesmo tempo, preservar dados em outras regiões da planilha. A tabela a seguir descreve o comportamento de limpeza para cada formato de região especificado.
| Formatação | Exemplo | Efeito |
| Endereço de célula única | B2 |
Atualize uma única célula na planilha, nenhum outro valor de célula será afetado. Esse formato é e não recomendado, a menos que você esteja gravando um único valor de célula. Se o arquivo de dados contiver mais de um único ponto de dados, o comando falhará quando você usar esse formato. |
| Endereço inicial da célula, sem célula ou coluna final | B2: |
Atualizar a planilha que começa no endereço da célula inicial. Os valores da planilha à esquerda (coluna) e acima (linha) do endereço da célula inicial são preservados; todos os outros valores são apagados, mesmo que o arquivo de dados não contenha valores de célula na linha ou na coluna. |
| Endereço inicial da célula, coluna final sem linha final | B2:D |
Atualizar a planilha que começa no endereço da célula inicial. Os valores da planilha à esquerda (coluna) e acima (linha) do endereço inicial da célula são preservados; todos os outros valores são apagados, mesmo que o arquivo de dados não contenha valores de célula na linha ou na coluna. |
| Endereço inicial da célula, endereço final da célula | B2:D5 |
Substitui todas as células dentro do intervalo especificado. Nota: Se o intervalo especificado no comando for menor (menos linhas ou colunas) do que o arquivo de dados que está sendo carregado, o comando falhará. |
Sobrescrever dados da planilha
O comando Sobrescrever dados da planilha é mais bem utilizado quando você precisa limpar um bloco inteiro em uma planilha. A tabela a seguir descreve o comportamento de limpeza para cada formato de célula inicial especificado.
| Formatação | Exemplo | Efeito |
| Endereço de célula única | B2 |
Os valores da planilha à esquerda (coluna) e acima (linha) do endereço de célula inicial são preservados; todos os outros valores da planilha são apagados e os dados do arquivo de dados são gravados a partir do endereço de célula especificado. |
| Endereço inicial da célula, sem célula ou coluna final | B2: |
Os valores da planilha à esquerda (coluna) e acima (linha) do endereço de célula inicial são preservados; todos os outros valores da planilha são apagados e os dados do arquivo de dados são gravados a partir do endereço de célula especificado. |
| Endereço inicial da célula, coluna final sem linha final | B2:D |
Esse formato é compatível com e não e resultará em um erro de execução do comando. |
| Endereço inicial da célula, endereço final da célula | B2:D5 |
Os valores da planilha à esquerda (coluna) e acima (linha) do endereço de célula inicial são preservados; todos os outros valores da planilha são apagados e os dados do arquivo de dados são gravados a partir do endereço de célula especificado. A largura (colunas) e a altura (linhas) do arquivo de dados são irrelevantes. |
Experimente
Foram criados um modelo de cadeia e uma planilha de teste que permitem que você veja os resultados de cada um dos formatos Start Cell/Region acima. Para testar:
- Faça o download da planilha de teste deste link (25 KB) e importe-a para o seu espaço de trabalho.
- Crie uma cadeia de testes utilizando o modelo Use Chains para atualizar uma planilha da Workiva encontrado em 4. Guias de início rápido -> Exemplos de ativação e uso Pasta de modelos.
- Recomenda-se que você mapeie a Spreadsheet ID Template Variable como uma Chain Variable.
- Atualize o ID da planilha Variável de cadeia antes de executar a cadeia em seu espaço de trabalho.
- Certifique-se de que o usuário na conexão Workiva Chains tenha o escopo file:write e que o usuário tenha sido atribuído à planilha importada.
- Execute a cadeia e analise os resultados. Os resultados esperados estão descritos na planilha Expected Results da planilha importada.