Elementos de modo comum de transformações no Jitterbit Integration Studio

Introdução

Existem três modos de exibição para acessar uma transformação: mapeamento, script, e visualizar. Os modos de mapeamento e script fornecem ferramentas para configurar a transformação, enquanto o modo de visualização fornece ferramentas para testar a transformação com dados de amostra. Alguns elementos da interface do usuário são comuns a todos os modos de exibição.

Esta página abrange elementos que são compartilhados pelo cabeçalho da tela de transformação:

• Modo de mapeamento

  

• Modo Script

  

• Modo de visualização

  

Renomear uma transformação

Quando você cria uma nova transformação, seu nome padrão é Nova Transformação. Novas transformações subsequentes com nomes padrão são anexadas com um número incrementado entre parênteses. Os nomes das Transformação devem ser exclusivos e não devem conter barras (/) ou dois pontos (:) para ser válido.

Para renomear uma transformação na tela de configuração de transformação, edite o campo no canto superior esquerdo:

As Transformações também podem ser renomeadas a partir destes locais:

• A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A quadro de design (consulte Renomeando workflows, operações e etapas de operação em Tela de design).

Adicionar notas

Você pode adicionar notas personalizadas a um script que sirvam como documentação ou lembretes para você ou para os colaboradores do projeto. Para adicionar uma nota, clique em ícone de nota ao lado do campo Tipo de Script.

Uma área editável abre, onde você pode inserir o texto da sua nota. Clique em Post para adicionar a nota ao script:

Sua nota publicada é exibida, junto com seu nome e um carimbo de data/hora. Qualquer pessoa com acesso de edição ao script pode remover notas clicando em remover ícone. Para fechar a nota, clique em outra parte da interface. Quando uma ou mais notas estiverem presentes, um ponto laranja será exibido no ícone da nota:

Ver status de salvamento

Após fazer alterações em um mapeamento, a configuração da transformação é salva automaticamente. O status de salvamento é exibido:

A presença de um asterisco após o tempo indica que a transformação possui alterações não salvas:

Para salvar manualmente a transformação, use Control+S (Windows ou Linux) ou Command+S (macOS).

Para obter mais informações sobre salvamento automático, consulte Permissões, colaboração e salvamento do Integration Studio.

Barra de ferramentas de Transformação

A barra de ferramentas de transformação contém um conjunto contextual de ferramentas para interagir com a transformação.

No modo de mapeamento e no modo de script, a barra de ferramentas de transformação contém este conjunto de ícones:

Ícone	Descrição
	Desfazer reverte sua última ação (veja Desfazer e refazer em Permissões, colaboração e salvamento do Integration Studio).
	Refazer reverte sua última ação Desfazer (veja Desfazer e refazer em Permissões, colaboração e salvamento do Integration Studio).
	Visualizar altera a visualização da transformação para o modo de visualização (consulte Modo de visualização). Esta opção está disponível somente quando a transformação tem um esquema de origem e um esquema de destino especificados.
	Fechar fecha a transformação.

No modo de visualização, ferramentas adicionais estão disponíveis que permitem que você interaja com os dados de visualização:

Essas ferramentas são abordadas em Visualizar uma transformação no modo de visualização.

Menu de ações do esquema

Após especificar um esquema de origem ou destino em uma transformação, as ações de menu para esse esquema ficam disponíveis na parte superior da tela de configuração da transformação. Na parte superior do lado de origem ou destino, clique em ícone de engrenagem para abrir o menu de ações:

Item de menu	Descrição
	Editar atividade abre a configuração da atividade para você fazer alterações conforme necessário (consulte Esquemas definidos em uma atividade). Esta ação está disponível somente quando a transformação está herdando um esquema de uma atividade adjacente ou inicialmente adjacente. Para atividades com esquemas definidos pelo usuário, você pode editar a configuração para limpar ou trocar o arquivo que você selecionou para usar para o esquema. Para outras atividades, você pode editar a consultar, alterar a seleção de objetos ou outra configuração desse tipo.
	Editar esquema abre o editor de esquema para você editar o esquema (consulte Esquemas definidos em uma transformação). Esta ação está disponível somente para esquemas editáveis. Quando você edita um esquema que foi criado a partir de um arquivo de amostra em uma transformação, a tela de configuração para um esquema simples personalizado ou esquema hierárquico personalizado abre para você adicionar ou editar campos e/ou nós conforme necessário. Esquemas fornecidos por uma atividade adjacente não são editáveis. Ao abrir um esquema que é referenciado por vários componentes, uma caixa de diálogo exibe uma lista de todos os componentes que referenciam o esquema e serão afetados por quaisquer alterações:
	Refresh Schema regenera o esquema do endpoint. Esta ação está disponível somente para esquemas herdados de uma atividade adjacente com um esquema gerado pelo conector (exceto para Banco de Dados, NetSuite, Salesforce, Salesforce Service Cloud, ou endpoints do ServiceMax). Esta ação também regenera o esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma atividade adjacente. Para obter mais informações, consulte Regeneração de esquema.
	Limpar esquema limpa um esquema fornecido pela transformação da transformação. Esta ação está disponível somente para esquemas definidos em uma transformação. Ao remover um esquema, uma mensagem solicita que você confirme a remoção do esquema, com estes resultados: Esquema de origem: A remoção de um esquema de origem pode resultar em mapeamentos inválidos. Para obter mais informações, consulte Validade do mapeamento de Transformação. Esquema de destino: A remoção de um esquema de destino remove todos os mapeamentos. Nota Se um esquema fornecido pela transformação estava presente antes da configuração de uma atividade adjacente, a opção Limpar esquema não está presente. Embora um esquema fornecido pela transformação permaneça referenciado pela transformação, ele não é usado no processamento. Para limpar um esquema fornecido pela transformação nessas circunstâncias, remova temporariamente a atividade adjacente e a opção Limpar esquema aparecerá. Depois de limpar o esquema fornecido pela transformação, substitua a atividade na operação.

Filtrar ou pesquisar

Usar filtro ou pesquisa pode ajudar você a localizar um campo específico dentro das estruturas de origem ou destino. Você também pode usar a pesquisa na estrutura de origem para localizar uma variável específica para usar na estrutura de destino, ou pode usar a pesquisa na estrutura de destino para pesquisar dentro dos próprios scripts de mapeamento de transformação.

Filtro

Nos modos de mapeamento e visualização, o menu suspenso View está localizado no topo das estruturas Source e Target. No modo de script, o menu suspenso View está presente no topo da estrutura Target. Este menu suspenso permite que você filtre por estas seleções:

• Todos os campos: Todos os campos são exibidos.
• Mapeado: Somente campos que foram mapeados são exibidos. Nos modos de mapeamento e visualização, dentro da estrutura Source, os objetos mapeados são limitados àqueles que foram mapeados para um campo de destino. Em todos os modos, para a estrutura Target, os campos mapeados são aqueles que foram definidos de alguma forma (com um objeto de origem, uma variável, um valor personalizado ou qualquer outra lógica de script). Os campos mapeados mostram um ícone de script no canto superior direito do campo de destino.
• Não mapeado: Somente campos que não foram mapeados são exibidos.
• Inválido: Esta opção está disponível somente na estrutura Target. Somente campos que foram mapeados onde o mapeamento não é válido são exibidos. A validade do mapeamento é detalhada em Validade do mapeamento de Transformação.
• Obrigatório: Esta opção está disponível somente na estrutura Target. Somente campos que têm uma chave de cardinalidade de [1] ou [1+] são exibidos. para mais informações, veja chave de cardinalidade em Nós e campos.

Procurar

Para pesquisar campos específicos em todos os modos, clique em Ícone Pesquisar localizado acima das guias Origem e Variáveis nos modos de mapeamento e visualização (quando um esquema está presente) e acima da estrutura Destino para todos os modos:

• Fonte: Ao pesquisar na estrutura de origem, os campos ou variáveis que têm qualquer parte das palavras-chave em seu nome são destacados.

• Destino: Ao pesquisar na estrutura de destino, os campos que têm qualquer parte das palavras-chave no nome do campo ou dentro do script de mapeamento de transformação de um campo são retornados e destacados. A pesquisa retorna até 100 scripts de mapeamento de transformação que correspondem aos critérios de pesquisa. Quando esse limite é atingido, uma mensagem é exibida:

  Script search results were limited to 100 scripts. All paths were searched.

Esquemas de origem e destino contendo mais de 999 nós exigem que dois ou mais caracteres sejam inseridos na caixa de pesquisa para iniciar uma pesquisa.

Quando uma pesquisa é iniciada, o número total de resultados é retornado:

Use o anterior e próximos ícones para mover pelos resultados.

Nota

Dentro da aba Source e da estrutura Target, a busca é limitada ao filtro selecionado. Para buscar campos mapeados e não mapeados, certifique-se de selecionar All Fields no menu suspenso do filtro.