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. Isso inclui determinados campos disponíveis ao configurar endpoints usando conectores. Palavras-chave de nome de arquivo são um dos tipos de elementos de dados globais disponíveis no Harmony. Os outros tipos de elementos de dados globais — variáveis de projeto, variáveis globais e variáveis Jitterbit — também estão disponíveis globalmente em todo o projeto. Elas são definidas de forma diferente, conforme descrito em Variáveis do Projeto, Variáveis globais e Variáveis Jitterbit, respectivamente. No entanto, como todos os elementos de dados globais partilham o mesmo espaço de nomes, os seus nomes devem ser exclusivos quando comparados com todos os outros elementos de dados globais.

Palavras-chave Disponíveis¶

As palavras-chave listadas na tabela abaixo estão disponíveis para uso em determinados campos nas telas de configuração do endpoint. As palavras-chave não diferenciam maiúsculas de minúsculas. Por exemplo, [time] é equivalente a [TIME] e [Time].

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. O uso pretendido desta palavra-chave está em um campo de nome de arquivo de destino do tipo de arquivo.
`[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. O uso pretendido desta palavra-chave está em um campo de nome de arquivo de destino do tipo de arquivo.
`[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.

Dica

Observe que a variável Jitterbit jitterbit.source.filename fornece o nome completo do arquivo, é definido com cada invocação de origem e pode ser usado no lugar das palavras-chave [file] e [ext].

Use Palavras-chave de Nome de Arquivo nas Telas de Configuração¶

Durante a configuração de endpoints usando conectores, você pode usar substituições de palavras-chave de nome de arquivo em determinados campos que possuem um ícone de variável . Palavras-chave de nome de arquivo podem ser usadas em campos junto com outras entradas, inclusive com outras palavras-chave ou variáveis. Essas seções são abordadas abaixo:

Campos onde palavras-chave podem ser usadas
Selecione uma palavra-chave para o nome do arquivo
Alternar formatos entre comprimido e texto
Remover uma palavra-chave de nome de arquivo

Aviso

Como palavras-chave usam a mesma sintaxe que global e variáveis do projeto, é possível criar uma variável global ou de projeto que tenha o mesmo nome. 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 substituem quaisquer variáveis de mesmo nome quando o componente do projeto é avaliado.

Campos Onde Palavras-chave Podem Ser Usadas¶

As substituições de palavras-chave devem ser usadas em campos configuráveis que usam nomes de arquivos como entrada. Isso inclui determinados campos disponíveis durante a configuração do endpoint dos conectores listados abaixo.

Ler Atividades¶

Configurações opcionais: após o processamento > Renomear arquivo (Compartilhamento de arquivo, FTP, Armazenamento temporário e Armazenamento local Leia atividades)
Configurações opcionais: Acionar arquivo > Caminho absoluto do arquivo (Compartilhamento de arquivo, FTP, Armazenamento temporário e Armazenamento local Leia atividades)
Configurações opcionais: Pasta de sucesso/erro > Pasta de sucesso no caminho absoluto e Pasta de erro no caminho absoluto (FTP e Armazenamento local Leia atividades)

Escrever Atividades¶

Nome(s) de arquivo (Compartilhamento de arquivo, FTP, Armazenamento temporário e Armazenamento local Escrever atividades)
Configurações opcionais: Compressão > Nome(s) de arquivo(s) no arquivo (Compartilhamento de arquivo, FTP, Armazenamento temporário e Armazenamento local Escrever atividades)
Configurações opcionais: Pasta de sucesso/erro > Pasta de sucesso no caminho absoluto e Pasta de erro no caminho absoluto (FTP e Armazenamento local Escrever atividades)

Nota

Uma restrição ao uso de palavras-chave de nome de arquivo em Trigger File e Success/Error Folder é descrita posteriormente nesta página em Limitações e soluções alternativas.

Selecione uma Palavra-chave de Nome de Arquivo¶

Para acessar palavras-chave de nome de arquivo, você pode clicar no ícone de variável ou insira um colchete aberto [ para exibir uma lista de palavras-chave e variáveis.

Dentro da lista, a palavra-chave ou tipo de variável é indicada pelo ícone próximo ao seu nome:

para palavra-chave de nome de arquivo
para variável global
para variável do projeto
para variável Jitterbit

Na lista, passe o mouse sobre o nome da palavra-chave para visualizar informações sobre ela:

O Valor que aparece no pop-up de informações está sempre vazio para uma palavra-chave de nome de arquivo. Um valor padrão para uma palavra-chave filename não pode ser definido em um campo de configuração.

Selecione uma palavra-chave para adicionar ao campo no local do cursor, em qualquer lugar da string. A variável é exibida em formato de comprimido semelhante ao mostrado abaixo:

Para revisar informações sobre a palavra-chave, passe o mouse sobre o quadro de palavras-chave:

Alternar Formatos Entre Comprimido e Texto¶

Para alterar o formato padrão do bloco de palavras-chave para formato de texto, clique no ícone de recolhimento :

Isso alterna a exibição do formato de comprimido para um formato de texto, com o nome da variável entre colchetes [ ]:

Para mudar de um formato de texto para o formato de comprimido, mude o foco do campo, clicando em outro campo configurável. A entrada do campo retorna automaticamente ao formato de comprimido padrão.

Remover uma Palavra-chave de Nome de Arquivo¶

Para remover uma palavra-chave de nome de arquivo, clique no ícone de remoção :

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, digamos que você tenha 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 foram resolvidas, você pode esperar que o resultado seja um arquivo de sucesso com nome semelhante a este, com o sublinhado e o carimbo de data/hora finais sendo adicionados pela funcionalidade Pasta de sucesso/erro:

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

No entanto, como as palavras-chave de nome de arquivo não são resolvidas, o resultado real é algo assim, incluindo as palavras-chave não resolvidas ainda entre colchetes:

[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:

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>
```
Use a variável global (no exemplo, chamada filename_target) como o nome do arquivo de destino no campo Pasta de sucesso/erro.

A variável global é resolvida corretamente para o arquivo de sucesso ou erro, respectivamente.

Nota

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