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

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Bizagi desde aplicaciones externas > API de Bizagi para aplicaciones externas > Servicios web SOAP > 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>

 

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

 

SOAFileExample

 

 

Nótese que para este ejemplo:

La entidad de proceso se llama Mi proceso (MyProcess).

La entidad MyProcess tiene un atributo de tipo archivo llamado Mi archivo (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 llamado MyProcess usando el siguiente modelo de datos;

 

SOAProcessExample

 

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>

         <File fileName="MiImagen.png">[bytes_codificados]</File>

 </Su_atributo_imagen>

</Su_entidad>

 

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

 

SOAImageExample

 

 

Nótese que para este ejemplo:

La entidad de proceso se llama Mi proceso (MyProcess).

La entidad MyProcess tiene un atributo de tipo archivo llamado Mi imagen (Myimage), 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 llamado MyProcess usando el siguiente modelo de datos;

 

SOAProcessExample