Ámbito de la aplicación ServiceNow

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

Consejo:

While the ServiceNow Application Scope activity can use standard authentication (UserName) and (Password), it is highly recommend to use OAuth security for all your connections per the steps below.

Las actividades de ServiceNow utilizan el protocolo OAuth 1.0 para establecer una conexión autenticada entre UiPath y su instancia de ServiceNow. Esta conexión autoriza a un Robot a llamar a las API de ServiceNow y acceder a los recursos en su nombre.

Para habilitar la autorización, crea un punto final de aplicación OAuth en tu instancia de ServiceNow. La creación de este punto final genera un registro de aplicación cliente OAuth, un ID de cliente y un secreto de cliente para habilitar el acceso autenticado a tu instancia.

After creating your endpoint, you enter your ServiceNow credentials along with the application endpoint URL, Client ID, and Client Secret in the ServiceNow Application Scope activity.

Consejo:

A los roles de usuario de integración solo se les deben asignar los permisos mínimos necesarios para realizar las tareas habilitadas por las actividades de este paquete (por ejemplo, admin, itil, SOAP_ECC, etc. no deben utilizarse para los roles de usuario de integración). Los servicios web entrantes que modifican tablas deben restringirse a los roles del sistema adecuados. Para obtener más información, consulta la sección Roles en la documentación de ServiceNow.

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Añade una actividad para cada propiedad de entrada SecureString (p. ej., dos en total: una para Contraseña y otra para SecretoDeCliente)
3. Add the ServiceNow Application Scope activity to your project.
4. Introduce valores para las propiedades Autenticación y Conexión .
5. Crea e introduce una variable IConnection para Propiedades de salida .

   • You can use this variable in subsequent uses of the ServiceNow Application Scope activity.

     

Si tienes problemas al utilizar la autenticación estándar, consulta Consejos de autenticación estándar.

En el cuerpo de la actividad

To build your project and enable the Object Wizard in other activities, you must use the Connection Wizard by clicking the Configure button.

Para obtener más información, consulta la sección Asistentes en la página Acerca de .

Propiedades

Autenticación

• Username - The username for your ServiceNow instance. Enter a String variable.
  • Este valor puede ser diferente de su cuenta de ServiceNow si tiene varias instancias.
  • El Nombre de usuario está asociado a la Contraseña. Se recomienda generar una variable String siguiendo la sección Crear activos de credenciales de la guía Configuración .
  • Para introducir tu variable String , utiliza una actividad que genere tu activo de credenciales (consulta el ejemplo a continuación).
• Password - The password (associated with the Username) to your ServiceNow instance. Enter a String or String variable.
  • Este valor puede ser diferente de su cuenta de ServiceNow si tiene varias instancias.
  • El Nombre de usuario está asociado a la Contraseña. Se recomienda generar una variable String siguiendo la sección Crear activos de credenciales de la guía Configuración .
  • Para introducir tu variable String , utiliza una actividad que genere tu activo de credenciales (consulta el ejemplo a continuación).
• Client Secret - The SecureString used to authorize communications between UiPath and your ServiceNow instance. Enter a SecureString variable.
  • El SecretoDeCliente se genera para tu instancia de ServiceNow cuando completas un registro de aplicación. Para obtener más información, consulta la sección Configuración de OAuth de la guía de Configuración .
  • Para generar una variable SecureString , consulta la sección Crear activos de credenciales de la guía Configuración .
  • Para introducir tu variable SecureString , utiliza una actividad que genere tu activo de credenciales (consulta el ejemplo a continuación).
• ClientId - The auto-generated, unique ID of your application registry. Enter a String variable.
  • El IDDeCliente se genera para tu instancia de ServiceNow al completar un registro de aplicación. Para obtener más información, consulta la sección Configuración de OAuth de la guía de Configuración .
  • El IDDeCliente está asociado al SecretoDeCliente. Se recomienda generar una variable String siguiendo la sección Crear activos de credenciales de la guía Configuración .
  • Para introducir tu variable String , utiliza una actividad que genere tu activo de credenciales (consulta el ejemplo a continuación).
• Puerto local (opcional) : el puerto local para la redirección. El valor predeterminado es 10001. Introduce una variable String o String .
• Use OAuth 2.0 - Check this to use OAuth2 code grant flow of ServiceNow.

Común

• DisplayName - The display name of the activity. Enter a String or String variable.

Conexión

• EndpointURL - The URL of your ServiceNow instance. Enter a String or String variable. The URL should be to your ServiceNow instance and not the Redirect URL in your application registry.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Opciones

• ReportApiErrorAsException - When selected, API error responses are reported in BusinessActivityExecutionException by all child activities that use this application scope. When cleared, the child activity populates the API error message in the ResponseStatus output property and workflow execution continues. Check the ResponseStatus property to confirm successful execution.

Salida

• ServiceNowConnection - A record of your established connection that you can use in subsequent ServiceNow Application Scope activities. Enter a IConnection variable (UiPath.BAF.Models.Connection.IConnection).

Usar conexión existente

• ExistingServiceNowConnection - A connection record from a parent ServiceNow Application Scope activity that you can use instead of establishing a new connection. Enter a IConnection variable (UiPath.BAF.Models.Connection.IConnection).
  • The IConnection variable must be from a previously run SeriviceNow Scope activity (parent) that still has an active connection.
  • If you're unable to establish a connection using this property, try re-running your parent ServiceNow Application Scope activity.

Ejemplo

La siguiente imagen muestra un ejemplo de la relación de dependencia de la actividad y los valores de las propiedades de entrada / salida.

Para obtener instrucciones paso a paso y ejemplos, consulta la guía de inicio rápido .

Consejos de autenticación estándar

En el paquete de actividades de ServiceNow, se puede utilizar la autenticación básica (nombre de usuario y contraseña) para ejecutar actividades. Los pasos se describen a continuación:

Tiempo de diseño

En el tiempo de diseño, introduzca el nombre de usuario y la contraseña con la URL del punto final y se guardarán estos detalles. Tenga en cuenta que las credenciales no se validan con ServiceNow para la autenticación básica a nivel de ámbito. Solo en una etapa posterior, cuando las entidades de ServiceNow se obtienen en una actividad individual o en tiempo de ejecución mientras se ejecuta una actividad, se usan estas credenciales de autenticación básicas para la autenticación.

Si las credenciales de autenticación básicas proporcionadas son incorrectas, se mostrará un error al cargar la lista de entidades, ya que utiliza las credenciales de autenticación básicas guardadas para conectarse a ServiceNow y obtener nombres de entidades / tablas.

If the credentials (Username, Password, EndpointUrl) are correct the entities will be populated in the activity dropdown like below:

Tiempo de ejecución

Asegúrese de que las credenciales se rellenen en el panel de propiedades de la derecha.

Si las credenciales son correctas, se ejecutará la actividad. Si es incorrecto, arrojará un error en tiempo de ejecución, como se muestra a continuación: