Synchrone verwerking gebruiken sync-processing-introduction
Forms as a Cloud Service - Met communicatie-API's kunt u merkgeoriënteerde en gepersonaliseerde communicatie maken, samenstellen en leveren, zoals zakelijke correspondentie, documenten, instructies, aanvraagverwerkingsbrieven, aankondigingen van voordelen, claimverwerkingsbrieven, maandelijkse facturen en welkomstkits. Met communicatie-API's kunt u een sjabloon (XFA of PDF) combineren met klantgegevens om documenten te genereren in de indelingen PDF, PS, PCL, DPL, IPL en ZPL.
Overweeg een scenario waar u één of meerdere malplaatjes en veelvoudige verslagen van de gegevens van XML voor elke malplaatje hebt. U kunt communicatie-API's gebruiken om een afdrukdocument te genereren voor elke record. Het resultaat is een niet-interactief PDF-document. In een niet-interactief PDF-document kunnen gebruikers geen gegevens invoeren in de bijbehorende velden.
Forms as a Cloud Service - Communications biedt op aanvraag API's (asynchrone API's) voor het genereren van geplande documenten:
-
Synchrone API's zijn geschikt voor gebruik op aanvraag, met lage latentie en het genereren van documenten met één record. Deze API's zijn geschikter voor gebruiksgevallen die zijn gebaseerd op handelingen van gebruikers. Het genereren van een document bijvoorbeeld nadat een gebruiker een formulier heeft ingevuld.
-
Batch-API's (Asynchrone API's) zijn geschikt voor geplande toepassingen waarbij meerdere documenten met hoge doorvoer worden gegenereerd. Met deze API's worden documenten batchgewijs gegenereerd. Zo worden telefoonrekeningen, creditcardafschriften en uitkeringsafschriften elke maand gegenereerd.
Synchrone bewerkingen gebruiken batch-operations
Een synchrone bewerking is een proces waarbij documenten lineair worden gegenereerd. Deze API's worden geclassificeerd als API's voor één gebruiker en API's voor meerdere gebruikers:
API's voor één gebruiker
- API's voor het genereren van documenten
- Documentmanipulatie-API's
Verifieer enig-huurder API
API-bewerkingen van één gebruiker ondersteunen twee verificatietypen:
-
Basisauthentificatie: De basisauthentificatie is een eenvoudige authentificatieregeling die in het protocol van HTTP wordt gebouwd. De cliënt verzendt HTTP- verzoeken met de kopbal van de Vergunning die het woord Basis bevat dat door een ruimte en een base64-gecodeerde koordgebruikersbenaming :password wordt gevolgd. Bijvoorbeeld, om als admin/admin toe te staan verzendt de cliënt Basis [ base64-gecodeerde koordgebruikersbenaming ]: [ base64-gecodeerde koordwachtwoord ].
-
op token-gebaseerde authentificatie: Op token-gebaseerde authentificatie gebruikt een toegangstoken (het teken van de authentificatie van de Drager) om verzoeken aan Experience Manager as a Cloud Service te doen. AEM Forms as a Cloud Service biedt API's om het toegangstoken veilig op te halen. Om het teken terug te winnen en te gebruiken om een verzoek voor authentiek te verklaren:
- wint de credentie van Experience Manager as a Cloud Service van Developer Console terug.
- installeer de credentie van Experience Manager as a Cloud Service op uw milieu . (De Server van de Toepassing, de Server van het Web, of andere servers niet-AEM) die worden gevormd om verzoeken naar (maken vraag) de wolkendienst te verzenden.
- produceer een teken JWT en ruilde het met Adobe IMS APIs voor een toegangstoken .
- Voer de Experience Manager API met het toegangstoken als token voor Dragerverificatie uit.
- plaats aangewezen toestemmingen voor de technische rekeningsgebruiker in het milieu van Experience Manager .
note note NOTE Adobe raadt aan tokenverificatie te gebruiken in een productieomgeving. note important IMPORTANT Voor meer informatie, zie OAuth server-aan-server authentificatie en server-aan-server authentificatie JWT .
(Alleen voor API's voor documentgeneratie) Elementen en machtigingen configureren
Voor het gebruik van synchrone API's is het volgende vereist:
- Gebruikers met Experience Manager-beheerdersrechten
- Sjablonen en andere elementen uploaden naar uw Experience Manager Forms Cloud Service-exemplaar
(Alleen voor API's voor documentgeneratie) Sjablonen en andere middelen uploaden naar uw Experience Manager-instantie
Een organisatie heeft doorgaans meerdere sjablonen. Bijvoorbeeld, één malplaatje elk voor creditcardverklaringen, voordelenverklaringen, en claimtoepassingen. Upload dergelijke XDP- en PDF-sjablonen naar uw Experience Manager-exemplaar. Een sjabloon uploaden:
- Open je Experience Manager-exemplaar.
- Ga naar Forms > Forms en Documenten
- Klik op Maken > Map en maak een map. Open de map.
- Klik op Maken > Bestand uploaden en upload de sjablonen.
Een API aanroepen
De API verwijzingsdocumentatie verstrekt gedetailleerde informatie over alle parameters, authentificatiemethodes, en diverse diensten die door APIs worden verleend. De API-naslagdocumentatie biedt ook een API-definitiebestand in de indeling .yaml. U kunt het .yaml dossier downloaden en het uploaden aan Postman om functionaliteit van APIs te controleren.