Ver código fuente

<keywords content="keywords">
archivo, archivos, subir, documento, documentos, file, archivo xpath, archivos xpath
</keywords> 

= Manejo Avanzado de Atributos Tipo Archivo  =

Bizagi [[Manejo_avanzado_de_archivos|administra fácilmente]] los [[Atributos Tipo Archivo|documentos]] entrantes de un proceso, ya que Bizagi permite adjuntar archivos (documentos de procesadores de texto, datos de hojas de cálculo, archivos de audio y video) a la aplicación, asociándolos directamente al caso especifico de negocio. 

Esto permite hacerle seguimiento en los diferentes puntos del proceso y que los usuarios correspondientes tengan acceso a estos de forma continua durante la ejecución del proceso.<br><br>Como el archivo hace parte de la información del caso, este pertenece al modelo de datos que esta soportando el proceso. Por este motivo, para poder adjuntar un archivo a un caso es necesario crear un tipo de campo 'Archivo(File)' en la entidad de negocio correspondiente. Una ventaja sobre las versiones anteriores, es que con un solo atributo es posible adjuntar multiples archivos en el mismo caso de negocio.Estos documentos pueden ser adjuntados o no a la aplicación y pueden tener más información relacionada acerca de cada documento como Fecha de Recibido, Fecha de Revisión, si se encuentra aprobado o no, si es requerido, etc. 

Bizagi también permite parametrizar los documentos de un proceso según el trámite realizado. <br><br>El tratamiento que Bizagi da a los archivos en la aplicacion web, es [[Configuracion de Ambiente#Avanzado_.28Advanced.29|configurable desde Bizagi Studio y la Consola de Administracion.]] <br><br>Por defecto el tamaño máximo de los uploads es 1 MB. Sin embargo depende de las capacidades del servidor (memoria), de la red desde donde se adjunte el archivo y de las necesidades de negocio. Se recomienda que el tamaño máximo este alrededor de 10 MB, pero puede variar dependiendo de las necesidades específicas. 

== Ejemplos ==


Es posible que un usuario necesite subir archivos en un atributo que haya sido obtenido, por ejemplo, a través de una interface. 

Bizagi permite subir un archivo a un atributo usando una Expresión. El archivo que será subido es recibido usualmente por un servicio Web, como un Arreglo de Bytes. 

Es importante que el atributo en el que el archivo será subido sea una atributo de tipo Archivo.<br>

<br>
=== Adjuntar un archivo desde una expresión  ===

En este ejemplo, en un Proceso de Solicitud de Préstamo la entidad principal de negocio es llamada <span style="color: rgb(0,0,255)">Request</span>. Asuma que en esta entidad hay un atributo llamado <span style="color: rgb(0,0,255)">HistoryFile </span>que almacenará una carta subida vía servicio Web.<br>

<br>

[[Image:HowToUploadFile Image003.jpg|center]]<br>

El Servicio Web tiene que retornar un Arregla de Bytes que contenga los datos del archivo. Asuma que este arreglo se graba en la variable <span style="color: rgb(0,0,255)">FileData</span>.<br>

<br>

Para subir un archivo en una Regla, '''LA SINTAXIS CORRECTA''' para la expresión es: 

<br>

<span style="color: rgb(0,0,128)">var FileToUpload = Me.addRelation("<span style="color: rgb(0,0,255)">Request.HistoryFile</span>");</span> 

<span style="color: rgb(0,0,128)">FileToUpload.setXPath("<span style="color: rgb(255,0,0)">FileName</span>", "DisplayNameOfTheFile.txt");</span> 

<span style="color: rgb(0,0,128)">FileToUpload.setXPath("<span style="color: rgb(255,0,0)">Data</span>", <span style="color: rgb(0,0,255)">FileData</span>);</span> 

El archivo y los datos en rojo NO deberían cambiar. Estos son parte del código. <br>

[[Image:HowToUploadFile Image001.jpg|center]]&nbsp; 

<br>

El archivo subido lucirá como esto: 

<br>

[[Image:HowToUploadFile Image004.jpg|center]] 

<br>

La sintaxis usada en versiones anteriores ya no está disponible. <span>'''NO USE''' lo siguiente:</span> 

<br>

<span style="color: rgb(0,0,128)">var FileToUpload = Entity.addRelation("myUpload"); </span>

<span style="color: rgb(0,0,128)">FileToUpload.setFileName("MyFile.txt"); </span>

<span style="color: rgb(0,0,128)">FileToUpload.setData(FileContents);</span> 

<br>[[Image:HowToUploadFile Image002.jpg|center]]<br>Si desea saber como la ruta de un archivo cargado en Bizagi por favor siga este <u>[http://kb.Bizagi.com/KnowledgebaseArticle50110.aspx?Keywords=upload link]</u> 

<br>

=== Copiar varios archivos de un atributo a otro === 

<u></u>Es posible cargar varios archivos a través de una expresion que realice el copiado de uno o más archivos, desde un atributo tipo archivo a otro. 


<pre>
var FileProcess1 = Me.getXPath("InsurancePolicyRequest.FileProcess1"); 

for(var i=0; i &lt; FileProcess1.size(); i++) 

{ 

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; var FileProcess2 = FileProcess1.get(i); 

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; var Name = FileProcess2.getXPath("FileName"); 

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; var Data = FileProcess2.getXPath("Data"); 

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; var&nbsp;NewFile = Me.addRelation("InsurancePolicyRequest.FileProcess2"); 

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; NewFile.setXPath("FileName", Name); 

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; NewFile.setXPath("Data", Data); 

} 
</pre>


<br>FileProcess1 y FileProcess2 son atributos de tipo archivo, asociados a la entidad de proceso (llamada InsurancePolicyRequest). Nótese que los atributos de tipo archivo se manejan como colecciones, principalmente porque cada atributo de tipo archivo puede contener más de 1 archivo.


=== Contando el Número de Archivos Subidos  ===

Si un usuario desea conocer cuantos de los archivos subidos están asociados a un atributo tipo Archivo, la mejor forma de hacerlo es utilizando la propiedad size en lugar de otras propiedades como CHelper.IsNull o CHelper.IsEmpty, dado que Bizagi crea una colección al manejar este tipo de atributos. Estas dos propiedades no proveen mayor información acerca de la existencia de archivos asociados al Atributo Tipo Archivo. La colección de datos creada entre dos Entidades Maestras tiene un comportamiento similar al de este tipo de atributos, y por esta razón la propiedad size aplica tanto para colecciones como para arhivos cargados. 

En la imagen a continuación, se crea una expesión que&nbsp;realiza el conteo de los archivos&nbsp;cargados asociados al&nbsp;atributo&nbsp;ReportUpload de la Entidad VacationRequest. Se utiliza la propiedad size del objeto para retornar el valor esperado a través de un mensaje (ThrowValidationError). En este caso, la expresión se ejecuta en un Evento al Salvar para efectos de prueba.&nbsp;&nbsp;<br>&nbsp; 

[[Image:HowToUploadFile Image005.jpg|center|710x497px]] 

<br>Si no se ha cargado ningún archivo, el número de Archivos Cargados que aparecerá será cero. 

<br>

[[Image:HowToUploadFile Image006.jpg|center|669x350px]] 

<br>

Por otro lado, si existen dos o n archivos cargados, esto se verá reflejado en el mensaje que retorna Bizagi. Este comportamiento se muestra en la imagen a continuación.&nbsp; 

<br>

[[Image:HowToUploadFile Image007.jpg|center|733x388px]] 

<br><br>

=== Obtener el nombre de archivo de un adjunto ===

En el siguiente ejemplo, dentro de una Expresión de Bizagi, obtendremos el nombre de archivo de un adjunto (fileName). 

Nótese que la obtención del nombre del archivo incluye su extensión, y por lo tanto, esto puede ser útil en una regla para realizar acciones adicionales.


<pre>
var UploadedFile = Me.getXPath("ProcessA.ServiceLevelAgreement");
if(UploadedFile.size() > 0){
     var Filename = UploadedFile.get(0).getXPath("fileName");
     // Store the filename in the attribute set aside for this purpose
     Me.setXPath("ProcessA.SLAFilename", Filename);
}

</pre>

En el ejemplo anterior, obtenemos "FileName" del archivo en el atributo ServiceLevelAgreement, para seguidamente almacenarlo en el modelo de datos, en el atributo SLAFilename. 

=== Validar el nombre de un archivo adjunto ===

Es posible que un usuario necesite validar el nombre de un archivo en el momento en que  éste es cargado.

Tomemos como ejemplo un proceso de auditoria en una compañía. Cada una de las áreas de la compañía debe presentar distintos informes a la firma auditora. Para mantener un orden en la recepción y consulta de la información presentada en forma de archivos, los nombres de éstos se deben predeterminar. Así por ejemplo, el área financiera al momento de presentar el balance debe adjuntar un archivo de Excel con el nombre Balance Compañía 2012.xls.

Para predefinir los nombres de los archivos podemos utilizar vocabularios. Para mayor información sobre vocabularios , consulte http://wiki.bizagi.com/es/index.php?title=Vocabulario

En este caso definiremos un vocabulario de tipo texto con el nombre Balance. Su valor será Balance Compañía.xls (el nombre deseado para el archivo).

<br>

[[Image:FileValidation2.png |center|733x388px]] 

<br><br>

En la forma de la actividad podemos definir las propiedades deseadas para el archivo que se cargará. Para esto, dé clic sobre el atributo del archivo en la forma y en el menú de propiedades defina el número máximo de archivos y las extensiones válidas. En este caso solo permitiremos que se cargue un archivo. En las extensiones válidas permitiremos archivos de Microsoft office Excel, por lo que definimos la extensión xls.

<br>

[[Image:FileValidation3.png |center|733x388px]] 

<br><br>
  
Para validar que el nombre del archivo que se adjunte en la actividad donde se carga el balance sea igual al nombre predefinido, utilizamos la siguiente regla de negocio a la salida de dicha actividad.

<pre>

// Store the vocabulary definition
var DesiredFileName=CHelper.resolveVocabulary(Me,"BALANCE")
var UploadedFile = Me.getXPath("Audit.Files"); 
// Store the filename in the attribute set aside for this purpose
var TargetFile = UploadedFile.get(0); 
var FileName = TargetFile.getXPath("FileName"); 
// Validate real versus desired file name
if (FileName!=DesiredFileName) 
{ 
CHelper.ThrowValidationError("The file must have the same name of the vocabulary") 
}

</pre>

En el ejemplo anterior, obtenemos la definición del vocabulario (nombre predefinido del archivo) en la variable "DesiredFileName". Luego obtenemos el nombre del archivo cargado en la forma de la actividad y lo almacenamos en la variable “FileName” (note que tomamos el archivo de la posición 0 de la grilla de archivos ya que en las propiedades del atributo definimos, como máximo, la carga de un archivo). Finalmente comparamos los valores de “DesiredFileName” y “FileName” y si son diferentes lanzamos un mensaje de validación de error. 

De esta manera si usted adjunta un archivo con un nombre diferente al definido la actividad no podrá continuar, usted deberá cargar un nuevo archivo con el nombre requerido.

<br>

[[Image:FileValidation1.png |center|733x388px]] 

<br><br>

== Articulos Relacionados  ==

*[[Atributos Tipo Archivo|Atributos Tipo Archivo]]&nbsp; 
*[[Subir Archivos Usando la Capa SOA|Subiendo Archivos Con Interfaces]] 
*[[Crear archivos PDF|Crear Archivos PDF ]]<br>

<comments />