Atividade de leitura de armazenamento temporário

Introdução

Uma atividade de Leitura de Armazenamento Temporário lê dados de um endpoint de Armazenamento Temporário e se destina a ser usada como uma fonte para fornecer dados a uma operação ou para ser chamada em um script. Após configurar uma conexão de Armazenamento Temporário, você pode configurar quantas atividades de Armazenamento Temporário desejar para cada conexão de Armazenamento Temporário.

Criar uma atividade de armazenamento temporário

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

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

Uma atividade existente pode ser editada a partir destes locais:

• A quadro de design (veja menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

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
• Etapa 2: Revise os esquemas de dados

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

Dica

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

• Nome: Insira um nome para usar para identificar a atividade Temporary Storage Read. O nome deve ser exclusivo para cada atividade Temporary Storage Read e não deve conter barras (/) ou dois pontos (:).

• Fornecer Esquema de Resposta: O esquema de resposta define a estrutura de dados que é usada pela atividade Leitura de Armazenamento Temporário. Se um esquema de resposta é necessário depende se a atividade é usada como a origem de uma transformação (consulte Uso do esquema). Para obter instruções sobre como concluir esta seção de configuração de 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 dos quais você deseja ler. Se nenhum caminho for inserido, os arquivos serão lidos da pasta de armazenamento temporário padrão. Para ler de um subdiretório de armazenamento temporário existente, insira o caminho da pasta contido no 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 arquivo: ~, %, $, ", <, >, :, ?.

  No entanto, alguns caracteres especiais são permitidos: !, @, #, ^, &, *, (, ), [, ], ', ;. Além disso, uma barra para frente / ou uma barra invertida \ pode ser usado como um 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 tal, sob o [OperationEngine] seção, conjunto TemporaryStorageRootDirectory para um caminho absoluto para um diretório existente.

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

• Obter arquivos: Insira o nome do(s) arquivo(s) que você deseja ler dentro do caminho inserido acima. Este campo também pode incluir um asterisco (*) para usar como 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 no 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:

  

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

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

    • Usar expressão regular: Marque esta caixa de seleção se você tiver inserido 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 de caracteres específica para o arquivo de origem. Se você deixar o campo em branco, o Harmony tenta detectar a codificação. Se você quiser substituir o padrão, pode escolher qualquer um dos tipos de codificação listados em Codificações de caracteres suportadas.

  • Após o processamento: Se você quiser executar outras ações após o processamento dos dados, estas opções estão disponíveis:

    • Excluir arquivo: Selecione esta caixa de seleção se quiser que os arquivos que foram processados com sucesso sejam excluídos. Quando esta opção é selecionada, a opção Renomear arquivo abaixo é preenchida automaticamente 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 quiser renomear os arquivos após o processamento. Qualquer uma das palavras-chave do nome do arquivo estão disponíveis para gerar nomes de arquivo exclusivos para os dados de origem após o processamento. Observe que o campo Renomear arquivo não estará disponível se Excluir arquivo acima estiver selecionado. Além disso, alternar Excluir arquivo acima limpa qualquer entrada inserida no campo Renomear arquivo.

      !!! tip "Dica" Se você quiser arquivar a origem do arquivo em um local separado em um agente privado, consulte também a opção Pasta de sucesso/Pasta de erro na Atividade de gravação de armazenamento temporário configuração.

  • 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á ainda no processo de ser escrito por uma operação anterior.

    • Usar gatilho: Selecione esta caixa de seleção se quiser 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 é fixado em um segundo.

      • O arquivo de gatilho é excluído quando o processamento é iniciado.

      • Se o arquivo de gatilho não for encontrado, a operação continuará tentando encontrá-lo até que o tempo limite da operação se esgote.

      • 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 o tempo limite da operação seja esgotado.

    • 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 como conteúdo; somente 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 que está 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, consulte Limitação e solução alternativa em Palavras-chave do nome do 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.

    !!! note "Nota" Esta configuração não entra em vigor quando uma atividade de Leitura de Armazenamento Temporário é referenciada de um script usando o ReadFile ou WriteFile funções.

  • Compressão: Se os dados de origem estiverem em um formato compactado, selecione Os dados de origem estão compactados. Estas 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.

      !!! note "Nota" O Harmony suporta somente a leitura do diretório raiz de um arquivo criptografado.

• Salvar e sair: Se habilitado, clique para salvar a configuração desta 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 nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revise os esquemas de dados

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

• Adicionar plugin(s): Os plugins são aplicativos fornecidos pelo Jitterbit ou pelo usuário que estendem os recursos nativos do Harmony. Para aplicar um plugin à atividade, clique para expandir esta seção e marque a caixa de seleção ao lado do plugin a ser usado. Para obter instruções adicionais sobre o uso de plugins, incluindo detalhes sobre a configuração de 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 para 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 nenhuma etapa. Uma mensagem solicita que você confirme se deseja descartar as alterações.

Próximos passos

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

Concluir a operação

Após configurar uma atividade Temporary Storage Read, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade de Armazenamento Temporário é criada, as ações de menu para essa atividade são acessíveis a partir do painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte menu de ações da atividade para mais detalhes.

As atividades de leitura de armazenamento temporário podem ser usadas como uma fonte com estes padrões de operação:

• Padrão de arquivo
• Padrão de Transformação
• Padrão de arquivo de dois alvos (apenas como primeira fonte)
• Padrão de arquivo HTTP de dois alvos (apenas como primeira fonte)
• Padrão de duas transformações (apenas como primeira fonte)
• Padrão de segmentação em massa do Salesforce

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

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

Usando atividades de armazenamento temporário em scripts

As atividades de leitura de armazenamento temporário também podem ser referenciadas em um script para uso com funções de script que usam um sourceId como parâmetro, incluindo estes:

Funções de Jitterbit Script

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

Funções Jitterbit do JavaScript

• Jitterbit.ReadFile

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