Datos de Acciones de Mis Cosas

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Bizagi desde aplicaciones externas > API de Bizagi para aplicaciones externas > Servicios OData > Índice de servicios > Servicios de Datos > Datos de Mis Cosas >

Datos de Acciones de Mis Cosas

Introducción

Bizagi ofrece un servicio OData que maneja aspectos del Diseño de Experiencia.

Por medio de la URI Stuff, puede manejar información respecto a la sección Mis Cosas para el Stakeholder autenticado, como se describe en My Stuff's data.

Esta sección describe como consultar y ejecutar una acción desde datos en Mis Cosas.

 

note_pin

Las acciones consideradas por este servicio son sólo aquellas que disparan nuevos procesos.

Las acciones que ejecutan reglar o lanzan formas no son soportadas.

 

URL del Recurso

Empezamos con la siguiente URL:

[url_del_proyecto_bizagi]/odata/data/stuff([ID_stuff])/values([ID_valor])/actions

 

Siendo:

[ID_stuff]: El GUID de una colección específica de Mis Cosas que es retornado al invocar Datos de Mis Cosas.

[ID_valor]: El ID de un ítem de una colección de Mis Cosas, como se retorna cuando se obtiene Datos de Mis Cosas.

[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/stuff([ID_stuff])/values([ID_valor])/actions

Mientras que para proyectos Bizagi PaaS, esta URL sería:

https://[ambiente_del_proyecto]-[su_proyecto]-[su_compañia].bizagi.com/odata/data/stuff([ID_stuff])/values([ID_valor])/actions

 

Ejemplo

La siguiente imagen ilustra como se puede enviar una solicitud HTTP GET para este recurso:

 

OData_SMyStuff3

 

Los resultados obtenidos (dentro del elemento value) son:

Name: El nombre único de la acción.

DisplayName: El nombre para mostrar por defecto de la acción, como se muestra para un registro.

@odata.id: La URL única para acceder la acción en específico.

Id: Una cadena de texto con el GUID que representa la URI de esta acción en específico.

Parameters: La lista de datos (atributos) que necesita la acción para correr una nueva (en este caso, iniciar un caso).

Estos parámetros incluyen para cada atributo:

oId: El GUID en una cadena de texto para el atributo.

oName: El nombre del atributo.

oXPath: El XPath completo para ese atributo (incluye su nombre).

oType: El tipo de dato para ese atributo. Una lista de los posibles valores para los tipos de datos en Bizagi se encuentra en Tipos de datos.

 

note_pin

Adicionalmente, para cada conjunto de resultados entregado por los servicios OData, la respuesta exitosa incluye un grupo de propiedades estándar que están precedidas por el símbolo @. Estas propiedades se describen en Propiedades y opciones de consulta.

 

Dese cuenta como desde la propiedad @odata.id, puede obtener únicamente el detalle de ese registro en específico en vez de una lista.

Por ejemplo, usando

[url_del_proyecto_bizagi]/odata/data/stuff([ID_stuff])/values([ID_valor])/actions([ID_accion])

 

OData_SMyStuff4

 

Para una acción dada, puede elegir ejecutarla.

Par más información en cómo ejecutar acciones, refiérase a Datos de Acciones Ejecutadas.