Centro de suporte da Workiva

O comando "Convert XLSX to CSV" da Tabular Transformation foi descontinuado em novembro de 2023 e substituído pelo comando "Worksheet to CSV" do conector do Microsoft Excel. Embora o comando mais antigo ainda possa ser usado, ele é menos estável e pode falhar ao lidar com arquivos maiores.

O artigo a seguir mostrará a você como atualizar as cadeias existentes para usar o comando Worksheet to CSV.

Observação: O comando "Convert XLSX to CSV" suporta um tamanho máximo de arquivo de 120mb.

Antes de você começar

• O conector Microsoft Excel deve estar ativado em seu espaço de trabalho. Esse conector principal está incluído na sua assinatura e está disponível para todos os usuários. Se ainda não tiver sido adicionado, peça a um administrador da organização que siga as etapas listadas neste artigo.

Atualize sua cadeia

Para atualizar os comandos em sua cadeia, você desconectará o comando "Convert XLSX to CSV" e inserirá o comando "Worksheet to CSV" em seu lugar. Em seguida, você pode copiar as entradas do nó antigo e colá-las no novo.

1. Faça login em Chain Builder.
2. Vá para a guia Chains device_hub e clique em Edit create à direita para a cadeia que você precisa atualizar.
3. Localize o comando Convert XLSX to CSV em sua tela de cadeia. Clique duas vezes no primeiro link que conecta esse comando ao restante da cadeia.
   
4. Clique em Delete para remover o link.
   
5. Repita a etapa anterior no outro lado do nó. O comando "Convert XLSX to CSV" deve ser desconectado do restante da cadeia.
6. Arraste o comando desconectado Convert XLSX to CSV para a lateral da tela.
   
   

   Observação: Uma vez desconectado, esse comando não será mais executado. No entanto, o manteremos na tela como ponto de referência para o novo comando.

7. No painel Nós, no lado esquerdo, procure o comando Worksheet to CSV. 
8. Arraste e solte-o no espaço da tela.
   
9. Reconecte a cadeia arrastando os links para o novo comando Worksheet to CSV.
   
10. Passe o mouse sobre o comando Worksheet to CSV e clique em Edit create.
    
11. Digite os detalhes de sua planilha do Excel; você pode abrir o comando órfão "Convert XLSX to CSV" em sua tela para obter esses detalhes. O novo comando e o antigo usam campos quase idênticos.
    

    Propriedade	Detalhes
    Arquivo de pasta de trabalho	Insira a pasta de trabalho XLS ou XLSX com a planilha a ser convertida em um arquivo tabular. Observação: Isso equivale ao campo "Input files" (Arquivos de entrada) do comando Convert XLSX to CSV (Converter XLSX em CSV).
    Senha	Se o arquivo da pasta de trabalho for uma pasta de trabalho XLSX protegida por senha, digite a senha. Nota: Esse campo não está disponível no comando "Convert XLSX to CSV"; com essa atualização, você agora pode usar pastas de trabalho seguras.
    Delimitador	Selecione o delimitador a ser usado no arquivo de saída.
    Nome da planilha	Digite o nome da planilha na pasta de trabalho a ser convertida. Para identificar a planilha por seu índice, deixe em branco.
    Índice da planilha	Insira a posição do índice da planilha na pasta de trabalho a ser convertida, com 1 para a primeira planilha e -1 para a última. Para identificar a planilha por seu nome, deixe em branco.
    Célula inicial	Insira a célula na primeira linha e na primeira coluna dos dados da planilha a serem convertidos.
    Coluna final	Na notação A1, digite a letra da coluna - como A, B ou C, sem o número da linha - onde os dados a serem convertidos terminam. Nota: O comando ignora todos os dados da planilha após essa coluna.
    Fim da linha	Na notação A1, digite o número da linha - por exemplo, 10, 200, 3000, sem a letra da coluna - em que os dados a serem convertidos terminam. Para ignorar a linha, digite 0. Observação: O comando ignora todos os dados da coluna após essa linha.
    Usar valores de célula formatados	Para converter os valores de exibição das células em vez de seus valores brutos, como no caso de manipulação de data/hora, marque esta caixa. Observação: Esse campo não está disponível no comando "Convert XLSX to CSV"; com essa atualização, agora você pode extrair uma fórmula (=SUM(A1:A23)) ou o valor real (1234.56)
    Prévia dos resultados	Para ativar uma visualização do arquivo de saída, marque essa caixa.
    Modo de streaming	Ative essa configuração para arquivos com mais de 25 MB.Lê o arquivo em janelas menores de dados para reduzir o uso da memória.Algumas fórmulas, especialmente as que fazem referência a células mais distantes no arquivo, podem não funcionar corretamente quando essa configuração é ativada em conjunto com a opção de valores formatados.

12. Clique em Save para concluir.

Depois de salvar, publique e execute sua nova cadeia. 

Comparação de recursos

Esses dois comandos são praticamente idênticos em suas entradas e funções, e recomendamos que você copie os valores do comando existente para o novo. A tabela a seguir mostra as entradas equivalentes para ambos os comandos.

Observe que duas entradas adicionais estão incluídas no comando "Worksheet to CSV":

• Senha: Permite que você forneça pastas de trabalho seguras.
• Células formatadas: Permite que você extraia uma fórmula (=SUM(A1:A23)) ou o valor real (1234.56)

Solução de problemas

Se o comando Worksheet to CSV não converter nenhum dado:

• Verifique o nome ou o índice da planilha na pasta de trabalho da qual você deseja extrair os dados.
• Certifique-se de que o intervalo de células na planilha - com base nas propriedades do comando Start cell, End column e End row - contenha dados.