Einrichten und Konfigurieren der Referenz-Website We.Gov und WeFinance set-up-and-configure-we-gov-reference-site
Details zum Demopaket demo-package-details
Installationsvoraussetzungen installation-prerequisites
Dieses Paket wurde für AEM Forms 6.4 OSGI-Autor erstellt. Es wurde getestet und wird daher in den folgenden Plattformversionen unterstützt:
Dieses Paket enthält eine Cloud-Konfiguration, die die folgenden Plattformversionen unterstützt:
Überlegungen zur Paketinstallation:
- Installieren Sie das Paket auf einem bereinigten Server, der frei von anderen Demopaketen oder älteren Demopaketversionen ist.
- Installieren Sie das Paket auf einem OSGi-Server, der im Autorenmodus ausgeführt wird.
Was enthält dieses Paket? what-does-this-package-include
Das AEM Forms-We.Gov-Demopaket (we-gov-forms.pkg.all-<version>.zip) wird als Paket geliefert, das mehrere andere Unterpakete und Services enthält. Das Paket enthält die folgenden Module:
-
we-gov-forms.pkg.all-<version>.zip – Vollständiges Demopaket
-
we-gov-forms.ui.apps-<version>.zip : Enthält alle Komponenten, Client-Bibliotheken, Beispielbenutzende, Workflow-Modelle usw.
-
we-gov-forms.core-<version>.jar: Enthält alle OSGi-Services, die Implementierung benutzerdefinierter Workflow-Schritte usw.
-
we-gov-forms.derby<version>.jar: Enthält alle OSGi-Services, Datenbankschemas usw.
-
core.wcm.components.all-2.0.4.zip – Sammlung von WCM-Beispielkomponenten
-
grid-aem.ui.apps-1.0-SNAPSHOT.zip – AEM Sites Grid-Layout-Paket für die Seitenspaltensteuerung in Sites
-
-
we-gov-forms.ui.content-<version>.zip: Enthält alle Inhalte, Seiten, Bilder, Formulare, Assets der interaktiven Kommunikation usw.
-
we-gov-forms.ui.analytics-<version>.zip: Enthält alle Forms-Analysedaten zu We.Gov, die im Repository gespeichert werden sollen.
-
we-gov-forms.config.public-<version>.zip: Enthält alle standardmäßigen Konfigurationsknoten, einschließlich Platzhalter-Cloud-Konfigurationen, damit Probleme mit Formulardatenmodellen und der Dienstbindung vermieden werden.
-
Zu den in diesem Paket enthaltenen Assets gehören:
- AEM-Website-Seiten mit bearbeitbaren Vorlagen
- Adaptive Formulare in AEM Forms
- Interaktive Kommunikation in AEM Forms (Print- und Web-Kanal)
- Aufzuzeichnendes XDP-Dokument in AEM Forms
- MS® Dynamics-Formulardatenmodell in AEM Forms
- Adobe Sign-Integration
- AEM-Workflow-Modell
- AEM Assets-Beispielbilder
- Beispiel-Apache Derby-Datenbank (im Speicher)
- Apache Derby-Datenquelle (zur Verwendung mit dem Formulardatenmodell)
Installation des Demopakets demo-package-installation
Dieser Abschnitt enthält Informationen zur Installation des Demopakets.
Von Software Distribution from-software-distribution
-
Öffnen Sie Software Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.
-
Wählen Sie im Kopfzeilenmenü Adobe Experience Manager aus.
-
Im Abschnitt Filter:
- Wählen Sie Formulare aus der Dropdown-Liste Lösung aus.
- Wählen Sie die Version aus und geben Sie sie für das Paket ein. Sie können auch die Option Downloads durchsuchen verwenden, um die Ergebnisse zu filtern.
-
Wählen Sie den Paketnamen we-gov-forms.pkg.all-<version>.zip, dann EULA-Bedingungen akzeptieren und schließlich Herunterladen aus.
-
Öffnen Sie Package Manager und klicken Sie auf Paket hochladen, um das Paket hochzuladen.
-
Wählen Sie das Paket aus und klicken Sie auf Installieren.
-
Lassen Sie den Abschluss des Installationsprozesses zu.
-
Navigieren Sie zu https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled, um sicherzustellen, dass die Installation erfolgreich war.
Von einer lokalen ZIP-Datei from-a-local-zip-file
-
Laden Sie die Datei we-gov-forms.pkg.all-<version>.zip herunter und suchen Sie sie.
-
Gehen Sie zu https://<aemserver>:<port>/crx/packmgr/index.jsp.
-
Wählen Sie die Option „Paket hochladen“.
-
Verwenden Sie den Datei-Browser, um zur heruntergeladenen ZIP-Datei zu gelangen und sie auszuwählen.
-
Klicken Sie zum Hochladen auf „Öffnen“.
-
Wählen Sie nach dem Hochladen die Option „Installieren“, um das Paket zu installieren.
-
Lassen Sie den Abschluss des Installationsprozesses zu.
-
Gehen Sie zu https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled, um sicherzugehen, dass die Installation erfolgreich war.
Installieren neuer Paketversionen installing-new-package-versions
Um eine neue Paketversion zu installieren, führen Sie die unter 4.1 und 4.2 definierten Schritte aus. Es ist möglich, eine neuere Paketversion zu installieren, während bereits ein älteres Paket installiert ist. Es wird jedoch empfohlen, die ältere Paketversion zuerst zu deinstallieren. Gehen Sie dazu wie folgt vor.
-
Navigieren Sie zu https://<aemserver>:<port>/crx/packmgr/index.jsp
-
Suchen Sie die ältere Datei we-gov-forms.pkg.all-<version>.zip.
-
Wählen Sie die Option „Mehr“.
-
Wählen Sie im Dropdown-Menü die Option „Deinstallieren“.
-
Wählen Sie nach der Bestätigung erneut „Deinstallieren“ und warten Sie, bis der Deinstallationsvorgang abgeschlossen ist.
Konfiguration des Demopakets demo-package-configuration
Dieser Abschnitt enthält Details und Anweisungen zur Konfiguration des Demopakets nach der Bereitstellung vor der Präsentation.
Konfigurieren eines fiktiven Benutzers fictional-user-configuration
-
Navigieren Sie zu https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html
-
Melden Sie sich als Admin an, um die unten aufgeführten Aufgaben durchzuführen.
-
Scrollen Sie nach unten zum Ende der Seite, um alle Benutzergruppen zu laden.
-
Suchen Sie nach „Workflow“.
-
Wählen Sie die Gruppe workflow-users aus und klicken Sie auf „Eigenschaften“.
-
Navigieren Sie zu der Registerkarte „Mitglieder“.
-
Geben Sie wegov in das Feld „Benutzer oder Gruppe wählen“ ein.
-
Wählen Sie im Dropdown-Menü „We.Gov Forms Users“.
-
Klicken Sie in der Menüleiste auf „Speichern und schließen“.
-
Wiederholen Sie die Schritte 2-7, indem Sie nach „Analytics“ suchen, die Gruppe „Analytics-Administratoren“ auswählen und die Gruppe „We.Gov Forms-Benutzer“ als Mitglied hinzufügen.
-
Wiederholen Sie die Schritte 2-7, indem Sie nach „Forms-Benutzer“ suchen, die Gruppe „forms-power-users“ auswählen und die Gruppe „We.Gov Forms-Benutzer“ als Mitglied hinzufügen.
-
Wiederholen Sie die Schritte 2-7, indem Sie nach „Forms-Benutzer“ suchen, die Gruppe „forms-users“ auswählen und diesmal die Gruppe „We.Gov-Benutzer“ als Mitglied hinzufügen.
Konfiguration des E-Mail-Servers email-server-configuration
-
Lesen Sie die Einrichtungsdokumentation Konfigurieren von E-Mail-Benachrichtigungen
-
Melden Sie sich als Administrator an, um diese Aufgabe durchzuführen.
-
Navigieren Sie zu https://<aemserver>:<port>/system/console/configMgr
-
Suchen Sie den Day CQ Mail Service und klicken Sie darauf, um ihn zu konfigurieren.
-
Konfigurieren Sie den Service für die Verbindung mit dem gewünschten SMTP-Server:
- SMTP server hostname (Host-Name des SMTP-Servers): z. B. „smtp.gmail.com“
- Server Port: z. B. „465“ für Gmail mit SSL
- SMTP User: (SMTP-Benuztende) demo@ <companyname> .com
- „Von“-Adresse: aemformsdemo@adobe.com
-
Klicken Sie auf „Speichern“, um die Konfiguration zu speichern.
(Optional) AEM-SSL-Konfiguration aemsslconfig
Dieser Abschnitt enthält Details zur SSL-Konfiguration in der AEM-Instanz, um die Adobe Sign-Cloud-Konfiguration einrichten zu können.
Verweise:
Anmerkungen:
-
Navigieren Sie zu „https://<aemserver>:<port>/aem/inbox“. Darüber können Sie den im obigen Link zur Referenzdokumentation beschriebenen Vorgang abschließen.
-
Das Paket
we-gov-forms.pkg.all-[version].zip
enthält einen Beispiel-SSL-Schlüssel und ein Beispiel-Zertifikat, auf die Sie zugreifen können, indem Sie den Ordnerwe-gov-forms.pkg.all-[version].zip/ssl
extrahieren, der Teil des Pakets ist. -
SSL-Zertifikat und Schlüsseldetails:
- ausgegeben an „CN=localhost“
- Gültigkeit von 10 Jahren
- Kennwortwert von „Kennwort“
-
Der private Schlüssel ist localhostprivate.der.
-
Das Zertifikat ist localhost.crt.
-
Klicken Sie auf Weiter.
-
Der HTTPS-Hostname sollte auf localhost gesetzt werden.
-
Der Port sollte auf einen Port eingestellt sein, den das System offen gelegt hat.
(Optional) Cloud-Konfiguration für Adobe Sign adobe-sign-cloud-configuration
Dieser Abschnitt enthält Details und Anweisungen zur Cloud-Konfiguration mit Adobe Sign.
Verweise:
Cloud-Konfiguration cloud-configuration
-
Überprüfen Sie die Voraussetzungen. Siehe AEM-SSL-Konfiguration für die erforderliche SSL-Konfiguration.
-
Gehen Sie zu:
https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov
note note NOTE Die URL, die für den Zugriff auf den AEM-Server verwendet wird, sollte mit der URL übereinstimmen, die im OAuth-Weiterleitungs-URI von Adobe Sign konfiguriert ist, um Konfigurationsprobleme zu vermeiden (z. B. https://<aemserver>:<port>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html) -
Wählen Sie die Konfiguration „We.gov Adobe Sign“ aus.
-
Klicken Sie auf „Eigenschaften“.
-
Navigieren Sie zur Registerkarte „Einstellungen“.
-
Geben Sie die oAuth-URL ein, z. B.: https://secure.na1.echosign.com/public/oauth
-
Geben Sie die konfigurierte Client-ID und das Client-Geheimnis aus der konfigurierten Adobe Sign-Instanz an.
-
Klicken Sie auf „Mit Adobe Sign verbinden“.
-
Klicken Sie nach erfolgreicher Verbindung auf „Speichern und schließen“, um die Integration abzuschließen.
(Optional) MS® Dynamics-Cloud-Konfiguration ms-dynamics-cloud-configuration
Dieser Abschnitt enthält Details und Anweisungen zur MS® Dynamics-Cloud-Konfiguration.
Verweise:
MS® Dynamics OData-Cloud-Service ms-dynamics-odata-cloud-service
-
Gehen Sie zu:
https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
- Stellen Sie sicher, dass Sie auf den Server zugreifen, indem Sie dieselbe Umleitungs-URL verwenden, die in der Registrierung des MS® Dynamics-Programms konfiguriert wurde.
-
Wählen Sie die Konfiguration „Microsoft® Dynamics OData Cloud-Dienst“.
-
Klicken Sie auf „Eigenschaften“.
-
Navigieren Sie zur Registerkarte „Authentifizierungseinstellungen“.
-
Geben Sie die folgenden Details ein:
-
Dienststamm: zum Beispiel:
https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
-
Authentifizierungstyp: OAuth 2.0
-
Authentifizierungseinstellungen (siehe Cloud-Konfigurationseinstellungen für MS® Dynamics, um diese Informationen zu sammeln):
- Client-ID – auch als Programm-ID bezeichnet
- Client-Geheimnis
- OAuth-URL: beispielsweise https://login.microsoftonline.com/common/oauth2/authorize
- Aktualisieren der Token-URL: beispielsweise https://login.windows.net/common/oauth2/token
- Zugriffstoken-URL: beispielsweise https://login.windows.net/common/oauth2/token
- Genehmigungsumfang – openid
- Authentifizierungs-Header – Autorisierungsanbieter
- Ressource: zum Beispiel
https://msdynamicsserver.api.crm3.dynamics.com
-
Klicken Sie auf „Mit OAuth verbinden“.
-
-
Klicken Sie nach erfolgreicher Authentifizierung auf „Speichern und schließen“, um die Integration abzuschließen.
Cloud-Konfigurationseinstellungen für MS® Dynamics dynamicsconfig
Die in diesem Abschnitt beschriebenen Schritte bieten Hilfe bei der Suche nach der Client-ID, dem Client-Geheimnis und Details aus Ihrer MS® Dynamics Cloud-Instanz.
-
Navigieren Sie zu https://portal.azure.com/ und melden Sie sich an.
-
Wählen Sie im Menü links „Alle Dienste“.
-
Suchen Sie nach „App-Registrierung“ oder navigieren Sie dorthin.
-
Erstellen oder wählen Sie eine bestehende Programmregistrierung aus.
-
Kopieren Sie die Programm-ID zur Verwendung als OAuth-Client-ID in der AEM Cloud-Konfiguration
-
Klicken Sie auf „Einstellungen“ oder „Manifest“, um die Antwort-URLs zu konfigurieren.
- Diese URL muss mit der URL übereinstimmen, die für den Zugriff auf Ihren AEM-Server beim Konfigurieren des OData-Services verwendet wird.
-
Klicken Sie in der Einstellungsansicht auf „Schlüssel“, um einen neuen Schlüssel anzuzeigen (dieser wird in AEM als Client-Geheimnis verwendet).
- Achten Sie darauf, eine Kopie des Schlüssels zu behalten, da Sie ihn später in Azure oder AEM nicht anzeigen können.
-
Um die Ressourcen-URL/Dienststamm-URL zu finden, navigieren Sie zum Dashboard der MS® Dynamics-Instanz.
-
Klicken Sie in der oberen Navigationsleiste auf „Verkauf“ oder Ihren eigenen Instanztyp und dann auf „Einstellungen auswählen“.
-
Klicken Sie unten rechts auf „Anpassungen“ und dann auf „Entwicklungsressourcen“.
-
Dort finden Sie die Dienststamm-URL, z. B.:
*
https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
-
Details zur URL für Aktualisierungs- und Zugriffs-Token finden Sie hier:
https://learn.microsoft.com/de-de/rest/api/datacatalog/authenticate-a-client-app
Testen des Formulardatenmodells (Dynamics) testing-the-form-data-model
Sobald die Cloud-Konfiguration abgeschlossen ist, sollten Sie das Formulardatenmodell testen.
-
Gehen Sie zu
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
-
Wählen Sie „We.gov Microsoft® Dynamics CRM FDM“ und dann „Eigenschaften“ aus.
-
Navigieren Sie zur Registerkarte „Quelle aktualisieren“.
-
Stellen Sie sicher, dass die „kontextsensitive Konfiguration“ auf „/conf/we-gov“ festgelegt ist und dass die konfigurierte Datenquelle „ms-dynamics-odata-cloud-service“ lautet.
-
Bearbeiten Sie das Formulardatenmodell.
-
Testen Sie die Services, um sicherzustellen, dass sie erfolgreich eine Verbindung zur konfigurierten Datenquelle herstellen.
note note NOTE Klicken Sie nach dem Testen der Services auf Abbrechen um sicherzustellen, dass unfreiwillige Änderungen nicht an das Formulardatenmodell weitergegeben werden. note note NOTE Es wurde berichtet, dass ein AEM Server-Neustart erforderlich war, damit die Datenquelle erfolgreich an das FDM gebunden werden konnte. note note NOTE Es wird empfohlen, den Befehl „Strg+C“ zu verwenden, um das SDK neu zu starten. Das Neustarten des AEM SDK mit anderen Methoden, z. B. dem Beenden von Java-Prozessen, kann zu Inkonsistenzen in der AEM-Entwicklungsumgebung führen.
Testen des Formulardatenmodells (Derby) test-fdm-derby
Sobald die Cloud-Konfiguration abgeschlossen ist, können Sie das Formulardatenmodell testen.
-
Navigieren Sie zu https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
-
Wählen Sie die We.gov Enrollment FDM und wählen Sie Eigenschaften.
-
Navigieren Sie zur Registerkarte Quelle aktualisieren.
-
Stellen Sie sicher, dass die Kontextabhängige Konfiguration auf
/conf/we-gov
gesetzt ist und dass die konfigurierte Datenquelle We.Gov Derby DS ist. -
Klicken Sie auf Speichern und schließen.
-
Testen der Services, um sicherzustellen, dass sie sich erfolgreich mit der konfigurierten Datenquelle verbinden
- Um die Verbindung zu testen, wählen Sie HOMEMORTGAGEACCOUNT aus und führen Sie dafür einen Dienstabruf durch. Wenn Sie den Service testen, können Systemadministratoren sehen, wie die Daten abgerufen werden.
Adobe Analytics-Konfiguration (optional) adobe-analytics-configuration
Dieser Abschnitt enthält Details und Anweisungen zur Adobe Analytics Cloud-Konfiguration.
Verweise:
Adobe Analytics-Cloud-Service-Konfiguration adobe-analytics-cloud-service-configuration
Dieses Paket ist für die Verbindung mit Adobe Analytics vorkonfiguriert. Die folgenden Schritte werden bereitgestellt, damit diese Konfiguration aktualisiert werden kann.
-
Navigieren Sie zu https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html
-
Suchen Sie den Abschnitt „Adobe Analytics“ und wählen Sie den Link „Konfigurationen anzeigen“.
-
Wählen Sie die Konfiguration „We.Gov Adobe Analytics (Analytics-Konfiguration)“ aus.
-
Klicken Sie auf die Schaltfläche „Bearbeiten“, um die Adobe Analytics-Konfiguration zu aktualisieren. (Sie müssen den gemeinsamen geheimen Schlüssel angeben.) Klicken Sie auf „Mit Analytics verbinden“, um eine Verbindung herzustellen, und auf „OK“, um den Vorgang abzuschließen.
-
Klicken Sie auf derselben Seite auf „We.Gov Adobe Analytics Framework (Analytics Framework)“, wenn Sie die Framework-Konfigurationen aktualisieren möchten (siehe Aktivieren von AEM-Authoring, um das Authoring zu aktivieren).
Adobe Analytics – Suchen von Benutzeranmeldeinformationen analytics-locating-user-credentials
Um die Benutzeranmeldeinformationen für ein Adobe Analytics-Konto zu finden, müssen Sie als Kontoadmin die folgenden Aufgaben ausführen.
- Navigieren Sie zum Adobe Experience Cloud-Portal.
- Melden Sie sich mit Ihren Administrator-Anmeldeinformationen an.
- Wählen Sie im Haupt-Dashboard das Adobe Analytics-Symbol aus.
- Navigieren Sie zur Registerkarte „Admin“ und wählen Sie das Element „User Management (Legacy)“ aus.
- Wählen Sie die Registerkarte Benutzer aus.
- Wählen Sie den gewünschten Benutzer aus der Liste der Benutzer aus.
- Scrollen Sie nach unten auf der Seite, und die Authentifizierungsinformationen des Benutzers werden unten auf der Seite angezeigt.
- Der Benutzername und die Informationen zum gemeinsamen geheimen Schlüssel werden rechts im Berechtigungsfeld angezeigt.
- Der Benutzername enthält einen Doppelpunkt im Namen. Alles, was links vom Doppelpunkt steht, gehört zum Benutzernamen. Alles, was rechts vom Doppelpunkt steht, gehört zum Firmennamen.
- Im Folgenden finden Sie ein Beispiel dafür: Benutzername : Firmenname
Einrichten der Benutzerauthentifizierung in Adobe Analytics setup-user-authentication
Administratoren können Benutzern AEM Analytics-Berechtigungen erteilen, indem sie die folgenden Aktionen ausführen.
-
Navigieren Sie zur Adobe Admin Console.
-
Klicken Sie auf die Analytics-Instanz, die in der Admin Console angezeigt wird.
- Diese befindet sich auf der Hauptseite der Admin-Seite.
-
Wählen Sie den vollständigen Administratorzugriff für Analytics aus.
-
Fügen Sie einen Benutzer zum Profil hinzu.
-
Klicken Sie auf die Registerkarte „Berechtigungen“, sobald die Benutzer-ID dem Profil zugeordnet wurde.
-
Stellen Sie sicher, dass alle Berechtigungen dem Profil zugeordnet sind.
-
Nach Zuweisung der Berechtigungen kann es einige Stunden dauern, bis eine Benutzeranmeldung möglich ist.
Adobe Analytics-Berichte adobe-analytics-reporting
Anzeigen von Adobe Analytics Sites-Berichten view-adobe-analytics-sites-reporting
we-gov-forms.ui.analytics-<version>.zip
installiert ist. Für AEM Sites-Daten ist jedoch eine aktive Cloud-Konfiguration erforderlich.-
Navigieren Sie zu https://<aemserver>:<port>/sites.html/content
-
Wählen Sie die „AEM Forms We.Gov-Site“ aus, um die Seiten der Site anzuzeigen.
-
Wählen Sie eine der Seiten der Site aus (z. B. die Startseite) und klicken Sie auf „Analysen und Empfehlungen“.
-
Auf dieser Seite werden abgerufene Informationen aus Adobe Analytics angezeigt, die sich auf die AEM Sites-Seite beziehen. (HINWEIS: Diese Informationen werden regelmäßig von Adobe Analytics aktualisiert und nicht in Echtzeit angezeigt.)
-
Zurück auf der Seitenansichtsseite (aufgerufen in Schritt 3) können Sie die Seitenansichtsinformationen auch anzeigen, indem Sie die Anzeigeeinstellung ändern und Elemente in der „Listenansicht“ anzeigen.
-
Suchen Sie das Dropdown-Menü „Ansicht“ und wählen Sie „Listenansicht“ aus.
-
Wählen Sie im gleichen Menü „Ansichtseinstellung“ aus und wählen Sie die Spalten aus, die Sie anzeigen möchten, aus dem Abschnitt „Analysen“.
-
Klicken Sie auf „Aktualisieren“, um die neuen Spalten verfügbar zu machen.
Anzeigen von Adobe Analytics-Formularberichten view-adobe-analytics-forms-reporting
we-gov-forms.ui.analytics-<version>.zip
installiert ist, für AEM Sites-Daten ist jedoch eine aktive Cloud-Konfiguration erforderlich.-
Gehen Sie zu
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
-
Wählen Sie das adaptive Formular „Registrierungsantrag für Gesundheitsleistungen“ aus und dann die Option „Analytics-Bericht“.
-
Warten Sie, bis die Seite geladen wurde, und zeigen Sie die Daten des Analytics-Berichts an.
Aktivierung der automatisierten Konfiguration von Adobe-Formularen automated-forms-enablement
Um AEM Forms mit dem Konvertierungs-Tool von Adobe Forms zu installieren und zu konfigurieren, müssen Benutzende über Folgendes verfügen.
-
Zugriff auf Adobe Developer.
-
Berechtigung zum Erstellen einer Integration mit dem Adobe Forms-Konvertierungs-Service.
-
Neuestes Service Pack von Adobe AEM 6.5, das als Autor ausgeführt wird.
Überprüfen Sie Folgendes, bevor Sie weitere Anweisungen lesen:
Erstellen einer IMS-Konfiguration, Teil 1 creating-ims-config
Damit der Service ordnungsgemäß mit dem Konvertierungs-Tool für Formulare kommunizieren kann, müssen Benutzende den Identity Management-System(IMS)-Dienst konfigurieren, damit sie sich bei Adobe I/O registrieren können.
-
Navigieren Sie zu https://<aemserver>:<port> und klicken Sie links oben auf „Adobe Experience Manager“ > „Tools“ > „Sicherheit“ > „Adobe IMS-Konfiguration“.
-
Klicken Sie auf „Erstellen“.
-
Führen Sie die Aktionen im folgenden Bild aus.
-
Stellen Sie sicher, dass Sie das Zertifikat herunterladen.
-
Fahren Sie nicht mit dem Rest der Konfiguration fort, sondern lesen Sie den Abschnitt Erstellen der Integration in Adobe I/O
Erstellen der Integration in Adobe I/O create-integration-adobeio
Vergewissern Sie sich, dass Sie die Möglichkeit haben, eine Integration in Ihrer Adobe-Domain zu erstellen. Wenn nicht, wenden Sie sich dafür an Ihr Systemadministrations-Team.
-
Navigieren Sie zu Adobe Developer Console.
-
Klicken Sie auf Integration erstellen.
-
Wählen Sie „Auf eine API zugreifen“ aus.
-
Vergewissern Sie sich, dass Sie sich in der richtigen Gruppe befinden (Dropdown-Liste oben rechts).
-
Wählen Sie im Bereich „Experience Cloud“ das Forms-Konvertierungs-Tool aus.
-
Klicken Sie auf Weiter.
-
Geben Sie den Namen und die Beschreibung Ihrer Integration ein.
-
Durch Verwendung des öffentlichen Schlüssels aus Abschnitt 2.1 wird dieser in die Integration des Schlüssels eingefügt.
-
Wählen Sie ein Profil für Ihre automatische Formularkonvertierung aus.
Erstellen der IMS-Konfiguration, Teil 2 create-ims-config-part-next
Nachdem Sie eine Integration erstellt haben, können Sie die Installation der IMS-Konfiguration abschließen.
-
Klicken Sie in Adobe I/O auf Ihre Integration, um die Verbindungsdetails anzuzeigen.
-
Navigieren Sie in AEM zu Ihrer IMS-Konfiguration („Tools“ > „Sicherheit“ > „IMS“)
-
Klicken Sie im Bildschirm „IMS-Konfiguration“ auf „Weiter“.
-
Geben Sie den Autorisierungs-Server ein (im Screenshot angezeigter Wert).
-
Geben Sie den API-Schlüssel ein.
-
Geben Sie das Client-Geheimnis ein (Sie müssen in der Integration in Adobe I/O auf die Option zum Offenlegen klicken, damit es angezeigt wird).
-
Klicken Sie in Adobe I/O auf die Registerkarte „JWT“, um die JWT-Payload abzurufen und sie in die Payload der IMS-Konfiguration einzufügen.
-
Klicken Sie nach der Erstellung auf die IMS-Konfiguration und wählen Sie „Konsistenzprüfung“ aus. Die Benutzenden sollten das folgende Ergebnis sehen.
Konfigurieren der Cloud-Konfiguration (We.Gov AFC Production) configure-cloud-configuration
Sobald die IMS-Konfiguration abgeschlossen ist, können Sie die Cloud-Konfiguration in AEM überprüfen. Wenn die Konfiguration nicht vorhanden ist, führen Sie die folgenden Schritte aus, um die Cloud-Konfiguration in AEM zu erstellen:
-
Öffnen Sie den Browser und navigieren Sie zur System-URL https://<domain_name>:<system_port>
-
Klicken Sie oben links im Bildschirm auf „Adobe Experience Manager“ > „Tools“ > „Cloud Services“ > „Konfiguration der automatisierten Formularkonvertierung“.
-
Wählen Sie den Konfigurationsordner aus, in dem die Konfiguration abgelegt werden soll.
-
Klicken Sie auf „Erstellen“.
-
Geben Sie die Informationen im folgenden Screenshot ein.
-
Geben Sie der Konfiguration einen Titel und einen Namen.
-
Die Service-URL für das System ist auf https://aemformsconversion.adobe.io/ festgelegt.
-
Vorlagen-URL /conf/we-gov/settings/wcm/templates/we-gov-flamingo-template.
-
Design-URL: /content/dam/formsanddocuments-themes/adobe-gov-forms-themes/we-gov-theme
-
Klicken Sie auf Weiter.
-
Für diese Konfiguration haben wir die beiden Kontrollkästchenwerte leer gelassen.
- Weitere Informationen zu diesen Optionen finden Sie unter Konfigurieren von Cloud Service.
Konfigurieren der Cloud-Konfiguration (We.Finance AFC Production) configure-cloud-configuration-wefinance
Sobald die IMS-Konfiguration abgeschlossen ist, können wir mit der Erstellung der Cloud-Konfiguration in AEM fortfahren.
-
Öffnen Sie den Browser und navigieren Sie zur System-URL https://<domain_name>:<system_port>
-
Klicken Sie oben links im Bildschirm auf „Adobe Experience Manager“ > „Tools“ > „Cloud Services“ > „Konfiguration der automatisierten Formularkonvertierung“.
-
Wählen Sie den Konfigurationsordner aus, in dem die Konfiguration abgelegt werden soll.
-
Klicken Sie auf „Erstellen“.
-
Geben Sie die Informationen im folgenden Screenshot ein.
-
Geben Sie der Konfiguration einen Titel und einen Namen.
-
Die Service-URL für das System ist auf https://aemformsconversion.adobe.io/ festgelegt.
-
Vorlagen-URL: /conf/we-finance/settings/wcm/templates/we-finance-adaptive-form
-
Design-URL: /content/dam/formsanddocuments-themes/adobe-finance-forms-themes/we-finance-theme
-
Klicken Sie auf Weiter.
-
Für diese Konfiguration haben wir die beiden Kontrollkästchenwerte leer gelassen.
- Weitere Informationen zu diesen Optionen finden Sie unter Konfigurieren des Cloud-Services.
Testen der Formularkonvertierung (We.Gov-Registrierungsprogramm) test-forms-conversion
Nach dem Einrichten der Konfiguration können Benutzer sie testen, indem sie ein PDF-Dokument hochladen.
-
Navigieren Sie zum AEM-System https://<domain_name>:<system_port>
-
Klicken Sie auf „Formulare“ > „Formulare und Dokumente“ > „AEM Forms We.gov-Formulare“ > „AFC“.
-
Wählen Sie die PDF der We.Gov Enrollment Application aus.
-
Klicken Sie oben rechts auf die Option zum Starten der automatischen Konvertierung.
-
Benutzer sollten die Option wie unten dargestellt sehen können.
-
Nachdem die Schaltfläche ausgewählt wurde, werden den Benutzern die folgenden Optionen angezeigt
- Stellen Sie sicher, dass die Benutzenden die Konfiguration We.Gov AFC Production auswählen.
-
Wählen Sie „Konvertierung starten“ aus, nachdem Sie alle gewünschten Optionen konfiguriert haben.
-
Wenn der Konvertierungsprozess beginnt, sollten die Benutzer den folgenden Bildschirm sehen:
-
Wenn die Konvertierung abgeschlossen ist, sehen die Benutzer den folgenden Bildschirm:
Klicken Sie auf den Ordner Ausgabe, um das generierte adaptive Formular anzuzeigen.
Bekannte Probleme und Hinweise known-issues-notes
Zum Service der automatischen Formularkonvertierung gehören bestimmte Best Practices, bekannte komplexe Muster und bekannte Probleme. Lesen Sie diese zuerst, bevor Sie mit der Verwendung des Services der automatischen Formularkonvertierung von AEM Forms beginnen.
-
Erzeugen Sie das Formular mit der Option „Generieren Adaptiver Formulare ohne Datenbindung“, wenn Sie das Formular nach der Konvertierung an einen FDM binden möchten.
-
Stellen Sie sicher, dass im Vorlagenordner die Berechtigung „jcr:read“ für alle aktiviert ist. Andernfalls können die Benutzenden des Services die Vorlage nicht aus dem Repository lesen, und die Konvertierung schlägt fehl.
Anpassung von Demopaketen demo-package-customizations
Dieser Abschnitt enthält Anweisungen zur Anpassung der Demo.
Anpassung von Vorlagen templates-customization
Bearbeitbare Vorlagen sind am folgenden Ort zu finden:
https://<aemserver>:<port>/libs/wcm/core/content/sites/templates.html/conf/we-gov
Zu diesen Vorlagen gehören die Vorlagen für AEM-Sites, adaptive Formulare und interaktive Kommunikation, die mit Komponenten erstellt und zusammengestellt wurden, welche unter folgender Adresse zu finden sind:
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/components
Stilsystem customizetemplates
Auf dieser Site finden Sie auch Client-Bibliotheken, von denen eine Bootstrap 4 importiert (https://getbootstrap.com/). Diese Client-Bibliothek ist verfügbar unter
https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
Die bearbeitbaren Vorlagen, die in diesem Paket enthalten sind, sind auch mit Vorlagen-/Seitenrichtlinien vorkonfiguriert, die die Bootstrap 4 CSS-Klassen für Paginierung, Stil usw. verwenden. Nicht alle Klassen wurden zu den Vorlagenrichtlinien hinzugefügt, aber jede Klasse, die von Bootstrap 4 unterstützt wird, kann zu den Richtlinien hinzugefügt werden. Eine Liste der verfügbaren Klassen finden Sie auf der Einführungsseite:
https://getbootstrap.com/docs/4.1/getting-started/introduction/
Die in diesem Paket enthaltenen Vorlagen unterstützen auch das Stilsystem:
Vorlagen-Logos template-logos
Projekt-DAM-Assets umfassen auch Logos und Bilder zu We.Gov. Diese Assets sind verfügbar unter:
https://<aemserver>:<port>/assets.html/content/dam/we-gov
Bei der Bearbeitung der Seiten- und Formularvorlagen können Sie Markenlogos aktualisieren, indem Sie die Komponenten „Navigation“ und „Fußzeile“ bearbeiten. Diese Komponenten bieten ein konfigurierbares Dialogfeld für Marken und Logos, mit dem Logos aktualisiert werden können:
Weitere Informationen hierzu finden Sie unter „Bearbeiten von Seiteninhalten“:
Anpassung von Sites-Seiten sites-pages-customization
Alle Sites-Seiten sind verfügbar unter: https://<aemserver>:<port>/sites.html/content/we-gov
Auf diesen Sites-Seiten wird auch das AEM Grid-Paket verwendet, um das Layout einiger Komponenten zu steuern.
Stilsystem style-system
Die in diesem Paket enthaltenen Seiten unterstützen auch das Stilsystem:
Weitere Informationen zu unterstützten Stilen finden Sie unter Stilsystem für die Vorlagenanpassung.
Anpassung adaptiver Formulare adaptive-forms-customization
Alle adaptiven Formulare sind verfügbar unter:
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
Diese Formulare können an bestimmte Anwendungsfälle angepasst werden. Beachten Sie, dass bestimmte Felder und die Übermittlungslogik nicht geändert werden sollten, um sicherzustellen, dass das Formular weiterhin ordnungsgemäß funktioniert. Hierzu gehört Folgendes:
Anmeldeformular für Gesundheitsleistungen:
- contact_id – Verstecktes Feld, das zum Empfangen der MS® Dynamics-Kontakt-ID während der Übermittlung verwendet wird
- Senden – Die Logik der Senden-Schaltfläche muss angepasst werden, um Rückrufe zu unterstützen. Die Anpassung ist dokumentiert, aber es war ein umfangreiches Skript erforderlich, um das Formular zu übermitteln und dabei sowohl einen POST- als auch einen GET-Vorgang über das Forms-Datenmodell an MS® Dynamics durchzuführen.
- Das Ereignis „Stammbedienfeld – Initialisierung“ wird verwendet, um eine MS® Dynamics-Schaltfläche zum AEM-Posteingang hinzuzufügen, und zwar auf die am wenigsten aufdringliche Weise, da alle Granite-UI-Komponenten vom AEM-Posteingang nicht veränderbar sind.
Adaptives Formular-Styling adaptive-form-styling
Adaptive Formulare können auch mit dem Stil-Editor oder dem Design-Editor formatiert werden:
Anpassung des Workflows workflow-customization
Das adaptive Anmeldungsformular sendet zur Verarbeitung an einen OSGi-Workflow. Diesen Workflow finden Sie unter https://<aemserver>:<port>/conf/we-gov/settings/models/we-gov-process.html.
Aufgrund bestimmter Einschränkungen enthält dieser Workflow mehrere Skripte und benutzerdefinierte OSGi-Workflow-Prozessschritte. Diese Workflow-Schritte wurden als generische Schritte und nicht mit Konfigurationsdialogen erstellt. Derzeit beruht die Konfiguration der Workflow-Schritte auf Prozessargumenten.
Der gesamte Java-Code der Workflow-Schritte ist im Paket we-gov-forms.core-<version>.jar enthalten.
Überlegungen zur Demo und bekannte Probleme demo-considerations-and-known-issues
Dieser Abschnitt enthält Informationen zu Demo-Funktionen und Design-Entscheidungen, die während des Demonstrationsprozesses möglicherweise besondere Überlegungen erfordern.
Überlegungen zur Demo demo-considerations
- Stellen Sie gemäß AGRS-159 sicher, dass der Name (Vor-, Mittel- und Nachname) des Kontakts, der im adaptiven Anmeldungsformular verwendet wird, einzigartig ist.
- Das adaptive Anmeldungsformular sendet die Adobe Sign-E-Mail an die E-Mail-Adresse, die im E-Mail-Feld des Formulars angegeben ist. Diese E-Mail-Adresse darf nicht dieselbe E-Mail-Adresse sein wie die E-Mail, die zum Konfigurieren der Adobe Sign-Cloud-Konfiguration verwendet wurde.
Bekannte Probleme known-issues
- (AGRS-120) Die Site-Navigationskomponente unterstützt derzeit keine verschachtelten untergeordneten Seiten, die mehr als zwei Ebenen tief sind.
- (AGRS-159) Der aktuelle MS® Dynamics-FDM muss zwei Vorgänge ausführen, um zunächst die Daten des adaptiven Anmeldungsformulars per POST an Dynamics zu senden und dann den Benutzerdatensatz abzurufen, um die Kontakt-ID zu erhalten. Im aktuellen Zustand schlägt das Abrufen der Kontakt-ID fehl, wenn in Dynamics mehr als zwei Benutzende mit dem gleichen Namen vorhanden sind, wodurch die Übermittlung des adaptiven Anmeldungsformulars nicht zugelassen wird.
Konfigurieren von Zugänglichkeitstests configure-accessibility-testing
Aktivieren des Chrome-Add-ons für Zugänglichkeitstests enable-chrome-add-on
Um Zugänglichkeitstests durchzuführen, installieren Sie das Chrome-Plug-in, das hier zu finden ist: https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en
.
Laden Sie nach der Installation die Seite, die Sie im Chrome-Browser testen möchten. (Hinweis: Wenn mehrere Registerkarten geöffnet sind, kann sich dies auf Ihr Scoring auswirken. Es empfiehlt sich deswegen, nur eine Registerkarte zu öffnen.) Sobald die Seite geladen ist, klicken Sie mit der rechten Maustaste auf die Seite und wählen Sie die Registerkarte Audits. Dort können Entwickelnde die Art der Prüfung auswählen, die vom Zugänglichkeits-Plug-in durchgeführt werden soll. Nachdem alle gewünschten Optionen ausgewählt sind, können die Benutzenden auf die Schaltfläche „Bericht erstellen“ klicken. Hierdurch wird ein PDF-Dokument generiert, das die allgemeine Zugänglichkeitsbewertung zeigt und verwendet werden kann, um die Zugänglichkeitsbewertung insgesamt zu verbessern.
Nachdem der Bericht ausgeführt wurde, sollten die Benutzenden Folgendes sehen:
Bei der Zahl, die vor den Anwendern angezeigt wird, handelt es sich um die allgemeine Zugänglichkeitsbewertung, die sie erhalten haben. Im Anschluss an die Bewertung wird auch beschrieben, wie diese berechnet wurde.
Wenn Benutzende diese exportieren möchten, können sie auf die drei Schaltflächen auf der rechten Seite des Bildschirms klicken und aus den weiteren Optionen wählen, die das Plug-in bietet.
Ultramarine-Design ultramarine-theme
Das öffentlich verfügbare Ultramarine-Design, das von Adobe gepflegt wird, ist in diewe-gov-forms.pkg.all-<version>.zip
installierbare ZIP-Datei integriert. Sobald dieses Paket mit CRX installiert ist.
Package Manager, Anwender können auf das Ultramarine-Design in AEM Forms zugreifen, indem sie zu Forms > Designs > Referenz-Designs > Ultramarine-zugänglich navigieren.
Konfigurationsoptionen configuration-options
Anwender haben die Möglichkeit, verschiedene Workflow-Service-Optionen zu konfigurieren, darunter die folgenden:
- Microsoft® Dynamics-Eintrag
- Adobe Sign
- AEM Custom Communication Management
- Adobe Analytics
Um sie so zu konfigurieren, dass sie im Workflow aktiviert werden, müssen Benutzende die folgenden Aufgaben ausführen.
-
Gehen Sie zu https://'[server]:[port]'/system/console/configMgr.
-
Suchen Sie die WeGov-Konfigurationen.
-
Öffnen Sie die Service-Definition und aktivieren Sie den Aufruf der ausgewählten Services innerhalb des Workflows.
note note NOTE Auch wenn Benutzende den Dienst auf der Seite des Konfigurations-Managers aktivieren, müssen sie dennoch eine Dienstkonfiguration einrichten, um mit den angefragten externen Diensten kommunizieren zu können. -
Klicken Sie abschließend auf die Speichern-Schaltfläche, um die Einstellungen zu speichern.
Nächste Schritte next-steps
Jetzt können Sie die WeGov-Referenz-Website erkunden. Weitere Informationen zum Workflow und den Schritten der WeGov-Referenz-Website finden Sie unter Schrittweise Anleitung zur WeGov-Referenz-Website.