Consideraciones, problemas conocidos y prácticas recomendadas best-practices-known-issues-and-limitations

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

Consideraciones considerations-for-communications-apis

Datos de formulario form-data

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:

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 supported-document-types

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 printable-areas

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) scripts

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 font-mapping

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) working-with-xdc-files

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:

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 working-with-xci-files

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.

Problemas conocidos

Prácticas recomendadas

Preguntas frecuentes faq

¿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.