Para gerenciar pastas de trabalho do Microsoft Excel® como parte de uma cadeia, adicione uma etapa que inclua um comando de conexão do Microsoft Excel.
Observação: O conector do Microsoft Excel oferece suporte a arquivos de pasta de trabalho do Excel (XLSM) habilitados para macro, mas não executa macros do Virtual Basic for Applications (VBA) nem macros baseadas em eventos, como Workbook Open, BeforeSave ou SheetCalculate.
Para habilitar esses comandos, um administrador de TI primeiro cria um conector do Microsoft Excel.
Criar pasta de trabalho a partir de arquivos
Para criar ou atualizar uma pasta de trabalho do Excel com planilhas baseadas em dados de arquivos de valores separados por delimitadores, use o comando Create Workbook from Files.
Observe que você tem duas opções de saída com base em como o conector está configurado:
- Se você estiver usando um GroundRunner, insira um objeto Javascript Object Notation (JSON).
- Se você estiver usando um CloudRunner, especifique as saídas de comando ou os recursos dentro da cadeia.
Propriedades
| Propriedade |
Detalhes |
| Arquivos |
Especifique os arquivos a serem criados como planilhas separadas na pasta de trabalho:
- Para arquivos baseados em saídas ou recursos dentro da cadeia, clique em Adicionar para cada arquivo, selecione a saída ou o recurso e digite o nome da planilha (até 31 caracteres).
Dica: Para recuperar um arquivo de um local de rede, use o conector File Utilities 's Get file comando anteriormente na cadeia.
- Para especificar os arquivos como JSON, selecione Habilite a variável e insira o JSON ou selecione o objeto JSON da saída de um comando anterior. Formate o JSON como:
[
{"file": "fullPathToFile_1", "name": "sheetName_1"},
{"file": "fullPathToFile_2", "name": "sheetName_2"}
] Nota: Para incluir um arquivo de saída de comando anterior no JSON, digite o caminho completo para seu local na pasta de processamento do GroundRunner.
|
| Delimitador |
Selecione o delimitador usado nos arquivos. |
| Nome dos Workbooks |
Para criar uma nova pasta de trabalho com base nos arquivos, digite um nome exclusivo para ajudar a identificá-la. Observação: O comando cria automaticamente anexa uma extensão .xlsx se não for fornecida. |
| Pasta de trabalho existente |
Para adicionar os dados dos arquivos a uma pasta de trabalho existente, e não a uma nova, selecione o arquivo da pasta de trabalho a ser atualizado. Qualquer planilha com um nome inserido em Files será substituída. Importante: Ao usar esse comando em um arquivo protegido, a pasta de trabalho resultante não será protegida. Isso significa que você deve reinserir manualmente a criptografia ao trabalhar com um arquivo protegido. |
Saídas
| Saída |
Tipo de saída |
| Pasta de trabalho XLSX |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Comando bem-sucedido |
| 1 |
Erro |
Falha geral |
Folhas de listagem
Para criar uma lista JSON de todas as planilhas em uma pasta de trabalho do Excel, use o comando List Sheets.
Propriedades
| Propriedade |
Detalhes |
| Arquivo de pasta de trabalho |
Digite a pasta de trabalho XLS ou XLSX para listar as planilhas de. |
| Senha |
Se o arquivo Workbook for uma pasta de trabalho XLSX protegida por senha, digite a senha. |
Saídas
| Saída |
Tipo de saída |
| Planilhas JSON |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Comando bem-sucedido |
| 1 |
Erro |
Falha geral |
Planilha para CSV
Para converter os dados da planilha de uma pasta de trabalho do Excel em um arquivo tabular, use o comando Worksheet to CSV.
Observação: O comando Worksheet to CSV extrai os últimos valores calculados na planilha; nenhum cálculo de fórmula é executado para atualizar os valores. Em planilhas com cálculos automáticos desativados, calcule e salve manualmente os valores antes da execução da cadeia para garantir a precisão.
Propriedades
| Propriedade |
Detalhes |
| Arquivo de pasta de trabalho |
Digite a pasta de trabalho XLS ou XLSX com a planilha a ser convertida em um arquivo tabular. |
| Senha |
Se o arquivo Workbook for uma pasta de trabalho XLSX protegida por senha, digite a senha. |
| 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, por exemplo, para tratamento de data/hora, marque essa caixa. |
| Prévia dos resultados |
Para ativar uma visualização do arquivo de saída, marque essa caixa. |
| Modo de streaming |
Aplicável somente a arquivos XLSX grandes.Recomendado para arquivos com mais de 20 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. |
Saídas
| Saída |
Tipo de saída |
| Saída de CSV |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Comando bem-sucedido |
| 1 |
Erro |
Falha geral |