Para acessar e trabalhar com arquivos nos sistemas operacionais baseados em Microsoft Windows® e Linux® como parte de uma cadeia, adicione uma etapa com um comando de conexão do File Utilities.
Para habilitar esses comandos, um administrador de TI primeiro cria uma conexão do File Utilities.
Quebras de linha limpas
Para remover quebras de linha extras das células de um arquivo tabular, como em uma saída de um sistema para fazer upload para outro, use o comando Clean Line Breaks .
Propriedades
| Propriedade |
Detalhes |
| Arquivo de origem |
Insira o arquivo tabular com as linhas quebradas a serem limpas. |
| Delimitador |
Selecione o delimitador usado em Arquivo de origem. |
Saídas
| Saída |
Tipo de saída |
| Arquivo limpo |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
O comando falhou |
Cópia
Para copiar arquivos e diretórios, use o comando Copy .
Propriedades
| Propriedade |
Detalhes |
| Fonte |
Digite o nome dos arquivos ou diretórios a serem movidos. Para corresponder a vários arquivos ou diretórios, use os caracteres curinga * ou ?. |
| Destino |
Digite o novo local do arquivo ou diretório. |
| Sobrescrever |
Para substituir os arquivos existentes, marque essa caixa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 14 |
Erro |
Arquivo de origem não encontrado |
| 15 |
Erro |
Falha ao gravar o arquivo de destino |
| 16 |
Erro |
Não foi possível gravar o arquivo de destino porque outro arquivo tem o mesmo nome |
Criar arquivo
Para criar um novo arquivo, use o comando Create File .
Propriedades
| Propriedade |
Detalhes |
| Texto |
Digite o texto a ser adicionado ao arquivo. |
| Caminho do arquivo |
Insira o caminho para onde criar o arquivo. Opcional se estiver usando o arquivo como saída para outro comando na cadeia. |
| Sobrescrever |
Para substituir outro arquivo existente no caminho do arquivo, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Arquivo criado |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 15 |
Erro |
Destino inválido |
| 16 |
Erro |
Não foi possível gravar o arquivo de destino porque outro arquivo tem o mesmo nome |
Excluir
Para excluir arquivos ou diretórios, use o comando Delete .
Propriedades
| Propriedade |
Detalhes |
| Nome do arquivo |
Digite o nome dos arquivos ou diretórios a serem excluídos. Para corresponder a vários arquivos ou diretórios, use os caracteres curinga * ou ?. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 14 |
Erro |
Não foram encontrados arquivos para excluir |
| 17 |
Erro |
Falha ao excluir os arquivos especificados |
Excluir diretório
Para excluir um ou mais diretórios, use o comando Delete directory .
Propriedades
| Propriedade |
Detalhes |
| Caminho |
Digite o nome dos diretórios a serem excluídos. Para corresponder a vários diretórios, use os caracteres curinga * ou ?. |
| Recursivo |
Para excluir recursivamente arquivos ou pastas no diretório, marque essa caixa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 17 |
Erro |
Falha ao excluir o diretório especificado |
Localizar
Para pesquisar uma cadeia de texto em um arquivo ou conjunto de arquivos, use o comando Find .
Propriedades
| Propriedade |
Detalhes |
| Arquivos |
Digite o arquivo ou conjunto de arquivos a serem pesquisados. |
| Padrão |
Digite a cadeia de texto a ser encontrada. |
| Sintaxe do padrão |
Selecione se deseja usar uma correspondência exata ou a sintaxe de expressão regular (regex) para o padrão.
|
| Diferença entre maiúsculas e minúsculas |
Para considerar o caso dos caracteres ao pesquisar o padrão, marque essa caixa. |
| Inversa |
Para localizar todas as linhas que não correspondem ao padrão, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Resultados do arquivo |
Arquivo |
| Contagem de linhas de resultados |
Inteiro |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 2 |
Erro |
Falha na tarefa |
| 14 |
Erro |
Arquivo não encontrado |
| 18 |
Erro |
Padrão não encontrado |
Localizar e substituir
Para localizar e substituir em um arquivo, use o comando Find and Replace .
Propriedades
| Propriedade |
Detalhes |
| Fonte |
Digite o nome do arquivo a ser pesquisado. |
| Destino |
Especifique se a saída será o arquivo original ou uma cópia:
- Para gerar o arquivo original com seus valores de coluna atualizados, insira o mesmo arquivo como Source.
- Para gerar uma cópia do original com os valores atualizados da coluna, digite o nome do novo arquivo.
|
| Sobrescrever |
Para substituir um arquivo de destino existente, marque essa caixa. |
| Localizar |
Digite a cadeia de texto a ser encontrada. |
| Substituir |
Digite a cadeia de texto a ser inserida nos locais correspondentes. |
| Localizar sintaxe |
Selecione se deseja usar a correspondência exata ou a sintaxe de expressão regular (regex) para Find. |
| Diferença entre maiúsculas e minúsculas |
Para considerar o caso dos caracteres ao pesquisar o padrão Find , marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Resultado substituído |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 2 |
Erro |
Falha na tarefa |
| 14 |
Erro |
Arquivo não encontrado |
| 15 |
Erro |
Destino inválido |
| 16 |
Erro |
Erro de substituição |
| 18 |
Erro |
Padrão não encontrado |
Obter arquivo
Para recuperar um arquivo do sistema de arquivos local, use o comando Get File .
Propriedades
| Propriedade |
Detalhes |
| Arquivo de entrada |
Digite o arquivo a ser recuperado e criado como saída. |
| Tipo de dados |
Selecione o tipo de conteúdo de Input File. |
Saídas
| Saída |
Tipo de saída |
| Informações do arquivo |
JSON |
| Arquivo |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
O arquivo não foi encontrado |
Obter informações de arquivo/pasta
Para recuperar as informações do sistema de arquivos de um arquivo ou pasta, use o comando Get File/Folder Info .
Propriedades
| Propriedade |
Detalhes |
| Arquivo/pasta |
Digite o arquivo ou pasta sobre o qual deseja recuperar informações. |
Saídas
| Saída |
Tipo de saída |
| Informações de arquivo/pasta |
JSON |
Por exemplo: { "absPath": "/tmp", "name": "tmp", "size": 4096, "mode": 2148532735, "modTime": "2018-09-27T19:31:52Z", "isDir": true, "exists": true }
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
Observação: Esse comando sempre é bem-sucedido. Se o arquivo ou a pasta não for encontrado, a propriedade exists será falsa.
Arquivo Gunzip
Para descompactar um arquivo GZIP usando gunzip, use um comando Gunzip File . Por exemplo, use este comando para descompactar a saída de um arquivo do site Oracle® Hyperion Financial Management (HFM).
Propriedades
| Propriedade |
Detalhes |
| Arquivo de entrada |
Digite o arquivo GZIP a ser descompactado. |
Saídas
| Saída |
Tipo de saída |
| Arquivo com gunzip |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
O comando falhou |
Arquivo Gzip
Para compactar um arquivo usando gzip, use o comando Gzip File .
Propriedades
| Propriedade |
Detalhes |
| Arquivo de entrada |
Digite o arquivo a ser compactado. |
Saídas
| Saída |
Tipo de saída |
| Arquivo compactado em Gzip |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
O comando falhou |
Diretório de listas
Para listar o conteúdo de um diretório, use o comando List Directory .
Propriedades
| Propriedade |
Detalhes |
| Caminho |
Digite o caminho do diretório a ser listado. |
| Formato de saída |
Selecione o formato da saída. Para incluir o cabeçalho e as informações de resumo, selecione Full (Completo). |
Saídas
| Saída |
Tipo de saída |
| Lista de arquivos encontrados |
Matriz |
| Arquivo de resultados |
CSV |
Observação: A saída Lista de arquivos encontrados é limitada a 500 itens; para operações maiores, a saída Arquivo de resultados deve ser usada em seu lugar.
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 14 |
Erro |
Diretório não encontrado |
Listar o conteúdo do arquivo
Para listar o conteúdo de um arquivo, use o comando List File Content .
Observação: Esse comando não pode retornar linhas individuais maiores que 64 KB.
Propriedades
| Propriedade |
Detalhes |
| Nome do arquivo |
Digite o nome do arquivo a ser inspecionado. |
| Linhas de visualização |
Para arquivos grandes, digite quantas linhas do arquivo devem ser visualizadas. Você pode definir a linha inicial para a visualização usando o campo Offset logo abaixo desse campo.
Para visualizar um arquivo, veja a saída do comando na tela do Monitor. |
| Deslocamento |
O número da linha em que a visualização deve ser iniciada. Esse valor é baseado em 0, portanto, para imprimir a partir do início do arquivo, use o valor 0. |
Exemplo
A imagem a seguir mostra 5 linhas de visualização com um deslocamento de 5. Observe que, como o deslocamento começa em 0, a primeira linha mostrada é, na verdade, 6.
Saídas
| Saída |
Tipo de saída |
| Arquivo |
Arquivo |
| Texto do arquivo |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 14 |
Erro |
Arquivo não encontrado |
| 20 |
Advertência |
O arquivo é muito grande ou não é legível por humanos |
Criar diretório
Para criar um diretório, use o comando Make Directory .
Propriedades
| Propriedade |
Detalhes |
| Diretório |
Digite o nome do diretório a ser criado. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 15 |
Erro |
Falha ao criar o diretório |
| 16 |
Advertência |
O diretório remoto já existe |
Mover
Para mover arquivos ou diretórios, use o comando Move .
Propriedades
| Propriedade |
Detalhes |
| Fonte |
Digite o nome dos arquivos ou diretórios a serem movidos. Para corresponder a vários arquivos ou diretórios, use caracteres curinga * ou ?. |
| Destino |
Digite o novo local para o arquivo ou diretório. |
| Sobrescrever |
Para substituir os arquivos existentes, marque essa caixa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 2 |
Erro |
Falha na tarefa |
| 14 |
Erro |
Arquivo de origem não encontrado |
Dividir arquivo
Para dividir um arquivo em vários pedaços com base no tamanho em bytes, na contagem de linhas ou no delimitador de expressão regular (RegExp), use o comando Split File . Por exemplo, use este comando para processar arquivos menores em paralelo para ajudar a melhorar o desempenho
Propriedades
| Propriedade |
Detalhes |
| Arquivo de entrada |
Digite o arquivo a ser dividido em vários blocos. |
| Tipo de divisão |
Selecione como dividir o arquivo de entrada por Byte, Linha ou RegExp |
| Valor |
Digite o valor pelo qual o arquivo de entrada será dividido, com base em Split type:
- Se for Byte, digite o tamanho máximo dos pedaços de arquivo.
- Se for Linha, digite o número máximo de linhas a serem incluídas em um bloco de arquivo.
- Se for RegExp, digite a expressão regular para a linha que indica quando criar um novo bloco.
|
| Incluir correspondência RegExp |
Se Split type for RegExp, selecione se deseja incluir a linha que corresponde a Value no bloco gerado. |
Saídas
| Saída |
Tipo de saída |
| Dividir pedaços de arquivos |
Arquivo |
| Número de arquivos |
Inteiro |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
Arquivos de pilha
Para empilhar vários arquivos assimétricos uns sobre os outros, use o comando Stack Files .
Observação: Com o conector Tabular Transformation, você pode usar um comando Stack Files para empilhar arquivos simétricos que tenham o mesmo número de colunas.
Propriedades
| Propriedade |
Detalhes |
| Arquivos de entrada |
Digite os arquivos a serem empilhados. |
Saídas
| Saída |
Tipo de saída |
| Arquivo empilhado |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
Linhas de tiras
Para remover linhas de um arquivo de acordo com os números de linha fornecidos, use o comando Strip Lines .
Propriedades
| Propriedade |
Detalhes |
| Arquivo de origem |
Insira o arquivo do qual as linhas serão removidas. |
| Linhas a serem removidas |
Insira uma lista das linhas a serem removidas, como linhas individuais ou intervalos. Por exemplo, um intervalo de 3:10 remove as linhas 3 a 10 do arquivo. |
Saídas
| Saída |
Tipo de saída |
| Arquivo de saída de linhas de strip |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 2 |
Erro |
Falha geral |
Alcatrão
Para criar um arquivo de fita (TAR), use o comando Tar .
Propriedades
| Propriedade |
Detalhes |
| Nome do arquivo |
Digite o nome do arquivo TAR a ser criado. |
| Arquivos de origem |
Digite o nome dos arquivos ou diretórios a serem adicionados ao arquivo TAR. Para especificar vários arquivos ou diretórios, use vírgulas ou caracteres curinga. |
| Sobrescrever |
Para substituir um arquivo TAR existente, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Arquivo TAR |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 16 |
Erro |
Falha ao criar o arquivo |
Codificação UTF-8
Para converter um arquivo a ser codificado em Unicode Transformation Format-8-bit (UTF-8), use o comando UTF-8 Encode .
Propriedades
| Propriedade |
Detalhes |
| Arquivo de origem |
Digite o nome dos arquivos ou diretórios a serem movidos. Para corresponder a vários arquivos ou diretórios, use caracteres curinga * ou ?. |
| Codificação de origem |
Digite a codificação de Source File, como uft-16 ou windows-1251. |
Saídas
| Saída |
Tipo de saída |
| Arquivo UTF-8 |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 2 |
Erro |
Falha no comando |
Untar
Para descompactar um arquivo TAR, use o comando Untar .
Propriedades
| Propriedade |
Detalhes |
| Arquivo |
Digite o nome do arquivo TAR a ser descompactado. |
| Destino |
Digite o nome do diretório no qual o arquivo será descompactado. |
| Sobrescrever |
Para substituir os arquivos existentes ao descompactar o arquivo, marque essa caixa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 2 |
Erro |
Falha ao descompactar o arquivo |
| 14 |
Erro |
Arquivo não encontrado |
| 16 |
Erro |
Erro de substituição |
Descompactar
Para descompactar um arquivo ZIP ou GZIP, use um comando Unzip .
Observação: Esse comando requer um GroundRunner.
Propriedades
| Propriedade |
Detalhes |
| Arquivo |
Digite o nome do arquivo a ser descompactado. |
| Destino |
Digite o nome do diretório no qual o arquivo será descompactado. |
| Sobrescrever |
Para substituir os arquivos existentes ao descompactar o arquivo, marque essa caixa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 2 |
Erro |
Falha ao descompactar o arquivo |
| 14 |
Erro |
Arquivo não encontrado |
| 16 |
Erro |
Erro de substituição |
CEP
Para criar um arquivo ZIP, GZIP ou GZIP+TAR, use o comando Zip .
Propriedades
| Propriedade |
Detalhes |
| Nome do arquivo |
Digite o nome do arquivo a ser criado. A extensão do arquivo determina o algoritmo de compactação:
- Para ZIP,
.zip ou .z
- Para GZIP,
.gzip ou .gz
- Para GZIP+TAR,
.tgz
|
| Destino |
Digite o nome do diretório no qual o arquivo será descompactado. |
| Sobrescrever |
Para substituir um arquivo existente, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Arquivo compactado |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 16 |
Erro |
Falha ao criar o arquivo |