Ontwikkelen met Output and Forms Services in AEM Forms developing-with-output-and-forms-services-in-aem-forms

Meer informatie over het ontwikkelen met Output en Forms Service API in AEM Forms.

In dit artikel zullen we het volgende bekijken:

  • Uitvoerservice - Deze service wordt doorgaans gebruikt om XML-gegevens samen te voegen met de xdp-sjabloon of pdf om samengevoegde pdf te maken.
  • FormsService - Dit is een zeer veelzijdige service waarmee u xdp kunt renderen als pdf en gegevens kunt exporteren/importeren van en naar een PDF-bestand.

Het volgende codefragment exporteert gegevens uit het PDF-bestand

javax.servlet.http.Part pdfPart = request.getPart("pdffile");
String filePath = request.getParameter("saveLocation");
java.io.InputStream pdfIS = pdfPart.getInputStream();
com.adobe.aemfd.docmanager.Document pdfDocument = new com.adobe.aemfd.docmanager.Document(pdfIS);
com.adobe.fd.forms.api.FormsService formsservice = sling.getService(com.adobe.fd.forms.api.FormsService.class);
com.adobe.aemfd.docmanager.Document xmlDocument = formsservice.exportData(pdfDocument,com.adobe.fd.forms.api.DataFormat.Auto);

Regel 1 haalt pdfile uit het verzoek uit

Line2 haalt saveLocation uit het verzoek uit

Regel 5 krijgt greep van FormsService

Regel 6 voert xmlData uit het Dossier van PDF uit

De monsterverpakking op uw systeem testen

Download en installeer het pakket met AEM pakketbeheer

Nadat u het pakket installeert, zult u volgende URLs in de Filter van de Adobe moeten lijsten van gewenste personen Granite CSRF.

  1. Volg de onderstaande stappen om de hierboven vermelde paden te lijsten van gewenste personen.
  2. Aanmelden bij configMgr
  3. Zoeken naar graniet-CSRF-filter voor Adobe
  4. Voeg de volgende drie paden toe aan de uitgesloten secties en sla deze op
  5. /content/AemFormsSamples/mergedata
  6. /content/AemFormsSamples/exportdata
  7. /content/AemFormsSamples/outputservice
  8. /content/AemFormsSamples/renderxdp
  9. Zoeken naar het filter Verticale verwijzing
  10. Schakel het selectievakje Lege toestaan in. (Deze instelling mag alleen voor testdoeleinden worden gebruikt)

De monsters testen

U kunt de voorbeeldcode op verschillende manieren testen. De snelste en eenvoudigste manier is om Postman-app te gebruiken. Met Postman kunt u POSTEN aanvragen bij uw server.

  • Installeer de Postman-toepassing op uw systeem.
  • Start de app en voer de juiste URL in
  • Controleer of u "POST" hebt geselecteerd in de vervolgkeuzelijst
  • Zorg ervoor dat u "Autorisatie" opgeeft als "Basic Auth". Geef de gebruikersnaam en het wachtwoord voor AEM server op
  • Geef de aanvraagparameters op op het tabblad body
  • Klik op Verzenden

De verpakking bevat 4 monsters. De volgende paragrafen verklaren wanneer om de outputdienst of de Dienst van Forms te gebruiken, de url van de dienst, inputparameters die elke dienst verwacht

OutputService gebruiken om gegevens samen te voegen met xdp-sjabloon

  • Met Uitvoerservice kunt u gegevens samenvoegen met xdp- of pdf-document om samengevoegde pdf te genereren

  • POST-URL: http://localhost:4502/content/AemFormsSamples/outputservice.html

  • Parameters aanvragen -

    • xdp_or_pdf_file : Het xdp- of pdf-bestand waarmee u gegevens wilt samenvoegen
    • xmlfile: Het XML-gegevensbestand dat is samengevoegd met xdp_or_pdf_file
    • saveLocation: De locatie waar het gerenderde document moet worden opgeslagen op uw bestandssysteem. Bijvoorbeeld c:\documents\sample.pdf

FormsService API gebruiken

Gegevens importeren

  • FormsService-importData gebruiken om gegevens te importeren in PDF-bestand

  • POST-URL - http://localhost:4502/content/AemFormsSamples/mergedata.html

  • Parameters aanvragen:

    • pdffile : Het PDF-bestand waarmee u gegevens wilt samenvoegen
    • xmlfile: Het XML-gegevensbestand dat is samengevoegd met het PDF-bestand
    • saveLocation: De locatie waar het gerenderde document moet worden opgeslagen op uw bestandssysteem. Bijvoorbeeld c:\\outputsample.pdf.

Gegevens exporteren

  • FormsService-API voor exportData gebruiken om gegevens uit PDF File te exporteren

  • POST-URL - http://localhost:4502/content/AemFormsSamples/exportdata.html

  • Parameters aanvragen:

    • pdffile : Het PDF-bestand waaruit u gegevens wilt exporteren
    • saveLocation: De locatie waar de geĆ«xporteerde gegevens op uw bestandssysteem moeten worden opgeslagen. Bijvoorbeeld c:\documents\export_data.xml

XDP renderen

  • XDP-sjabloon renderen als statisch/dynamisch pdf
  • FormsService renderPDFForm-API gebruiken om xdp-sjabloon te renderen als PDF
  • POST-URL - http://localhost:4502/content/AemFormsSamples/renderxdp?xdpName=f1040.xdp
  • Request-parameter:
    • xdpName: naam van het xdp-bestand dat moet worden gerenderd als een pdf

U kunt deze postmanverzameling importeren om de API te testen

recommendation-more-help
8de24117-1378-413c-a581-01e660b7163e