Entwickeln mit dem Ausgabe- und dem Forms-Service in AEM Forms developing-with-output-and-forms-services-in-aem-forms
Erfahren Sie mehr über die Entwicklung mit der Ausgabe- und Forms Service-API in AEM Forms.
In diesem Artikel werden wir uns Folgendes ansehen:
- Ausgabe-Service: In der Regel wird dieser Service verwendet, um XML-Daten mit einer XDP-Vorlage oder PDF zusammenzuführen, um eine reduzierte PDF-Datei zu generieren.
- Forms-Service: Dies ist ein sehr vielseitiger Service, mit dem Sie XDP als PDF rendern und Daten aus einer PDF-Datei exportieren sowie in eine PDF-Datei importieren können.
Mit dem folgenden Codesnippet werden Daten aus der PDF-Datei exportiert:
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);
Zeile 1 extrahiert die PDF-Datei aus der Anfrage.
Zeile 2 extrahiert den Speicherort aus der Anfrage.
Zeile 5 ruft den Forms-Dienst ab.
Zeile 6 exportiert die XML-Daten aus der PDF-Datei.
So testen Sie das Beispielpaket auf Ihrem System:
Laden Sie das Paket herunter und installieren Sie es mit Package Manager.
Nachdem Sie das Paket installiert haben, müssen Sie die folgenden URLs unter „Adobe Granite CSRF Filter“ auf die Zulassungsliste setzen.
- Führen Sie die folgenden Schritte aus, um die oben genannten Pfade auf die Zulassungsliste zu setzen.
- Melden Sie sich bei configMgr an.
- Suchen Sie nach „Adobe Granite CSRF Filter“.
- Fügen Sie die drei folgenden Pfade in den ausgeschlossenen Abschnitten hinzu und speichern Sie
- /content/AemFormsSamples/mergedata
- /content/AemFormsSamples/exportdata
- /content/AemFormsSamples/outputservice
- /content/AemFormsSamples/renderxdp
- Suchen Sie nach „Sling Referrer filter“.
- Aktivieren Sie das Kontrollkästchen „Leere zulassen“. (Diese Einstellung sollte nur zu Testzwecken verwendet werden.)
Testen der Beispiele
Es gibt verschiedene Möglichkeiten, den Beispiel-Code zu testen. Am schnellsten und einfachsten lässt sich hier die Postman-App verwenden. Mit Postman können Sie POST-Anfragen an Ihren Server richten.
- Installieren Sie die Postman-App auf Ihrem System.
- Starten Sie die App und geben Sie die entsprechende URL ein.
- Vergewissern Sie sich, dass Sie in der Dropdown-Liste „POST“ ausgewählt haben.
- Stellen Sie sicher, dass Sie „Autorisierung“ als „Standard-Authentifizierung“ angeben. Geben Sie den Benutzernamen und das Kennwort des AEM-Servers ein.
- Geben Sie die Anfrageparameter auf der Registerkarte „Text“ ein.
- Klicken Sie auf die Schaltfläche „Senden“.
Das Paket enthält vier Beispiele. In den folgenden Absätzen wird erläutert, wann der Ausgabe-Service oder der Forms-Service verwendet werden soll. Außerdem werden die URL des Service und die Eingabeparameter angegeben, die von jedem Service erwartet werden.
Verwenden des Ausgabe-Service zum Zusammenführen von Daten mit der XDP-Vorlage
-
Verwenden des Output-Dienstes zum Zusammenführen von Daten mit dem XDP- oder PDF-Dokument, um eine reduzierte PDF-Datei zu generieren
-
POST-URL: http://localhost:4502/content/AemFormsSamples/outputservice.html
-
Anfrageparameter:
- xdp_or_pdf_file: XDP- oder PDF-Datei, mit der Sie Daten zusammenführen möchten.
- xmlfile: XML-Datendatei, die mit „xdp_or_pdf_file“ zusammengeführt wird.
- saveLocation: Speicherort für das gerenderte Dokument auf Ihrem Dateisystem. Beispiel: „c:\documents\sample.pdf“.
Verwenden der FormsService-API
Importieren von Daten
-
Verwenden des Forms-Service „importData“ zum Importieren von Daten in eine PDF-Datei
-
POST-URL: http://localhost:4502/content/AemFormsSamples/mergedata.html
-
Anfrageparameter:
- pdfile: PDF-Datei, mit der Sie Daten zusammenführen möchten.
- xmlfile: XML-Datendatei, die mit der PDF-Datei zusammengeführt wird.
- saveLocation: Speicherort für das gerenderte Dokument auf Ihrem Dateisystem. Beispiel
c:\\outputsample.pdf.
Exportieren von Daten
-
Verwenden der Forms-Service-API „exportData“ zum Exportieren von Daten aus einer PDF-Datei
-
POST-URL: http://localhost:4502/content/AemFormsSamples/exportdata.html
-
Anfrageparameter:
- pdfile: PDF-Datei, aus der Sie Daten exportieren möchten.
- saveLocation: Speicherort für die exportierten Daten auf Ihrem Dateisystem. Beispiel: „c:\documents\exporting_data.xml“.
Rendern von XDP
- Rendern einer XDP-Vorlage als statische/dynamische PDF
- Verwenden Sie die Forms-Service-API „renderPDFForm“, um die XDP-Vorlage als PDF zu rendern.
- POST-URL: http://localhost:4502/content/AemFormsSamples/renderxdp?xdpName=f1040.xdp
- Anfrageparameter:
- xdpName: Name der XDP-Datei, die als PDF gerendert werden soll.
Sie könnten diese Postman-Sammlung importieren, um die API zu testen.