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 un nuevo incidente 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. Completa los pasos de configuración de ServiceNow.
2. Un archivo local para adjuntar a un registro de ServiceNow.

Pasos

1. Crea tu proyecto.
2. Pruebe su proyecto.

Construya su proyecto

1. Añade una actividad Obtener credencial .

2. Introduce el AssetName para el activo de credenciales que creaste (durante la configuración) para el nombre de usuario y la contraseña de tu instancia de ServiceNow (por ejemplo, ServiceNowSignin).

3. Crea e introduce una variable SecureString para tu valor de Contraseña (por ejemplo, password).

4. Crea e introduce una variable String para tu valor de Nombre de usuario (por ejemplo, username).

5. Add a second Get Credential activity.

6. Introduce el AssetName para el activo de credenciales que creaste (durante la configuración) para tu ID de cliente y secreto de cliente de la instancia de ServiceNow (por ejemplo, ServiceNowClients).

7. Crea e introduce una variable SecureString para tu valor de Contraseña (por ejemplo, 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 (por ejemplo, clientSecret).

11. En la propiedad ID de cliente , introduce la variable String que creaste para tu ID de cliente (por ejemplo, clientId).

12. In the Password property, enter the SecureString variable you created for your password in the steps above (e.g., password).

13. En la propiedad Nombre de usuario , introduce la variable String que creaste para tu nombre de usuario (por ejemplo, clientId).

14. Crea e introduce una variable String para tu URLDePuntoFinal (por ejemplo, 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 de objetos.

17. En la lista desplegable Seleccionar objeto , selecciona Incidente.

18. Crea e introduce una variable String para el valor sys_id (por ejemplo, sysID)

19. Utilizando el cuadro de texto Añadir campo único , introduce short_description.

    • Introduce un valor short_description (por ejemplo, UiPath-Attachment).

20. Click Done.

21. Crea e introduce una variable ResponseStatus para el valor de ServiceNowStatus (por ejemplo, insertRecordResponse).

22. Añade una actividad Escribir línea después de la actividad Insertar registro de ServiceNow .

23. Introduce 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. Click the Configure button inside the Add Attachment activity.

26. En la lista desplegable Seleccionar objeto , selecciona Incidente.

27. En la propiedad NombreDelArchivo , introduce la ruta completa a tu archivo local (por ejemplo, "C:\UiPath_Projects\DemoFile.docx") o haz clic en el botón Elegir archivo en la actividad.

28. En la propiedad ObjectSysId , introduce la variable sys_id que creaste para la actividad Insertar registro (por ejemplo, sysID)

29. Crea e introduce una variable String para la propiedad IDDeAdjunto (por ejemplo, attachmentId).

30. Crea e introduce una variable ResponseStatus para el valor de ServiceNowStatus (por ejemplo, addAttachmentResponse).

31. Añade una actividad Escribir línea después de la actividad Insertar registro de ServiceNow .

32. Introduce el siguiente texto: "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 RutaDeArchivo donde quieres descargar el archivo (por ejemplo, "C:\UiPath_Projects\Downloads").

35. En la propiedad SysId , introduce la variable AttachmentId 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. Click the Configure button inside the Insert ServiceNow Record activity.

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 (por ejemplo, attachmentId)

5. Click Done.

6. Crea e introduce una variable ResponseStatus para el valor de ServiceNowStatus (por ejemplo, getRecordResponse).

7. Añade una actividad Si después de la actividad Obtener registro de ServiceNow .

8. En la propiedad Condición , introduce getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") para determinar si el registro del archivo adjunto se eliminó correctamente comprobando el mensaje de error (donde getRecordResponse es la variable que creaste para la propiedad ServiceNowStatus anterior).

9. In the Then statement box, add a Write Line activity.

   1. En la propiedad Texto , introduce "Prueba superada: "+getRecordResponse.Message.

10. Añade Eliminar registro de ServiceNow después de la actividad Escribir línea .

    1. Click the Configure button inside the Add Attachment activity.
    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. Crea e introduce una variable ResponseStatus para el valor de ServiceNowStatus (por ejemplo, deleteRecordResponse).

11. Add a Write Line activity after the Delete ServiceNow Record activity.

    1. En la propiedad Texto , introduce "Registro eliminado: "+deleteRecordResponse.Success.ToString.

12. In the Else statement box, add a Write Line activity.

    1. En la propiedad Texto , introduce "Prueba fallida: "+getRecordResponse.Message.

13. Click Run and verify the Output window includes the expected write line values.

    

¡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.