AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
In AEM Forms Workspace werden mehrere Formulartypen nahtlos unterstützt. Dazu gehören:
In diesem Dokument wird die Arbeit dieser Renderer aus der Perspektive der semantischen Anpassung/Komponentenwiederverwendung erläutert, sodass die Kundenanforderungen erfüllt werden, ohne dass die Ausgabedarstellung unterbrochen wird. Obwohl der Arbeitsbereich von AEM Forms beliebige Änderungen der Benutzeroberfläche oder der Bedeutung zulässt, wird empfohlen, die Rendering-Logik von verschiedenen Formulartypen nicht zu ändern. Andernfalls können die Ergebnisse unvorhersehbar sein. Dieses Dokument dient als Anleitung bzw. als Anleitung für das Rendern desselben Formulars mit denselben Workspace-Komponenten in verschiedenen Portalen und nicht zum Ändern der Renderlogik selbst.
PDF-Formulare werden von PdfTaskForm View
gerendert.
Wenn ein XDP-Formular als PDF-Datei gerendert wird, wird vom FormsAugmenter-Service ein FormBridge
-JavaScript™ hinzugefügt. Dieses JavaScript™ (innerhalb des PDF-Formulars) hilft bei Aktionen wie dem Senden und Speichern von Formularen oder dem Offline-Schalten des Formulars.
Im Arbeitsbereich von AEM Forms kommuniziert die Ansicht „PDFTaskForm“ über einen HTML-Zwischen-Code, der unter /lc/libs/ws/libs/ws/pdf.html
gespeichert ist, mit dem FormBridge
-Javascript. Der Fluss ist:
PDFTaskForm-Ansicht - pdf.html
Kommunikation über window.postMessage
/window.attachEvent('message')
Diese Methode ist die Standardkommunikation zwischen einem übergeordneten Frame und einem iframe. Die vorhandenen Ereignis-Listener aus zuvor geöffneten PDF forms werden entfernt, bevor ein neuer hinzugefügt wird. Bei dieser Bereinigung wird auch der Wechsel zwischen Formular-Registerkarte und Verlaufs-Registerkarte in der Aufgabendetailansicht berücksichtigt.
pdf.html – FormBridge
-Javascript innerhalb der gerenderten PDF-Datei
Kommunikation über pdfObject.postMessage
/pdfObject.messageHandler
Diese Methode ist die Standardkommunikation mit einem PDF-JavaScript von einer HTML. Die PdfTaskForm-Ansicht kümmert sich auch um flaches PDF und rendert es einfach.
Es wird nicht empfohlen, den Inhalt der PdfTaskForm-Ansicht "pdf.html"zu ändern.
Neue HTML-Formulare werden von der NewHTMLTaskForm-Ansicht wiedergegeben.
Wenn ein XDP-Formular mithilfe des in CRX bereitgestellten Mobile Forms-Pakets als HTML gerendert wird, werden auch zusätzliche FormBridge
JavaScript auf das Formular verweist, das verschiedene Methoden zum Speichern und Senden von Formulardaten verfügbar macht.
Dieses JavaScript unterscheidet sich von dem oben in PDF forms genannten, erfüllt jedoch einen ähnlichen Zweck.
Es wird nicht empfohlen, den Inhalt der NewHTMLTaskForm-Ansicht zu ändern.
Flex Forms wird von SwfTaskForm gerendert und Guides werden von HtmlTaskForm-Ansichten gerendert.
Im Arbeitsbereich von AEM Forms kommunizieren diese Ansichten mit dem tatsächlichen SWF, aus dem das Flex-Formular bzw. der Form/Guide besteht, über einen Zwischen-SWF-Code, der in /lc/libs/ws/libs/ws/WSNextAdapter.swf
gespeichert ist.
Die Kommunikation erfolgt mithilfe von swfObject.postMessage
/window.flexMessageHandler
.
Dieses Protokoll wird durch WsNextAdapter.swf
definiert. Die vorhandenen flexMessageHandlers
im window-Objekt von zuvor geöffneten SWF-Formularen werden entfernt, bevor ein neuer hinzugefügt wird. Bei dieser Logik wird auch der Wechsel zwischen Formular-Registerkarte und Verlaufs-Registerkarte in der Aufgabendetailansicht berücksichtigt. WsNextAdapter.swf
wird zum Ausführen verschiedener Formularaktionen wie Speichern oder Senden verwendet.
Es wird nicht empfohlen, WSNextAdapter.swf
oder den Inhalt der Ansichten SwfTaskForm bzw. HtmlTaskForm zu ändern.
Drittanbieteranwendungen werden mithilfe der ExtAppTaskForm-Ansicht gerendert.
Kommunikation zwischen Drittanbieterprogrammen und dem Arbeitsbereich von AEM Forms
Der Arbeitsbereich von AEM Forms ruft von window.global.postMessage([Message],[Payload])
ab.
[Nachricht] kann eine in runtimeMap
als SubmitMessage
| CancelMessage
| ErrorMessage
| actionEnabledMessage
angegebene Zeichenfolge sein. Drittanbieterprogramme müssen diese Schnittstelle verwenden, um den Arbeitsbereich von AEM Forms bei Bedarf zu benachrichtigen. Die Verwendung dieser Schnittstelle ist obligatorisch, da der Arbeitsbereich von AEM Forms wissen muss, wann die Aufgabe gesendet wird, damit das Aufgabefenster bereinigt werden kann.
Kommunikation zwischen dem Arbeitsbereich von AEM Forms und Drittanbieterprogrammen
Wenn die direkten Aktionsschaltflächen des Arbeitsbereichs von AEM Forms sichtbar sind, wird window.[External-App-Name].getMessage([Action])
aufgerufen, wobei [Action]
aus routeActionMap
gelesen wird. Das Drittanbieterprogramm muss von dieser Schnittstelle abrufen und dann den Arbeitsbereich von AEM Forms über die API postMessage ()
benachrichtigen.
Beispielsweise kann ein Flex-Programm ExternalInterface.addCallback('getMessage', listener)
definieren, um diese Kommunikation zu unterstützen. Wenn im Drittanbieterprogramm das Senden von Formularen über eigene Schaltflächen behandelt wird, sollten Sie hideDirectActions = true() in the runtimeMap
angeben, und Sie können diesen Listener überspringen. Daher ist dieses Konstrukt optional.
Weitere Informationen zur Integration von Drittanbieteranwendungen mit Correspondence Management finden Sie unter Integrieren von Correspondence Management in AEM Forms Workspace.