Criar uma transformação em Service Bridge

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura

    • Como provedor ou consumidor, crie uma transformação em Service Bridge 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 para provedores. Os consumidores podem navegar até Todos > Consumidor do Service Bridge > Transformações e siga o mesmo processo.

    Procedimento

    1. Navegar até Todos > Provedor do Service Bridge > Administração > Transformações.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Transformar formulário
      Campo Descrição
      Número Número gerado automaticamente para o registro de transformação.
      Empresa Nome do cliente para o 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 de nível de empresa.

      Use este campo para criar uma definição de transformação padrão que possa 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 elas 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 requerem 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.
      Saída Opção que habilita uma transformação de saída para esta transformação.
      Tabela do provedor Opção que designa a tabela de tarefas do provedor. Por exemplo, Caso.
      Campo do provedor Opção que designa o campo do provedor. Por exemplo, Estado.
      Tabela do consumidor Opção que designa a tabela de tarefas do consumidor. Por exemplo, incidente.
      Campo de consumidor Opção que designa o campo do consumidor. Por exemplo, Estado.
      Campo de entrada Quando o campo Tipo é definido como Entrada virtual, esse campo fica disponível para fazer referência ao campo virtual que esta transformação deve preencher.
      Campo de saída Quando o campo Tipo é definido como Saída virtual, esse campo fica disponível para fazer referência ao campo virtual que esta transformação deve preencher.
    4. Clique em Salvar.
    5. Selecione uma das seguintes propriedades:
      1. Simples: clique em Novo na lista relacionada Transformar linhas e preencha os campos no formulário.
        Tabela 2. Formulário de 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.
      2. Avançado: use um script para definir os rótulos e os valores de saída e de 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;
       }
    }
}
      3. 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);
    }
}
      4. Saída virtual: use um script para determinar o rótulo de saída e o valor, 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';
    6. Clique em Enviar.
    7. No formulário de transformação, clique em Ativar.

    Resultado

    Um registro de transformação é criado na sua instância ServiceNow®. Os campos de entrada ou de saída de qualquer tarefa remota que correspondam a uma transformação os usarão automaticamente. Para saber mais, consulte Criar definições de tarefa remota em Service Bridge para provedores.