Introducción
Bizagi ofrece un servicio OData que maneja aspectos de Diseño de Experiencia, como se explica en Servicios de datos.
Por medio de la URI de Searches, puede manejar información relacionada a las búsquedas de los Stakeholders.
URL del Recurso
Empecemos con la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/searches
Donde:
•[url_del_proyecto_bizagi]: Corresponde a la URL donde los usuarios finales acceden al Portal de Trabajo de Bizagi.
Por ejemplo, para proyectos de Bizagi en sus instalaciones, esta URL sería:
https://[su_servidor]/[su_proyecto]/odata/data/searches
Mientras que para proyectos Automation Service, esta URL sería:
https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañía].bizagi.com/odata/data/searches
Ejemplo
La siguiente imagen ilustra como se puede enviar una petición HTTP GET para este recurso:
Los resultados de esta petición son los siguientes (dentro del elemento valor):
•Nombre: El nombre único de la búsqueda para ese Stakeholder.
•displayName: El nombre para mostrar por defecto de la búsqueda, como lo ve el Stakeholder.
•@odata.id: La URL única para acceder a esa búsqueda en específico.
•Id: Una cadena de texto con el GUID que representa la URI para esa búsqueda en específico.
•parameters: La lista de datos (atributos) que esa búsqueda necesita para realizar una nueva.
Estos parámetros incluyen para cada atributo:
oId: El GUID del atributo en una cadena de texto.
oNombre: El nombre para mostrar del atributo.
oXPath: El XPath completo para ese atributo (incluye su nombre).
oTipo: El tipo de dato de ese atributo. Para una lista de los posibles valores de tipos de dato en Bizagi, refiérase a Tipos de datos.
•Acciones: La lista de las acciones disponibles para esa colección de Mis Cosas.
Estos parámetros incluyen para cada acción:
oId: El GUID de la acción en una cadena de texto.
oNombre: El nombre único de la acción.
odisplayName: El nombre para mostrar de la acción.
oParámetros: La lista de los parámetros necesarios para ejecutar esta acción, que especifica ID, nombre, XPath y tipo de dato del parámetro (de acuerdo a Tipos de datos).
•Plantilla: La lista de datos (atributos) que esta búsqueda usa cuando muestra los registros que coinciden.
Este template incluye conjuntos de información, que tienen:
oNombre: El nombre del atributo.
oXPath: El XPath a ese atributo partiendo de la entidad de proceso.
oTipo: El tipo de dato de ese atributo. Para una lista de los posibles valores de tipos de dato en Bizagi, refiérase a Tipos de datos.
|
Adicionalmente, para cada conjunto de resultados entregados por los servicios OData, la respuesta exitosa incluye un grupo de propiedades estándar que son precedidas por el símbolo @. Estas propiedades se describen en Propiedades y opciones de consulta. |
Note como por medio de la propiedad @odata.id, puede obtener únicamente el detalle de un registro en específico en vez de una lista.
Por ejemplo usando
[url_del_proyecto_bizagi]/odata/data/searches([ID_busqueda])
Para una búsqueda dada, puede ejecutarla y explorar los resultados (por ejemplo ejecutar las acciones disponibles para un resultado).
Para mayor información sobre cómo continuar para ejecutar búsquedas y navegar sus resultados, refiérase a Resultados y datos para ejecución de búsquedas.
Note que puede también obtener acciones disponibles para las búsquedas en general.
Por ejemplo usando:
[your_bizagi_project_url]/odata/data/searches([ID_busqueda])/actions
Y podrá de igual manera entrar al detalle de dicha acción.
Por ejemplo usando:
[your_bizagi_project_url]/odata/data/searches([ID_busqueda])/actions([ID_accion])
Personalizar los atributos retornados
En caso de que desee filtrar o cambiar por completo los atributos que han sido entregados con esta invocación, refiérase a Configurar qué información de negocio se retorna.