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

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

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

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

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

compartilhamento de arquivo, gravação de nome de arquivo, seleção de palavra-chave

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:

compartilhamento de arquivo, gravação de pílula de nome de arquivo

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

compartilhamento de arquivo, gravação do nome do arquivo, pairar

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 ícone de recolhimento:

compartilhamento de arquivo, gravação do nome do arquivo, colapso da pílula

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

compartilhamento de arquivo escreve texto do nome do arquivo

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 ícone de remoção:

compartilhamento de arquivo, gravação de pílula de nome de arquivo, 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:

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