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 la las búsquedas de los Stakeholders.
Esta sección describe como usar y ejecutar una búsqueda y explorar sus resultados.
URL del Recurso
Empiece con la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/searches([ID_busqueda])
Donde:
•[ID_busqueda]: El ID de una búsqueda en específico, como se obtiene con Datos de búsqueda.
•[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([ID_busqueda])
Mientras que para proyectos Automation Service, esta URL sería:
https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañía].bizagi.com/odata/data/searches([ID_busqueda])
Posibilidades con una búsqueda dada
Las siguientes opciones están disponibles una vez esté trabajando con una búsqueda en específico:
1.Ejecutarla al enviar filtros (parámetros).
La invocación para estos resultados es una acción HTTP POST dado que necesite enviar parámetros como se muestra en Ejecutar una búsqueda con parámetros.
2.Ejecutarla y obtener resultados por defecto sin filtros (parámetros).
La invocación para estos resultados es una acción HTTP GET dado que no necesita enviar parámetros, como se muestra en Ejecutar una búsqueda sin especificar parámetros.
Ejemplos
Para los dos escenarios descritos anteriormente, tenemos estos ejemplos.
1. Ejecutar una búsqueda con parámetros
Considere la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/searches([ID_busqueda])/performSearch
Incluya la siguiente estructura JSON para enviar los parámetros:
{
"startParameters": [
{
"XPath": "[nombre_XPath]",
"searchType": "[tipoBusqueda]",
"value": "[valor_para_XPath]"
}
]
}
Donde:
•[nombre_XPath]: El nombre del XPath como se espera de los parámetros de esa búsqueda.
•[tipoBusqueda]: Ya sea approx (para un valor aproximado basado en el texto), o exact (para un valor preciso).
•[valor_para_XPath]: El valor que desee usar como filtro para el parámetro XPath.
Si tiene más de un parámetro, usaría:
{
"startParameters": [
{
"XPath": "[nombre_xpath1]",
"searchType": "[tipoBusqueda]",
"value": "[valor_para_xpath1]"
},
{
"XPath": "[nombre_xpath2]",
"searchType": "[tipoBusqueda]",
"value": "[valor_para_xpath2]"
}
]
}
La siguiente imagen muestra la información que se puede enviar en la acción HTTP POST y el resultado de la invocación:
Los resultados de esta petición son los siguientes (dentro del elemento valor):
•@odata.id: La URL única para acceder ese registro en específico.
•Id: Una cadena de texto con el GUID que representa la URI para ese registro en específico.
•Parámetros: La lista de los parámetros asociados a la información de ese registro.
Estos parámetros incluyen conjuntos de información con:
oXPath: El XPath a ese atributo partiendo de la entidad de proceso.
oValor: El valor para ese XPath del registro.
|
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. |
Para una búsqueda dada, puede ejecutarla y explorar resultados (por ejemplo, para realizar acciones disponibles para un resultado).
Para mayor información sobre como ejecutar acciones en sus resultados, refiérase a Datos de acciones de resultados de búsquedas.
Formatos específicos
Consulte los siguientes enlaces para casos de uso específicos:
•Para filtrar la búsqueda con parámetros, tenga en cuenta las anotaciones para los diferentes tipos de datos, como se describen en Tipos de datos en las respuestas OData de Bizagi.
•Para obtener de manera dinámica los valores de negocio que pueda necesitar como parámetros de entrada para iniciar un proceso nuevo o completar una actividad, consulte los Valores de entidades relacionadas.
•Para obtener de manera dinámica las columnas que necesita llenar cuando se envían registros nuevos en colecciones, consulte Columnas en colecciones.
•Para conocer cómo construir un formato compatible a lo que se espera cuando se envían fechas, imágenes o adjuntos, o campos Booleanos, consulte Enviar parámetros de entrada.
2. Ejecutar una búsqueda sin especificar parámetros
Considere la siguiente URL:
[url_del_proyecto_bizagi]/odata/data/searches([ID_busqueda])/results
La siguiente imagen muestra como puede usar una acción HTTP GET para este recurso.
Los resultados de esta petición son los siguientes (dentro del elemento value):
•@odata.id: La URL única para acceder ese registro en específico.
•Id: Una cadena de texto con el GUID que representa la URI para ese registro en específico.
•Parámetros: La lista de los parámetros asociados a la información de ese registro.
Estos parámetros incluyen conjuntos de información con:
oXPath: El XPath a ese atributo partiendo de la entidad de proceso.
oValor: El valor para ese XPath del registro.
|
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 el detalle de un registro en específico, en vez de una lista.
Por ejemplo, al usar:
[url_del_proyecto_bizagi]/odata/data/searches([ID_busqueda])/results([ID_resultado])
Para una búsqueda dada, puede ejecutarla y explorar resultados (por ejemplo, para realizar acciones disponibles para un resultado).
Para mayor información sobre como ejecutar acciones en sus resultados, refiérase a Datos de acciones de resultados de búsquedas.