AEM Forms as a Cloud Service communicatie-API's frequently-asked-questions

Hero Beeld

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.

Document genereren

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 APIs gebruikt PDF en malplaatjes XFA met gegevens van XMLom één enkel document op bestelling of veelvoudige documenten te produceren die een partijbaan gebruiken.

Typisch, creeert u een malplaatje gebruikend Designeren gebruikt Mededelingen 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:

Communicatie Werkschema van de documentgeneratie

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.

creeer PDF documenten
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

U kunt API's voor het genereren van documenten gebruiken om een PostScript-document (PS), een PCL-document (Printer Command Language) en een ZPL-document (Zebra Printing Language) te maken dat is gebaseerd op een XDP-formulierontwerp of een 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.

creeer de Documenten van PDF

Documentmanipulatie

Met API's voor het manipuleren van communicatiedocumenten (Document Transformation) kunt u PDF-documenten combineren en opnieuw rangschikken. Doorgaans maakt u een DDX en verzendt u deze naar API's voor documentmanipulatie om een document samen te stellen of opnieuw te rangschikken. Het DDX- documentverstrekt instructies op hoe te om de brondocumenten te gebruiken om een reeks vereiste documenten te veroorzaken. 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

samenstellend een eenvoudig document van PDF van veelvoudige documenten van PDF
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

het Verdelen van een brondocument dat op referenties in veelvoudige documenten wordt gebaseerd
Afbeelding: Een brondocument dat is gebaseerd op bladwijzers, opsplitsen in meerdere documenten

NOTE
AEM Forms biedt diverse ingebouwde lettertypen die naadloos kunnen worden geïntegreerd met PDF-bestanden. Om de lijst van gesteunde doopvonten te zien, klik hier.

Document uitnemen

De functie voor het uitnemen van documenten valt onder het programma voor vroegtijdige adoptie. U kunt vanaf uw officiële e-mailadres naar aem-forms-ea@adobe.com schrijven om deel te nemen aan het programma voor vroege adoptie en toegang tot de functie te vragen.

Met de service Documentextractie kunt u de eigenschappen van een PDF-document ophalen, zoals gebruiksrechten, PDF-eigenschappen en metagegevens. De mogelijkheden voor het uitnemen van documenten zijn:

  • Hiermee worden de eigenschappen van een PDF-document opgehaald, bijvoorbeeld als de PDF bijlagen, opmerkingen, de Acrobat-versie en nog veel meer bevat.
  • Haal de gebruiksrechten uit die in een PDF-document zijn ingeschakeld, gebruikers halen de gebruiksrechten op die zijn in- of uitgeschakeld voor Adobe Acrobat Reader-uitbreidbaarheid naar een PDF-document.
  • Haal de metagegevens op die aanwezig zijn in een PDF-document. De metagegevens zijn gegevens over het document (die verschillen van de inhoud van het document, zoals tekst en afbeeldingen). Het Adobe Extensible Metadata Platform (XMP) is een standaard voor de verwerking van documentmetagegevens. Met de XMP Utilities kunt u XMP metagegevens ophalen uit PDF-documenten en XMP metagegevens exporteren naar PDF-documenten.

De API verwijzingsdocumentatieverstrekt gedetailleerde informatie over alle parameters, authentificatiemethodes, en de diensten die door APIs worden verleend. De API-naslagdocumentatie is ook beschikbaar in de indeling .yaml. U kunt de .yaml downloaden en uploaden naar Postman om de functionaliteit van API's te controleren.

Documentconversie

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

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

PDF omzetten in XDP convert-pdf-to-xdp

De functie PDF omzetten in XDP valt onder het programma Vroege adopter. U kunt vanaf uw officiële e-mailadres naar aem-forms-ea@adobe.com schrijven om deel te nemen aan het programma voor vroege adoptie en toegang tot de functie te vragen.

Zet een PDF-document om in een XDP-bestand. Een PDF-document kan alleen met succes worden geconverteerd naar een XDP-bestand als het PDF-document een XFA-stroom bevat in het woordenboek.

Documentcontrole doc-assurance

De DocAssurance-service bevat de API's voor handtekening 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. De beveiligingsfuncties worden toegepast op het document zelf. Het document blijft gedurende de gehele levenscyclus beveiligd en beheerd. Het document blijft beveiligd buiten de firewall, wanneer het offline wordt gedownload en wanneer het wordt teruggestuurd naar uw organisatie. U kunt de volgende taken uitvoeren met de handtekening-API's:

  • Voeg een zichtbaar handtekeningveld toe aan een PDF-document.
  • Voeg een onzichtbaar 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.

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.
  • Retourneer het beveiligingstype dat op een PDF-document is toegepast.

Zowel handtekening APIs als encryptie APIs zijn Synchrone APIs.

Documenthulpprogramma doc-utility

Met behulp van documenthulpprogramma's met synchrone API's kunt u documenten omzetten tussen PDF- en XDP-bestandsindelingen. Pas gebruiksrechten toe op een document en extraheer de ingeschakelde gebruiksrechten uit een document. Vraag informatie over een document van PDF. Meer informatie over de gebruiksrechten-API's vindt u hieronder:

Gebruiksrechten-API's (extensie Reader)

De mogelijkheid Gebruiksrechten (extensie Reader) valt onder het programma Vroege adopter. U kunt vanaf uw officiële e-mailadres naar aem-forms-ea@adobe.com schrijven om deel te nemen aan het programma voor vroege adoptie en toegang tot de functie te vragen.

Met de functie Gebruiksrechten kan uw organisatie eenvoudig interactieve PDF-documenten delen door de functionaliteit van Adobe Reader uit te breiden met extra gebruiksrechten. De service werkt met Adobe Reader 7.0 of hoger en voegt gebruiksrechten toe aan een PDF-document. Met deze actie activeert u functies die gewoonlijk niet beschikbaar zijn wanneer een PDF-document wordt geopend met Adobe Reader, zoals het toevoegen van opmerkingen aan een document, het invullen van formulieren en het opslaan van het document.

Wanneer voor PDF-documenten de juiste gebruiksrechten zijn toegevoegd, kunnen ontvangers de volgende activiteiten uitvoeren vanuit Adobe Reader:

  • Voltooi PDF-documenten en -formulieren online of offline, zodat ontvangers kopieën lokaal kunnen opslaan voor hun records en de toegevoegde gegevens intact kunnen houden.
  • Sla PDF-documenten op een lokale vaste schijf op om het originele document en eventuele aanvullende opmerkingen, gegevens of bijlagen te behouden.
  • Bestanden en mediaclips aan PDF-documenten koppelen.
  • Onderteken, certificeer en authenticeer PDF-documenten door digitale handtekeningen toe te passen met PKI-technologieën (Public Key Infrastructure) die industriestandaard zijn.
  • Ingevulde of geannoteerde PDF documenten elektronisch verzenden.
  • Gebruik PDF-documenten en -formulieren als intuïtieve ontwikkelvoorkant van interne databases en webservices.
  • Deel PDF-documenten met anderen, zodat revisoren opmerkingen kunnen toevoegen met intuïtieve opmaakgereedschappen. Deze gereedschappen zijn onder andere elektronische notities, stempels, hooglichten en doorhalen van tekst. Dezelfde functies zijn beschikbaar in Acrobat.
  • Ondersteuning voor gestreepte Forms-decodering.

Deze mogelijkheden voor speciale gebruiksrechten worden automatisch geactiveerd wanneer een PDF-document met ingeschakelde rechten wordt geopend in Adobe Reader. Wanneer de gebruiker klaar is met het werken met een document waarvoor rechten zijn ingeschakeld, worden deze functies weer uitgeschakeld in Adobe Reader. Ze blijven uitgeschakeld totdat de gebruiker een ander PDF-document met ingeschakelde rechten ontvangt.

Gebruiksrechten in- of uitschakelen

De verschillende mogelijkheden van gebruiksrechten voor het uitbreiden van de diensten van de Reader van de PDF zijn:

  • Decodering van Streepjescodes: Om streepjescodes binnen het document van de PDF te decoderen.

  • Commentaren: Om off-line op het document van de PDF commentaar te geven.

  • Online Commentaren: Om online op het document van de PDF commentaar te geven.

  • Digitale Handtekening: Om digitale handtekeningen aan een document van de PDF toe te voegen.

  • Dynamische Gebieden van de Vorm: Om vormgebieden aan een document van de PDF toe te voegen.

  • Dynamische Pagina's van de Vorm: Om vormpagina's aan een document van de PDF toe te voegen.

  • Ingebedde Dossiers: Om dossiers binnen een document van PDF in te bedden.

  • de Invoer van de Gegevens van de Vorm: Om vormgegevens in een document van de PDF in te voeren.

  • de Uitvoer van de Gegevens van de Vorm: Om vormgegevens in een document van de PDF in te voeren.

  • Vulling van de Vorm: Om vormgebieden binnen een document van de PDF te vullen.

  • Online Forms: Om tot een Webdienst of gegevensbestand van een document van PDF toegang te hebben.

  • legt Zelfstandig voor: Om formuliergegevens off-line van een document van PDF voor te leggen.

Andere mogelijkheden

  • Bericht: Het bericht dat binnen Adobe Acrobat Reader wordt getoond bij het openen van een document van de PDF met één of meerdere toegepaste gebruiksrechten.
  • Ontgrendel Wachtwoord: Het wachtwoord dat voor het openen van een gecodeerd document van PDF wordt vereist. Dit is doorgaans het wachtwoord voor het openen van het document, maar als het PDF-document extra wordt beveiligd door een wachtwoord voor machtigingen, kan een van beide worden gebruikt om het document te openen.

De API verwijzingsdocumentatieverstrekt gedetailleerde informatie over alle parameters, authentificatiemethodes, en diverse diensten die door APIs worden verleend. De API-naslagdocumentatie is ook beschikbaar in de indeling .yaml. U kunt de .yaml downloaden en uploaden naar Postman om de functionaliteit van de API's te controleren.

Typen communicatie-API's types

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

  • Synchrone APIs zijn geschikt voor op bestelling, lage latentie, en enige scenario's van de verslagdocumentgeneratie. 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.

  • Partij APIs (Asynchrone APIs) is 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 Forms as a Cloud Service gebruikers. U kunt contact opnemen met het verkoopteam van de Adobe of uw Adobe om toegang aan te vragen. 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 Forms as a Cloud Service ontwikkelaars (gebruikers) van uw organisatie om APIs 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 AEM Forms as a Cloud Service Instance.

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

    Mededelingen

    Als u de optie Forms - Digital Enrollment al hebt ingeschakeld, selecteert u de optie Forms - Communications Add-On .

    Addon

  3. Klik op Update.

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

NOTE
Om documentmanipulatie APIs toe te laten en te vormen, voeg de volgende regel aan de configuratie van Dispatchertoe:
# 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