Transformar um campo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura
  • Transforme o conteúdo do campo usando um conjunto de regras e condições.

    Antes de Iniciar

    Função necessária: administrador ou normalizador

    Procedimento

    1. Crie um registro de transformação.
    2. Crie um ou mais registros de transformação relacionados.
    3. Teste a transformação.
    4. Executa trabalhos de dados.

    O que Fazer Depois

    Se você também quiser mostrar qual era o valor de entrada original (bruta) antes da transformação, crie um campo bruto para armazenar esse valor.

    Criar um registro de transformação

    Criar um registro de transformação é a primeira etapa na transformação de um campo.

    Procedimento

    1. Ative o plug-in de normalização de campo.
    2. Navegar até Normalização de Campo > Configurações > Transformações.
    3. Clique em Nova.
    4. Crie um registro de transformação.
      Tabela 1. Campos de registro de transformação
      Campo Descrição
      Nome Nome exclusivo para este registro de transformação. Este valor é apenas para referência e não é usado em nenhum processamento.
      Tabela Selecione a tabela ServiceNow que contém o campo que está sendo transformado. É importante entender a hierarquia da tabela ao configurar uma transformação de campo. Por exemplo, se você configurar a transformação para um campo na tabela Computador [cmdb_ci_computer], esse campo será transformado para todas as máquinas de estação de trabalho, servidores [ Windows, servidores Linux e servidores UNIX.
      Campo Selecione o campo a ser transformado. A lista apresentada contém somente os tipos de campo (inteiro e cadeia de caracteres) da tabela selecionada que podem ser transformados.
      Nota:
      O registro sys_user que inicia o processo de transformação deve ter seu formato de data definido para o formato padrão de "aaaa-MM-dd". Qualquer outro formato de data causa um erro durante a transformação. Este problema é específico somente para a transformação de campos TO TARGET do tipo Data/Hora. Este problema não será um problema se o tipo de campo de destino for do tipo Cadeia de caracteres ou se o mapeamento do campo de data for alterado para o mesmo formato de data do processo de transformação.
      Modo Os três modos disponíveis são Desligado, Testee Ativo. Todos os registros de transformação são criados no modo de teste por padrão. Não altere o modo até que você tenha testado completamente a transformação. Quando o teste estiver concluído, altere o modo para Ativo. Para desabilitar esta transformação, altere o modo para Desativado.
      Normalizar consulta Marque esta caixa de seleção para aplicar o valor do campo transformado por este registro a todas as consultas que envolvem este campo. As consultas emitidas com o valor do campo bruto (original) serão editadas para usar o valor de transformação.
      Campo bruto Selecione o campo a ser usado para exibir os valores de entrada originais (não normalizados) em um formulário no qual um valor de campo foi normalizado. Para que a seleção apareça na lista suspensa, adicione um campo personalizado ao formulário da tabela selecionada. Para obter instruções sobre como adicionar um campo para dados brutos, consulte Criar um campo bruto.
    5. Clique em Enviar.

      As listas relacionadas a transformações e trabalhos de dados aparecem no formulário.

    Criar um ou mais registros de transformação relacionados

    Cada registro de transformação relacionado executa um tipo de transformação específico, como adicionar caracteres ao início do valor ou substituir uma cadeia de caracteres por outra. Pode ser necessário criar vários registros de transformação relacionados para gerar um valor de campo de saída preferencial.

    Procedimento

    1. No registro de Transformação, selecione a Lista relacionada de Transformações.
    2. Clique em Nova.

      Uma lista de seleção de tipos de transformação é exibida, exibindo somente as transformações apropriadas para o tipo de campo selecionado.

      Figura 1. Tipos de transformação
      Tipos de transformação
    3. Selecione um tipo de transformação e forneça os parâmetros apropriados.
    4. Selecione um Número de pedido para esta transformação.
      Nota:
      As condições para as transformações são executadas de acordo com os números de ordem atribuídos.
    5. Marque a caixa de seleção Final para interromper o processamento com esta transformação se a condição for avaliada como verdadeira.
    6. Marque a caixa de seleção Diferencia maiúsculas de minúsculas para forçar a diferenciação de maiúsculas e minúsculas na declaração de condição.

      O exemplo de transformação a seguir substituirá o INC no início de um número de incidente pela cadeia de caracteres ENG se o grupo de atribuição for ITSM Engineering.

      Figura 2. Registro de transformação
      Registro de transformação
    7. Clique em Enviar.

      A nova transformação aparece na lista relacionada do registro de transformação.

      Quando a transformação é criada, um trabalho de dados da aplicação de transformação também é criado. Este trabalho de dados aplica esta transformação aos registros apropriados em todo o banco de dados e não deve ser executado até que o teste seja concluído.

    8. Opcional: Repita as etapas 2 a 8 até que o valor de saída atenda aos critérios desejados.

    Testar uma transformação

    Verifique se a transformação muda o valor do campo conforme desejado antes de aplicá-la aos registros existentes no banco de dados.

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    Os usuários devem ter a função normalization_tester para criar registros de teste.

    Novos registros de transformação são abertos no modo de teste por padrão, permitindo que os administradores testem as transformações completamente antes de aplicá-las aos registros existentes no banco de dados. No modo de teste, os controles Iniciar não estão disponíveis para o trabalho de transformação de dados da aplicação. Existem dois métodos, listados abaixo, para testar transformações antes de confirmar as transformações nos dados existentes.

    Procedimento

    • Crie ou atualize manualmente os registros de teste.

      No modo de teste, somente os registros que foram criados ou atualizados por um usuário com a função normalization_tester são transformados. Conceda as funções normalizador e normalization_tester ao mesmo usuário ou conceda-as a usuários separados.

    • Use o utilitário Testar transformações para inserir um valor bruto e ver o valor transformado resultante.

      Este recurso permite que um testador de normalização transforme valores de campos em tempo real sem abrir ou atualizar registros. Este utilitário testa todas as transformações configuradas para este campo.

      1. Abra um registro de Transformação.
      2. Clique no Link relacionado Testar transformações.

        Uma caixa de diálogo é exibida para testar valores de campo.

      3. Insira um valor a ser transformado no campo Dados brutos.
        Campo de dados brutos
      4. Clique em OK.

        A plataforma transforma o valor bruto no campo Dados transformados.

        Campo de dados transformado
      5. Insira novos dados brutos para testar outras transformações.
      6. Clique em Cancelar para encerrar o teste.
      7. Quando o teste estiver concluído, altere o Modo para Ativo e execute o trabalho de dados.