De Assembler-service gebruiken using-assembler-service

CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Met de service Assembler kunt u PDF- en XDP-documenten combineren, opnieuw rangschikken en vergroten en informatie over PDF-documenten opvragen. Elke baan die aan de dienst van de Assembler wordt voorgelegd omvat een document van XML van de Beschrijving van het Document (DDX), brondocumenten, en externe middelen (koorden en grafiek). Voor meer informatie over de assembleerdienst, zie Overzicht van de Assembler Service.

U kunt de verzamelservice gebruiken voor de volgende bewerkingen:

PDF-documenten samenstellen assemble-pdf-documents

U kunt de dienst van de Assembler gebruiken om twee of meer documenten van de PDF in één enkel document van de PDF of Portfolio van de PDF samen te stellen. U kunt ook functies toepassen op het PDF-document die navigatie ondersteunen of de beveiliging verbeteren. Hier volgen enkele voorbeelden van manieren waarop u PDF-documenten kunt samenstellen:

Een eenvoudig PDF-document samenstellen assemble-a-simple-pdf-document

In de volgende afbeelding ziet u drie brondocumenten die in één resulterend document worden samengevoegd.

Een eenvoudig PDF-document samenstellen op basis van meerdere PDF-documenten
Afbeelding: Een eenvoudig PDF-document samenstellen op basis van meerdere PDF-documenten

Het volgende voorbeeld is een eenvoudig DDX-document dat wordt gebruikt om het document samen te stellen. Hierin worden de namen van de brondocumenten opgegeven die worden gebruikt om het resulterende document te produceren, en de naam van het resulterende document:

<PDF result="Doc4">
<PDF source="Doc1"/>
<PDF source="Doc2"/>
<PDF source="Doc3"/>
</PDF>

De assemblage van het document veroorzaakt een resulterend document dat de volgende inhoud bevat en
kenmerken:

  • Alle of een deel van elk brondocument
  • De bladwijzers van elk brondocument of een deel ervan worden genormaliseerd voor het samengevoegde resulterende document
  • Andere kenmerken die zijn overgenomen uit het basisdocument (Doc1), waaronder metagegevens, paginalabels en paginagrootte
  • Het resulterende document bevat eventueel een inhoudsopgave die is opgebouwd uit de bladwijzers in de brondocumenten

Een PDF-Portfolio maken create-a-pdf-portfolio

De dienst van de Assembler kan PDF Portfolio tot stand brengen die een inzameling van documenten en een selfbevat gebruikersinterface bevatten. De interface wordt genoemd een Lay-out van de Portfolio van de PDF of een navigator van de Portfolio van de PDF (navigator). PDF Portfolio vergroten de mogelijkheden van PDF-pakketten door een navigator, mappen en welkomstpagina's toe te voegen. De interface kan de gebruikerservaring verbeteren door gebruik te maken van gelokaliseerde tekst, aangepaste kleurenschema's en grafische bronnen. De PDF-Portfolio kan ook mappen bevatten voor het ordenen van de bestanden in het portfolio.

Wanneer de dienst van de Assembler het volgende DX- document interpreteert, assembleert het een Portfolio van PDF die een PDF Portfolio navigator en een pakket van twee dossiers omvat. De dienst verkrijgt de navigator van de plaats die door myNavigator bron wordt gespecificeerd. Hiermee wordt het standaardkleurenschema van de navigator gewijzigd in het rozeScheme-kleurenschema.

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

Gecodeerde documenten samenstellen assemble-encrypted-documents

Wanneer u een document samenstelt, kunt u het PDF-document ook versleutelen met een wachtwoord. Nadat een PDF-document met een wachtwoord is versleuteld, moet een gebruiker het wachtwoord opgeven om het PDF-document in Adobe Reader of Acrobat weer te geven. Als u een PDF-document met een wachtwoord wilt versleutelen, moet het DDX-document waarden voor versleuteling bevatten die vereist zijn voor het versleutelen van een PDF-document.

De versleutelingsservice hoeft geen deel uit te maken van de LiveCycle-installatie om een PDF-document met een wachtwoord te versleutelen.

Als een of meer invoerdocumenten zijn versleuteld, geeft u een wachtwoord op om het document te openen als onderdeel van de DDX.

Documenten samenstellen met Bates-nummering assemble-documents-using-bates-numbering

Wanneer u een document samenstelt, kunt u Bates-nummering gebruiken om een unieke pagina-id toe te passen op elke pagina. Wanneer u Bates-nummering gebruikt, wordt aan elke pagina in het document (of in een set documenten) een nummer toegewezen dat de pagina op unieke wijze identificeert. Bijvoorbeeld, kunnen de productiedocumenten die rekening van materiaalinformatie bevatten en met de productie van een assemblage worden geassocieerd een herkenningsteken bevatten. Een Bates-nummer bevat een opeenvolgend verhoogde numerieke waarde en een optioneel voor- en achtervoegsel. Het voorvoegsel + de numerieke waarde + achtervoegsel wordt een bonepatroon genoemd.

In de volgende afbeelding ziet u een PDF-document dat een unieke id bevat die zich in de koptekst van het document bevindt.

Een PDF-document dat een unieke id bevat die zich in de koptekst van het document bevindt
Afbeelding: Een PDF-document dat een unieke id bevat die zich in de koptekst van het document bevindt

Documenten samenvoegen en samenvoegen flatten-and-assemble-documents

Met de Assembler-service kunt u een interactief PDF-document (bijvoorbeeld een formulier) transformeren naar een niet-interactief PDF-document. Met een interactief PDF-document kunnen gebruikers gegevens in de documentvelden van het PDF-document invoeren of wijzigen. Het transformeren van een interactief PDF-document naar een niet-interactief PDF-document wordt afvlakking genoemd. Wanneer een PDF-document wordt afgevlakt, behouden formuliervelden hun grafische weergave maar zijn ze niet meer interactief. Een reden om een PDF-document af te vlakken is ervoor te zorgen dat gegevens niet kunnen worden gewijzigd. Daarnaast werken scripts die aan de velden zijn gekoppeld niet meer.

Wanneer u een document van de PDF creeert dat van interactieve documenten van de PDF wordt samengesteld, voegt de dienst van de Assembler die vormen samen alvorens hen in het resulterende document te assembleren.

NOTE
De Assembler-service gebruikt de Output-service om dynamische XFA-formulieren af te vlakken. Als de dienst van de Assembler een DDX verwerkt die het vereist om een XFA dynamische vorm af te vlakken en de dienst van de Output niet beschikbaar is, wordt een uitzondering geworpen. De Assembler-service kan een Acrobat-formulier of een statisch XFA-formulier afvlakken zonder de Output-service te gebruiken.

XDP-documenten samenstellen assemble-xdp-documents

Met de Assembler-service kunt u meerdere XDP-documenten samenvoegen in één XDP-document of in een PDF-document. Voor XDP-bronbestanden die invoegpunten bevatten, kunt u opgeven welke fragmenten moeten worden ingevoegd.

Hier volgen enkele voorbeelden van manieren waarop u XDP-documenten kunt samenstellen:

Een eenvoudig XDP-document samenstellen assemble-a-simple-xdp-document

In de volgende afbeelding ziet u drie XDP-brondocumenten die in één resulterend XDP-document worden samengevoegd. Het resulterende XDP-document bevat de drie bron-XDP-documenten inclusief de bijbehorende gegevens. Het resulterende document krijgt basiskenmerken van het basisdocument, het eerste bron-XDP-document.

Een eenvoudig XDP-document samenstellen op basis van meerdere XDP-documenten
Afbeelding: Een eenvoudig XDP-document samenstellen op basis van meerdere XDP-documenten

Hier volgt een DDX-document dat het hierboven weergegeven resultaat oplevert.

<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="MyXDPResult">
<XDP source="sourceXDP1"/>
<XDP source="sourceXDP2"/>
<XDP source="sourceXDP3"/>
</XDP>
</DDX>

Referenties oplossen tijdens verzameling resolving-references-during-assembly

XDP-documenten kunnen doorgaans afbeeldingen bevatten waarnaar wordt verwezen door absolute of relatieve verwijzingen. Standaard blijven in de verzamelingsservice de verwijzingen naar de afbeeldingen in het resulterende XDP-document behouden.

U kunt specificeren hoe de dienst van de Assembler de beelden die in de bronXDP documenten van verwijzingen worden voorzien of door absolute of relatieve verwijzingen in de XDP dossiers wanneer het assembleren. U kunt ervoor kiezen om alle afbeeldingen in de resulterende afbeelding in te sluiten, zodat deze geen relatieve of absolute verwijzingen bevat. U definieert dit door de waarde van de tag resolveAssets in te stellen. Dit kan een van de volgende opties hebben. Standaard worden geen verwijzingen omgezet in het resultaatdocument.

Waarde
Beschrijving
none
Hiermee worden referenties niet opgelost.
alles
Hiermee worden alle afbeeldingen waarnaar wordt verwezen, ingesloten in het XDP-brondocument.
relatief
Hiermee worden alle afbeeldingen ingesloten waarnaar wordt verwezen door relatieve verwijzingen in de bron-XDP
document.
absoluut
Hiermee worden alle afbeeldingen ingesloten waarnaar wordt verwezen door absolute referenties in de bron-XDP
document.

U kunt de waarde van het kenmerk resolveAssets opgeven in de XDP-brontag of in de bovenliggende XDP-resultaattag. Als het attribuut aan de XDP resultaatmarkering wordt gespecificeerd, zal het door alle XDP bronelementen worden geërft die kinderen van XDP resultaat zijn. Nochtans, treedt uitdrukkelijk het specificeren van de attributen voor een bronelement met voeten het plaatsen van het resultaatelement voor dat brondocument alleen.

Alle bronverwijzingen in een XDP-document omzetten resolve-all-source-references-in-an-xdp-document

Als u alle verwijzingen in de bron-XDP-documenten wilt oplossen, geeft u het kenmerk resolveAssets op voor de
resulterend document aan allen, zoals in het onderstaande voorbeeld:

<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

U kunt ook het kenmerk voor alle XDP-brondocumenten afzonderlijk opgeven om hetzelfde te verkrijgen
resultaat.

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

Geselecteerde bronverwijzingen omzetten in een XDP-document resolve-selected-source-references-in-an-xdp-document

U kunt selectief de bronverwijzingen specificeren die u wilt oplossen door de resolveAssets attributen voor hen te specificeren. De kenmerken voor afzonderlijke brondocumenten overschrijven de instelling van het resulterende XDP-document. In dit voorbeeld worden de opgenomen fragmenten ook opgelost.

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

Absolute of relatieve verwijzingen selectief oplossen selectively-resolve-absolute-or-relative-references

U kunt absolute of relatieve verwijzingen selectief oplossen in alle of sommige brondocumenten, zoals aangetoond in het hieronder voorbeeld:

<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

Formulierfragmenten dynamisch invoegen in een XFA-formulier dynamically-insert-form-fragments-into-an-xfa-form

Met de Assembler-service kunt u een XFA-formulier maken dat is gemaakt op basis van een ander XFA-formulier waarin fragmenten worden ingevoegd. Met deze functie kunt u fragmenten gebruiken om meerdere formulieren te maken.

Ondersteuning voor dynamische invoeging van formulierfragmenten ondersteunt single-source-beheer. U behoudt één bron van veelgebruikte componenten. U kunt bijvoorbeeld een fragment voor uw bedrijfsbanner maken. Als de banner verandert, hoeft u alleen het fragment te wijzigen. De andere formulieren met het fragment blijven ongewijzigd.

Formulierontwerpers gebruiken LiveC Cycle Designer om formulierfragmenten te maken. Deze fragmenten hebben een unieke naam voor subformulieren in een XFA-formulier. De formulierontwerpers gebruiken Designer ook om XFA-formulieren te maken met invoegpunten met een unieke naam. U (de programmeur) schrijft DX- documenten die specificeren hoe de fragmenten in de vorm XFA worden opgenomen.

In de volgende afbeelding ziet u twee XML-formulieren (XFA-sjablonen). Het formulier aan de linkerkant bevat een invoegpunt met de naam myInsertionPoint. Het formulier aan de rechterkant bevat een fragment met de naam myFragment.

Formulierfragmenten invoegen in een XFA-formulier
Afbeelding: Formulierfragmenten invoegen in een XFA-formulier

Wanneer de Assembler-service het volgende DDX-document interpreteert, wordt een XML-formulier gemaakt dat een ander XML-formulier bevat. Het subformulier myFragment uit het document myFragmentSource wordt ingevoegd bij myInsertionPoint in het document 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

Een XDP-document verpakken als PDF package-an-xdp-document-as-pdf

Met de Assembler-service kunt u een XDP-document verpakken als een PDF-document, zoals wordt weergegeven in dit DDX-document.

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

PDF-documenten demonteren disassemble-pdf-documents

U kunt de dienst van de Assembler gebruiken om een document van de PDF te demonteren. De service kan pagina's uitnemen uit het brondocument of een brondocument splitsen op basis van bladwijzers. Deze taak is meestal handig als het PDF-document oorspronkelijk is gemaakt op basis van veel afzonderlijke documenten, zoals een verzameling instructies.

Pagina's uit een brondocument extraheren extract-pages-from-a-source-document

In de volgende afbeelding worden pagina 1-3 uit het brondocument geëxtraheerd en in een nieuw resulterend document geplaatst.

Specifieke paginas uit een brondocument extraheren
Afbeelding: Specifieke pagina's uit een brondocument extraheren

Het volgende voorbeeld is een DDX-document dat wordt gebruikt om het document te demonteren.

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

Een brondocument splitsen op basis van bladwijzers divide-a-source-document-based-on-bookmarks

In de volgende afbeelding wordt DocA verdeeld in meerdere resulterende documenten. De eerste bladwijzer van niveau 1 op een pagina identificeert het begin van een nieuw resulterend document.

Een brondocument dat is gebaseerd op bladwijzers, opsplitsen in meerdere documenten
Afbeelding: Een brondocument dat is gebaseerd op bladwijzers, opsplitsen in meerdere documenten

Het volgende voorbeeld is een DDX-document dat bladwijzers gebruikt om een brondocument te demonteren.

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

Bepalen of documenten PDF/A-compatibel zijn determine-whether-documents-are-pdf-a-compliant

U kunt de dienst van de Assembler gebruiken om te bepalen of een document van de PDF PDF/A-Volgzaam is. PDF/A is een archiefindeling die is bedoeld voor het op lange termijn bewaren van de inhoud van het document. De lettertypen worden ingesloten in het document en het bestand wordt niet gecomprimeerd. Een PDF/A-document is daarom doorgaans groter dan een standaard PDF-document. Een PDF/A-document bevat ook geen audio- en video-inhoud.

Informatie opvragen over een PDF-document obtain-information-about-a-pdf-document

U kunt de dienst van de Assembler gebruiken om de volgende informatie over een document van de PDF te verkrijgen:

  • Tekstgegevens.

    • Woorden op elke pagina van het document
    • Positie van elk woord op elke pagina van het document
    • Zinnen in elke alinea van elke pagina van het document
  • Bladwijzers, inclusief het paginanummer, de titel, het doel en de weergave. U kunt deze gegevens exporteren uit een PDF-document en deze importeren in een PDF-document.

  • Bestandsbijlagen, inclusief bestandsinformatie. Voor bijlagen op paginaniveau bevat dit ook de locatie van de annotatie voor bestandsbijlagen. U kunt deze gegevens exporteren uit een PDF-document en deze importeren in een PDF-document.

  • Pakketbestanden, waaronder bestandsinformatie, mappen, pakket, schema en veldgegevens. U kunt deze gegevens exporteren uit een PDF-document en deze importeren in een PDF-document.

DDX-documenten valideren validate-ddx-documents

U kunt de dienst van de Assembler gebruiken om te bepalen of een Dx- document geldig is. Als u bijvoorbeeld een upgrade hebt uitgevoerd vanaf een vorige LiveCycle-versie, zorgt validatie ervoor dat uw DDX-document geldig is.

Andere services bellen call-other-services

U kunt DX- documenten gebruiken die de dienst van de Assembler veroorzaken om de volgende LiveC cyclusdiensten te roepen. De dienst van de Assembler kan slechts die diensten roepen die met LiveCycle worden geïnstalleerd.

Reader Extensions-service: Hiermee kunnen Adobe Reader-gebruikers het resulterende PDF-document digitaal ondertekenen.

Forms-service: Hiermee voegt u een XDP-bestand en een XML-gegevensbestand samen om een PDF-document te maken dat het ingevulde interactieve formulier bevat.

Uitvoerservice: Hiermee converteert u een dynamisch XML-formulier naar een PDF-document dat een niet-interactief formulier bevat (het formulier wordt afgevlakt). Met de service Assembler worden statische XML-formulieren en Acrobat-formulieren afgevlakt zonder dat de service Output wordt aangeroepen.

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

Het gebruiken van DDX en de dienst van de Assembler om andere LiveC cyclusdiensten te roepen kan uw procesdiagram vereenvoudigen. Het kan zelfs de moeite die u besteedt aan het aanpassen van uw workflows verminderen. (Zie ook: Programmaticaal AEM Document Services gebruiken)

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da