Entwickeln mit Output- und Forms-Diensten in AEM Forms

Verwenden der Output- und Forms-Dienst-API in AEM Forms

In diesem Artikel werden wir uns folgende Themen ansehen:

• Output-Dienst - Dieser Dienst wird in der Regel zum Zusammenführen von XML-Daten mit einer XDP-Vorlage oder PDF-Datei verwendet, um reduzierte PDF-Dateien zu generieren. Weitere Informationen zum Output-Dienst finden Sie unter javadoc.
• FormsService - Dies ist ein sehr vielseitiger Dienst, mit dem Sie Daten aus und in eine PDF-Datei exportieren/importieren können. Weitere Informationen zum Forms-Dienst finden Sie unter javadoc.

Der folgende Codeausschnitt exportiert Daten aus der PDF-Datei

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 Anforderung

Line2 extrahiert saveLocation aus der Anforderung

Zeile 5 enthält FormsService

Zeile 6 exportiert die xmlData aus der PDF-Datei

So testen Sie das Musterpaket auf Ihrem System

Herunterladen und Installieren des Pakets mit dem AEM Package Manager

Nach der Installation des Pakets müssen Sie die folgenden URLs in Zulassungsliste Adobe Granite CSRF Filter.

1. Gehen Sie wie folgt vor, um die oben genannten Pfade in Zulassungsliste zu setzen.
2. Bei configMgr anmelden
3. Adobe Granite CSRF-Filter suchen
4. hinzufügen Sie die folgenden 3 Pfade in den ausgeschlossenen Abschnitten und speichern Sie
5. /content/AEMFormsSamples/mergedata
6. /content/AEMFormsSamples/exportdata
7. /content/AEMFormsSamples/outputservice
8. Suchen Sie nach "Sling Werber filter".
9. Aktivieren Sie das Kontrollkästchen "Leeres Feld zulassen". (Diese Einstellung sollte nur zu Testzwecken verwendet werden.)
   Es gibt verschiedene Möglichkeiten, den Beispielcode zu testen. Am schnellsten und einfachsten ist die Verwendung der Postman-App. Postman ermöglicht es Ihnen, POST an Ihren Server zu senden. Installieren Sie die Postman-App auf Ihrem System.
   App starten und folgende URL eingeben, um die Export-Daten-API zu testen

Vergewissern Sie sich, dass Sie in der Dropdown-Liste "POST"ausgewählt haben
http://localhost:4502/content/AemFormsSamples/exportdata.html
Stellen Sie sicher, dass Sie "Autorisierung"als "Grundlegende Auth"angeben. AEM Server-Benutzernamen und -Kennwort angeben
Navigieren Sie zur Registerkarte "Haupttext"und geben Sie die Anforderungsparameter an, wie in der Abbildung unten dargestellt

Klicken Sie dann auf Senden

Das Paket enthält 3 Beispiele. In den folgenden Absätzen wird erläutert, wann der Output-Dienst oder der Forms-Dienst, die URL des Dienstes, Eingabeparameter, die jeder Dienst erwartet, verwendet werden soll

Daten zusammenführen und Ausgabe reduzieren:

• Verwenden Sie den Output-Dienst zum Zusammenführen von Daten mit dem xdp- oder pdf-Dokument, um reduzierte PDF-Dateien zu erstellen

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

• Anforderungsparameter -

  • xdp_or_pdf_file : Die XDP- oder PDF-Datei, mit der Sie Daten zusammenführen möchten
  • xmlfile: Die XML-Datendatei, die mit der Datei xdp_or_pdf_file zusammengeführt wird
  • saveLocation: Der Speicherort des gerenderten Dokuments im Dateisystem

Daten in PDF-Datei importieren:

• FormsService zum Importieren von Daten in die PDF-Datei verwenden

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

• Anforderungsparameter:

  • pdfile: Die PDF-Datei, mit der Sie Daten zusammenführen möchten
  • xmlfile: Die XML-Datendatei, die mit der PDF-Datei zusammengeführt wird
  • saveLocation: Der Speicherort des gerenderten Dokuments im Dateisystem. Beispiel: c:\\outputsample.pdf.

Daten aus PDF-Datei exportieren

• FormsService zum Exportieren von Daten aus der PDF-Datei verwenden

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

• Anforderungsparameter:

  • pdfile: Die PDF-Datei, aus der Sie Daten exportieren möchten
  • saveLocation: Speicherort der exportierten Daten im Dateisystem

Sie können diese Postman-Sammlung importieren, um die API zu testen