Cargar archivos o imágenes desde una aplicación externa

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Bizagi desde aplicaciones externas > API de Bizagi para aplicaciones externas > URL y notas importantes >

Cargar archivos o imágenes desde una aplicación externa

Introducción

A menudo en escenarios de integración entre aplicaciones, es necesario enviar archivos (documentos o imágenes) como parte de los datos de entrada.

Cuando se invoca Bizagi desde una aplicación externa, este escenario se logra fácilmente mediante el API de Bizagi, que se describe en API de Bizagi para aplicaciones externas.

Esto significa que los métodos web del API de Bizagi le permiten enviar información de negocio que incluye archivos, sea al momento de crear casos, completar actividades o disparar eventos de negocio en el flujo.

 

note_pin

Cargar archivos o imágenes a través del API de Bizagi aplica a los métodos del componente WorkflowEngineSOA (p.e, createCasesAsString, performActivityAsString, setEventAsString).

Para mayor información sobre estos métodos, consulte los Métodos web de WorkflowEngineSOA.

 

Sintaxis

Recuerde que al utilizar el API de Bizagi, el sistema externo debe enviar la información bajo un formato estándar XML.

 

Archivos

Lo siguiente aplica para los atributos de tipo Archivo de su modelo de datos, independientemente del tipo de archivo que será enviado y su extensión.

 

AdvanceFilesManagement_File

 

Para enviar archivos, usted deberá considerar lo siguiente:

El contenido del archivo debe ir como cadenas de texto codificadas en base 64.

Existen algunas palabras clave (reservadas) en la sintaxis de este uso: File, que debe ir como elemento XML con un atributo llamado fileName.

Los atributos de tipo archivo en Bizagi soportan más de un archivo.

Por lo tanto si desea enviar múltiples archivos, deberá repetir las ocurrencias del elemento File (uno por cada archivo).

 

La siguiente sintaxis ilustra la sección que representa cómo enviar archivos:

<Su_entidad>

 <Su_atributo_archivo>

         <File fileName="Adjunto1.txt">[bytes_codificados]</File>

         <File fileName="Adjunto2.txt">[bytes_codificados]</File>

         <File fileName="Adjunto3.txt">[bytes_codificados]</File>

 </Su_atributo_archivo>

</Su_entidad>

 

 

Imágenes

Lo siguiente aplica para los atributos de tipo Imagen de su modelo de datos, independientemente del tipo de imagen que será enviada y su extensión.

 

AdvanceFilesManagement_Image

 

Para enviar archivos o imágenes, usted deberá considerar lo siguiente:

El contenido debe ir como cadenas de texto codificadas en base 64.

De manera similar al manejo con archivos, existen algunas palabras clave (reservadas) en la sintaxis de este uso aunque el elemento File no se utiliza. El atributo llamado fileName deberá ir dentro del elemento del atributo como tal.

Los atributos de tipo imagen en Bizagi podrán almacenar como máximo un archivo de imagen.

 

La siguiente sintaxis ilustra la sección que representa cómo enviar archivos:

<Su_entidad>

 <Su_atributo_imagen fileName="MiImagen.png">

 [bytes_codificados]

 </Su_atributo_imagen>

</Su_entidad>

 

 

Ejemplo

El siguiente ejemplo ilustra cómo cargar archivos a Bizagi:

 

AdvancedFilesManagement17

 

Nótese que para este ejemplo:

La entidad de proceso se llama Incidente (Incident).

La entidad Incident tiene un atributo de tipo archivo llamado MiArchivo (MyFile), el cuál almacenará el archivo enviado.

A manera global, en este ejemplo, el archivo se envia a Bizagi cuando una aplicación externa invoca el método para crear un caso nuevo del proceso de Registro de incidentes (IncidentRegistration).