Navegando na interface de transformação no Jitterbit Integration Studio
Introdução
Esta página mostra como navegar na interface de transformação e usar diferentes visualizações e opções de exibição. A interface de transformação fornece ferramentas para mapear dados entre esquemas de origem e destino.
Para prática prática com esses elementos da interface, veja Crie sua primeira transformação.
Elementos da interface de transformação
Minimap de transformação
O minimap de transformação fornece uma visão geral navegacional das estruturas dos esquemas de origem e destino, facilitando a navegação em transformações complexas. O minimap exibe uma representação condensada de ambos os esquemas e mostra a área visível atual, campos selecionados e relacionamentos de mapeamento.
O minimap aparece ao lado da interface principal de transformação. Clique em Abrir/Fechar minimap para mostrar ou ocultar o minimap.
Indicadores de área visível
O minimap exibe pistas visuais para mostrar sua posição atual dentro de cada esquema:
No exemplo acima, anotações rosas indicam o esquema de origem, enquanto anotações roxas indicam o esquema de destino.
As caixas azul claro representam áreas visíveis que mostram qual parte de cada esquema está atualmente visível na visualização principal de transformação. Você pode arrastar essas áreas visíveis para navegar por diferentes partes dos seus esquemas.
O minimap mostra indicadores visuais adicionais tanto na visualização principal quanto no minimap:
-
Campos selecionados são exibidos como linhas de mapeamento azuis.
-
Nós de loop são exibidos como linhas pretas sólidas.
Barra de ferramentas de transformação
A barra de ferramentas de transformação contém ferramentas para interagir com transformações:
Í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 de Desfazer (veja Desfazer e refazer em permissões, colaboração e salvamento do Integration Studio). | |
Clique para ajustar as configurações de visualização da transformação. Você pode selecionar se deseja mostrar ou ocultar esses indicadores visuais:
|
|
Visualizar muda a visualização da transformação para o modo de visualização (veja Testar e validar transformações). Esta opção está disponível apenas quando a transformação possui um esquema de origem e um esquema de destino especificados. |
|
Fechar fecha a transformação. |
Filtro e pesquisa
Você pode usar filtros e pesquisa para localizar campos específicos dentro das estruturas de origem ou destino. Também é possível usar a pesquisa na estrutura de origem para encontrar uma variável específica a ser utilizada na estrutura de destino, ou pesquisar na estrutura de destino para buscar dentro dos scripts de mapeamento de transformação.
Filtro
O menu suspenso de visualização está localizado na parte superior das estruturas Origem e Destino:
Esse menu suspenso permite filtrar por estas seleções:
- Selecionar todos os campos de destino/origem: Todos os campos são exibidos.
- Inválido: Esta opção está disponível apenas na estrutura Destino. Apenas os 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.
- Mapeado: Apenas os campos que foram mapeados são exibidos. Dentro da estrutura Origem, os objetos mapeados são limitados àqueles que foram mapeados para um campo de destino. Para a estrutura Destino, 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).
- Obrigatório: Esta opção está disponível apenas na estrutura Destino. Apenas os campos que têm uma chave de cardinalidade de
[1]
ou[1+]
são exibidos. Para mais informações, consulte notação de cardinalidade em Conceitos-chave. - Não mapeado: Apenas os campos que não foram mapeados são exibidos.
Pesquisa
Use a caixa de pesquisa localizada acima da estrutura Origem ou Destino para pesquisar dentro dessa estrutura:
-
Origem: Ao pesquisar na estrutura de origem, campos ou variáveis que contêm qualquer parte das palavras-chave em seus nomes são destacados.
-
Alvo: Ao pesquisar na estrutura de destino, campos que contê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:
Os resultados da pesquisa de script foram limitados a 100 scripts. Todos os caminhos foram pesquisados.
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 busca.
Quando uma pesquisa é iniciada, o número total de resultados é retornado:
Use os ícones anterior e próximo para navegar pelos resultados.
Nota
Dentro da aba Origem e da estrutura Destino, a pesquisa é limitada ao filtro selecionado. Para pesquisar campos mapeados e não mapeados, certifique-se de selecionar Todos os Campos no menu suspenso de filtros.
Expandir e recolher esquema de origem
Use os botões de expandir/recolher entre os esquemas para mostrar ou ocultar o esquema de origem (expandido por padrão).
Indicadores visuais de campos mapeados
Quando você visualiza objetos mapeados nas abas Origem ou Variáveis, um número indica quantas vezes cada objeto é referenciado no lado de destino da transformação. Clique no número para ver o caminho de destino em uma dica de ferramenta.
Além disso, ao passar o mouse sobre um objeto de origem, linhas aparecem conectando o campo de origem a quaisquer campos de destino aos quais ele está mapeado ou nós nos quais é referenciado.
Quando você visualiza objetos mapeados dentro da estrutura Destino, passar o mouse sobre o campo mostra uma linha que conecta o campo de destino mapeado às suas origens nas abas Origem ou Variáveis, se aplicável. Clique no objeto de origem mapeado para ir automaticamente ao objeto na aba.
Clicar no nome de um objeto de destino mapeado o colapsa, de modo que seus objetos mapeados não fiquem visíveis:
Dica
Se um nó colapsado contiver mapeamentos de campo de destino, esse nó é exibido em negrito para indicar que contém mapeamentos.
Ações do nó de destino
Quando você passa o mouse sobre um nó de destino e clica no menu de ações , estas ações estão disponíveis:
Item do menu | Descrição |
---|---|
![]() |
Remover nó de loop remove a definição do nó de loop. Esta ação está disponível apenas em nós que têm um nó de loop definido manualmente. Nota Se você remover todos os mapeamentos de folha diretos de um nó de loop definido manualmente, a definição do nó de loop ainda existe. |
![]() |
Remover nó de loop e mapeamentos remove a definição do nó de loop devido a mapeamentos que são filhos diretos associados ao nó de loop, e remove esses mapeamentos. Quaisquer outros mapeamentos dentro de nós de loop filhos abaixo do nó de loop pai são preservados, e o nó mantém sua definição de nó de loop se pelo menos um neto estiver mapeado. Esta ação está disponível apenas em nós que têm um nó de loop definido (seja manualmente ou por geração automática). |
![]() |
Remover todos os mapeamentos abaixo deste nó remove todos os mapeamentos em campos contidos dentro do nó, bem como todos os mapeamentos em campos contidos dentro de nós filhos desse nó. Usar esta ação em um nó raiz remove todos os mapeamentos em uma transformação. Ao selecionar esta ação, uma mensagem pede para confirmar que você deseja remover os mapeamentos. |
![]() |
Remover todos os mapeamentos inválidos remove todos os mapeamentos inválidos em campos contidos dentro do nó, bem como todos os mapeamentos inválidos em campos contidos dentro de nós filhos desse nó. Para mais informações sobre mapeamentos inválidos, veja Validade do mapeamento de transformação. |
![]() |
Expandir todos os nós abaixo deste nó expande todos os nós filhos abaixo do nó pai. (Por padrão, os nós são expandidos até 8 níveis de profundidade para esquemas com 750 ou menos nós e até 5 níveis de profundidade para esquemas com mais de 750 nós.) |
![]() |
Duplicar nó duplica o nó e seus campos, bem como quaisquer nós filhos e seus campos. Mapeamentos não são duplicados. Esta ação está disponível em nós raiz em esquemas planos e em nós cuja cardinalidade indica que elementos podem ocorrer mais de uma vez. O nó não deve já ser uma duplicata de outro nó. Para fins de exibição apenas durante o tempo de design, o nome do nó duplicado é acrescido de um hash ( Se um nó duplicado é refletido em outros locais ao longo do projeto depende de como o esquema foi definido:
|
![]() |
Remover nó duplicado remove o nó duplicado e seus campos, bem como quaisquer nós filhos duplicados e seus campos. Esta ação está disponível apenas em nós que foram criados usando Duplicar nó. |
![]() |
Renomear nó duplicado permite que você renomeie um nó de destino duplicado. O novo nome é apenas para fins de exibição durante o tempo de design. Durante a execução, o nome original do nó duplicado (o nome do nó acrescido de um hash ( Esta ação está disponível apenas em nós que foram criados usando Duplicar nó. |
![]() |
Adicionar condição ao nó é usado para aplicar condicionalmente um mapeamento aos campos contidos dentro de um nó. Esta ação está disponível apenas em nós que ainda não têm uma condição aplicada. Ao selecionar esta ação, uma área de script editável é aberta para você criar a condição. Para detalhes sobre como criar a condição, veja Lógica condicional. |
![]() |
Editar condição abre uma área de script editável Esta ação está disponível apenas em nós que já têm uma condição aplicada. Para mais detalhes, veja Lógica condicional. |
![]() |
Remover condição remove a condição. Esta ação está disponível apenas em nós que já têm uma condição aplicada. |
Ações do campo de destino
Quando você passa o mouse sobre um campo de destino, estas ações estão disponíveis:
Ícone | Descrição |
---|---|
Mostra ou oculta os nomes dos objetos de origem mapeados no campo de destino. Para mostrar ou ocultar todos os nomes dos objetos de origem mapeados, use a opção de visualização de transformação na barra de ferramentas de transformação. | |
Abre o editor de scripts para o campo. | |
Remove o mapeamento para o campo. | |
Abre uma caixa de texto para adicionar um valor personalizado. Esta ação está desativada para campos mapeados. Para campos mapeados, use Expandir para editar o script. |
Remover mapeamentos de múltiplos campos
Para mapeamentos em esquemas hierárquicos, opções para remover múltiplos mapeamentos de campos de destino estão disponíveis no menu de ações de um nó (descrito em Ações de nós de destino).
Ações de esquema
Ações do painel do projeto
Após a criação de um esquema, as ações do menu para esse esquema estão acessíveis na aba Componentes do painel do projeto (veja Menu de ações de componentes na aba Componentes do painel do projeto).
Essas ações de menu estão disponíveis:
Item do Menu | Descrição |
---|---|
![]() |
Cortar coloca uma cópia do esquema na sua área de transferência e exclui o esquema original do projeto (veja Reutilização de componentes). |
![]() |
Copiar coloca uma cópia do esquema na sua área de transferência (veja Reutilização de componentes). |
![]() |
Renomear posiciona o cursor no nome do esquema para que você possa fazer as edições necessárias. |
![]() |
Ver Dependências altera a visualização no painel do projeto para exibir quaisquer outras partes do projeto das quais o esquema específico depende (veja Dependências de componentes, exclusão e remoção). |
![]() |
Adicionar ao Grupo abre um diálogo para criar um novo grupo personalizado ou para adicionar o esquema a um grupo existente (veja Grupos de componentes). |
![]() |
Excluir exclui permanentemente o esquema (veja Dependências de componentes, exclusão e remoção). |
Ações de transformação
Após especificar um esquema de origem ou destino em uma transformação, as ações do menu para esse esquema estão disponíveis na parte superior da tela de configuração da transformação. Quando você passa o mouse sobre a parte superior de qualquer um dos lados de origem ou destino, as ações do esquema aparecem:
Item do menu | Descrição |
---|---|
Editar Atividade abre a configuração da atividade para que você possa fazer alterações conforme necessário (veja Esquemas definidos em uma atividade). Esta ação está disponível apenas quando a transformação herda 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 como esquema. Para outras atividades, você pode editar a consulta, alterar a seleção de objetos ou outras configurações semelhantes. |
|
Editar Esquema abre o editor de esquemas para que você possa editar o esquema (veja Esquemas definidos em uma transformação). Esta ação está disponível apenas para esquemas que são editáveis. Quando você edita um esquema que foi criado a partir de um arquivo de exemplo em uma transformação, a tela de configuração para um esquema plano personalizado ou esquema hierárquico personalizado é aberta para que você possa 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 múltiplos componentes, um diálogo exibe uma lista de quaisquer componentes que referenciam o esquema e que serão afetados por quaisquer alterações: Texto do diálogo Este esquema é utilizado por todos os seguintes componentes. Quaisquer alterações feitas nele podem afetar a validade desses componentes.
|
|
Atualizar Esquema regenera o esquema a partir do endpoint. Esta ação está disponível apenas para esquemas herdados de uma atividade adjacente com um esquema gerado por 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 mais informações, veja Regeneração de Esquema. |
|
Limpar Esquema remove um esquema fornecido pela transformação da transformação. Esta ação está disponível apenas para esquemas definidos em uma transformação. Ao remover um esquema, uma mensagem solicita que você confirme a remoção do esquema, com os seguintes resultados:
Nota Se um esquema fornecido pela transformação estava presente antes da configuração de uma atividade adjacente, a opção Limpar Esquema fica desabilitada. Embora um esquema fornecido pela transformação continue referenciado pela transformação, ele não é utilizado no processamento. Para limpar um esquema fornecido pela transformação nessas circunstâncias, remova temporariamente a atividade adjacente e a opção Limpar Esquema será habilitada. Depois de limpar o esquema fornecido pela transformação, substitua a atividade na operação. |
Paleta de componentes de script
A paleta de componentes de script fornece acesso a vários componentes que podem ser usados dentro de um script:
Para colapsar a paleta de componentes de script, clique no ícone de colapso localizado no canto superior direito da paleta. Quando colapsada, você pode expandir a paleta de componentes de script clicando em uma das abas da paleta.
Para pesquisar dentro de uma aba, use a caixa de pesquisa para inserir uma única palavra-chave ou string de palavras-chave. Para limpar a pesquisa, clique no ícone de remoção .
Cada aba da paleta de componentes de script é resumida abaixo, com detalhes adicionais fornecidos em Jitterbit Script ou JavaScript, dependendo da linguagem.
Aba | Descrição |
---|---|
Objetos de Fonte | A aba Objetos de Fonte está presente apenas para scripts criados dentro de uma transformação. Como esse tipo de script é limitado àqueles que usam a linguagem Jitterbit Script, referenciar objetos de fonte em scripts escritos em JavaScript não é aplicável. Dentro de um script de transformação, você pode referenciar dados de origem inserindo o caminho de referência de um campo ou pode referenciar nós de dados de origem inserindo o caminho de referência de um nó. Para adicionar um caminho de referência de campo ou nó a um script de transformação (apenas Jitterbit Script), use um destes métodos:
|
Funções | A aba Funções fornece uma lista de funções disponíveis para uso em um script para a linguagem selecionada no script (seja Jitterbit Script ou JavaScript). Dentro de um script, você pode usar funções inserindo a sintaxe da função apropriada para a linguagem do script. Para adicionar a sintaxe da função a um script (apenas Jitterbit Script ou JavaScript), use um destes métodos:
|
Variáveis | A aba Variáveis fornece acesso a variáveis que estão disponíveis para referência globalmente em um projeto, incluindo variáveis globais, variáveis de projeto e variáveis Jitterbit. Dentro de um script, você pode usar variáveis inserindo a sintaxe da variável. Para adicionar a sintaxe da variável a um script (apenas Jitterbit Script ou JavaScript), use um destes métodos:
|
Plugins | A aba Plugins fornece uma lista de plugins que podem ser executados dentro de um script. Dentro de um script, você pode usar um plugin como um argumento para a função RunPlugin inserindo o caminho de referência do plugin.Para adicionar um caminho de referência de plugin a um script (apenas Jitterbit Script), use um destes métodos:
|
Operações | Esta aba fornece uma lista de operações no projeto que estão disponíveis para referência em um script. Dentro de um script, você pode usar uma operação como um argumento para funções inserindo o caminho de referência da operação. Para adicionar um caminho de referência de operação a um script (apenas Jitterbit Script), use um destes métodos:
|
Notificações | A aba Notificações fornece uma lista de notificações no projeto que estão disponíveis para referência em um script. Dentro de um script, você pode referenciar uma notificação como um argumento para a função SendEmailMessage inserindo o caminho de referência da notificação.Para adicionar um caminho de referência de notificação a um script (apenas Jitterbit Script), use um destes métodos:
|
Scripts | A aba Scripts fornece uma lista de todos os outros scripts de componentes de projeto independentes no projeto — escritos em Jitterbit Script ou JavaScript — que estão disponíveis para referência em um script. Dentro de um script, você pode referenciar outro script como um argumento para a função RunScript inserindo o caminho de referência do script.Para adicionar um caminho de referência de script a um script (apenas Jitterbit Script), use um destes métodos:
Nota Embora um Jitterbit Script possa chamar um JavaScript, o inverso não é verdadeiro. Um JavaScript do Jitterbit não pode chamar outro script de qualquer linguagem. |
Endpoints | A aba Endpoints fornece uma lista de endpoints no projeto que estão disponíveis para referência em um script. Dentro de um script, você pode referenciar endpoints como um argumento para funções inserindo o caminho de referência da conexão ou atividade. Para adicionar um caminho de referência de conexão ou atividade a um script (apenas Jitterbit Script ou JavaScript), use um destes métodos:
Para detalhes adicionais, veja Endpoints em Jitterbit Script ou Endpoints em JavaScript. |
Atalhos de teclado
Esses atalhos de teclado podem ser usados ao trabalhar em uma transformação:
- Ctrl+S (Windows/Linux) ou Cmd+S (macOS): Salvar transformação manualmente.
- Ctrl+Z (Windows/Linux) ou Cmd+Z (macOS): Desfazer ação.
- Ctrl+Y (Windows/Linux) ou Cmd+Y (macOS): Refazer ação.
- Ctrl+Space: Mostrar sugestões de autocompletar em scripts.
- Esc: Fechar diálogos ou retornar à visualização anterior.