Ir para o conteúdo

Atividade de Leitura de Armazenamento Temporário

Introdução

Uma atividade de Leitura de Armazenamento Temporário, utilizando sua conexão de Armazenamento Temporário, lê dados de um endpoint de Armazenamento Temporário e é destinada a ser usada como uma fonte para fornecer dados a uma operação ou ser chamada em um script.

Criar uma Atividade de Leitura de Armazenamento Temporário

Uma instância de uma atividade de Leitura de Armazenamento Temporário é criada a partir de uma conexão de Armazenamento Temporário usando seu tipo de atividade Leitura.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de Leitura de Armazenamento Temporário existente pode ser editada a partir destes locais:

Configurar uma Atividade de Leitura de Armazenamento Temporário

Siga estas etapas para configurar uma atividade de Leitura de Armazenamento Temporário:

Etapa 1: Insira um nome, forneça um esquema de resposta e especifique as configurações

Atividade de leitura de armazenamento temporário 1

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome: Insira um nome para identificar a atividade de leitura de Armazenamento Temporário Read. O nome deve ser exclusivo para cada atividade de leitura de Armazenamento Temporário e não deve conter barras (/) ou dois pontos (:).

  • Fornecer esquema de resposta: O esquema de resposta define a estrutura dos dados que são usados pela atividade de leitura de Armazenamento Temporário. Se um esquema de resposta é necessário depende se a atividade é usada como fonte de uma transformação (veja Uso de esquemas). Para instruções sobre como completar esta seção da configuração da atividade, consulte Esquemas definidos em uma atividade.

  • Caminho (opcional): Insira o(s) caminho(s) da pasta dentro do diretório de armazenamento temporário que contém os arquivos que você deseja ler. Se nenhum caminho for inserido, os arquivos são lidos da pasta padrão de armazenamento temporário. Para ler de um subdiretório de armazenamento temporário existente, insira o caminho da pasta contido dentro do diretório de armazenamento temporário. Vários caminhos podem ser especificados usando valores separados por vírgula.

    Aviso

    Esses caracteres especiais não podem ser usados em caminhos de arquivos: ~, %, $, ", <, >, :, ?.

    No entanto, alguns caracteres especiais são permitidos: !, @, #, ^, &, *, (, ), [, ], ', ;. Além disso, pode-se usar uma barra / ou uma barra invertida \ como separador de caminho.

    Nota

    O diretório de armazenamento temporário padrão usado pelo Harmony é o diretório temporário do sistema operacional do agente. Normalmente:

    • Windows: C:\Windows\Temp\jitterbit\TemporaryStorage
    • Linux: /tmp/jitterbit/TemporaryStorage

    Em agentes privados, o diretório de armazenamento temporário padrão pode ser alterado usando o arquivo de configuração do agente privado. Para fazer isso, na seção [OperationEngine], defina TemporaryStorageRootDirectory para um caminho absoluto de um diretório existente.

    Em agentes em nuvem, o diretório de armazenamento temporário padrão não pode ser alterado. No entanto, como o caminho é relativo, se um arquivo foi gravado no armazenamento temporário com um determinado caminho, esse mesmo arquivo pode ser recuperado do armazenamento temporário usando o mesmo caminho se criado dentro da mesma cadeia de operações. Para explicações adicionais, consulte Notas importantes em Armazenamento Temporário.

  • Obter arquivos: Insira o nome do(s) arquivo(s) que você deseja ler a partir do caminho inserido acima. Este campo também pode incluir um asterisco (*) para usar como um caractere curinga (por exemplo, *.dat ou *.*) ou um ponto de interrogação (?) para corresponder exatamente a um caractere (por exemplo, file?.txt). O uso de curingas é separado da opção Usar expressão regular descrita abaixo. Se especificar dados em formato ZIP para serem descompactados e lidos automaticamente, consulte as opções de Compressão descritas abaixo.

  • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

    Configurações opcionais da atividade de leitura de armazenamento temporário

    • Opções de Filtro de Arquivo: Essas opções afetam como a entrada inserida no campo Obter arquivos acima é interpretada:

      • Ignorar Maiúsculas: Selecione esta caixa de seleção se você inseriu uma entrada no campo Obter arquivos acima que deve ser interpretada como insensível a maiúsculas.

      • Usar Expressão Regular: Selecione esta caixa de seleção se você inseriu uma entrada no campo Obter arquivos acima que deve ser interpretada como uma expressão regular.

    • Codificação de Caracteres: Especifique a codificação de caracteres para definir uma codificação específica para o arquivo de origem. Se você deixar o campo em branco, o Harmony tentará detectar a codificação. Se você quiser substituir o padrão, pode escolher entre qualquer um dos tipos de codificação listados em Codificações de caracteres suportadas.

    • Após o processamento: Se você quiser realizar ações adicionais após processar os dados, estas opções estão disponíveis:

      • Excluir Arquivo: Selecione esta caixa de seleção se você quiser que os arquivos que foram processados com sucesso sejam excluídos. Quando esta opção é selecionada, a opção Renomear Arquivo abaixo é automaticamente preenchida com /\delete/\ para indicar que os arquivos processados serão excluídos e, como tal, renomear um arquivo não se aplica. Limpar Excluir Arquivo também limpa o campo Renomear Arquivo.

      • Renomear Arquivo: Insira um nome se você quiser renomear arquivos após o processamento. Qualquer uma das palavras-chave de nome de arquivo está disponível para gerar nomes de arquivos exclusivos para os dados de origem após o processamento. Observe que o campo Renomear Arquivo não está disponível se Excluir Arquivo acima estiver selecionado. Além disso, alternar Excluir Arquivo acima limpa qualquer entrada inserida no campo Renomear Arquivo.

        Dica

        Se você quiser arquivar a fonte do arquivo em um local separado em um agente privado, veja também a opção Pasta de Sucesso/Pasta de Erro na configuração da Atividade de Gravação em Armazenamento Temporário.

    • Arquivo de Gatilho: Disponível apenas para uso com agentes privados onde arquivos locais estão habilitados, um arquivo de gatilho é um arquivo que deve estar presente antes que um arquivo de origem seja recuperado por uma operação para processamento. A presença de um arquivo de gatilho indica que um arquivo de origem está pronto para ser lido e não está mais em processo de escrita por uma operação anterior.

      • Usar Gatilho: Selecione esta caixa de seleção se desejar que o sistema procure um arquivo de gatilho antes de processar os arquivos de origem. Observe que, ao usar um arquivo de gatilho:

        • A operação faz polling, procurando pelo arquivo de gatilho. O intervalo de tempo de polling é fixo em um segundo.

        • O arquivo de gatilho é excluído assim que o processamento começa.

        • Se o arquivo de gatilho não for encontrado, a operação continua tentando encontrar o arquivo de gatilho até que a operação atinja o tempo limite.

        • Definir um arquivo de gatilho bloqueia qualquer operação ou script que use a origem até que a condição do arquivo de gatilho seja satisfeita ou a operação atinja o tempo limite.

      • Caminho absoluto do arquivo: Insira o caminho absoluto do arquivo na máquina do agente privado onde o arquivo de gatilho reside. Selecione um arquivo que atenda a estes critérios:

        • O arquivo pode ser de qualquer tipo e pode conter qualquer coisa em seu conteúdo; apenas a presença do arquivo define o comportamento do arquivo de gatilho.

        • O uso de curingas não é permitido.

        • O arquivo de gatilho não pode ser o mesmo arquivo que um arquivo de origem sendo processado.

        Nota

        Ao usar palavras-chave de nome de arquivo neste campo, as palavras-chave não são resolvidas. Para uma solução alternativa, veja Limitação e solução alternativa em Palavras-chave de nome de arquivo.

    • Ignorar Linhas: Se houver cabeçalhos e/ou rodapés nos dados de origem, insira o número de linhas a serem ignoradas nos campos Primeiro e Último.

      Nota

      Esta configuração não tem efeito quando uma atividade de Leitura de Armazenamento Temporário é referenciada de um script usando as funções ReadFile ou WriteFile.

    • Compressão: Se os dados de origem estiverem em um formato comprimido, selecione Os dados de origem estão Comprimidos. Essas opções ficam disponíveis:

      • Formato: Use o menu suspenso para selecionar o formato dos dados compactados. Atualmente, apenas o formato ZIP é suportado.

      • Senha: Se o arquivo estiver criptografado, insira a senha.

        Nota

        Harmony suporta leitura apenas do diretório raiz de um arquivo criptografado.

  • Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Atividade de Leitura de Armazenamento Temporário 2

  • Esquema de Dados: Se fornecido durante a configuração da atividade, o esquema de dados da resposta é exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais. Você também pode definir esquemas diretamente em uma transformação.

  • Adicionar plugin(s): Plugins são aplicativos fornecidos pela Jitterbit ou pelo usuário que estendem as capacidades nativas do Harmony. Para aplicar um plugin à atividade, clique para expandir esta seção e selecione a caixa de seleção ao lado do plugin a ser utilizado. Para instruções adicionais sobre como usar plugins, incluindo detalhes sobre como definir quaisquer variáveis necessárias usadas pelo plugin, consulte Plugins adicionados a uma atividade.

  • Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para confirmar que você deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de Leitura de Armazenamento Temporário, você pode usá-la dentro de uma operação ou script, conforme descrito abaixo.

Completar a operação

Após configurar uma atividade de Leitura de Armazenamento Temporário, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para mais detalhes, veja o menu de ações da atividade em Conceitos básicos de conectores.

Atividades de Leitura de Armazenamento Temporário podem ser usadas como fonte com esses padrões de operação:

Outros padrões não são válidos ao usar atividades de Leitura de Armazenamento Temporário. Veja os padrões de validação na página de Validade da operação.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.

Usando atividades de Armazenamento Temporário em scripts

Atividades de Leitura de Armazenamento Temporário também podem ser referenciadas em um script para uso com funções de script que utilizam um sourceId como parâmetro, incluindo estas:

Funções de Script Jitterbit

  • ArchiveFile
  • Base64EncodeFile
  • DeleteFile
  • DeleteFiles
  • DirList
  • FileList
  • ReadFile

Funções Jitterbit em JavaScript

  • Jitterbit.ReadFile

Para mais detalhes sobre como referenciar atividades em scripts, veja Endpoints em Jitterbit Script ou Endpoints em JavaScript.