Profundizando en el consumo de APIS REST

1. BIENVENIDOS
PROFUNDIZANDO
EN EL CONSUMO DE
APIS REST DESDE
UIPATH

2. TITTLE HERE
• Contexto acerca de los APIs web
• Estructura JSON
• Dependencias e instalación
• ¿Qué es un JObjects/JArray?
• Manejo de JObjects/JArray
• Autenticación
• Workshop
• Sección de preguntas
A G E N D A

3. Omar Contreras
Intelligent Automation Leader,
Mayasoft
Juan Estupiñan
Digital Transformation Leader,
Mayasoft
Lynda Quintero
Intelligent Automation Project Manager,
Mayasoft
O R A D O R E S

4. TITTLE HERE
¿Por qué son importantes las APIS Web?
API
REST
Cliente
API
REST
Base de
datos
Servicio de
terceros
{…}
{…}

5. TITTLE HERE
APIS Web. Ventajas de as APIS en automatización
Entorno más controlado
vs interfaz gráfica
Menos vulnerabilidad
ante el cambio
Mayor velocidad vs las
actividades de usuario

6. TITTLE HERE
¿Por qué son importantes las APIS Web?
API
REST
Cliente
API
REST
Base de
datos
Servicio de
terceros
{…}
{…}

7. TITTLE HERE
APIS Web.
Conceptos clave de las APIS REST
Solicitud:
Mensaje que envía un cliente a
un servidor para acceder a un servicioweb.
Tiene encabezados y un cuerpo.
Timeout:
Tiempolímite de duración de
una conexión
Respuesta:
Mensaje que retorna un servidor a
un cliente luegode una solicitud.
Tiene encabezados,cuerpoy
un Código de respuesta.
EndPoint:
URL o ruta de un servicioweb
Métodos:
GET – POST – PATCH - DELETE
JSON

8. TITTLE HERE
Estructura JSON

9. TITTLE HERE
Dependencias e instalación
Para el consumo de WEB API es necesario instalar el paquete oficial
de UiPath llamado UiPath.WebAPI.Activities desde UiPath Studio
menú Design/Manage Package

10. TITTLE HERE
Para el consumo de WEB API es necesario instalar el paquete oficial
de UiPath llamado UiPath.WebAPI.Activities desde UiPath Studio
menú Design/Manage Packages
Dependencias e instalación

11. TITTLE HERE
• La librería utilizada por UiPath para el manejo de JSON se llama newtonsoft.Json.
• UiPath provee varias actividades para el consumo de API y conversión de JSON
Dependencias e instalación

12. TITTLE HERE
HTTP Request Activity
Dependencias e instalación
Properties Wizard

13. TITTLE HERE
Dependencias e instalación
Properties Deserialize JSON Activity Properties Deserialize JSON Array Activity

14. TITTLE HERE
Qué es un JOBJECT/JARRAY?

15. TITTLE HERE
¿Qué es un JOBJECT?
El manejo de objetos JSON se puede realizar mediante la clase llamada JObject, los objetos JSON
también se pueden representar en Diccionarios cuya llave sea una cadena y el valor un objeto.

16. TITTLE HERE
¿Qué es un JARRAY?
La clase JArray representa una secuencia ordenada de valores indexados donde los valores pueden ser
de cualquier combinación (JSONObject, JSONArray, Integer, Double, Boolean, String).

17. TITTLE HERE
MANEJO DE JOBJECT/JARRAY
Propiedades y métodos más usados en JObject
https://www.newtonsoft.com/json/help/html/T_Newtonsoft_Json_Linq_JObject.htm
Propiedades
Item[String] Obtiene o estableceel JToken con el
nombre de propiedadespecificado.
Count Obtiene el recuentode tokens JSON
secundarios.
HasValues Obtiene un valor que indica si este
JObject tiene tokens secundarios.
Métodos
ContainsKey Determina si el objeto JSON tiene la propiedad
especifica.
DeepClone Crea una nueva instanciade JToken. Todos los tokens
secundarios se clonan recursivamente.
FromObject Crea un JObject a partir de un objeto.
Parse Cargue un JObject desde un string que contenga JSON.
Remove Eliminaeste token de su padre.
ToObject(Type) Crea una instanciadel tipo .NET especificadoa partir
de JToken.
ToString Devuelve el stringindentadodel valor del token.

18. TITTLE HERE
MANEJO DE JOBJECT/JARRAY
Propiedades y métodos más usados en JArray
https://www.newtonsoft.com/json/help/html/T_Newtonsoft_Json_Linq_JArray.htm
Propiedades
Item[Int32] Obtiene o estableceel JToken en el
índice especificado.
Count Obtiene el recuentode los elementos
del array.
First Obtiene el primer elementodel
array.
Last Obtiene el últimoelementodel array.
Métodos
ToObject(Type) Crea una instanciadel tipo .NET especificadoa partir de JT
oken.(Ej. List, Array)
DeepClone Crea una nueva instanciade JToken. Todos los tokens
secundarios se clonan recursivamente.
FromObject Crea un JObject a partir de un objeto.
Parse Cargue un JObject desde un string que contenga JSON.
Add(JToken) Agrega un elementoal JArray.
Remove Eliminaeste token de su padre.
ToString Devuelve el stringindentadodel valor del token.

19. TITTLE HERE
MANEJO DE JOBJECT/JARRAY
Métodos
FirstOrDefault: JToken array.FirstOrDefault(function(x)x.Item("cedula").ToString().Equals("12345"))
Where: IEnumerable<JToken> array.Where(Function(x)x.Item("edad").ToObject(OfInt32)=25)
All: Boolean array.All(Function(x)x.Item("activo").ToObject(OfBoolean))
Any: Boolean array.Any(Function(x)x.Item("activo").ToObject(OfBoolean))
Select: IEnumerable<T> array.Select(function(x)x.Item("nombre").ToString()).OfType(OfString)
OrderBy/OrderByDescending:I
Enumerable<JToken>
array.OrderBy(Function(x)x.Item("edad").ToObject(OfInt32))
Herencia JArray: IList<JToken>, ICollection<JToken>,
IEnumerable<JToken>

20. TITTLE HERE
AUTENTICACIÓN WEB
Recurso web
sensible
Solicitud
Unauthorized401
Solicitudautenticada
Respuesta
¿Por qué es necesaria la autenticación?
Cliente
{…}

21. TITTLE HERE
AUTENTICACIÓN WEB
AUTENTICACIÓNBÁSICA

22. TITTLE HERE
AUTENTICACIÓN WEB
AUTENTICACIÓNOAUTH

23. workshop
https://gitlab.com/mayasoftrepopublic/uipath-chapter-colombia/rest-api-consumption

24. TITTLE HERE
UiPath Community
→ Únete a nuestro grupo en LinkedIn:
UiPath Community Colombia chapter
https://www.linkedin.com/groups/14095058/
→ Encuentra nuestro chapter desde la página
oficial de UiPath community aquí:
https://community.uipath.com/colombia/

25. SECCIÓN DE
PREGUNTAS