Atividade de Gravação em Armazenamento Temporário

Introdução

Uma atividade de Gravação em Armazenamento Temporário, utilizando sua conexão de Armazenamento Temporário, grava dados em um endpoint de Armazenamento Temporário e é destinada a ser usada como um alvo para consumir dados em uma operação ou para ser chamada em um script.

Criar uma Atividade de Gravação em Armazenamento Temporário

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

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 Gravação em Armazenamento Temporário existente pode ser editada a partir destes locais:

• A tela de design (veja Menu de ações do componente em Tela de design).

• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).

Configurar uma Atividade de Gravação em Armazenamento Temporário

Siga estas etapas para configurar uma atividade de Gravação em Armazenamento Temporário:

• Etapa 1: Insira um nome, forneça um esquema de solicitação e especifique as configurações

• Passo 2: Revise os esquemas de dados

Passo 1: Insira um nome, forneça um esquema de solicitação e especifique as configurações

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

• Fornecer esquema de solicitação: O esquema de solicitação define a estrutura dos dados que são usados pela atividade de Gravação em Armazenamento Temporário. Se um esquema de solicitação é necessário depende se a atividade é usada como o alvo 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 caminho da pasta que você deseja gravar dentro do diretório de armazenamento temporário, ou insira vários caminhos separados por vírgula (por exemplo, pasta1, pasta2). Se nenhum caminho for inserido, os arquivos são gravados diretamente dentro da pasta padrão de armazenamento temporário. Para gravar em um novo ou existente subdiretório de armazenamento temporário, insira o(s) caminho(s) da pasta existente contidos dentro do diretório de armazenamento temporário.

  Warning

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

  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 através do 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.

• Nome(s) do arquivo: Insira o nome do(s) arquivo(s) que você deseja gravar nos caminhos inseridos acima. Qualquer uma das palavras-chave de nome de arquivo está disponível para gerar nomes de arquivos exclusivos (por exemplo, result[date][time].[ext]). Se especificar dados no formato ZIP, consulte as opções de Compressão descritas abaixo.

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

  

  • Não crie arquivos vazios: Selecione esta caixa de seleção para pular a criação do arquivo de destino se não houver dados de destino.

  • Anexar ao arquivo: Selecione esta caixa de seleção para anexar ao arquivo de destino existente em vez de sobrescrever.

  • Escrever cabeçalhos: Selecione esta caixa de seleção se você estiver usando um destino de texto simples e quiser escrever cabeçalhos (nomes de coluna/campo) na primeira linha.

  • Tipo de final de linha: Especifique como escrever quebras de linha ao escrever para um destino. Observe que os caracteres de final de linha nos dados em si não são convertidos. As opções são as seguintes:

    • Padrão: Caracteres de final de linha padrão para a plataforma em que o agente está sendo executado.

    • Windows: CRLF (ASCII 13 e ASCII 10).

    • Unix: LF (ASCII 10).

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

  • Compressão: Selecione a caixa de seleção para Compactar arquivos de destino se você quiser que os dados de destino sejam compactados. Essas opções ficam disponíveis:

    • Formato: Use o menu suspenso para selecionar o formato de compressão desejado. Atualmente, apenas o formato ZIP é suportado.

    • Nomes de arquivos no(s) arquivo(s): Insira o nome do(s) arquivo(s) de destino a serem compactados dentro do arquivo. Qualquer uma das palavras-chave de nome de arquivo está disponível para gerar nomes de arquivos exclusivos. O(s) arquivo(s) são automaticamente escritos no arquivo no nível raiz.

      Dica

      Para manter o(s) nome(s) do arquivo no arquivo o mesmo que o(s) nome(s) do arquivo definidos no destino, insira [file].[ext].

    • Modo: Use o menu suspenso para selecionar entre estes modos:

      • Sobrescrever: Sobrescreve o arquivo existente.
      • Anexar: Se o arquivo não estiver criptografado, adiciona arquivos compactados ao arquivo existente. Anexar a um arquivo ZIP criptografado não é suportado.

    • Senha: Para criptografar o arquivo, insira a senha desejada.

    • Modo de criptografia: Se uma senha for fornecida, use o menu suspenso para selecionar entre os dois modos de criptografia disponíveis: AES e ZIP Padrão.

• 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 desta 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 que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

• Esquema de Dados: Se fornecido durante a configuração da atividade, o esquema de dados da solicitação é 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 usado. Para instruções adicionais sobre como usar 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 desta etapa e retornar à etapa anterior.

• Finalizado: 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 você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade de Gravação em 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 Gravação em 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.

Uma vez que uma atividade de Gravação em Armazenamento Temporário tenha sido criada, as ações do menu para essa atividade estão acessíveis no painel do projeto nas abas Fluxos de Trabalho ou Componentes, e no canvas de design. Veja Menu de ações da atividade para mais detalhes.

Atividades de Gravação em Armazenamento Temporário podem ser usadas como um alvo com esses padrões de operação:

• Padrão de Arquivamento
• Padrão de Script
• Padrão de Transformação
• Padrão de Arquivamento de Dois Alvos (apenas como o segundo alvo)
• Padrão de Arquivamento HTTP de Dois Alvos (apenas como o segundo alvo)
• Padrão de Duas Transformações (apenas como o segundo alvo)
• Padrão de Fonte em Massa do Salesforce

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

Um padrão de design comum para usar armazenamento temporário é fornecido em Persistindo dados para processamento posterior usando Armazenamento Temporário (Este padrão usa o Design Studio como exemplo, mas os mesmos conceitos podem ser aplicados no Integration Studio).

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

Use atividades de Armazenamento Temporário em scripts

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

Funções de Script Jitterbit

• ArchiveFile
• FlushAllFiles
• FlushFile
• WriteFile

Funções Jitterbit em JavaScript

• Jitterbit.WriteFile

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