Utilizzo di Assembler Service

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:

Assemblare documenti PDF

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

Assemblare un semplice documento 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:

• Tutto o parte di ciascun documento di origine
• Tutti o parte dei segnalibri di ciascun documento di origine, normalizzati per il documento risultante assemblato
• Altre caratteristiche adottate dal documento di base (Doc1), compresi metadati, etichette di pagina e dimensioni di pagina
• Facoltativamente, il documento risultante include un sommario costruito dai segnalibri nei documenti di origine

Creare un Portfolio PDF

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>

Assemblare documenti crittografati

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.

Assemblare i documenti utilizzando la numerazione Bates

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

Appiattisci e assembla documenti

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

Assemblare documenti XDP

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

Assemblare un semplice documento 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>

Risoluzione dei riferimenti durante l'assembly

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.

Risolvere tutti i riferimenti di origine in un documento XDP

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>

Risolvere i riferimenti di origine selezionati in un documento XDP

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>

Risolvere in modo selettivo i riferimenti assoluti o relativi

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

Inserimento dinamico di frammenti di modulo in un modulo XFA

È 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

Creare un pacchetto di documenti XDP come 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>

Smontare documenti PDF

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

Estrarre pagine da un documento di origine

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>

Dividere un documento di origine in base ai segnalibri

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>

Determinare se i documenti sono conformi allo standard PDF/A

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

Ottenere informazioni su un documento PDF

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

• Informazioni sul testo.

  • Parole in ogni pagina del documento
  • Posizione di ogni parola su ogni pagina del documento
  • Frasi in ciascun paragrafo di ciascuna pagina del documento

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

Convalida documenti DDX

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

Chiama altri servizi

È 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