Elementos de Modo Comum¶

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 Cloud 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:

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.

Nos modos de mapeamento e visualização, ao visualizar objetos mapeados nas guias Origem ou Variáveis, um número entre parênteses e a cor laranja indicam o número de vezes que cada objeto é referenciado no lado de destino da transformação.

Além disso, ao passar o mouse sobre um objeto de origem, aparecem linhas que conectam o campo de origem a quaisquer campos de destino aos quais ele está mapeado ou nós aos quais ele é referenciado. Clique diretamente no número para exibir os campos de destino ou nós referenciados e clique para rolar automaticamente para o objeto ou nó na estrutura de destino.

Ao visualizar objetos mapeados dentro da estrutura Target, ao passar o mouse sobre o campo, uma linha aparece conectando o campo de destino mapeado às suas origens nas guias Source ou Variables, se aplicável. Clique no objeto de origem mapeado para ir automaticamente para o objeto na aba.

Clicar no nome de um objeto de destino mapeado o recolhe para que seus objetos mapeados não fiquem visíveis.

Se um nó recolhido contiver mapeamentos de campos de destino, esse nó será mostrado em negrito para indicar que contém mapeamentos:

Procurar¶

Você também pode pesquisar campos específicos em todos os modos clicando em Ícone Pesquisar localizado na parte superior das guias Origem e Variáveis nos modos de mapeamento e visualização, e na 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.