Utilizzo del servizio Assembler using-assembler-service

Il servizio Assembler consente di combinare, ridisporre e integrare documenti PDF e XDP e di ottenere informazioni sui documenti PDF. Ogni job inviato al servizio Assembler include un documento DDX (Document Description XML), documenti di origine e risorse esterne (stringhe e elementi grafici). Per ulteriori informazioni sul servizio Assembler, vedere Panoramica del servizio Assembler.

È possibile utilizzare il servizio di assemblaggio per le operazioni seguenti:

assemblare documenti PDF assemble-pdf-documents

È possibile utilizzare il servizio Assembler per assemblare due o più documenti PDF in un unico documento PDF o Portfolio PDF. È inoltre possibile applicare al documento PDF funzionalità che facilitano la navigazione o migliorano la sicurezza. Di seguito sono riportati alcuni modi per assemblare documenti PDF:

Assemblare un semplice documento PDF assemble-a-simple-pdf-document

Nella figura seguente vengono illustrati tre documenti di origine uniti in un unico documento risultante.

Assemblaggio di un semplice documento PDF 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 e 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 che contiene il seguente contenuto e
caratteristiche:

Creare un portfolio PDF create-a-pdf-portfolio

Il servizio Assembler può creare Portfoli di PDF che contengono una raccolta di documenti e un'interfaccia utente autonoma. L’interfaccia è denominata Layout Portfolio di PDF o Navigatore Portfolio di PDF. I Portfoli PDF estendono le funzionalità dei pacchetti PDF aggiungendo un navigatore, cartelle e pagine di benvenuto. L’interfaccia può migliorare l’esperienza utente sfruttando la stringa di testo localizzata, le combinazioni di colori personalizzate e le risorse grafiche. Il Portfolio PDF può anche includere cartelle per organizzare i file nel portfolio.

Quando il servizio Assembler interpreta il seguente documento DDX, assembla un Portfolio di PDF che include un navigatore di Portfoli di PDF 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 alla 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>

Assemblare documenti crittografati assemble-encrypted-documents

Quando si assembla un documento, è inoltre possibile crittografare il documento PDF con una password. Dopo aver crittografato un documento PDF PDF con una password, l’utente deve specificare la password per visualizzarlo in Adobe Reader o Acrobat. Per crittografare un documento PDF con una password, il documento DDX deve contenere i valori degli elementi di crittografia necessari per crittografare un documento PDF.

Il servizio Crittografia non deve far parte dell'installazione del LiveCycle per crittografare un documento PDF con una password.

Se uno o più documenti di input sono crittografati, specificare una password per aprire il documento come parte del DDX.

Assemblare documenti utilizzando la numerazione Bates assemble-documents-using-bates-numbering

Quando si assembla un documento, è possibile utilizzare la numerazione Bates per applicare un identificatore di pagina univoco a ogni 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 in sequenza e un prefisso e un suffisso opzionali. Il prefisso + valore numerico + suffisso è chiamato pattern di Bates.

Nell’illustrazione seguente viene illustrato un documento PDF che contiene un identificatore univoco nell’intestazione del documento.

Un documento PDF che contiene un identificatore univoco nell’intestazione del documento

Uniformare e assemblare documenti flatten-and-assemble-documents

È possibile utilizzare il servizio Assembler per trasformare un documento interattivo di PDF (ad esempio un modulo) in un documento non interattivo di PDF. Un documento PDF interattivo consente agli utenti di immettere o modificare dati nei campi del documento PDF. Il processo di trasformazione di un documento interattivo di PDF in un documento non interattivo di PDF è denominato appiattimento. Quando un documento PDF viene appiattito, i campi modulo mantengono il loro 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 assemblato da documenti PDF interattivi, il servizio Assembler appiattisce tali moduli prima di assemblarli nel documento risultante.

Assemblare documenti XDP assemble-xdp-documents

È 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, puoi specificare i frammenti da inserire.

Di seguito sono riportati alcuni dei modi per assemblare i documenti XDP:

Assemblare un semplice documento XDP assemble-a-simple-xdp-document

La figura seguente mostra tre documenti XDP di origine assemblati in un unico documento XDP risultante. Il documento XDP risultante contiene i tre documenti XDP di origine, inclusi i dati associati. Il documento risultante ottiene gli attributi di base dal documento di base, che è il primo documento XDP di origine.

Assemblaggio di un semplice documento XDP da più documenti XDP

Ecco 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>

Risoluzione dei riferimenti durante l'assemblaggio resolving-references-during-assembly

In genere, i documenti XDP possono contenere immagini a cui si fa riferimento tramite riferimenti assoluti o relativi. Per impostazione predefinita, il servizio Assembler mantiene i riferimenti alle immagini nel documento XDP risultante.

È possibile specificare il modo in cui 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 definire questo valore, imposta il valore del tag resolveAssets, che può accettare una qualsiasi delle seguenti opzioni. Per impostazione predefinita, nel documento dei risultati non vengono risolti riferimenti.

Puoi specificare il valore dell’attributo resolveAssets nel tag di origine XDP o nel tag di risultato XDP principale. Se l'attributo viene specificato nel tag dei risultati XDP, verrà ereditato da tutti gli elementi di origine XDP che sono figli del risultato XDP. Tuttavia, specificando in modo esplicito l'attributo per un elemento di origine, viene ignorata l'impostazione dell'elemento risultato per il solo documento di origine.

Risolvere tutti i riferimenti di origine in un documento XDP resolve-all-source-references-in-an-xdp-document

Per risolvere tutti i riferimenti nei documenti XDP di origine, specificate l'attributo resolveAssets per
documento risultante a 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>

Risolvere i riferimenti di origine selezionati in un documento XDP resolve-selected-source-references-in-an-xdp-document

È possibile specificare in modo selettivo i riferimenti di origine che si desidera risolvere specificando l'attributo resolveAssets relativo. Gli attributi dei singoli documenti di origine sovrascrivono 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>

Risoluzione selettiva di riferimenti assoluti o relativi selectively-resolve-absolute-or-relative-references

È possibile risolvere in modo selettivo i riferimenti assoluti o relativi in tutti o in alcuni dei documenti di origine, come illustrato nell'esempio seguente:

<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

Inserire dinamicamente frammenti di modulo in un modulo XFA dynamically-insert-form-fragments-into-an-xfa-form

È possibile utilizzare il servizio Assembler per creare un modulo XFA creato da un altro modulo XFA in cui vengono inseriti i frammenti. Utilizzando questa funzione è possibile utilizzare i frammenti per creare più moduli.

Il supporto per l’inserimento dinamico di frammenti di modulo supporta il controllo di un’unica origine. Puoi mantenere un’unica origine dei componenti di uso comune. Ad esempio, puoi creare un frammento per il banner dell’azienda. Se il banner cambia, devi solo 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. Questi frammenti sono sottomaschere con nomi univoci all’interno di un modulo XFA. I progettisti di moduli utilizzano inoltre Designer per creare moduli XFA con punti di inserimento con un nome univoco. Il programmatore scrive documenti DDX che specificano la modalità di inserimento dei frammenti nel modulo XFA.

Nella figura seguente vengono illustrati due moduli XML (modelli XFA). La maschera 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 contenente 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

Creare un pacchetto di un documento XDP come PDF package-an-xdp-document-as-pdf

È 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>

Separare i documenti PDF disassemble-pdf-documents

È possibile utilizzare il servizio Assembler per disassemblare un documento PDF. Il servizio può estrarre pagine dal documento di origine o dividere un documento di origine in base ai segnalibri. In genere, questa attività è utile se il documento PDF è stato creato in origine da molti documenti singoli, ad esempio da una raccolta di istruzioni.

Estrarre pagine da un documento di origine extract-pages-from-a-source-document

Nella figura 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

Nell'esempio seguente viene illustrato un documento DDX utilizzato per disassemblare il documento.

<PDF result="Doc4">
<PDF source="Doc2" pages="1-3"/>
</PDF>

Dividere un documento di origine basato sui segnalibri divide-a-source-document-based-on-bookmarks

Nella figura 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 di origine basato su segnalibri in più documenti

L'esempio seguente è un documento DDX che utilizza segnalibri per disassemblare un documento di origine.

<PDFsFromBookmarks prefix="A">
<PDF source="DocA"/>
</PDFsFromBookmarks>

Determinare se i documenti sono conformi a PDF/A determine-whether-documents-are-pdf-a-compliant

È possibile utilizzare il servizio Assembler per determinare se un documento PDF è compatibile con PDF/A. PDF/A è un formato di archiviazione destinato alla conservazione a lungo termine del contenuto del documento. I font vengono incorporati nel documento e il file non è compresso. Di conseguenza, un documento PDF/A è generalmente più grande di un documento PDF standard. Inoltre, un documento PDF/A non include contenuti audio e video.

Ottenere informazioni su un documento PDF obtain-information-about-a-pdf-document

È possibile utilizzare il servizio Assembler per ottenere le seguenti informazioni su un documento PDF:

Convalida documenti DDX validate-ddx-documents

È possibile utilizzare il servizio Assembler per determinare se un documento DDX è valido. Se ad esempio si è eseguito l'aggiornamento da una versione precedente del LiveCycle, la convalida garantisce che il documento DDX sia valido.

Chiama altri servizi call-other-services

È possibile utilizzare i documenti DDX che fanno sì che il servizio Assembler chiami i seguenti servizi ciclo LiveC. Il servizio Assembler può chiamare solo i servizi installati con LiveCycle.

Servizio estensioni di Reader: consente agli utenti di 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 i moduli Acrobat senza chiamare il servizio di 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 richiamare altri servizi ciclici LiveC può semplificare il diagramma dei processi. Può anche ridurre il carico di lavoro dedicato alla personalizzazione dei flussi di lavoro. (Vedere anche