Configuración

Introducción

Para establecer correctamente una conexión y enviar solicitudes a la API de ServiceNow, la actividad Ámbito de ServiceNow necesita una URL de punto final para tu tenant de ServiceNow (URL de punto final), un nombre de usuario (Usuario) y una contraseña (Contraseña). Opcionalmente, puedes recuperar un token de acceso OAuth de tu tenant de ServiceNow. Para recuperar el token de acceso OAuth, se necesita el ID de cliente, el secreto de cliente y la URL del punto final de la instancia de ServiceNow.

If you choose to use OAuth, you must give the ServiceNow Scope activity the ability to retrieve the OAuth access token and enable the other activities to successfully send requests to the ServiceNow API, you must complete the following steps:

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 los pasos documentados son probablemente 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 (por ejemplo, Madrid, Nueva York, etc.)

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

Nota:

Si ya configuraste OAuth para tu instancia de ServiceNow, toma nota del 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. Go to System Definitions > Plugins and verify the OAuth plugin Status is set to Active.

   

3. Go to System OAuth > Application Registry and click New.

   • When asked What kind of OAuth application?, click Create an OAuth API endpoint for external clients.

     

4. Enter a Name for your application (e.g., UiPathQuickstart) and click Submit (if successful, you are redirected back to your Application Registries list).

   

5. In the Application Registries list, find your new application and click on its Name to open the details page.

6. Click on the lock icon next to Client Secret to show the value.

7. Take note of the Client Id and Client Secret values (you'll enter these in the ServiceNow Scope activity).

   

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

   Importante:

   A partir de la versión 1.3.8, hemos añadido soporte para 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 se establece en 10001 (por ejemplo, http://127.0.0.1:10001/authorize/). Al configurar tu aplicación OAuth, establece la URL de redireccionamiento 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 Ámbito de ServiceNow requiere entradas SecureString para tus credenciales de ServiceNow (Contraseña y SecretoDeCliente). 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. In the left-hand navigation, click Assets (this opens the Assets page).

3. Click the + icon to create a new Asset (this opens the Create Asset window).

   

4. Enter a Name and select Credential under Type.

5. In the Username field, enter the ClientId of your ServiceNow application registry.

6. In the Password field, enter the ClientSecret of your ServiceNow application registry.

7. Haz clic en Crear.

   

8. Repeat steps 3-7 to create another Asset for your ServiceNow Username and Password.

   

Construya su proyecto

1. Crear un nuevo proyecto de automatización.

   1. Open UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Enter a project Name, Location, and Description.

   4. Haz clic en Crear.

      

2. Install the UiPath.ServiceNowActivities package.
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Beta
   3. In the Search bar, enter ServiceNow.
   4. Click, install and accept the license for the 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áctico 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 familiarizarte 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.