Consideraciones, problemas conocidos y prácticas recomendadas

Antes de empezar a usar las API de comunicación, revise las siguientes consideraciones, problemas conocidos y preguntas más frecuentes:

Consideraciones

Datos de formulario

Las API de comunicaciones aceptan un diseño de formulario que se suele crear en Designer y los datos de formulario XML como entrada. Para rellenar un documento con datos, debe existir un elemento XML en los datos del formulario XML para cada campo de formulario que desee rellenar. El nombre del elemento XML debe coincidir con el nombre del campo. Se ignora un elemento XML si no se corresponde con un campo de formulario o si el nombre del elemento XML no coincide con el nombre del campo. No es necesario coincidir con el orden en el que se muestran los elementos XML. El factor importante es que los elementos XML se especifiquen con los valores correspondientes.

Consulte el siguiente ejemplo de formulario de solicitud de préstamo:

Formulario de solicitud de préstamo

Para combinar datos en este diseño de formulario, cree una fuente de datos XML que corresponda al formulario. El siguiente XML representa una fuente de datos XML que corresponde al formulario de aplicación hipotecaria de ejemplo.

<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
    - <Layer>
        <closeDate>1/26/2007</closeDate>
        <lastName>Johnson</lastName>
        <firstName>Jerry</firstName>
        <mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
        <city>New York</city>
        <zipCode>00501</zipCode>
        <state>NY</state>
        <dateBirth>26/08/1973</dateBirth>
        <middleInitials>D</middleInitials>
        <socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
        <phoneNumber>5555550000</phoneNumber>
    </Layer>
    - <Mortgage>
        <mortgageAmount>295000.00</mortgageAmount>
        <monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
        <purchasePrice>300000</purchasePrice>
        <downPayment>5000</downPayment>
        <term>25</term>
        <interestRate>5.00</interestRate>
    </Mortgage>
</data>
</xfa:data>
</xfa:datasets>

Tipos de documentos compatibles

Para acceder completamente a las funcionalidades de procesamiento de las API de comunicaciones, se recomienda utilizar un archivo XDP como entrada. A veces, se puede utilizar un archivo PDF. Con todo, el uso de un archivo PDF como entrada tiene las siguientes limitaciones:

Un documento PDF que no contiene una secuencia XFA no se puede procesar como PostScript, PCL o ZPL. Las API de comunicaciones pueden procesar documentos PDF con secuencias XFA (es decir, formularios creados en Designer) en formatos láser y de etiqueta. Si el documento PDF está firmado, certificado o contiene derechos de uso (aplicados mediante el servicio AEM Forms Reader Extensions), no se puede procesar en estos formatos de impresión.

Áreas imprimibles

El margen no imprimible predeterminado de 0,25 pulgadas no es exacto para impresoras de etiquetas y varía de impresora a impresora y de tamaño de etiqueta a tamaño de etiqueta, aunque se recomienda mantener el margen de 0,25 pulgadas o reducirlo. Con todo, se recomienda no aumentar el margen no imprimible. De lo contrario, la información del área imprimible no se imprime correctamente.

Asegúrese siempre de utilizar el archivo XDC correcto para la impresora. Por ejemplo, evite elegir un archivo XDC para una impresora de 300 dpi y enviar el documento a una impresora de 200 dpi.

Solo scripts para formularios XFA (XDP/PDF)

Un diseño de formulario que se utiliza con las API de comunicaciones puede contener scripts que se ejecutan en el servidor. Asegúrese de que el diseño de formulario no contenga scripts que se ejecuten en el cliente. Para obtener información acerca de la creación de scripts de diseño de formulario, consulte Ayuda de Designer.

Asignación de fuentes

Para diseñar un formulario que utilice fuentes residentes en la impresora, elija un nombre de tipo de letra en Designer que coincida con las fuentes disponibles en la impresora. En los perfiles de dispositivo correspondientes (archivos XDC), se encuentra una lista de fuentes compatibles con PCL o PostScript. Alternativamente, se puede crear una asignación de fuentes para asignar fuentes no residentes en la impresora a fuentes residentes en la impresora con un nombre de tipo de letra diferente. Por ejemplo, en un escenario de PostScript, las referencias a la fuente Arial® se pueden asignar al tipo de letra Helvetica® residente en la impresora.

Si una fuente está instalada en un equipo cliente, está disponible en la lista desplegable de Designer. Si la fuente no está instalada, es necesario especificar el nombre de la fuente manualmente. La opción “Reemplazar permanentemente fuentes no disponibles” de Designer puede estar desactivada. De lo contrario, cuando el archivo XDP se guarda en Designer, el nombre de la fuente de sustitución se escribe en el archivo XDP. Significa que no se utiliza la fuente residente en la impresora.

Existen dos tipos de fuentes OpenType®. Un tipo es una fuente TrueType OpenType® compatible con PCL. El otro es CFF OpenType®. La salida de PDF y PostScript es compatible con fuentes Type-1, TrueType y OpenType® incrustadas. La salida PCL es compatible con fuentes TrueType incrustadas.

Las fuentes Type-1 y OpenType® no están incrustadas en la salida PCL. El contenido con formato de fuente Type-1 y OpenType® se rasteriza y genera como imagen de mapa de bits que puede ser grande y lenta de generar.

Las fuentes descargadas o incrustadas se sustituyen automáticamente al generar una salida PostScript, PCL o PDF. Significa que solo el subconjunto de los glifos de fuente que se requieren para procesar correctamente el documento generado se incluye en la salida generada.

Trabajar con archivos de perfil de dispositivo (archivo XDC)

Un perfil de dispositivo (archivo XDC) es un archivo de descripción de impresora en formato XML. Este archivo permite que las API de comunicaciones emitan documentos como formatos de impresora láser o de etiquetas. Las API de comunicaciones utilizan los archivos XDC, que incluyen lo siguiente:

  • hppcl5c.xdc

  • hppcl5e.xdc

  • ps_plain_level3.xdc

  • ps_plain.xdc

  • zpl300.xdc

  • zpl600.xdc

  • zpl300.xdc

  • ipl300.xdc

  • ipl400.xdc

  • tpcl600.xdc

  • dpl300.xdc

  • dpl406.xdc

  • dpl600.xdc

Puede utilizar los archivos XDC facilitados para generar documentos de impresión o modificarlos según sus necesidades.

Estos archivos son archivos XDC de referencia compatibles con las funciones de impresoras específicas, como fuentes residentes, bandejas de papel y grapadora. El propósito de estas referencias es ayudarle a comprender cómo configurar sus propias impresoras mediante perfiles de dispositivo. La referencia también es un punto de partida para impresoras similares en la misma línea de productos.

Trabajar con el archivo de configuración XCI

Las API de comunicaciones utilizan un archivo de configuración XCI para realizar tareas, como controlar si la salida es un papel único o paginado. Aunque este archivo contiene opciones que se pueden configurar, no es habitual modificar este valor.

Puede pasar un archivo XCI modificado al utilizar un API de comunicaciones. Al hacerlo, cree una copia del archivo predeterminado, cambie solo los valores que requieran modificación para satisfacer los requisitos comerciales y utilice el archivo XCI modificado.

Las API de comunicaciones empiezan con el archivo XCI predeterminado (o el archivo modificado). A continuación, aplica los valores especificados mediante las API de comunicaciones. Estos valores anulan la configuración de XCI.

La siguiente tabla especifica las opciones de XCI.

Opción XCI Descripción
config/present/pdf/creator Identifica al creador del documento mediante la entrada Creador del diccionario de información del documento. Para obtener información sobre este diccionario, consulte la guía de referencia del PDF.
config/present/pdf/producer Identifica al productor del documento mediante la entrada Productor del diccionario de información del documento. Para obtener información sobre este diccionario, consulte la guía de referencia del PDF.
config/present/layout Controla si la salida es un papel único o paginado.
config/present/pdf/compression/level Especifica el grado de compresión que se utilizará al generar un documento PDF.
config/present/pdf/scriptModel Controla si la información específica de XFA se incluye en el documento PDF de salida.
config/present/common/data/adjustData Controla si la aplicación XFA ajusta los datos después de la combinación.
config/present/pdf/renderPolicy Controla si la generación del contenido de la página se realiza en el servidor o se difiere al cliente.
config/present/common/locale Especifica la ubicación predeterminada utilizada en el documento de salida.
config/present/destination Cuando está contenido en un elemento presente, especifica el formato de salida. Cuando está contenido en un elemento openAction, especifica la acción que se debe realizar al abrir el documento en un cliente interactivo.
config/present/output/type Especifica el tipo de compresión que se aplicará a un archivo o el tipo de salida que se producirá.
config/present/common/temp/uri Especifica el URI del formulario.
config/present/common/template/base Proporciona una ubicación base para URI en el diseño de formulario. Cuando este elemento está ausente o vacío, se utiliza como base la ubicación del diseño de formulario.
config/present/common/log/to Controla la ubicación en la que se escriben los datos de registro o los datos de salida.
config/present/output/to Controla la ubicación en la que se escriben los datos de registro o los datos de salida.
config/present/script/currentPage Especifica la página inicial cuando se abre el documento.
config/present/script/exclude Notifica a las API del servidor/comunicaciones de AEM Forms sobre qué eventos se deben ignorar.
config/present/pdf/linearized Controla si el documento PDF de salida está linealizado.
config/present/script/runScripts Controla qué conjunto de scripts ejecuta AEM Forms.
config/present/pdf/tagged Controla la inclusión de etiquetas en el documento PDF de salida. Las etiquetas, en el contexto del PDF, son información adicional incluida en un documento para exponer la estructura lógica del mismo. Las etiquetas ayudan a facilitar la accesibilidad y a cambiar el formato. Por ejemplo, un número de página puede etiquetarse como un artefacto para que un lector de pantalla no lo enuncie en medio del texto. Aunque las etiquetas hacen que un documento sea más útil, también aumentan el tamaño del documento y el tiempo de procesamiento para crearlo.
config/present/pdf/version Especifica la versión del documento PDF que se va a generar.

Problemas conocidos

  • Puede utilizar un tipo de procesamiento específico (PDF, PRINT) solo una vez en la lista de opciones de impresión. Por ejemplo, no puede tener dos opciones PRINT y que cada una especifique un tipo de procesamiento PCL.

  • Para una configuración por lotes, solo se permite una instancia de combinación de valores de OutputType (PDF, PRINT) y RenderType (PostScript, PCL, IPL, ZPL, etc.) .

  • Para las API asíncronas (procesamiento por lotes), el nivel de registro predeterminado es 2. Puede utilizar un XCI personalizado para cambiar el nivel de registro a 1.

  • Cuando se configura el XCI predeterminado, incluye la ruta hasta la representación original. Por ejemplo /content/dam/formsanddocuments/default.xci/jcr:content/renditions/original

Prácticas recomendadas

  • Adobe recomienda hospedar los archivos de datos en el almacén de contenedores del Blob en la región de la nube utilizada por AEM Cloud Service.

Preguntas frecuentes

¿Puedo utilizar una carpeta vigilada u otros mecanismos de almacenamiento para almacenar entradas y salidas?

En este momento, puede utilizar el almacenamiento de Microsoft Azure para guardar datos de entrada y documentos generados. El almacenamiento de Microsoft Azure ofrece varias opciones para automatizar las operaciones de movimiento de datos.

¿Se incluye una cuenta de almacenamiento de Microsoft Azure con la licencia de Experience Manager Forms Cloud Service?

La cuenta de almacenamiento de Microsoft Azure es independiente de la licencia de Experience Manager Forms Cloud Service.

¿Las API de comunicación almacenan datos en los servidores de Experience Manager Forms Cloud Service?

Los datos de entrada y salida solo se guardan en el almacenamiento de Microsoft Azure.

¿Las API de comunicación solo están disponibles para Experience Manager Forms Cloud Service? ¿Puedo obtener una funcionalidad similar en el entorno local?

Puede utilizar el servicio de salida de AEM Forms para combinar una plantilla (XFA o PDF) con datos de clientes para generar documentos en los formatos PDF, PS, PCL y ZPL.

En comparación con el entorno local, Cloud Service ofrece las ventajas adicionales de escalabilidad automática y rentabilidad.

¿Puedo ejecutar varias operaciones por lotes simultáneamente?
Sí, puede ejecutar varias operaciones por lotes de forma simultánea. Utilice siempre carpetas fuente y destino diferentes para cada operación para evitar conflictos.

En esta página