Ir para o conteúdo

Palavras-chave de Nome de Arquivo

Introdução

Palavras-chave de nome de arquivo são usadas para gerar nomes de arquivos exclusivos para campos configuráveis que usam nomes de arquivos como entrada. Os campos que especificam nomes de arquivos estão disponíveis ao configurar origens e destinos baseados em arquivo.

Palavras-chave Disponíveis

Essas palavras-chave estão disponíveis para uso em campos configuráveis para nomes de arquivos que permitem o uso de uma variável. Conforme mostrado abaixo em Palavras-chave do nome do arquivo de entrada, você pode testar sua disponibilidade inserindo um único colchete esquerdo]([); se aparecer uma lista suspensa de palavras-chave e variáveis, as palavras-chave aparecerão no topo e poderão ser usadas. As substituições de palavras-chave não diferenciam maiúsculas de minúsculas: [TIME] e [Time] são equivalentes a [time].

Esta lista mostra as palavras-chave disponíveis e o que elas substituem:

Palavra-chave Substituição
[date] Substituído pela data atual no formato YYYY-Mon-DD.
[ext] Substituído pela extensão do arquivo, se houver, conforme definido ao usar uma origem de tipo de arquivo. Consulte Aviso abaixo desta tabela.
[file] Substituído pelo nome do arquivo base (ou seja, excluindo a extensão do arquivo, se houver), conforme definido ao usar uma origem de tipo de arquivo. Consulte Aviso abaixo da tabela.
[sequence] Substituído pela sequência do arquivo: 1 para o primeiro, 2 para o segundo e assim por diante. Semelhante às funções Jitterbit SourceInstanceCount() e TargetInstanceCount().
[time] Substituído pela hora atual no formato HHMMSS.
[unique] Substituído por um GUID, um identificador exclusivo aleatório.

Aviso

Como as palavras-chave usam a mesma sintaxe das variáveis globais e do projeto, depois de usar uma palavra-chave e salvar o item do projeto, ele aparecerá na lista de variáveis globais do seu projeto e como uma entrada duplicada na lista suspensa. Também é possível criar diretamente uma variável global ou de projeto que tenha o mesmo nome e terminar com entradas adicionais na lista suspensa. Como isso pode causar confusão, recomendamos não criar variáveis globais ou de projeto que tenham o mesmo nome dessas palavras-chave. As palavras-chave substituirão quaisquer variáveis com o mesmo nome quando o item do projeto for avaliado.

Observe que [file] e [ext] são definidos na fonte e estão disponíveis como variáveis $file e $ext respectivamente. Entretanto, o uso pretendido está nos nomes de arquivos de um destino e eles não devem ser lidos diretamente das variáveis globais. A variável Jitterbit $jitterbit.source.filename fornece o nome completo do arquivo, é definido com cada invocação de origem e pode ser usado em seu lugar.

Use Palavras-chave de Nome de Arquivo em Telas de Definição

Durante a configuração de origens e destinos, você pode usar substituições de palavras-chave de nome de arquivo em determinados campos que possuem entrada de texto. As substituições de palavras-chave devem ser usadas em campos configuráveis que usam nomes de arquivos como entrada. Embora você possa usar qualquer uma dessas palavras-chave em fontes ou destinos, elas só funcionam em determinados usos e contextos. Nestes locais, você pode usar palavras-chave de nome de arquivo:

Fontes

  • Para fontes de compartilhamento de arquivos, site FTP, armazenamento temporário e arquivo local:

    • Arquivo de gatilho (caminho absoluto do arquivo)
    • Após o processamento (renomear arquivo)

  • Para fontes de site FTP, armazenamento temporário e arquivo local:

    • Pasta de sucesso/erro (pasta de sucesso/erro no caminho absoluto)

Alvos

  • Para destinos de compartilhamento de arquivos, site FTP e armazenamento temporário:

    • Nome(s) de arquivo(s)
    • Compressão (nome(s) de arquivo(s) no arquivo)

  • Para destinos de site FTP e arquivo local:

    • Pasta de sucesso/erro (pasta de sucesso/erro no caminho absoluto)

Consulte a seção abaixo Limitações para as restrições atuais na implementação de palavras-chave de nome de arquivo.

Palavras-chave de Nome de Arquivo de Entrada

Para usar uma palavra-chave junto com outra entrada de campo, incluindo outras palavras-chave ou variáveis, insira um colchete aberto ([) para o campo. Na lista, passe o mouse sobre o nome da palavra-chave para visualizar informações sobre ela. Selecione uma palavra-chave para inseri-la no local do cursor, em qualquer lugar da string:

exemplo de pasta de erro de sucesso

As variáveis inseridas através deste método são exibidas como texto entre colchetes [ ] dentro do campo. Insira qualquer entrada adicional ou adicione várias palavras-chave e variáveis usando o mesmo método descrito acima:

exemplo de nome de arquivo

Tutoriais Sobre Palavras-chave de Nome de Arquivo

Consulte estas seções para obter detalhes sobre o uso de palavras-chave de nome de arquivo em seus projetos:

Limitações e Soluções Alternativas

Ao usar palavras-chave de nome de arquivo nos campos Arquivo de acionamento ou Pasta de sucesso/erro, uma limitação é que as palavras-chave não são resolvidas ao usar o arquivo de acionamento ou ao criar o arquivo de sucesso ou de erro, respectivamente.

Por exemplo, se você tiver um arquivo de origem chamado customers.csv e a data atual é 2 de outubro de 2019, você pode tentar usar uma combinação de palavras-chave como esta para definir o nome do arquivo de destino:

[file]_[date].csv

Com este exemplo, se as palavras-chave do nome do arquivo fossem resolvidas, você esperaria que o resultado fosse um arquivo nomeado com sucesso, com o sublinhado e o carimbo de data/hora finais sendo adicionados pela funcionalidade Success/Error Folder, como:

customers_2019-10-02.csv-_2019-10-02_02-02-54-525

No entanto, como as palavras-chave do nome do arquivo não são resolvidas, o resultado real será, incluindo as palavras-chave não resolvidas ainda entre colchetes, como:

[file]_[date].csv_2019-10-02_02-02-54-525

Uma solução alternativa é usar uma variável global em vez de palavras-chave de nome de arquivo para o nome de arquivo de destino:

  1. Crie uma variável global em uma condição adicionada a um nó de destino da transformação e defina essa variável global para especificar o nome do arquivo de origem.

    Neste exemplo, foi criado um nome de arquivo que usa o nome do arquivo de origem e a hora atual, em UTC:

    <trans>
If(SourceInstanceCount() == 1,
  $filename_target = $jitterbit.source.filename + "_";
  $filename_target += Replace(GetUTCFormattedDateTime(Now(), "UTC", false), ":", "-");
);
true;
</trans>

  2. Use a variável global (no exemplo, filename_target) como o nome do arquivo de destino no campo Success/Error Folder:

    [filename_target].csv

    A variável global será resolvida corretamente para o arquivo de sucesso ou erro, respectivamente, conforme necessário.

Nota

Da mesma forma, com um Arquivo Trigger de origem, o uso de palavras-chave de nome de arquivo não será resolvido corretamente em um nome de arquivo. Como solução alternativa, use uma variável global definida com um valor apropriado.

Exemplos de Palavras-chave de Nome de Arquivo

  1. Um alvo que usa o [date] e [time] variáveis de palavra-chave para criar um nome de arquivo exclusivo sempre que o destino for usado:

    exemplo de destino 1

  2. Este exemplo mostra a adição ao [date] e [time] variáveis de palavra-chave do exemplo anterior o arquivo [file] e extensão [ext] da fonte no nome do arquivo criado:

    exemplo de destino 2