Objetos y archivos adjuntos

El propósito de esta guía es ayudarle a crear una muestra de trabajo que utilice las siguientes actividades de ServiceNow:

• Introducir registro de ServiceNow
• Añadir archivo adjunto
• Descargar archivo adjunto
• Eliminar archivo adjunto
• Obtener registro de ServiceNow
• Eliminar registro de ServiceNow

Esta muestra funcional le permite verificar rápidamente la conexión a su instancia de ServiceNow y familiarizarse con los tipos de datos de entrada / salida de la actividad.

Información general

Después de completar los pasos de esta guía, tendrá una secuencia de automatización que hará lo siguiente:

1. Establece una conexión a tu instancia de ServiceNow (Ámbito de ServiceNow).
2. Crea una nueva incidencia de ServiceNow (Insertar registro de ServiceNow).
3. Carga un archivo en el nuevo incidente (Añadir archivo adjunto).
4. Descarga el archivo cargado en una carpeta local (Descargar archivo adjunto).
5. Elimina el archivo cargado (Eliminar archivo adjunto).
6. Verifica que el archivo se eliminó al intentar recuperar el registro del archivo adjunto y mostrar el mensaje de error esperado (Obtener registro de ServiceNow, Si).
7. Elimina el incidente creado (Eliminar registro de ServiceNow).
   
   

   

   
   

Requisitos previos

Antes de comenzar:

1. Complete los pasos de configuración de ServiceNow.
2. Un archivo local para adjuntar a un registro de ServiceNow.

Pasos

1. Cree su proyecto.
2. Pruebe su proyecto.

Cree su proyecto

1. Añade una actividad Obtener credencial .
2. Introduzca el NombreDeActivo para el activo de credencial que creó (durante la configuración) para su nombre de usuario y contraseña de instancia de ServiceNow (por ejemplo, ServiceNowSignin).
3. Crea e introduce una variable SecureString para tu valor de Contraseña (p. Ej., password).
4. Crea e introduce una variable String para tu valor de nombre de usuario (. Por ejemplo, username).
5. Añade una segunda actividad Obtener credencial .
6. Introduzca el NombreDeActivo para el activo de credencial que creó (durante la configuración) para el ID de cliente y el secreto de cliente de la instancia de ServiceNow (por ejemplo, ServiceNowClients).
7. Crea e introduce una variable SecureString para tu valor de Contraseña (p. Ej., clientSecret).
8. Crea e introduce una variable String para tu valor de nombre de usuario (. Por ejemplo, clientId).
9. Añade la actividad Ámbito de ServiceNow después de las dos actividades Obtener credencial .
10. En la propiedad Secreto de cliente , introduce la variable SecureString que creaste para tu Secreto de cliente en los pasos anteriores (p. Ej., clientSecret).
11. En la propiedad Client ID , introduce la variable String que creaste para tu ID de cliente (p. Ej., clientId).
12. En la propiedad Contraseña , introduce la variable SecureString que creaste para tu contraseña en los pasos anteriores (p. Ej., Contraseña).
13. En la propiedad Nombre de usuario, introduce la variable String que creaste para tu nombre de usuario (p. Ej., clientId).
14. Crea e introduce una variable String para tu URL de punto final (p. Ej., endpointURL).
15. Añade la actividad Insertar registro de ServiceNow dentro de la actividad Ámbito de ServiceNow .
16. Haz clic en el botón Configurar dentro de la actividad Insertar registro de ServiceNow (esto abre el Asistente para objetos.
17. En la lista desplegable Seleccionar objeto , seleccione Incidente.
18. Cree e introduzca una String variable para el valor sys_id (p. Ej., sysID)
19. Usando el cuadro de texto Añadir un solo campo , introduce short_description.
    • Introduce un Valor_descripción_ corta ( por ejemplo, UiPath-Attachment).
20. Haz clic en Listo.
21. Cree e introduzca una variable ResponseStatus para el valor de ServiceNowStatus (p. Ej., insertRecordResponse).
22. Añade una actividad Escribir línea después de la actividad Insertar registro de ServiceNow .
23. Introduzca el siguiente texto: "Registro creado:" + insertRecordResponse.Success.ToString + "| sys_id:" + sysID (donde sysID es la variable creada para el campo de valor sys_id anterior).
    
    

    

    
    
24. Añade la actividad Añadir archivo adjunto después de la actividad Escribir línea .
25. Haz clic en el botón Configurar dentro de la actividad Añadir archivo adjunto .
26. En la lista desplegable Seleccionar objeto , selecciona Incidente.
27. En la propiedad NombreDeArchivo , introduce la ruta completa a tu archivo local (por ejemplo, "C:\UiPath_Projects\DemoFile.docx") o haz clic en el botón Elegir archivo de la actividad.
28. En la propiedad ObjectSysId , introduzca la variable sys_id que creó para la actividad Insertar registro (por ejemplo, sysID)
29. Crea e introduce una variable String para la propiedad AttachmentId (p. Ej., attachmentId).
30. Cree e introduzca una variable ResponseStatus para el valor de ServiceNowStatus (p. Ej., addAttachmentResponse).
31. Añade una actividad Escribir línea después de la actividad Insertar registro de ServiceNow .
32. Introduce el siguiente texto: "Archivo adjunto añadido:" + addAttachmentResponse.Success.ToString + "| sys_id:" +attachmentId (donde attachmentId es la variable creada para la propiedad AttachmentId anterior).
33. Añade la actividad Descargar archivo adjunto después de la actividad Escribir línea .
34. Introduce la Ruta del archivo donde quieres descargar el archivo (por ejemplo, "C:\UiPath_Projects\Downloads").
35. En la propiedad IDDelSistema , introduce la variable IDDeAdjunto que creaste para la actividad Añadir archivo adjunto (por ejemplo, attachmentId).
36. Añade la actividad Eliminar archivo adjunto después de la actividad Descargar archivo adjunto .
37. En la propiedad ObjectSysId , introduce la variable AttachmentId que creaste para la actividad Añadir archivo adjunto (por ejemplo, attachmentId).
    
    

    

    
    

Pruebe su proyecto

1. Añade la actividad Obtener registro de ServiceNow después de la actividad Eliminar archivo adjunto .
2. Haga clic en el botón Configurar dentro de la actividad Insertar registro de ServiceNow .
3. En la lista desplegable Seleccionar objeto , selecciona Archivo adjunto.
4. En el campo Valor de sys_id , introduce la variable AttachmentId que creaste para la actividad Añadir archivo adjunto (p. Ej., attachmentId)
5. Haz clic en Listo.
6. Cree e introduzca una variable ResponseStatus para el valor de ServiceNowStatus (p. Ej., getRecordResponse).
7. Añade una actividad Si después de la actividad Obtener registro de ServiceNow .
8. En la propiedad Condición , introduzca getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") para determinar si el registro de archivos adjuntos se eliminó correctamente comprobando el mensaje de error (donde getRecordResponse es la variable que ha creado para la propiedad ServiceNowStatus anterior).
9. En el cuadro Instrucción Entonces , agrega una actividad Escribir línea .
   1. En la propiedad Texto , introduce "Prueba aprobada:" +getRecordResponse.Message.
10. Añade Eliminar registro de ServiceNow después de la actividad Escribir línea .
    1. Haz clic en el botón Configurar dentro de la actividad Añadir archivo adjunto .
    2. En la lista desplegable Seleccionar objeto , selecciona Incidente.
    3. En la propiedad ID , introduce la variable sys_id que creaste para la actividad Insertar registro (por ejemplo, sysID).
    4. Cree e introduzca una variable ResponseStatus para el valor de ServiceNowStatus (p. Ej., deleteRecordResponse).
11. Agregue una actividad Escribir línea después de la actividad Eliminar registro de ServiceNow .
    1. En la propiedad Texto , introduce "Registro eliminado:" +deleteRecordResponse.Success.ToString.
12. En el cuadro Instrucción Si no, añade una actividad Escribir línea .
    1. En la propiedad Texto , introduce "Prueba fallida:" +getRecordResponse.Message.
13. Haz clic en Ejecutar y verifica que la ventana de Salida incluya los valores de línea de escritura esperados.
    
    

    

    
    

¡Ya está!

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.