Atividade de gravação de armazenamento temporário

Introdução

Uma atividade de Gravação de Armazenamento Temporário grava dados em um endpoint de Armazenamento Temporário e tem a intenção de ser usada como um alvo para consumir dados em 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 gravação de armazenamento temporário

Siga estas etapas para configurar uma atividade de gravação de armazenamento temporário:

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

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

• Nome: Insira um nome para usar para identificar a atividade de Gravação de Armazenamento Temporário. O nome deve ser exclusivo para cada atividade de Gravação de 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 de dados que é usada pela atividade de Gravação de Armazenamento Temporário. Se um esquema de solicitação é necessário depende se a atividade é usada como o destino 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 caminho da pasta na qual você deseja gravar dentro do diretório de armazenamento temporário ou insira vários caminhos separados por uma vírgula (por exemplo, folder1, folder2). Se nenhum caminho for inserido, os arquivos serão gravados diretamente na pasta de armazenamento temporário padrão. Para gravar em um subdiretório de armazenamento temporário novo ou existente, insira o(s) caminho(s) de pasta existente(s) contido(s) no diretório de armazenamento temporário.

  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 por meio do 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.

• Nome(s) de arquivo(s): Insira o nome do(s) arquivo(s) em que você deseja gravar dentro do(s) caminho(s) inserido(s) acima. Qualquer uma das palavras-chave de nome de arquivo estão disponíveis para gerar nomes de arquivo exclusivos (por exemplo, result[date][tempo].[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 criar arquivos vazios: Marque esta caixa de seleção para pular a criação do arquivo de destino se não houver dados de destino.

  • Acrescentar ao arquivo: Marque esta caixa de seleção para acrescentar ao arquivo de destino existente em vez de substituí-lo.

  • Escrever cabeçalhos: Marque esta caixa de seleção se estiver usando um destino de texto simples e quiser escrever cabeçalhos (nomes de colunas/campos) na primeira linha.

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

    • Padrão: Caracteres de fim de linha padrão para a plataforma na qual 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 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.

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

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

    • Nomes de arquivo em arquivo(s): Insira o nome do(s) arquivo(s) de destino a ser(em) compactado(s) dentro do arquivo. Qualquer uma das palavras-chave de nome de arquivo estão disponíveis para gerar nomes de arquivo exclusivos. Arquivo(s) são automaticamente gravados no arquivo no nível raiz.

      Dica

      Para manter o(s) nome(s) de arquivo(s) no arquivo igual(es) ao(s) nome(s) de arquivo(s) definido(s) no destino, digite [file].[ext].

    • Modo: Use o menu suspenso para selecionar um destes modos:

      • Substituir: Substitui o arquivo existente.
      • Append: 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, digite 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 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 da solicitação é 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 Gravação 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 Write, 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 Gravação de Armazenamento Temporário é criada, as ações de menu para essa atividade ficam acessíveis no 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 gravação de armazenamento temporário podem ser usadas como um alvo com estes padrões de operação:

• Padrão de arquivo
• Padrão de Script
• Padrão de Transformação
• Padrão de arquivo de dois alvos (apenas como o segundo alvo)
• Padrão de arquivo HTTP de dois alvos (apenas como o segundo alvo)
• Padrão de duas transformações (apenas como segundo alvo)
• Padrão de origem em massa do Salesforce

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

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

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 gravação de armazenamento temporário também podem ser referenciadas em um script para uso com funções de script que usam um targetId como parâmetro, incluindo estes:

Funções de Jitterbit Script

• ArchiveFile
• FlushAllFiles
• FlushFile
• WriteFile

Funções Jitterbit do JavaScript

• Jitterbit.WriteFile

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