Show Menu
TEMAS×

Uso del servicio de ensamblador

El servicio Ensamblador le permite combinar, reorganizar y aumentar documentos PDF y XDP y obtener información sobre documentos PDF. Cada trabajo enviado al servicio Ensamblador incluye un documento XML de descripción de documento (DDX), documentos de origen y recursos externos (cadenas y gráficos). Para obtener más información sobre el servicio de ensamblador, consulte Visión general del servicio de ensamblador.
Puede utilizar el servicio de ensamblaje para las siguientes operaciones:

Compilación de documentos PDF

Puede utilizar el servicio Ensamblador para montar dos o más documentos PDF en un único documento PDF o una única cartera PDF. También puede aplicar funciones al documento PDF que ayuden a la navegación o mejoren la seguridad. A continuación se indican algunas de las formas de ensamblar documentos PDF:

Compilación de un documento PDF sencillo

La siguiente ilustración muestra tres documentos de origen que se están combinando en un único documento resultante.
Montaje de un documento PDF sencillo a partir de varios documentos PDF Figura: Compilación de un documento PDF sencillo a partir de varios documentos PDF
El siguiente ejemplo es un documento DDX sencillo que se utiliza para montar el documento. Especifica los nombres de los documentos de origen utilizados para producir el documento resultante, así como el nombre del documento resultante:
<PDF result="Doc4">
<PDF source="Doc1"/>
<PDF source="Doc2"/>
<PDF source="Doc3"/>
</PDF>

El ensamblado de documento produce un documento resultante que contiene el siguiente contenido y características:
  • Todo o parte de cada documento de origen
  • Todos o parte de los marcadores de cada documento de origen, normalizados para el documento resultante ensamblado
  • Otras características adoptadas a partir del documento base (Doc1), incluidos metadatos, etiquetas de página y tamaño de página
  • Opcionalmente, el documento resultante incluye una tabla de contenido creada a partir de los marcadores en los documentos de origen

Creación de una cartera PDF

El servicio Ensamblador puede crear carteras PDF que contengan una colección de documentos y una interfaz de usuario independiente. La interfaz se denomina Diseño de portafolios PDF o navegador de portafolios PDF (navegador). Las carteras PDF amplían la capacidad de los paquetes PDF agregando un navegador, carpetas y páginas de bienvenida. La interfaz puede mejorar la experiencia del usuario aprovechando la cadena de texto localizada, los esquemas de color personalizados y los recursos gráficos. La cartera PDF también puede incluir carpetas para organizar los archivos de la cartera.
Cuando el servicio Ensamblador interpreta el siguiente documento DDX, ensambla una cartera PDF que incluye un navegador de portafolios PDF y un paquete de dos archivos. El servicio obtiene el navegador de la ubicación especificada por el origen myNavigator. Cambia la combinación de colores predeterminada del navegador a la combinación de colores rosaScheme.
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1">
<Portfolio>
<Navigator source="myNavigator"/>
<ColorScheme scheme="pinkScheme"/>
</Portfolio>
<PackageFiles>
<PDF source="sourcePDF1"/>
<PDF source="sourcePDF2"/>
</PackageFiles>
</PDF>
</DDX>

Compilación de documentos cifrados

Al compilar un documento, también puede codificar el documento PDF con una contraseña. Después de cifrar un documento PDF con una contraseña, el usuario debe especificar la contraseña para ver el documento PDF en Adobe Reader o Acrobat. Para cifrar un documento PDF con una contraseña, el documento DDX debe contener valores de elementos de codificación que sean necesarios para cifrar un documento PDF.
El servicio de cifrado no tiene que formar parte de la instalación de LiveCycle para cifrar un documento PDF con una contraseña.
Si uno o varios de los documentos de entrada están cifrados, proporcione una contraseña para abrir el documento como parte del DDX.

Compilación de documentos con numeración Bates

Al compilar un documento, puede utilizar la numeración Bates para aplicar un identificador de página único a cada página. Al utilizar la numeración Bates, cada página del documento (o conjunto de documentos) tiene asignado un número que identifica de forma exclusiva la página. Por ejemplo, los documentos de fabricación que contienen información sobre la lista de materiales y que están asociados con la producción de un conjunto pueden contener un identificador. Un número Bates contiene un valor numérico incrementado secuencialmente y un prefijo y sufijo opcionales. El prefijo + valor numérico + sufijo se denomina patrón bates.
La siguiente ilustración muestra un documento PDF que contiene un identificador único ubicado en el encabezado del documento.
Documento PDF que contiene un identificador único ubicado en el encabezado del documento Figura: Un documento PDF que contiene un identificador único ubicado en el encabezado del documento

Acoplar y ensamblar documentos

Puede utilizar el servicio Ensamblador para transformar un documento PDF interactivo (por ejemplo, un formulario) en un documento PDF no interactivo. Un documento PDF interactivo permite a los usuarios introducir o modificar datos ubicados en los campos del documento PDF. El proceso de transformar un documento PDF interactivo en un documento PDF no interactivo se denomina acoplamiento. Cuando se acopla un documento PDF, los campos del formulario conservan su aspecto gráfico, pero ya no son interactivos. Una razón para acoplar un documento PDF es asegurarse de que no se puedan modificar los datos. Además, las secuencias de comandos asociadas a los campos ya no funcionan.
Al crear un documento PDF que se ensambla a partir de documentos PDF interactivos, el servicio Ensamblador acopla dichos formularios antes de ensamblarlos en el documento resultante.
El servicio Ensamblador utiliza el servicio Output para acoplar formularios XFA dinámicos. Si el servicio Ensamblador procesa un DDX que lo requiere para acoplar un formulario dinámico XFA y el servicio Output no está disponible, se genera una excepción. El servicio Ensamblador puede acoplar un formulario de Acrobat o un formulario XFA estático sin utilizar el servicio Output.

Compilación de documentos XDP

Puede utilizar el servicio Ensamblador para montar varios documentos XDP en un único documento XDP o en un documento PDF. Para los archivos XDP de origen que incluyen puntos de inserción, puede especificar los fragmentos que desea insertar.
Estas son algunas de las formas en que puede ensamblar documentos XDP:

Compilación de un documento XDP sencillo

La siguiente ilustración muestra tres documentos XDP de origen que se están ensamblando en un único documento XDP resultante. El documento XDP resultante contiene los tres documentos XDP de origen, incluidos sus datos asociados. El documento resultante obtiene atributos básicos del documento base, que es el primer documento XDP de origen.
Montaje de un documento XDP sencillo a partir de varios documentos XDP Figura: Compilación de un documento XDP sencillo a partir de varios documentos XDP
Este es un documento DDX que produce el resultado ilustrado anteriormente.
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="MyXDPResult">
<XDP source="sourceXDP1"/>
<XDP source="sourceXDP2"/>
<XDP source="sourceXDP3"/>
</XDP>
</DDX>

Resolución de referencias durante el ensamblado

Normalmente, los documentos XDP pueden contener imágenes a las que se hace referencia mediante referencias absolutas o relativas. El servicio de ensamblador, de forma predeterminada, conserva las referencias a las imágenes en el documento XDP resultante.
Puede especificar el modo en que el servicio Ensamblador gestiona las imágenes a las que se hace referencia en los documentos XDP de origen mediante referencias absolutas o relativas en los archivos XDP al ensamblar. Puede elegir que todas las imágenes estén incrustadas en el resultado para que no contenga referencias relativas o absolutas. Esto se define estableciendo el valor de la etiqueta resolveAssets, que puede tomar cualquiera de las siguientes opciones. De forma predeterminada, no se resuelve ninguna referencia en el documento de resultados.
Value Descripción
ninguno No resuelve ninguna referencia.
all Incrusta todas las imágenes a las que se hace referencia en el documento XDP de origen.
relativo Incrusta todas las imágenes a las que se hace referencia mediante referencias relativas en el documento XDP de origen.
absoluto Incrusta todas las imágenes a las que se hace referencia mediante referencias absolutas en el documento XDP de origen.
Puede especificar el valor del atributo resolveAssets en la etiqueta de origen XDP o en la etiqueta de resultado XDP principal. Si el atributo se especifica en la etiqueta de resultado XDP, todos los elementos de origen XDP que sean secundarios de un resultado XDP lo heredarán. Sin embargo, si se especifica explícitamente el atributo de un elemento de origen, se anula la configuración del elemento de resultado solo para ese documento de origen.

Resolver todas las referencias de origen en un documento XDP

Para resolver todas las referencias de los documentos XDP de origen, especifique el atributo resolveAssets para el documento resultante para todos, como en el ejemplo siguiente:
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp" resolveAssets="all">
<XDP source="input1.xdp" />
<XDP source="input2.xdp" />
<XDP source="input3.xdp" />
</XDP>
</DDX

También puede especificar el atributo de todos los documentos XDP de origen de forma independiente para obtener el mismo resultado.
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp">
<XDP source="input1.xdp" resolveAssets="all"/>
<XDP source="input2.xdp" resolveAssets="all"/>
<XDP source="input3.xdp" resolveAssets="all"/>
</XDP>
</DDX>

Resolver referencias de origen seleccionadas en un documento XDP

Puede especificar de forma selectiva las referencias de origen que desea resolver especificando el atributo resolveAssets para ellas. Los atributos de los documentos de origen individuales anulan la configuración del documento XDP resultante. En este ejemplo, los fragmentos incluidos también se resuelven.
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp" resolveAssets="all">
<XDP source="input1.xdp" >
<XDPContent source="fragment.xdp" insertionPoint="MyInsertionPoint"
fragment="myFragment"/>
</XDP>
<XDP source="input2.xdp" />
</XDP>
</DDX>

Resolver de forma selectiva referencias absolutas o relativas

Puede resolver de forma selectiva referencias absolutas o relativas en todos o algunos de los documentos de origen, como se muestra en el ejemplo siguiente:
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="result.xdp" resolveAssets="absolute">
<XDP source="input1.xdp" />
<XDP source="input2.xdp" />
</XDP>
</DDX

Inserción dinámica de fragmentos de formulario en un formulario XFA

Puede utilizar el servicio Ensamblador para crear un formulario XFA creado a partir de otro formulario XFA en el que se insertan fragmentos. Con esta función, puede utilizar fragmentos para crear varios formularios.
La compatibilidad con la inserción dinámica de fragmentos de formulario admite el control de un solo origen. Se mantiene una única fuente de componentes de uso común. Por ejemplo, puede crear un fragmento para la pancarta de su empresa. Si la pancarta cambia, solo tiene que modificar el fragmento. Los demás formularios que incluyen el fragmento no cambian.
Los diseñadores de formularios utilizan LiveC ycle Designer para crear fragmentos de formulario. Estos fragmentos son subformularios con un nombre exclusivo dentro de un formulario XFA. Los diseñadores de formularios también utilizan Designer para crear formularios XFA con nombres únicos. El programador escribe documentos DDX que especifican cómo se insertan los fragmentos en el formulario XFA.
La siguiente ilustración muestra dos formularios XML (plantillas XFA). El formulario de la izquierda contiene un punto de inserción denominado myInsertionPoint. El formulario de la derecha contiene un fragmento denominado myFragment.
Inserción de fragmentos de formulario en un formulario XFA Figura: Inserción de fragmentos de formulario en un formulario XFA
Cuando el servicio Ensamblador interpreta el siguiente documento DDX, crea un formulario XML que contiene otro formulario XML. El subformulario myFragment del documento myFragmentSource se inserta en myInsertionPoint en el documento myFormSource.
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="myFormResult">
<XDP source="myFormSource">
<XDPContent fragment="myFragment" insertionPoint="myInsertionPoint"
source="myFragmentSource"/>
</XDP>
</XDP>
</DDX

Empaquetar un documento XDP como PDF

Puede utilizar el servicio Ensamblador para empaquetar un documento XDP como documento PDF, como se muestra en este documento DDX.
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1" encryption="passEncProfile1">
<XDP>
<XDP source="sourceXDP3"/>
<XDP source="sourceXDP4"/>
</XDP>
</PDF>
</DDX>

Desmontar documentos PDF

Puede utilizar el servicio Ensamblador para desmontar un documento PDF. El servicio puede extraer páginas del documento de origen o dividir un documento de origen basado en marcadores. Normalmente, esta tarea resulta útil si el documento PDF se creó originalmente a partir de muchos documentos individuales, como una colección de instrucciones.

Extraer páginas de un documento de origen

En la siguiente ilustración, las páginas 1 a 3 se extraen del documento de origen y se colocan en un nuevo documento resultante.
Extracción de páginas específicas de un documento de origen Figura: Extracción de páginas específicas de un documento de origen
El siguiente ejemplo es un documento DDX que se utiliza para desmontar el documento.
<PDF result="Doc4">
<PDF source="Doc2" pages="1-3"/>
</PDF>

Dividir un documento de origen según los marcadores

En la siguiente ilustración, DocA se divide en varios documentos resultantes. El primer marcador de nivel 1 de una página identifica el inicio de un nuevo documento resultante.
División de un documento de origen basado en marcadores en varios documentos ​Figura: División de un documento de origen basado en marcadores en varios documentos
El siguiente ejemplo es un documento DDX que utiliza marcadores para desmontar un documento de origen.
<PDFsFromBookmarks prefix="A">
<PDF source="DocA"/>
</PDFsFromBookmarks>

Determinar si los documentos son compatibles con PDF/A

Puede utilizar el servicio Ensamblador para determinar si un documento PDF es compatible con PDF/A. PDF/A es un formato de archivo diseñado para la conservación a largo plazo del contenido del documento. Las fuentes se incrustan en el documento y el archivo se descomprime. Como resultado, un documento PDF/A suele ser más grande que un documento PDF estándar. Además, un documento PDF/A no contiene contenido de audio y vídeo.

Obtener información sobre un documento PDF

Puede utilizar el servicio Ensamblador para obtener la siguiente información sobre un documento PDF:
  • Información de texto.
    • Palabras en cada página del documento
    • Posición de cada palabra en cada página del documento
    • Frases en cada párrafo de cada página del documento
  • Marcadores, incluidos el número de página, el título, el destino y la apariencia. Puede exportar estos datos desde un documento PDF e importarlos a un documento PDF.
  • Archivos adjuntos, incluida la información del archivo. Para los archivos adjuntos de nivel de página, también incluye la ubicación de la anotación de datos adjuntos del archivo. Puede exportar estos datos desde un documento PDF e importarlos a un documento PDF.
  • Empaquetar archivos, incluida la información de archivo, las carpetas, el paquete, el esquema y los datos de campo. Puede exportar estos datos desde un documento PDF e importarlos a un documento PDF.

Validación de documentos DDX

Puede utilizar el servicio Ensamblador para determinar si un documento DDX es válido. Por ejemplo, si ha actualizado una versión anterior de LiveCycle, la validación garantiza que el documento DDX sea válido.

Llamar a otros servicios

Puede utilizar documentos DDX que hagan que el servicio Ensamblador llame a los siguientes servicios de ciclo LiveC. El servicio Ensamblador solo puede llamar a los servicios instalados con LiveCycle.
Servicio Reader Extensions: Permite a los usuarios de Adobe Reader firmar digitalmente el documento PDF resultante.
Servicio de formularios: Combina un archivo XDP y un archivo de datos XML para crear un documento PDF que contenga el formulario interactivo rellenado.
Servicio de salida: Convierte un formulario XML dinámico en un documento PDF que contiene un formulario no interactivo (acopla el formulario). El servicio Ensamblador acopla los formularios XML estáticos y los formularios de Acrobat sin llamar al servicio Output.
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<PDF result="outDoc">
<PDF source="doc1"/>
<PDF source="doc2"/>
<ReaderRights
credentialAlias="LCESCred"
digitalSignatures="true"/>
</PDF>
</DDX>

El uso de DDX y el servicio de ensamblador para llamar a otros servicios de ciclo LiveC puede simplificar el diagrama de proceso. Puede incluso reducir el esfuerzo que gasta en personalizar los flujos de trabajo. (Consulte también Uso de AEM Document Services mediante programación )