Atividade de gravação variável
Introdução
Uma atividade Variable Write grava dados em um endpoint Variable e tem a intenção de ser usada como um alvo para consumir dados em uma operação. Após configurar uma conexão Variable, você pode configurar quantas atividades Variable desejar para cada conexão Variable.
Para obter mais informações sobre o uso de variáveis em scripts, transformações e telas de configuração de conexão/atividade, consulte Variáveis.
Crie uma atividade variável
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 variável
Siga estas etapas para configurar uma atividade de gravação variável:
Etapa 1: insira um nome e forneça um esquema de solicitação
-
Nome: Insira um nome para usar para identificar a atividade de Gravação de Variável. O nome deve ser exclusivo para cada atividade de Gravação de Variável 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 Gravação de Variável. Se um esquema de solicitação é necessário depende se a atividade é usada como o alvo 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.
-
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 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
Após configurar uma atividade Variable 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 Variável é 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. Veja menu de ações de atividade para mais detalhes.
Atividades de gravação de variáveis 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 Variável. Veja os padrões de validação em Validade da operação página.
Um caso de uso típico é usar uma atividade de gravação de variável no padrão Transformação. Neste exemplo, a atividade FTP Read (Read Request) fornece dados para a operação que são então recebidos pela transformação (FTP to Variable). A atividade Variable Write (Write Response) é usada como um alvo, recebendo dados dentro da operação:
Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.
Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando os logs de operação.
Importante
Por padrão, as operações bem-sucedidas configuradas para uma API personalizada não estão incluídos nos registros de operação a menos que uma destas configurações esteja habilitada:
- Agentes de nuvem: Para operações de API em um agente de nuvem, registro de depurar de operação deve ser habilitado na operação.
- Agentes privados: Para operações de API em um agente privado, registro de depurar da operação deve estar habilitado na operação ou você deve definir
EnableLogging=true
no[APIoperation]
seção do arquivo de configuração do agente privado.