Atividade de Escrita de Variável
Introdução
Uma atividade de Escrita de Variável, utilizando sua conexão de Variável, grava dados em uma variável e é destinada a ser usada como um alvo para consumir dados em uma operação ou ser chamada em um script.
Para mais informações sobre como usar variáveis em scripts, transformações e telas de configuração de conexão/atividade, veja Variáveis.
Criar uma atividade de Escrita de Variável
Uma instância de uma atividade de Escrita de Variável é criada a partir de uma conexão de Variável usando seu tipo de atividade Escrita.
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 Escrita de Variável 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 Escrita de Variável
Siga estas etapas para configurar uma atividade de Escrita de Variável:
Etapa 1: Insira um nome e forneça um esquema de solicitação
-
Nome: Insira um nome 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 dos dados utilizados pela atividade de 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 (veja Uso de Esquema). Para instruções sobre como completar esta seção da configuração da atividade, consulte Esquemas definidos em uma atividade.
-
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 solicita 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 utiliza uma transformação, os esquemas de dados sã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 ampliam 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 a configuração de quaisquer variáveis necessárias usadas pelo plugin, veja 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 você confirmar que deseja descartar as alterações.
Próximas etapas
Após configurar uma atividade de Gravar Variável, você pode usá-la dentro de uma operação ou script, conforme descrito abaixo.
Completar a operação
Após configurar uma atividade de Gravar Variável, 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 Gravar Variável 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 detalhes.
Atividades de Gravar Variável 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 (como o segundo alvo apenas)
- Padrão de Arquivamento HTTP de Dois Alvos (como o segundo alvo apenas)
- Padrão de Duas Transformações (como o segundo alvo apenas)
- Padrão de Fonte em Massa do Salesforce
Outros padrões não são válidos ao usar atividades de Gravação de Variáveis. Veja os padrões de validação na página de validade da operação.
Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.
Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.
Importante
Por padrão, operações bem-sucedidas configuradas para uma API personalizada não são incluídas nos logs da operação a menos que uma dessas configurações esteja habilitada:
- Agentes em nuvem: Para operações de API em um agente em nuvem, o registro de depuração da operação deve estar habilitado na operação.
- Agentes privados: Para operações de API em um agente privado, ou o registro de depuração da operação deve estar habilitado na operação ou você deve definir
EnableLogging=true
na seção[APIoperation]
do arquivo de configuração do agente privado.