Crie um mapa do campo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura
  • Os mapas de campo estabelecem um relacionamento entre um campo em uma tabela de conjunto de importação e um campo na tabela de destino.

    Antes de Iniciar

    Função necessária: import_transformer, import_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    O mapa de campo determina quais valores da tabela de origem a transformação adiciona à tabela de destino.

    Procedimento

    1. Navegar até Todos > Conjuntos para importação do sistema > Mapas de transformação.
    2. Abra um mapa de transformação.
    3. Na lista relacionada Mapas de campo, clique em Novo.
    4. Preencha o formulário.
      Tabela 1. Campos do mapa de campo
      Campo Descrição
      Mapa Mapa de transformação que usa este mapeamento de campo (preenchido automaticamente).
      Tabela de origem Tabela da qual os dados brutos do conjunto de importação são carregados (a origem da transformação). Preenchido automaticamente a partir do mapa de transformação.
      Campo de origem Campo na tabela de origem a ser transformado. Pode ficar em branco se a tabela de origem contiver somente dados brutos.
      Ação de opção Especifica a ação a ser tomada se o conjunto para importação contiver uma referência ou valor de opção diferente dos disponíveis. Aparece se o campo de destino for uma lista de seleção ou um campo de referência.
      • create: cria uma nova opção ou registro na tabela de referência.
      • ignore: ignora o novo valor da tabela de origem.
      • rejeitar: ignora a linha inteira (registro) que contém o novo valor e continua para a próxima linha.
      Formato de data Formato de data do campo de origem. Aparece se o campo de destino for um campo de data ou data/hora.
      Nota:
      Para saber mais sobre formatos de data permitidos, consulte Formato de campo de data e hora global.
      Usar script de origem Caixa de seleção para usar um script em vez do campo Origem.
      Aplicação Escopo da aplicação: global ou por aplicação.
      Tabela de destino Tabela na qual os dados transformados são inseridos. Você pode selecionar somente tabelas dentro do escopo da aplicação selecionado no momento ou do escopo global, ou tabelas que concedem acesso de gravação a outras aplicações.
      Campo de destino Campo na tabela de destino em que o valor do campo de origem é armazenado.
      Nome do valor do campo referenciado Quando o campo de destino é um campo de referência, o mapa de transformação precisa de uma maneira de corresponder os valores de origem de entrada aos registros existentes na tabela de origem do campo de referência. Como a maioria das importações não fornece um valor de sys_id de 32 caracteres, você deve especificar uma coluna da tabela de origem do campo de referência que contenha valores que correspondam aos valores de origem de entrada.

      Quando há um registro correspondente, o mapa de transformação armazena o sys_id do registro correspondente no campo de destino. Se não houver registro correspondente, o mapa de transformação criará um novo registro na tabela do campo de referência e armazenará o sys_id do novo registro no campo de destino.

      Se você deixar este campo em branco, o mapa de transformação procurará valores correspondentes na coluna de valor de exibição da tabela de campos de referência.

      Por exemplo, suponha que você esteja importando registros de incidentes e os dados de entrada listem IDs de usuário para o campo Atribuído a. Se você deixar o Nome do campo de valor referenciado em branco, o mapa de transformação pesquisará valores correspondentes na coluna de valor de exibição da tabela Usuário: nome. Ao definir o nome do campo Valor referenciado para a coluna user_name, você pode corresponder os valores de ID do usuário aos registros de usuário apropriados.

      Aglutinar Configurar um campo de destino para aglutinação faz com que o conjunto para importação trate o campo como uma chave exclusiva. Quando selecionada, a aplicação de conjunto de importação tenta corresponder valores de origem a registros com valores de um registro existente. Se uma correspondência for encontrada, o mapa de transformação atualizará o registro em vez de criar um novo registro. Quando falso, a aplicação de conjunto de importação sempre cria novos registros para cada transformação. Se vários campos estiverem definidos para aglutinação, todos os valores de aglutinação deverão corresponder a um registro existente. Se dois campos forem definidos para aglutinação e um valor correspondente for encontrado para um dos campos de aglutinação, mas não no outro, um novo registro será inserido.

      Você deve criar um índice na tabela de destino se nenhum dos campos de aglutinação estiver indexado. A indexação pode melhorar o desempenho das operações de leitura e gravação. Se um ou mais campos de aglutinação já tiverem um índice, você não precisará criar um índice adicional.

      Depois de definir o valor de Aglutinação para todos os campos na tabela de destino, use o link relacionado Campos de Aglutinação de Índice para criar um índice. Antes de criar o índice, certifique-se de que o valor de Aglutinar esteja definido corretamente para todos os campos na tabela de destino para evitar a criação de índices desnecessários para a mesma tabela de destino.

      O índice precisa ser concatenado; o que significa que todos os campos especificados para serem aglutinados precisam estar no mesmo índice. A configuração correta é para que um índice inclua todos os campos que estão sendo aglutinados.

      Aglutinar campos vazios Caixa de seleção para corresponder um valor de campo de origem vazio a um valor de campo de destino vazio. Por exemplo, o mapa de transformação do usuário é aglutinado no campo de e-mail. Com esta opção selecionada, um registro de origem que contém um endereço de e-mail vazio é aglutinado em um registro de destino que contém um endereço de e-mail vazio.
      Aglutinar com distinção entre maiúsculas e minúsculas Caixa de seleção para fazer com que os valores de aglutinação que diferenciam maiúsculas de minúsculas resultem na criação de novos registros. Por padrão, os valores marcados como Aglutinar são usados em uma pesquisa que não diferencia maiúsculas de minúsculas para registros existentes. Registros que não diferenciam maiúsculas de minúsculas atualizam somente os registros existentes e não causam a criação de novos registros.
    5. Clique em Salvar.
    6. Repita as etapas 3 a 5 para cada mapeamento de campo.
    7. Clique em Atualizar.