Crie uma transformação em Central de controle de serviços

Versão de lançamento: Zurich

Atualizado 31 de jul. de 2025

4 min. de leitura

Como provedor ou consumidor, crie uma transformação em Central de controle de serviços para integrar tarefas entre instâncias conectadas.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

As etapas a seguir descrevem o processo de transformação dos provedores. Os consumidores podem navegar até Tudo > Consumidor da Central de controle de serviços > Transformações e seguir o mesmo processo.

Procedimento

Navegar até Tudo > Provedor da Central de controle de serviços > Administração > Transformações.
Clique em Nova.

No formulário, preencha os campos.

Tabela 1. Formulário de transformação
Campo	Descrição
Número	Número gerado automaticamente para o registro de transformação.
Empresa	Nome do consumidor ao qual esta transformação é aplicável.
Todas as empresas	Se esta opção for selecionada, a transformação será executada para todas as empresas, exceto aquelas com a mesma transformação no nível da empresa. Use este campo para criar uma definição de transformação padrão que pode ser aplicada a todas as empresas. O campo Todas as empresas elimina a necessidade de definir uma transformação específica para cada conta de cliente, mesmo quando eles têm requisitos semelhantes. Você pode usar a definição padrão para transformar campos específicos em todas as empresas simultaneamente. A transformação global é aplicada somente a empresas que correspondem à configuração e não têm uma transformação específica já definida. Se já existir uma transformação específica da empresa para a mesma configuração, isso substituirá a transformação global.
Tipo	Simples : Usado quando o campo tem uma lista de seleção conhecida e estável em cada instância. Uma lista relacionada de linhas de transformação é criada para corresponder aos valores de entrada e saída. Avançado : Usado para critérios complexos que exigem um script para determinar o novo valor. Entrada virtual : Usado para transformar um campo de entrada virtual. Requer um script para determinar o novo valor. Saída virtual : Usado para transformar um campo de saída virtual. Requer um script para determinar o novo valor.
Entrada	Opção que habilita uma transformação de entrada para esta transformação. Esta opção estará disponível somente se você selecionar o Tipo como Simples ou Avançado.
Saída	Opção que habilita uma transformação de saída para esta transformação. Esta opção estará disponível somente se você selecionar o Tipo como Simples ou Avançado.
Tabela do provedor	Opção que designa a tabela de tarefas do provedor. Por exemplo, Caso.
Tabela do consumidor	Opção que designa a tabela de tarefas do consumidor. Por exemplo, incidente.
Campo do provedor	Opção que designa o campo do provedor. Por exemplo, Estado. Este campo estará disponível somente se você selecionar o Tipo como Simples ou Avançado.
Campo de consumidor	Opção que designa o campo do consumidor. Por exemplo, Estado . Este campo estará disponível somente se você selecionar o Tipo como Simples ou Avançado.
Campo virtual	Quando o campo Tipo está definido como Entrada virtual ou Saída virtual este campo está disponível para fazer referência ao campo virtual que esta transformação deve preencher.

Clique em Salvar.

Selecione uma das seguintes propriedades:

Simples: Clique em Novo Na lista relacionada Linhas de transformação e preencha os campos no formulário.

Tabela 2. Formulário Linhas de transformação
Campo	Descrição
Rótulo do provedor	Opção que designa o rótulo de escolha do provedor. Por exemplo, Abrir.
Valor do provedor	Opção que designa o valor de escolha do provedor. Por exemplo, 10.
Rótulo do cliente	Opção que designa o rótulo de escolha do cliente. Por exemplo, andamento.
Valor do cliente	Opção que designa o valor de escolha do cliente. Por exemplo, 2.

Nota:

Você pode gerar mapeamentos de transformação entre as tabelas do provedor e do consumidor automaticamente usando o recurso Assistência de mapeamento de transformação. Para obter mais informações, consulte Automate transforms with Now Assist for TMT.

Avançado : Use um script para definir os rótulos e valores de saída e entrada, conforme mostrado no exemplo a seguir:

output.value=input.value;
output.label=input.label;

var ci=new GlideRecord('cmdb_ci');

if(direction=='inbound'){
   if(ci.get('correlation_id',input.value)){
      output.value=ci.sys_id+";
      output.label=ci.getDisplayValue();
      }
}
if (direction=='outbound'){
  if(ci.get(input.value)){
     if(ci.correlation_id){
        output.value=ci.correlation_id+";
        output.label=input.label;
       }
    }
}

Entrada virtual : Use um script para determinar o rótulo e o valor de entrada, conforme mostrado no exemplo a seguir:

var inputArr = input.value.split(',');
var outputValues = [];
var outputLabels = [];
for (i in inputArr) {
    getInstanceID(inputArr[i]);
}
output.value = outputValues+'';
output.label = outputLabels+'';

function getInstanceID(name) {
    var gr = new GlideRecord('cmdb_ci_server');
    if (gr.get('name', name)) {
        outputValues.push(gr.sys_id+'');
        outputLabels.push(name);
    }
}

Saída virtual : Use um script para determinar o rótulo e o valor de saída, conforme mostrado no exemplo a seguir:

/*
 ** The 'input' object contains the original value and label
 ** 'direction' contains an 'inbound' or 'outbound' value to determine transform direction
 ** 'object_data' contains the Remote Task GlideRecord
 ** It is required to set the variables 'output.value' and 'output.label' with your script.
 */
output.value = 'condev,conprod';
output.label = 'condev,conprod';

Clique em Enviar.
No formulário Transformar, clique em Ativar .

Resultado

Um registro de transformação é criado em seu ServiceNow® instância. Todos os campos de entrada ou saída da tarefa remota que correspondam a uma transformação os usarão automaticamente. Para saber mais, consulte Crie uma definição de tarefa remota em Central de controle de serviços Para provedores.