Inleiding tot as a Cloud Service communicatie met AEM Forms frequently-asked-questions

Versie
Artikelkoppeling
AEM 6,5
Klik hier
AEM as a Cloud Service
Dit artikel

Met communicatiemogelijkheden kunt u documenten maken die door uw merk zijn goedgekeurd, gepersonaliseerd en gestandaardiseerd, zoals zakelijke correspondentie, instructies, aanvraagverwerkingsbrieven, aankondigingen van voordelen, maandelijkse facturen of welkomstkits.

De mogelijkheid biedt API's om de documenten te genereren en te bewerken. U kunt een document op verzoek genereren of bewerken of een batchtaak maken om meerdere documenten met gedefinieerde intervallen te genereren. Communicatie-API's bieden:

  • gestroomlijnde mogelijkheden voor het genereren van documentatie op aanvraag en batchverwerking.

  • de mogelijkheid om PDF-documenten op aanvraag te combineren, opnieuw te rangschikken en te valideren.

  • HTTP-API's voor eenvoudigere integratie met externe systemen. Afzonderlijke API's voor bewerkingen op aanvraag (lage latentie) en batchbewerkingen (bewerkingen met hoge doorvoer) worden opgenomen.

  • een veilige toegang tot gegevens. Communicatie APIs verbindt met en heeft toegang tot gegevens slechts van klant-aangewezen gegevensbewaarplaatsen, die mededelingen hoogst veilig maken.

Een voorbeeld van een creditcardformulier
Een creditcardverklaring kan worden gecreeerd gebruikend Communicatie APIs. Deze voorbeeldinstructie gebruikt dezelfde sjabloon maar afzonderlijke gegevens voor elke klant, afhankelijk van het gebruik van de creditcard.

Documentgeneratie

Via API's voor het genereren van communicatiedocumenten kunt u een sjabloon (XFA of PDF) combineren met klantgegevens (XML) om documenten te genereren in de indelingen PDF en Afdrukken, zoals de indelingen PS, PCL, DPL, IPL en ZPL. Deze API's gebruiken PDF- en XFA-sjablonen met XML-gegevens om één document op bestelling of meerdere documenten te produceren die een partijbaan gebruiken.

Doorgaans maakt u een sjabloon met Designer en gebruik Communicatie APIs om gegevens met het malplaatje samen te voegen. Uw toepassing kan het uitvoerdocument naar een netwerkprinter, een lokale printer of een opslagsysteem verzenden voor archivering. Een typisch uit de doos en de douanewerkschema's kijken als het volgende:

Workflow voor het genereren van communicatiedocumenten

Afhankelijk van het gebruiksgeval kunt u deze documenten ook beschikbaar stellen voor downloaden via uw website of een opslagserver.

Voorbeelden van API's voor het genereren van documenten zijn:

PDF-documenten maken create-pdf-documents

Met de API's voor het genereren van documenten kunt u een PDF-document maken dat is gebaseerd op een formulierontwerp en XML-formuliergegevens. De uitvoer is een niet-interactief PDF-document. Met andere woorden, gebruikers kunnen de formuliergegevens niet invoeren of wijzigen. Een basisworkflow is het samenvoegen van XML-formuliergegevens met een formulierontwerp om een PDF-document te maken. In de volgende afbeelding ziet u hoe een formulierontwerp en XML-formuliergegevens worden samengevoegd om een PDF-document te maken.

PDF-documenten maken
Afbeelding: Standaardworkflow voor het maken van een PDF-document

PostScript (PS), Printer Command Language (PCL), Zebra Printing Language (ZPL)-document maken create-PS-PCL-ZPL-documents

Met API's voor het genereren van documenten kunt u PostScript- (PS), PCL-documenten (Printer Command Language) en ZPL-documenten (Zebra Printing Language) maken die zijn gebaseerd op een XDP-formulierontwerp of PDF-document. Deze API's helpen u bij het samenvoegen van een formulierontwerp met formuliergegevens om een document te genereren. U kunt het document opslaan in een bestand en een aangepast proces ontwikkelen om het naar een printer te verzenden.

Batchgegevens verwerken om meerdere documenten te maken processing-batch-data-to-create-multiple-documents

Met API's voor het genereren van documenten kunt u afzonderlijke documenten maken voor elke record in een XML-batchgegevensbron. U kunt documenten bulksgewijs en asynchroon genereren. U kunt diverse parameters voor de omzetting vormen en dan het partijproces beginnen.

PDF-documenten maken

Documentmanipulatie

Via API's voor documentmanipulatie kunt u PDF-documenten combineren, opnieuw rangschikken en valideren. Doorgaans maakt u een DDX en verzendt u deze naar API's voor documentmanipulatie om een document samen te stellen of opnieuw te rangschikken. De DDX-document Hier vindt u instructies over het gebruik van de brondocumenten om een set vereiste documenten te maken. De DDX-referentiedocumentatie biedt gedetailleerde informatie over alle ondersteunde bewerkingen. Voorbeelden van documentmanipulatie zijn:

PDF-documenten samenstellen

Met de API's voor documentmanipulatie kunt u twee of meer PDF- of XDP-documenten samenvoegen tot één PDF-document of PDF-Portfolio. Hier volgen enkele voorbeelden van manieren waarop u PDF-documenten kunt samenstellen:

  • Een eenvoudig PDF-document samenstellen
  • Een PDF-Portfolio maken
  • Gecodeerde documenten samenstellen
  • Documenten samenstellen met Bates-nummering
  • Documenten samenvoegen en samenvoegen

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

PDF-documenten demonteren

U kunt de API's voor documentmanipulatie gebruiken om een PDF-document te demonteren. De API's kunnen 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
  • Een brondocument splitsen op basis van bladwijzers

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

Converteren naar en valideren van documenten die voldoen aan PDF/A

U kunt de API's voor documentmanipulatie gebruiken om een PDF-document te converteren naar een document dat voldoet aan de PDF/A-standaard en om te bepalen of een PDF-document voldoet aan de PDF/A-standaard. 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.

NOTE
AEM Forms biedt diverse ingebouwde lettertypen die naadloos kunnen worden geïntegreerd met PDF-bestanden. De lijst met ondersteunde lettertypen weergeven klik hier.

Documentcontrole doc-assurance

De DocAssurance-service bevat de API's voor handtekeningen en versleuteling:

Handtekening-API's

Met de handtekening-API's kunt u de beveiliging en privacy van Adobe PDF-documenten die door uw organisatie worden gedistribueerd en ontvangen, beschermen. Deze service gebruikt digitale handtekeningen en certificering om ervoor te zorgen dat alleen de beoogde ontvangers documenten kunnen wijzigen. Omdat beveiligingsfuncties op het document zelf worden toegepast, blijft het document gedurende de gehele levenscyclus beveiligd en beheerd. Een document blijft veilig buiten de firewall, wanneer het offline wordt gedownload en wanneer het terug naar uw organisatie wordt verzonden. U kunt de volgende taken uitvoeren met de handtekening-API's:

  • Voeg een handtekeningveld toe aan een PDF-document.
  • Onderteken het opgegeven handtekeningveld in een PDF-document.
  • Een PDF-document certificeren

Coderings-API's

Met de API's voor versleuteling kunt u documenten versleutelen en ontsleutelen. Wanneer een document wordt versleuteld, wordt de inhoud ervan onleesbaar. Een geautoriseerde gebruiker kan het document decoderen om toegang tot de inhoud te krijgen. Als een PDF-document met een wachtwoord is versleuteld, moet de gebruiker het wachtwoord voor openen opgeven voordat het document in Adobe Reader of Adobe Acrobat kan worden weergegeven. Als een PDF-document met een certificaat is versleuteld, moet de gebruiker het PDF-document decoderen met de openbare sleutel die overeenkomt met het certificaat (de persoonlijke sleutel) waarmee het PDF-document is versleuteld.

U kunt deze taken uitvoeren met de API's voor codering:

  • Codeer een PDF-document met een wachtwoord.
  • Verwijder op wachtwoord gebaseerde versleuteling uit een PDF-document.
  • Hiermee haalt u het type beveiliging op dat op een PDF-document is toegepast.

Zowel handtekening-API's als versleutelings-API's zijn Synchrone API's.

Typen communicatie-API's types

Communicatie biedt HTTP-API's voor het genereren van documenten op aanvraag en in batches:

  • Synchrone API's zijn geschikt voor on-demand, lage latentie en scenario's voor het genereren van één record. Deze API's zijn geschikter voor gebruiksgevallen die zijn gebaseerd op handelingen van gebruikers. Als u bijvoorbeeld een document genereert nadat een gebruiker een formulier heeft ingevuld.

  • Batch-API's (Asynchrone API's) zijn geschikt voor geplande, hoge productie, en veelvoudige scenario's van de documentgeneratie. Met deze API's worden documenten batchgewijs gegenereerd. Zo worden telefoonrekeningen, creditcardafschriften en uitkeringsafschriften elke maand gegenereerd.

Onboarding

Communicatiecapaciteit is beschikbaar als zelfstandige en add-on module voor as a Cloud Service Forms-gebruikers. U kunt contact opnemen met het verkoopteam van de Adobe of met uw Adobe als u toegang wilt aanvragen. Adobe maakt toegang voor uw organisatie mogelijk en biedt de vereiste rechten aan de persoon die is aangewezen als beheerder in uw organisatie. De beheerder kan toegang verlenen aan uw as a Cloud Service Forms-ontwikkelaars (gebruikers) van uw organisatie om de API's te gebruiken.

Na het instappen, om Communicatie vermogen voor uw as a Cloud Service milieu van Forms toe te laten:

  1. Meld u aan bij Cloud Manager en open de as a Cloud Service AEM Forms-instantie.

  2. Open de optie Programma bewerken, ga naar het tabblad Oplossingen en invoegtoepassingen en selecteer de optie Forms - Communications -optie.

    Communicatie

    Als u al Forms - Digital Enrollment en selecteert u vervolgens de optie Forms - Communications Add-On -optie.

    Addon

  3. Klik op Update.

  4. Stel de bouwstijlpijpleiding in werking. Nadat de bouwstijlpijpleiding slaagt, Communicatie APIs wordt toegelaten voor uw milieu.

NOTE
Als u API's voor documentmanipulatie wilt inschakelen en configureren, voegt u de volgende regel toe aan Dispatcher-configuratie:
# Allow Forms Doc Generation requests
/0062 { /type "allow" /method "POST" /url "/adobe/forms/assembler/*" }

Zie ook see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab