CoE Manager Plus: integrar con ServiceNow

Puede integrar CoE Manager Plus con ServiceNow para sincronizar datos entre los registros de ServiceNow, como tickets y oportunidades de CoE Manager Plus.

Procedimiento

  1. En la instancia de ServiceNow, registre una aplicación nueva y genere el ID de cliente y un secreto de cliente.
    1. Inicie sesión en ServiceNow como administrador.
    2. Navegue hasta Todos > Sistema OAuth > Registro de aplicaciones.
    3. Haga clic en Nuevo.
      Se mostrará una lista de las opciones.
    4. Seleccione Crear un extremo de API de OAuth para clientes externos.
    5. En la pantalla Registros de aplicaciones, haga clic en Nuevo.
    6. Proporcione un nombre para la aplicación. Por ejemplo, CoEMgr.
    7. Deje los valores predeterminados para los otros campos y haga clic en Enviar.
    8. Abra la aplicación y copie el ID del cliente y el Secreto del cliente al portapapeles.
  2. En la instancia de ServiceNow, puede obtener la tabla y el rol.
    1. Inicie sesión en ServiceNow como administrador.
    2. Navegue hasta Todos > Definición del sistema > Tablas.
    3. Busque su tabla proporcionando el nombre en el campo de etiqueta.
    4. Haga clic para abrir la tabla.
    5. Desde el campo Nombre, copie el nombre de la tabla al portapapeles.
    6. Desplácese hacia abajo hasta la pestaña Controles de acceso y abra el registro haciendo clic en el Nombre en la última fila.
    7. Desplácese hacia abajo hasta la pestaña Requiere rol y copie el Rol.
  3. En la instancia de ServiceNow, cree un usuario y asígnele un rol.
    1. Inicie sesión en ServiceNow como administrador.
    2. Navegue hasta Todos > Organización > Usuarios.
    3. Haga clic en Nuevo para crear un usuario nuevo.
    4. Ingrese el ID de usuario, el Nombre y Apellido.
    5. Seleccione las casillas de verificación Activo y Usuario de integración interna.
    6. Haga clic en Enviar.
      Esto hará que regrese a la página anterior.
    7. Busque el usuario que acaba de crear y haga clic para editarlo.
    8. Desplácese hacia abajo hasta la pestaña Roles y haga clic en Editar.
    9. Utilice el filtro y agregue el nombre de su aplicación para encontrar el rol correspondiente.
    10. Seleccione los dos roles y haga clic en Guardar.
      Se le redirigirá a la página para editar el usuario.
    11. Haga clic en Establecer contraseña > Generar y copie la contraseña generada al portapapeles.
    12. Haga clic en Guardar contraseña.
    13. En la página Editar usuario, haga clic en Actualizar.
  4. En la instancia de CoE Manager Plus, agregue la integración de ServiceNow.
    1. Inicie sesión como administrador.
    2. Vaya a la pestaña Admin-Tech.
    3. Haga clic en Agregar integración de automatización.
    4. Introduzca un nombre adecuado.
    5. Seleccione ServiceNow de la lista desplegable Proveedor.
    6. Introduzca la URL de instancia de ServiceNow y haga clic en Crear.
    7. Abra la integración de ServiceNow que se creó y haga clic en Editar.
    8. Introduzca los ajustes de configuración copiados al portapapeles: URL del proveedor, ID del cliente, secreto del cliente y el nombre de usuario, la contraseña y el nombre de la tabla de ServiceNow.
    9. Introduzca los atributos de asignación de campos de ServiceNow -> CoE Manager y CoE Manager -> de ServiceNow en formato JSON. Primero, establezca el nombre de la API del atributo Shibumi seguido del nombre del campo de ServiceNow. Observe el siguiente ejemplo.
      Asignación de campo de ServiceNow -> CoE Manager Asignación de campo de CoE Manager -> ServiceNow 
      {
"description":"idea_description",
"name":"idea_name"
}
      		 
      {
"Total_Savings_c":"expected_savings",
"Stage_c":"opportunity_status"
}

      Los dos atributos de la asignación de campos permiten que los datos se pasen desde CoE Manager a ServiceNow y viceversa. Puede consultar los atributos por asignar en Oportunidad > Detalles > Atributos en CoE Manager Plus. Del mismo modo, para verificar los atributos en ServiceNow, navegue hasta Todo > Explorador > Explorador de API REST. Utilice el método Get API para ver los atributos en el cuerpo de la respuesta.

    10. Haga clic en Guardar.
    11. La pestaña de ServiceNow ahora se agregó al menú Oportunidad .
  5. Cree una regla de negocio en ServiceNow.
    1. Inicie sesión en ServiceNow como administrador.
    2. Navegue hasta Todos > Definición del sistema > Reglas de negocio > Nueva.
    3. Ingrese el nombre de la regla de negocio.
    4. Seleccione la tabla desde la lista desplegable.
    5. Seleccione las casillas de verificación Activo y Avanzado.
    6. Vaya a la pestaña Cuándo ejecutar y seleccione Asincrónico en el menú desplegable Cuándo.
    7. Seleccione la casilla de verificación Insertar.
    8. Vaya a la pestaña Avanzado y pegue el script que se proporciona a continuación: 
      function executeRule(current, previous /*null when async*/ ) {
 try {
 var r = new sn_ws.RESTMessageV2();
 r.setEndpoint("https://util.shibumi.com/utilities/integration/service_now/create_shibumi_item_aai");
 r.setHttpMethod("post");
 
 	var k = "18856af6-fda9-41be-93cc-66548179b213"; 
 	var entId = "f79ce11f-bc4c-46e6-8d4a-4652ed132a24";
 		var parentTemplateAPIName ="Workstream__t";
 		var parentId ="1";
 		var templateAPIName = "Opportunity__t";
 		var serviceNowId = current.getValue("number"); 
 		var app = "App_29__app";
 		var snow_unique_id_attribute = "ServiceNow_ID__c";
 
 		var workstream = "Finance"; //current.getValue("business_unit");
 		var name = current.getValue("idea_name");
 		var instanceName = gs.getProperty("instance_name");

 
var body = "k="+k+"&entId="+entId+"&parentTemplateAPIName="+parentTemplateAPIName+"&parentId="+parentId+"&templateAPIName="+templateAPIName+"&serviceNowId="+serviceNowId+"&app="+app+"&snow_unique_id_attribute="+snow_unique_id_attribute+"&serviceNowUrl="+instanceName;

r.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
 //var body = JSON.stringify(obj);
 	gs.info("Webhook body: " + body);
 r.setRequestBody(body);

 		var response = r.execute();
 var httpStatus = response.getStatusCode();
 } catch (ex) {
 var message = ex.message;
       	 gs.error("Error message: " + message);
 }
	
 gs.info("Webhook target HTTP status response: " + httpStatus);

})(current, previous);

      Cuando se crea una idea nueva en ServiceNow, este script se ejecuta y crea una oportunidad en CoE Manager Plus.

      Actualice los siguientes campos en el script con los detalles que se proporcionan en la tabla Administrador-Avanzado.
      Variables en JS Valor encontrado en CoE Manager Variable en CoE Manager
      k Pestaña Administrador-Avanzado GUID DE LA API
      entId Pestaña Administrador-Avanzado ID de Enterprise
      Aplicación Pestaña Administrador-Avanzado Aplicación
      ID del elemento primario ID del flujo de trabajo, sección de Información en Flujo de trabajo. ID
  6. Vincule la idea de ServiceNow con la oportunidad en CoE Manager Plus.
    1. En su instancia de ServiceNow, copie el Número correspondiente a la idea en el portapapeles.
    2. En la instancia de CoE Manager Plus, navegue hasta la pestaña ServiceNow en su oportunidad.
    3. Haga clic en Actualizar oportunidad de CoEM o Actualizar registro de ServiceNow.
    4. Haga clic en el icono Actualizar.
      Los datos del registro de ServiceNow ahora están actualizados en la oportunidad en CoE Manager Plus. Puede ver todo el historial de auditoría en la página Oportunidad > Historial.
      Nota: La funcionalidad básica se proporciona como parte de CoE Manager Plus. Puede personalizarlo aún más para agregar otras funcionalidades.