Configuración

Introducción

Para establecer correctamente una conexión y enviar solicitudes a la API de ServiceNow, la actividad del ámbito de ServiceNow necesita una URL de punto de conexión para su tenant de ServiceNow (URLde punto de conexión), un nombre de usuario (UserName) y una contraseña (Password). De forma opcional, puede recuperar un token de acceso de OAuth de su tenant de ServiceNow. Para recuperar el token de acceso de OAuth, necesita su ID de cliente, el secreto de cliente y la URL del punto final de la instancia de ServiceNow.

Si elige usar OAuth, debe otorgar a la actividad del ámbito de ServiceNow la capacidad de recuperar el token de acceso de OAuth y habilitar las otras actividades para enviar solicitudes con éxito a la API de ServiceNow; debe completar los siguientes pasos:

1. Configurar OAuth.
2. Crear activos de credenciales.
3. Construya su proyecto.
   
   

   

   
   

Configurar OAuth

Completa los pasos de configuración de OAuth en la documentación de ServiceNow. Aunque es probable que los pasos documentados sean los mismos en todas las regiones de la plataforma ServiceNow, se recomienda que sigas los pasos para tu región específica en caso de que haya diferencias (p. ej., Madrid, Nueva York, etc.)

Como referencia, a continuación se muestra cómo configuramos OAuth para nuestros ejemplos.

Nota: Si ya has configurado OAuth para tu instancia de ServiceNow, anota el ID de cliente y el Secreto de cliente asignados a tu registro de aplicaciones y continúa con el paso 2. Crear activos de credenciales .

1. Inicie sesión en su instancia de ServiceNow (por ejemplo, https://dev74293.service-now.com/login)

2. Ve a Definiciones del sistema> Complementos y verifica que el Estado del complemento de OAuth esté establecido en Activo.

   
   

   

   
   

3. Ve a Sistema OAuth> Registro de aplicaciones y haz clic en Nuevo.

   • Cuando se le pregunta ¿Qué tipo de aplicación OAuth?, haz clic en Crear un punto final de la API de OAuth para clientes externos.

     
     

     

     
     

4. Introduzca un nombre para su aplicación (por ejemplo, UiPathQuickstart) y haga clic en Enviar (si tiene éxito, se le redirigirá de nuevo a la lista de Registros de la aplicación ).

   
   

   

   
   
5. En la lista de Registros de aplicaciones , busca tu nueva aplicación y haz clic en su nombre para abrir la página de detalles.
6. Haga clic en el icono de candado junto al Secreto del cliente para mostrar el valor.

7. Tome nota de los valores de ID de cliente y Secreto del cliente (los introducirá en la actividad Ámbito de ServiceNow ).

   
   

   

   
   
8. Si quieres que esta aplicación OAuth sea compatible con OAuth2, debes establecer la URL de redirección en http://127.0.0.1:10001/authorize/.
   Importante:

   A partir de la versión 1.3.8, hemos añadido compatibilidad con el puerto local. El parámetro Puerto local , disponible en Ámbito de aplicación de ServiceNow, es opcional y configurable. De forma predeterminada, su valor está establecido en 10001 (por ejemplo, http://127.0.0.1:10001/authorize/). Cuando configures tu aplicación OAuth, establece la URL de redirección en: http://127.0.0.1:{LocalPort}/authorize/. Por ejemplo, para el puerto local 10002, la URL de redirección sería http://127.0.0.1:10002/authorize/. No es aconsejable cambiar el puerto local en el mismo proyecto. Si el puerto cambia, crea un nuevo proyecto o flujo de trabajo para evitar errores de caché, si los hubiera.
   
   

   

   
   

Crear activos de credenciales

La actividad de ámbito de ServiceNow requiere entradas SecureString para sus credenciales de ServiceNow (Contraseña y ClientSecret). Para generar las variables SecureString , se recomienda crear dos Activos de credenciales en tu Tenant de Orchestrator.

1. Inicie sesión en el Tenant de Orchestrator que desea usar para su proyecto.
2. En el panel de navegación de la izquierda, haz clic en Activos (se abre la página Activos).

3. Haga clic en el icono + para crear un nuevo Activo (se abre la ventana Crear activo ).

   
   

   

   
   
4. Introduce un Nombre y selecciona Credencial en Tipo.
5. En el campo Nombre de usuario, introduce el ClientId del registro de tu aplicación ServiceNow.
6. En el campo Contraseña , introduzca el ClientSecret del registro de su aplicación ServiceNow.

7. Haz clic en Crear.

   
   

   

   
   

8. Repita los pasos 3-7 para crear otro Activo para su nombre de usuario y contraseña de ServiceNow.

   
   

   

   
   

Construya su proyecto

1. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.
   2. En Nuevo proyecto, haz clic en Proceso (se abre una ventana Nuevo proceso en blanco ).
   3. Introduce un Nombre, una Ubicacióny una Descripcióndel proyecto.

   4. Haz clic en Crear.

      
      

      

      
      

2. Instale el paquete UiPath.ServiceNowActivities .

   1. En la cinta Diseño , haz clic en Administrar paquetes (se abre la ventana Administrar paquetes ).
   2. En Todos los paquetes, haz clic en Beta
   3. En la barra de búsqueda , ingrese ServiceNow.

   4. Haz clic en, instala y acepta la licencia de UiPath.ServiceNow.Activities.

      • Para obtener más información sobre los paquetes de Uipath Studio, consulta Gestionar paquetes en la Guía de Studio.

¡Ya está!

Ahora que ha completado la configuración, puede comenzar a agregar las actividades de ServiceNow a su proyecto.

Próximos pasos

Para una experiencia de aprendizaje práctica y para empezar a utilizar rápidamente las actividades, consulta la guía de inicio rápido . Esta guía proporciona instrucciones paso a paso para ayudarte a crear una muestra funcional de las diferentes actividades para que puedas verificar la conexión a tu instancia de ServiceNow y familiarizarse con las propiedades de entrada / salida.

Para obtener más información sobre las actividades de ServiceNow (incluidas las entradas / salidas de propiedades de ejemplo), consulta la página Actividades para obtener una lista completa de actividades y enlaces a las páginas de detalles de las actividades.