Ámbito de la aplicación ServiceNow

UiPath.ServiceNow.Activities.ServiceNowScopeActivity

Consejo: aunque la actividad del ámbito de la aplicación de ServiceNow puede usar la autenticación estándar (NombreDeUsuario) y (Contraseña), se recomienda encarecidamente usar la seguridad OAuth para todas las conexiones según los pasos que se indican a continuación.

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, cree un punto final de la aplicación OAuth en su instancia de ServiceNow. La creación de este punto final genera un registro de aplicación cliente OAuth, una ID de cliente y un secreto de cliente para habilitar el acceso autenticado a tu instancia.

Después de crear tu punto de conexión, introduce tus credenciales de ServiceNow junto con la URL del punto de conexión de la aplicación, el ID de cliente y el Secreto del cliente en la actividad Ámbito de la aplicación de ServiceNow .

Consejo:

A los roles de usuario de integración solo se les debe 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 sistemaapropiados.

Para obtener más información, consulte 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. Agrega una actividad para cada propiedad de entrada de SecureString (p. Ej., Dos en total: una para Contraseña y otra para ClientSecret)
3. Agregue la actividad Ámbito de la aplicación ServiceNow a su proyecto.
4. Introduzca valores para las propiedades de Autenticación y Conexión .
5. Crea e introduce una variable IConnection para las propiedades de salida .

   • Puede utilizar esta variable en los usos posteriores de la actividad Ámbito de la aplicación de ServiceNow .

     
     

     

     
     

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

En el cuerpo de la actividad

Para crear tu proyecto y habilitar el Asistente para objetos en otras actividades, debes usar el Asistente de conexión haciendo clic en el botón Configurar .

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

Propiedades

Autenticación

• Nombre de usuario: el nombre de usuario para su instancia de ServiceNow. Introduce una variable String .
  • Este valor puede ser diferente de su cuenta de ServiceNow si tiene varias instancias.
  • El nombre de usuario está asociado con la contraseña. Se recomienda generar una variable String siguiendo la sección Crear activos de credenciales de la guía de configuración .
  • Para introducir tu variable String , utiliza una actividad que genere tu Activo de credencial (consulta el ejemplo a continuación).
• Contraseña : la contraseña (asociada con el nombre de usuario) de la instancia de ServiceNow. Introduce una variable String o String .
  • Este valor puede ser diferente de su cuenta de ServiceNow si tiene varias instancias.
  • El nombre de usuario está asociado con la contraseña. Se recomienda generar una variable String siguiendo la sección Crear activos de credenciales de la guía de configuración .
  • Para introducir tu variable String , utiliza una actividad que genere tu Activo de credencial (consulta el ejemplo a continuación).
• Secreto del cliente : el SecureString utilizado para autorizar las comunicaciones entre UiPath y tu instancia de ServiceNow. Introduce una variable SecureString .
  • ClientSecret se genera para su instancia de ServiceNow cuando completa el registro de una 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 de configuración .
  • Para introducir tu variable SecureString , utiliza una actividad que genere tu Activo de credencial (consulta el ejemplo a continuación).
• ClientId : el identificador único generado automáticamente del registro de tu aplicación. Introduce una variable String .
  • El ClientId se genera para su instancia de ServiceNow cuando completa el registro de una aplicación. Para obtener más información, consulta la sección Configuración de OAuth de la guía de configuración .
  • El ClientId está asociado con el ClientSecret. Se recomienda generar una variable String siguiendo la sección Crear activos de credenciales de la guía de configuración .
  • Para introducir tu variable String , utiliza una actividad que genere tu Activo de credencial (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 .
• Usar OAuth 2.0 : marca esta opción para usar el flujo de concesión de código OAuth2 de ServiceNow.

Común

• Nombre para mostrar: el nombre para mostrar de la actividad. Introduce una variable String o String .

Conexión

• URL delpunto final : la URL de su instancia de ServiceNow. Introduce una variable String o String . La URL debe ser su instancia de ServiceNow y no la URL de redirección en el registro de su aplicación.

Otros

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

Opciones

• ReportApiErrorAsException : cuando se selecciona, las respuestas de error de la API se notifican en BusinessActivityExecutionException por todas las actividades secundarias que usan este ámbito de aplicación. Cuando se borra, la actividad secundaria rellena el mensaje de error de la API en la propiedad de salida EstadoDeRespuesta y la ejecución del flujo de trabajo continúa. Comprueba la propiedad EstadoDeRespuesta para confirmar que la ejecución se ha realizado correctamente.

Salida

• ConexiónDeServiceNow: un registro de la conexión establecida que puedes utilizar en actividades posteriores del ámbito de la aplicación ServiceNow . Introduzca una variable IConnection (UiPath.BAF.Models.Connection.IConection).

Usar conexión existente

• ConexiónDeServiceNowExistente : un registro de conexión de una actividad del ámbito de la aplicación ServiceNow principal que puedes usar en lugar de establecer una nueva conexión. Introduzca una variable IConnection (UiPath.BAF.Models.Connection.IConection).
  • La variable IConnection debe ser de una actividad de ámbito de SeriviceNow ejecutada previamente (principal) que aún tiene una conexión activa.
  • Si no puedes establecer una conexión usando esta propiedad, vuelve a ejecutar tu actividad principal del ámbito de la aplicación ServiceNow .

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.

Si las credenciales (nombre deusuario, contraseña, URLdel punto final) son correctas, las entidades se completarán en el menú desplegable de actividades como se muestra a continuación:

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: