Il servizio Assembler consente di combinare, ridisporre e integrare documenti PDF e XDP e di ottenere informazioni sui documenti PDF. Ogni processo inviato al servizio Assembler include un documento DDX (Document Description XML), documenti di origine e risorse esterne (stringhe e grafica). Per ulteriori informazioni sul servizio assembler, vedere Panoramica del servizio Assembler.
È possibile utilizzare il servizio di assemblaggio per le seguenti operazioni:
È possibile utilizzare il servizio Assembler per assemblare due o più documenti PDF in un singolo documento PDF o in un singolo Portfolio PDF. È inoltre possibile applicare al documento PDF funzioni che facilitano la navigazione o migliorano la protezione. Di seguito sono riportati alcuni modi per assemblare documenti PDF:
L'illustrazione seguente mostra tre documenti sorgente che vengono uniti in un singolo documento risultante.
Assemblare un documento PDF semplice da più documenti PDF
L'esempio seguente è un semplice documento DDX utilizzato per assemblare il documento. Specifica i nomi dei documenti di origine utilizzati per produrre il documento risultante, nonché il nome del documento risultante:
<PDF result="Doc4">
<PDF source="Doc1"/>
<PDF source="Doc2"/>
<PDF source="Doc3"/>
</PDF>
L'assieme Document produce un documento risultante contenente il contenuto seguente e
caratteristiche:
Il servizio Assembler può creare Portfoli PDF contenenti una raccolta di documenti e un'interfaccia utente indipendente. L’interfaccia è denominata Layout Portfolio PDF o Navigatore Portfolio PDF. Gli Portfoli PDF ampliano la capacità dei pacchetti PDF aggiungendo un navigatore, cartelle e pagine di benvenuto. L'interfaccia può migliorare l'esperienza dell'utente sfruttando la stringa di testo localizzata, gli schemi di colore personalizzati e le risorse grafiche. L’Portfolio PDF può anche includere cartelle per l’organizzazione dei file nel portfolio.
Quando il servizio Assembler interpreta il seguente documento DDX, assembla un Portfolio PDF che include un Portfolio PDF navigator e un pacchetto di due file. Il servizio ottiene il navigatore dalla posizione specificata dall'origine myNavigator. Cambia la combinazione di colori predefinita del navigatore nella combinazione di colori 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>
Quando si assembla un documento, è anche possibile cifrare il documento PDF con una password. Dopo aver crittografato un documento PDF con una password, l'utente deve specificare la password per visualizzare il documento PDF in Adobe Reader o Acrobat. Per cifrare un documento PDF con una password, il documento DDX deve contenere i valori degli elementi di cifratura necessari per la cifratura di un documento PDF.
Il servizio di cifratura non deve necessariamente far parte dell'installazione del LiveCycle per cifrare un documento PDF con una password.
Se uno o più documenti di input sono crittografati, immettere una password per aprire il documento come parte del DDX.
Quando assemblate un documento, potete utilizzare la numerazione Bates per applicare un identificatore di pagina univoco a ciascuna pagina. Quando si utilizza la numerazione Bates, a ogni pagina del documento (o set di documenti) viene assegnato un numero che identifica in modo univoco la pagina. Ad esempio, i documenti di fabbricazione che contengono informazioni sulla distinta base e sono associati alla produzione di un assieme possono contenere un identificatore. Un numero Bates contiene un valore numerico incrementato sequenzialmente e un prefisso e un suffisso facoltativi. Il prefisso + il valore numerico + il suffisso è denominato pattern a intervalli.
L'illustrazione seguente mostra un documento PDF contenente un identificatore univoco nell'intestazione del documento.
Un documento PDF contenente un identificatore univoco nell'intestazione del documento
È possibile utilizzare il servizio Assembler per trasformare un documento PDF interattivo (ad esempio, un modulo) in un documento PDF non interattivo. Un documento PDF interattivo consente agli utenti di immettere o modificare i dati presenti nei campi del documento PDF. Il processo di trasformazione di un documento PDF interattivo in un documento PDF non interattivo è denominato "appiattimento". Quando un documento PDF viene appiattito, i campi del modulo mantengono l’aspetto grafico ma non sono più interattivi. Uno dei motivi per appiattire un documento PDF è garantire che i dati non possano essere modificati. Inoltre, gli script associati ai campi non funzionano più.
Quando si crea un documento PDF che viene assemblato da documenti PDF interattivi, il servizio Assembler li appiattisce prima di assemblarli nel documento risultante.
Il servizio Assembler utilizza il servizio Output per appiattire i moduli XFA dinamici. Se il servizio Assembler elabora un DDX che lo richiede per appiattire un modulo dinamico XFA e il servizio Output non è disponibile, viene generata un'eccezione. Il servizio Assembler può appiattire un modulo Acrobat o un modulo XFA statico senza utilizzare il servizio Output.
È possibile utilizzare il servizio Assembler per assemblare più documenti XDP in un singolo documento XDP o in un documento PDF. Per i file XDP di origine che includono punti di inserimento, è possibile specificare i frammenti da inserire.
Di seguito sono riportati alcuni modi per assemblare i documenti XDP:
L'illustrazione seguente mostra tre documenti XDP sorgente che vengono assemblati in un singolo documento XDP risultante. Il documento XDP risultante contiene i tre documenti XDP di origine, inclusi i relativi dati associati. Il documento risultante ottiene gli attributi di base dal documento di base, che è il primo documento XDP di origine.
Assemblare un semplice documento XDP da più documenti XDP
Di seguito è riportato un documento DDX che produce il risultato illustrato sopra.
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="MyXDPResult">
<XDP source="sourceXDP1"/>
<XDP source="sourceXDP2"/>
<XDP source="sourceXDP3"/>
</XDP>
</DDX>
In genere, i documenti XDP possono contenere immagini cui viene fatto riferimento tramite riferimenti assoluti o relativi. Il servizio Assembler, per impostazione predefinita, mantiene i riferimenti alle immagini nel documento XDP risultante.
È possibile specificare come il servizio Assembler gestisce le immagini a cui si fa riferimento nei documenti XDP di origine tramite riferimenti assoluti o relativi nei file XDP durante l'assemblaggio. Potete scegliere di incorporare tutte le immagini nel risultato in modo che non contenga riferimenti relativi o assoluti. Per definirlo è necessario impostare il valore del tag resolveAssets, che può assumere una delle seguenti opzioni. Per impostazione predefinita, nel documento dei risultati non vengono risolti riferimenti.
Valore | Descrizione |
---|---|
nessuno | Non risolve alcun riferimento. |
all | Incorpora tutte le immagini di riferimento nel documento XDP di origine. |
relativo | Incorpora tutte le immagini a cui viene fatto riferimento tramite riferimenti relativi nel documento XDP di origine. |
assoluto | Incorpora tutte le immagini a cui viene fatto riferimento tramite riferimenti assoluti nel documento XDP di origine. |
È possibile specificare il valore dell'attributo resolveAssets nel tag di origine XDP o nel tag di risultato XDP padre. Se l'attributo è specificato per il tag dei risultati XDP, verrà ereditato da tutti gli elementi di origine XDP secondari del risultato XDP. Tuttavia, specificando in modo esplicito l'attributo per un elemento di origine, l'impostazione dell'elemento result viene ignorata solo per il documento di origine.
Per risolvere tutti i riferimenti nei documenti XDP di origine, specificate l'attributo resolveAssets per
documento risultante per tutti, come nell'esempio seguente:
<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
È inoltre possibile specificare l'attributo per tutti i documenti XDP di origine in modo indipendente per ottenere lo stesso
risultato.
<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>
Potete specificare in modo selettivo i riferimenti di origine che desiderate risolvere specificando l'attributo resolveAssets per tali riferimenti. Gli attributi per i singoli documenti sorgente sostituiscono l’impostazione del documento XDP risultante. In questo esempio vengono risolti anche i frammenti inclusi.
<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>
Potete risolvere in modo selettivo i riferimenti assoluti o relativi in tutti o in parte i documenti sorgente, come illustrato nell’esempio di seguito:
<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
È possibile utilizzare il servizio Assembler per creare un modulo XFA creato da un altro modulo XFA in cui vengono inseriti i frammenti. Questa funzione consente di creare più moduli utilizzando i frammenti.
Il supporto per l'inserimento dinamico dei frammenti di modulo supporta il controllo a origine singola. È possibile mantenere un'unica origine di componenti comunemente utilizzati. Ad esempio, è possibile creare un frammento per il banner aziendale. Se il banner cambia, è sufficiente modificare il frammento. Gli altri moduli che includono il frammento rimangono invariati.
I progettisti di moduli utilizzano Designer di LiveCycle per creare frammenti di modulo. Tali frammenti hanno un nome univoco all'interno di un modulo XFA. I progettisti di moduli utilizzano inoltre Designer per creare moduli XFA con punti di inserimento denominati in modo univoco. Il programmatore scrive documenti DDX che specificano la modalità di inserimento dei frammenti nel modulo XFA.
Nell'illustrazione seguente sono visualizzati due moduli XML (modelli XFA). Il modulo a sinistra contiene un punto di inserimento denominato myInsertionPoint. Il modulo a destra contiene un frammento denominato myFragment.
Inserimento di frammenti di modulo in un modulo XFA
Quando il servizio Assembler interpreta il seguente documento DDX, crea un modulo XML che contiene un altro modulo XML. Il sottomodulo myFragment del documento myFragmentSource viene inserito in myInsertionPoint nel 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
È possibile utilizzare il servizio Assembler per creare un pacchetto di un documento XDP come documento PDF, come illustrato in questo 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>
È possibile utilizzare il servizio Assembler per smontare un documento PDF. Il servizio può estrarre pagine dal documento di origine o dividere un documento di origine basato su segnalibri. In genere, questa attività è utile se il documento PDF è stato creato originariamente da molti documenti, ad esempio una raccolta di istruzioni.
Nell'illustrazione seguente, le pagine 1-3 vengono estratte dal documento di origine e inserite in un nuovo documento risultante.
Estrazione di pagine specifiche da un documento di origine
L'esempio seguente è un documento DDX utilizzato per smontare il documento.
<PDF result="Doc4">
<PDF source="Doc2" pages="1-3"/>
</PDF>
Nell'illustrazione seguente, DocA è diviso in più documenti risultanti. Il segnalibro di primo livello 1 in una pagina identifica l'inizio di un nuovo documento risultante.
Divisione di un documento sorgente basato su segnalibri in più documenti
L'esempio seguente è un documento DDX che utilizza segnalibri per smontare un documento di origine.
<PDFsFromBookmarks prefix="A">
<PDF source="DocA"/>
</PDFsFromBookmarks>
È possibile utilizzare il servizio Assembler per determinare se un documento PDF è conforme allo standard PDF/A. PDF/A è un formato di archiviazione che consente di preservare a lungo termine il contenuto del documento. I font vengono incorporati nel documento e il file non viene compresso. Di conseguenza, un documento PDF/A è generalmente più grande di un documento PDF standard. Inoltre, un documento PDF/A non contiene contenuto audio e video.
È possibile utilizzare il servizio Assembler per ottenere le seguenti informazioni su un documento PDF:
Informazioni sul testo.
Segnalibri, inclusi il numero di pagina, il titolo, la destinazione e l’aspetto. Puoi esportare questo
i dati di un documento PDF e importarli in un documento PDF.
Allegati di file, comprese le informazioni sui file. Per gli allegati a livello di pagina, include anche
posizione dell'annotazione dell'allegato del file. È possibile esportare questi dati da un documento PDF e
importarlo in un documento PDF.
Creare pacchetti di file, incluse informazioni sui file, cartelle, pacchetti, schemi e dati dei campi. È possibile esportare questi dati da un documento PDF e importarli in un documento PDF.
È possibile utilizzare il servizio Assembler per determinare se un documento DDX è valido. Ad esempio, se si effettua l'aggiornamento da una versione di LiveCycle precedente, la convalida verifica la validità del documento DDX.
È possibile utilizzare documenti DDX che fanno sì che il servizio Assembler chiami i seguenti servizi LiveC ycle. Il servizio Assembler può chiamare solo i servizi installati con il LiveCycle.
Servizio Estensioni Reader: Consente utenti Adobe Reader di firmare digitalmente il documento PDF risultante.
Servizio Forms: Unisce un file XDP e un file di dati XML per produrre un documento PDF contenente il modulo interattivo compilato.
Servizio di output: Converte un modulo XML dinamico in un documento PDF contenente un modulo non interattivo (appiattisce il modulo). Il servizio Assembler appiattisce i moduli XML statici e moduli Acrobat senza chiamare il servizio 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>
L'utilizzo di DDX e del servizio Assembler per chiamare altri servizi LiveC ciclabili può semplificare il diagramma del processo. È anche possibile ridurre il lavoro di personalizzazione dei flussi di lavoro. (Consulta anche