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
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.