Ver código fuente

<keywords content="keywords">
PDF, archivo, FOP, NFop, reportes, reporte, reporte PDF, reportes PDF, archivos PDF, archivo PDF, documento, documentos PDF, documento PDF, archivos
</keywords>&nbsp;

= Cómo Crear Archivos PDF  =

== Introducción  ==

El objetivo de este artículo es ilustrar la generación de un archivo PDF para los procesos en Bizagi.<br>El archivo PDF contemplado en este ejemplo soporta caracteres del alfabeto occidental tradicional (latino). Para incluir caracteres unicode en el PDF, revise [[Crear archivos PDF con caracteres Unicode|<u>este artículo</u>]]. 

<br>[[Image:Pdf05 sample.png|center|700px]] <br>

<br>

== Lo que debe hacer en Bizagi  ==

Para generar archivos PDF en sus procesos Bizagi, los siguientes pasos se llevan a cabo: 

'''1. Tener un atributo para almacenar el archivo PDF.''' 

'''2. Crear la plantilla del PDF y su archivo de transformación.''' 

'''3. Crear el servicio Web que genera el PDF.''' 

'''4. Configurar la invocación a ese servicio web en Bizagi.''' 

<br>

== Ejemplo  ==

<br>Este ejemplo fue trabajado con el proceso '''Office Supply Request''' ("Solicitud de suministros de oficina") instruído en [http://help.bizagi.com/bpmsuite/es/mi_primer_y_mi_segundo_proceso.htm <u>Mi Segundo Proceso</u>]. 
'''La documentación aplica para la última versión de Bizagi. No está disponible para versiones 9.1.x. '''

Para este escenario, el archivo PDF contiene el detalle de la Orden de compra. <br>Las instrucciones que se describen a continuación aplican tanto para la edición Xpress como para las ediciones Enterprise de Bizagi.<br>El PDF es creado en la tarea automática '''Generar orden de compra'''("Generate Purchase Order"), para ser luego visualizado en la actividad '''Recibir productos''' ("Receive Products"). 

<br>[[Image:Pdf01 secondworkshop generatepurchaseorder.jpg|center|700px]] <br>

La estrategia cubierta en este artículo se basa en invocar un servicio web desde Bizagi. <br>El servicio web crea el PDF con los datos de negocio utilizando un componente llamado [http://xmlgraphics.apache.org/fop/ <u>Apache FOP</u>].<br>La respuesta del servicio web cargará de manera automática en Bizagi el archivo PDF en un atributo de tipo Archivo ("File"). 

<br>

=== Tener un atributo para almacenar el archivo PDF  ===

<br>Para realizar este ejemplo ( y partiendo del proceso "Office Supply Request" completado en las instrucciones del documento "Mi segundo Proceso"), se hicieron 3 adiciones al proceso: 

1. La creación de 2 nuevos atributos en la entidad de proceso ("Office Supply Request"): 

*Un atributo de tipo Archivo llamado '''PurchaseOrderFile'''. Su nombre visual es '''Purchase Order File''' ("Archivo de Orden de compra"). 
*Un atributo de tipo Fecha-Hora llamado '''PurchaseDate'''. Su nombre visual es '''Purchase Date''' ("Fecha de compra").

<br>[[Image:HowToCreatePDFFiles Image002.jpg|center]]&nbsp;<br>

2. La inclusión de estos atributos creados anteriormente en la forma de la actividad '''Recibir productos''' ("Receive Products"). Éstos se incluyen como campos no editables. 

<br>[[Image:HowToCreatePDFFiles Image003.jpg|center]]&nbsp;<br>

3. La asignación de valor a el atributo '''Purchase Date''' con la fecha actual. Esto se realizó por medio de una expresión en la acción "al Entrar" ("onEnter") de la tarea de servicio '''Generar orden de compra'''("Generate Purchase Order") como se enseña a continuación. 

<br>[[Image:Pdf01 expressionDateTime.jpg|center|700px]]&nbsp;<br>

=== Crear la plantilla del PDF y su archivo de transformación  ===

El primer paso es crear el archivo de transformación XSL-FO. <br>Este archivo es usado para los parámetros de entrada de la configuración de la invocación del servicio web desde Bizagi. <br>Un producto que facilita la generación de este archivo de transformación es [http://www.altova.com/download-stylevision.html <u>Altova StyleVision</u>]. <br>

Para este ejemplo, se utilizó Altova StyleVision para el diseño del PDF que queremos crear, de acuerdo al modelo de datos de "Mi segundo proceso". Por lo tanto, para este diseño requerimos conocer el esquema (XSD) del modelo de datos. <br>Éste se extra usando Bizagi Studio: 

<br>[[Image:Pdf03 Bizagi schemageneration1.jpg|center|700px]]&nbsp;<br>Nótese que generamos el esquema para el process "OfficeSupplyRequest" y marcamos la información específica del proceso que queremos incluir en el reporte PDF. 

El contenido del esquema generado lo guardamos en un archivo. 

<br>[[Image:Pdf03 Bizagi schemageneration2.jpg|center|700px]]&nbsp;<br>[[Image:Pdf03 Bizagi schemageneration3.jpg|center|500px]]&nbsp;<br>

El archivo debe ser de extensión ".xsd". 

<br>[[Image:Pdf03 Bizagi schemageneration4.jpg|center|500px]]&nbsp;<br>

Una vez que ya tenemos el esquema, creamos el diseño del PDF usando este esquema como dato de entrada para Altova Stylevision. 

<br>[[Image:Pdf03 altova newfromxsd.jpg|center|550px]]&nbsp;<br>

Nótese que en este ejemplo usamos una imagen (el logo de Bizagi). 

<br>[[Image:Pdf03 altova Sps1logo.jpg|center|700px]]&nbsp;<br>

Descargue la imagen empleada en este ejemplo [[Media:Logo.rar|<u>aquí</u>]]. Esta imagen debe guardarse en una ruta local en el servidor que albergará el servicio web.<br>Asegúrese de que el archivo de transformación XSL-FO contenga la ruta válida de referencia a esta imagen. 

<br>[[Image:HowToCreatePDFFiles Image005.jpg|center]] <br>
<div align="center">
{| class="MsoNormalTableAlert" border="1" cellspacing="0" cellpadding="0" width="432"
|-
| valign="top" width="100%" | 
'''<span lang="ES-CO">Alerta: </span>'''<span lang="ES-CO">Bizagi soporta XSLT 1.0 (XSLT 2.0 no es soportado). En Altova StyleVision, asegúrese de seleccionar XSLT 1.0 para la salida del archivo de transformación.</span>

|}
</div>
<br>

<br>[[Image:Pdf03 altova xlst10.jpg|center]] <br>

Una vez se haya terminado con el diseño del PDF, guardamos el archivo de transformación XLS-FO generado. 

<br>[[Image:Pdf03 altova savegeneratedfile.jpg|center]]&nbsp;<br>
<div align="center">
{| class="MsoNormalTableAlert" border="1" cellspacing="0" cellpadding="0" width="432"
|-
| valign="top" width="100%" | 
'''<span lang="ES-CO">Alerta: </span>'''<span lang="ES-CO">Algunas versiones de Altova StyleVision posteriores a 2008, incluyen un elemento "&lt;fo:declarations&gt;" que no es soportado por el componente Apache FOP.Net. Por lo tanto, para que el servicio web en .Net genere el PDF correctamente, asegúrese de que el archivo de transformación XSL-FO no contenga este elemento (ni su contenido).</span>

|}
</div>
<br>Descargue el archivo de transformación resultante (y el proyecto de Altova Stylevision's .sps que lo genera) [[Media:XSLTPurchaseOrder.rar|<u>aquí en este .rar</u>]]. 

<br>

=== Crear el servicio Web que genera el PDF  ===

Habiendo terminado el diseño de PDF en Altova Stylevision, procedemos a crear el servicio web que se encargará de recibir la petición (request XML) enviada desde Bizagi. <br>El PDF se genera a partir de este XML con formato XSL-FO, gracias al uso de Apache FOP. Apache FOP es un proyecto de código abierto desarrollado en Java que también cuenta con una versión soportada para el Framework de .Net ("NFop"). 

En este ejemplo, nuestro servicio web fue creado con Visual Studio y por ende se utiliza el componente .Net de Apache Fop.<br>Descargue el componente para .Net de Apache Fop [[Media:ApacheFop.Net.rar|<u>aquí</u>]], o desde el enlace externo principal: [http://sourceforge.net/projects/nfop/ <u>http://sourceforge.net/projects/nfop/</u>] 

Para ver Cómo crear este servicio web generador de PDF en Java que soporte caracteres especiales Unicode, haga clic [[Crear archivos PDF con caracteres Unicode|<u>aquí</u>]]. <br>Asegúrese de adicionar la referencia del componente NFop (y también el "vjslib") al proyecto en .Net. 

<br>[[Image:HowToCreatePDFFiles Image006.jpg|center]]&nbsp;<br>

Se deben incluir los namespaces para la clase del servicio web: 
<pre>using System;
using System.ComponentModel;
using System.Web;
using System.Web.Services;
using System.Xml;
</pre>
<br>El método web tiene como código: 
<pre>[WebMethod]
public XmlDocument GeneratePurchaseOrder(string sFileContent)
{
	//Generate the PDF file
	sbyte[] bufSByte = CBizagiReports.GeneratePDF(sFileContent);
	byte[] bufByte = new byte[bufSByte.Length];

	//Copy the sbyte[] to a byte[]
	System.Text.UTF8Encoding utf = new System.Text.UTF8Encoding();
	Buffer.BlockCopy(bufSByte, 0, bufByte, 0, bufSByte.Length);
			
	//Load an empty StringBuilder into an XmlWriter
	System.Text.StringBuilder sb = new System.Text.StringBuilder();
	System.IO.TextWriter tw = new System.IO.StringWriter(sb);
	XmlTextWriter m_XmlWriter = new XmlTextWriter(tw);

	//Write the bytes in the StringBuilder in Base 64
	m_XmlWriter.WriteBase64(bufByte, 0, bufByte.Length); 
			
	//Build the Xml document
        string sRes = "&lt;App&gt;&lt;OfficeSupplyRequest&gt;&lt;PurchaseOrderFile&gt;&lt;File fileName=\"PurchaseOrder.pdf\"&gt;";
        sRes += sb.ToString();
        sRes += "&lt;/File&gt;&lt;/PurchaseOrderFile&gt;&lt;/OfficeSupplyRequest&gt;&lt;/App&gt;";
	XmlDocument xDoc = new XmlDocument();		
	xDoc.LoadXml(sRes);

	//Return de Xml document
	return xDoc;
}
</pre>
<br>En el proyecto, creamos la clase CBizagiReports.cs con el siguiente código: 
<pre>using System;
using System.IO;
using org.apache.fop.apps;
using org.xml.sax;
using java.io;

namespace OfficeSupplyWS
{
	public class CBizagiReports
	{
		internal static sbyte[] GeneratePDF(string sInput)
		{
			sbyte[] buf;
			try
			{
				InputSource source = new InputSource(new java.io.StringReader(sInput));
				ByteArrayOutputStream stream = new ByteArrayOutputStream();
				Driver driver = new Driver(source, stream);
				driver.setRenderer(1);
				driver.run();
				buf = stream.buf;
			}
			catch (Exception exception)
			{
				throw new ApplicationException(exception.Message);
			}
			return buf;
		}		

	}
}
</pre>


Recuerde convertir a "aplicación" el proyecto en el IIS, para que éste pueda ser referenciado remotamente por URL como un servicio web. 

<br>[[Image:Pdf04 iis webapplication.jpg|center]]&nbsp;<br>De esta forma, el servicio web quedará publicado como: "http://[my_server]/OfficeSupplyWS/OfficeService.asmx" (para el ejemplo, "OfficeSupplyWS" es nuestro proyecto). 

<br>Nótese que para las ediciones Enterprise, el PDF puede ser creado por medio del servicio web o también usando [[Libreria de Componentes|<u>la Librería de Componente</u>]]. Por lo tanto para la edición Xpress, es completamente necesario seguir lo indicado a continuación en este artículo. <br>



=== Configurar la invocación a ese servicio web en Bizagi  ===

El último paso para nuestro ejemplo es la configuración para la invocación del servicio web creado en el paso anterior.<br>A través del Asistente de Interfaces, en nuestro proyecto podemos completar este paso de la siguiente manera:<br>En Bizagi Studio, ubique el sexto paso del asistente de proceso ('''Integrar''') y haga clic en la tarea de servicio '''Generate Purchase Order''' ("Generar Orden de compra"). <br>

Ingrese la URL del servicio publicado en el paso previo, y seleccione el método "GeneratePurchaseOrder". <br>Marque la opción de '''Usar opciones avanzadas''' ("Use Advanced Options") en el asistente de configuración de interfaces. 

<br>[[Image:Pdf05 interface01.jpg|center|623px]] 

<br>

Una vez que el usuario hace clic en siguiente, se deben ingresar los parámetros de entrada. Para&nbsp;hacer esto, se debe hacer&nbsp;doble clic en '''Parámetros''' y seleccionar la entidad del Modelo de Datos. 

&nbsp;[[Image:HowToCreatePDFFiles Image014.jpg|center]]

<br>Para los parámetros de entrada de la invocación, seleccione el XPath para el proceso (OfficeSupplyRequest) y defina nuevamente el esquema que contiene los datos necesarios para nuestro PDF: OfficeSupplyRequest <br>-- OrderTotal <br>-- ProductRequest <br>-- -- Approved <br>-- -- Comments <br>-- -- ProductType <br>-- -- -- ProductType <br>-- -- Quantity <br>-- -- TotalPrice <br>-- -- UnitPrice <br>-- PurchaseDate <br>-- PurchaseOrderNumber <br>-- VendorRequest <br>-- -- Vendor <br>-- -- -- VendorAddress <br>-- -- -- VendorCity <br>-- -- -- -- CityName <br>-- -- -- VendorEMail <br>-- -- -- VendorName <br>-- -- -- VendorTelephone 

<br>[[Image:HowToCreatePDFFiles Image008.jpg|center]] <br>

Cuando el esquema haya sido definido, asociamos el archivo de transformación XLS-que creamos con Altova Stylevision ('''SPS1_PurchaseOrder.xslt''')&nbsp;haciendo doble clic en&nbsp;la opción de Definir la Transformación XSL 

<br>[[Image:Pdf05 inputParameters.jpg|center|700px]] <br>

Para este ejemplo, no necesitamos ninguna acción o configuración para los parámetros de salida ("Output") del servicio web.<br>Esto se debe a que el servicio web desarrollado devuelve la información del PDF con el formato del modelo de datos del proceso para que Bizagi actualice el atributo "Purchase Order File" de manera automática. 

<br>[[Image:HowToCreatePDFFiles Image009.jpg|center]] <br>

En la ventana final, haga clic en "Terminar".<br>

<br>

== Ejecución  ==

En este punto, el proceso de OfficeSupplyRequest está configurado para la creación del archivo PDF para que pueda ser visto en la actividad '''Recibir productos''' ("Receive Products"). 

Para ver su creación, ejecute el proceso de Office Supply Request desde el portal de Bizagi. 

Podemos ver que el archivo PDF es adjuntado al proceso en nuestro atributo: 

<br>[[Image:Pdf05 finalview.jpg|center|700px]] <br>

<br>

<br>

== Temas Relacionados  ==

*[[Crear archivos PDF con caracteres Unicode|<u>Cómo crear archivos PDF con caracteres Unicode</u>]]. 
*Bizagi ofrece un modo de generar archivos RTF configurando una plantilla, [[Cartas|<u>aprenda aquí sobre Cartas de Bizagi</u>]]. 
*[[Subir Archivos Usando la Capa SOA|<u>Subir archivos usando la Capa SOA</u>]]. 
*Para la edición Enterprise .NET hay otra manera de crear los archivos PDF, [[Libreria de Componentes|<u>aprenda aquí sobre la Librería de Componente</u>]]. 
*[[Cómo soportar la generación de documentos de caso a partir de plantillas dinámicas|<u>Cómo soportar la creación de PDFs a partir de plantillas dinámicas</u>]]

<br><br>Lea más sobre la creación de archivos PDF con .NET en estos enlaces externos: 

*[http://www.codeproject.com/KB/dotnet/nfop.aspx <u>http://www.codeproject.com/KB/dotnet/nfop.aspx</u>] 
*[http://nfop.sourceforge.net/article.html <u>http://nfop.sourceforge.net/article.html</u>]

<comments />