Einrichten und Konfigurieren der Referenz-Sites We.Gov und We-Finance set-up-and-configure-we-gov-reference-site
Details zum Demopaket demo-package-details
Voraussetzungen für die Installation 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.
Aus 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 den Paket-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 die neue Paketversion zu installieren, führen Sie die in 4.1 und 4.2 definierten Schritte aus. Sie können eine neuere Paketversion installieren, auch wenn bereits eine ältere Version installiert ist. Adobe empfiehlt jedoch, zuerst die ältere Paketversion 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 aus.
-
Wählen Sie in der Dropdown-Liste die Option Deinstallieren aus.
-
Wählen Sie nach der Bestätigung 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 zur Registerkarte Mitglieder .
-
Geben Sie Feld „Benutzer oder Gruppe"
wegovein. -
Wählen Sie aus der Dropdown-Liste We.Gov Forms Users.
-
Klicken Sie 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 Users 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 Users als Mitglied hinzufügen.
-
Wiederholen Sie die Schritte 2-7, indem Sie nach forms-users suchen, die Gruppe forms-users auswählen und diesmal die Gruppe We.Gov Users 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].zipenthä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/sslextrahieren, 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.
-
Setzen Sie den HTTPS-Hostnamen auf localhost.
-
Setzen Sie Port auf einen Port, 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 Adobe Sign Cloud-Konfiguration.
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 Um Konfigurationsprobleme zu vermeiden, stellen Sie sicher, dass die URL, die für den Zugriff auf den AEM-Server verwendet wird, mit der URL übereinstimmt, die im OAuth-Umleitungs-URI von Adobe Sign konfiguriert ist.
Beispiel: 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. Beispiel:
https://secure.na1.echosign.com/public/oauth(nur zu Veranschaulichungszwecken). -
Geben Sie die konfigurierte Client-ID und das Client-Geheimnis aus der konfigurierten Adobe Sign-Instanz an.
-
Klicken Sie 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 Verbindung zu OAuth herstellen.
-
-
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 die Option Alle Services.
-
Suchen Sie nach (App-Registrierung oder navigieren Sie.
-
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 (der in AEM als Client-Geheimnis verwendet wird).
- Achten Sie darauf, eine Kopie des Schlüssels zu behalten, da Sie ihn später nicht mehr in Azure oder AEM 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 Entwicklerressourcen.
-
Suchen Sie die Service-Stamm-URL. Beispiel:
https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/ -
Details zur URL für Aktualisierungs- und Zugriffstoken finden Sie unter:
https://learn.microsoft.com/en-us/rest/api/datacatalog/authenticate-a-client-app
Testen des Formulardatenmodells (Dynamics) testing-the-form-data-model
Sobald die Cloud-Konfiguration abgeschlossen ist, können Sie das Formulardatenmodell testen.
-
Gehen Sie zu
https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
-
Wählen Sie den We.gov Microsoft® Dynamics CRM-FDM und anschließend Eigenschaften aus.
-
Navigieren Sie zur Registerkarte Quelle aktualisieren.
-
Stellen Sie sicher dass die Kontextabhängige Konfiguration“ auf
/conf/we-govfestgelegt ist und dass die konfigurierte Datenquellems-dynamics-odata-cloud-serviceist.
-
Bearbeiten Sie das Formulardatenmodell.
-
Testen Sie die Services, um sicherzustellen, dass sie sich erfolgreich mit der konfigurierten Datenquelle verbinden.
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 Neustart des AEM-Servers erforderlich war, damit die Datenquelle erfolgreich an das FDM gebunden werden konnte. note note NOTE Adobe empfiehlt die Verwendung des Befehls Ctrl + Czum Neustart von SDK. Neustarten von AEM SDK mit alternativen Methoden. Das Anhalten von Java-Prozessen kann beispielsweise zu Inkonsistenzen in der AEM-Entwicklungsumgebung führen.
Testen des Forms-Datenmodells (Derby) test-fdm-derby
Sobald die Cloud-Konfiguration abgeschlossen ist, können Sie das Forms-Datenmodell 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-govgesetzt 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. Testen Sie den Service, und Systemadministratoren können 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
Suchen Sie die Benutzeranmeldeinformationen für ein Adobe Analytics-Konto, das der Kontoadministrator ausführen muss, indem Sie 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 Informationen zur Benutzerauthentifizierung werden unten auf der Seite angezeigt.
-
Der Benutzername und die Informationen zum gemeinsamen geheimen Schlüssel werden auf der rechten Seite des Berechtigungsfelds angezeigt.
-
Der Benutzername enthält einen Doppelpunkt im Namen. Bei allen Informationen links vom Doppelpunkt handelt es sich um den Benutzernamen und bei allen Informationen rechts vom Doppelpunkt um den Firmennamen, wie im folgenden Beispiel gezeigt:
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.
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 ist.
-
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 installieren, sind AEM Forms Analytics-Daten offline oder ohne Adobe Analytics Cloud-Konfiguration verfügbar. AEM Sites-Daten erfordern eine aktive Cloud-Konfiguration.-
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 wählen Sie Analysen und Empfehlungen.
-
Auf dieser Seite sehen Sie die von Adobe Analytics abgerufenen Informationen. Die Informationen beziehen sich auf die AEM Sites-Seite. Diese Informationen werden regelmäßig von Adobe Analytics aktualisiert und nicht in Echtzeit angezeigt.
-
Zurück auf der Seite „Seitenansicht“ (die Sie in Schritt 3. aufgerufen haben) können Sie die Informationen der Seitenansicht auch anzeigen, indem Sie die Anzeigeeinstellung so ändern, dass Elemente in der Listenansicht“ angezeigt.
-
Suchen Sie das Dropdown-Menü „Ansicht“ und wählen Sie Listenansicht.
-
Wählen Sie im gleichen Menü Ansichtseinstellung und wählen Sie die Spalten, die Sie anzeigen möchten, aus dem Abschnitt Analytics aus.
-
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-Paket installiert ist. AEM Sites-Daten erfordern jedoch eine aktive Cloud-Konfiguration.-
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 Adobe Forms zu installieren und zu konfigurieren, müssen Benutzende des Konvertierungs-Tools ü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
Konfigurieren Sie den Dienst für die korrekte Kommunikation mit dem Forms Conversion Tool Benutzer müssen den Identity Management System (IMS)-Dienst konfigurieren, um sich bei Adobe I/O registrieren zu können.
-
Navigieren Sie zu https://<aemserver>:<port> und klicken Sie auf Adobe Experience
Manager oben links > 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 Zugriff auf eine API aus.
-
Stellen Sie sicher, dass Sie sich in der richtigen Gruppe befinden (Dropdown-Liste oben rechts).
-
Wählen Sie im Abschnitt 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 IMS Konfigurationsbildschirm 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 (klicken Sie Anzeigen auf der Seite „Integration in Adobe I/O", um es anzuzeigen).
-
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 Benutzer 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 wurden die beiden Kontrollkästchenwerte leer gelassen.
Weitere Informationen zu diesen Optionen finden Sie unter Konfigurieren des Cloud-Service.
Konfigurieren der Cloud-Konfiguration (We.Finance AFC Production) configure-cloud-configuration-wefinance
Sobald die IMS-Konfiguration abgeschlossen ist, können Sie 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 wurden 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
Nachdem die Konfiguration eingerichtet wurde, können Benutzer sie testen, indem sie ein PDF-Dokument hochladen.
-
Navigieren Sie zum AEM-System https://<domain_name>:<system_port>
-
Klicken Sie auf Forms > Forms und Dokumente > AEM Forms We.gov Forms > 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 können die Option wie unten dargestellt sehen.
-
Sobald die Schaltfläche ausgewählt ist, werden den Benutzenden 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.
-
Zu Beginn des Konvertierungsprozesses sehen Benutzerinnen und Benutzer Folgendes:
-
Nach Abschluss der Konvertierung sehen Benutzerinnen und Benutzer Folgendes:
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 Informationen, bevor Sie mit der Verwendung des Service zur automatischen Formularkonvertierung von AEM Forms beginnen.
-
Erstellen Sie das Formular mit aktivierter Option „Adaptive Formulare ohne Datenbindung generieren“, wenn Sie das Formular nach der Konvertierung an einen FDM binden möchten.
-
Stellen Sie sicher, dass im Vorlagenordner die Berechtigung für alle
jcr:readaktiviert ist. Wenn die Berechtigung nicht festgelegt ist, kann der Service-Benutzer 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 den Vorlagenrichtlinien hinzugefügt, aber jede Klasse, die Bootstrap 4 unterstützt, kann den Richtlinien hinzugefügt werden. Eine Liste der verfügbaren Klassen finden Sie unter:
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:
Informationen zu Stilen finden Sie unter von Vorlagenanpassungen .
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
Sie können diese Formulare an bestimmte Anwendungsfälle anpassen. Bearbeiten Sie nicht bestimmte Felder und Übermittlungslogiken, um sicherzustellen, dass das Formular weiterhin ordnungsgemäß funktioniert, z. B. die folgenden:
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 Callbacks zu unterstützen. In der Dokumentation wird die Anpassung beschrieben. Sie müssen jedoch ein umfangreiches Skript schreiben, um das Formular abzusenden und sowohl
POST- als auchGETü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
Die adaptive Anmelde-Forms wird zur Verarbeitung an einen OSGi-Workflow übermittelt. Dieser Workflow befindet sich 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, 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 Benutzereintrag abzurufen, um die Kontakt-ID zu erhalten. Im aktuellen Status schlägt das Abrufen der Kontakt-ID fehl, wenn in Dynamics mehr als zwei Benutzer mit demselben Namen vorhanden sind, was die Übermittlung des adaptiven Anmeldungsformulars nicht zulässt.
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 testen möchten, im Chrome-Browser. Das Öffnen mehrerer Registerkarten kann sich auf die Punktzahl auswirken. Daher ist es vorzuziehen, nur eine Registerkarte zu öffnen. Nachdem die Seite geladen wurde, klicken mit der rechten auf die Seite und wählen Sie die Registerkarte Audits aus. Hier wählen Entwickler den Prüfungstyp aus, den das Barrierefreiheits-Plug-in durchführt. Nachdem die gewünschten Optionen ausgewählt sind, klicken Sie auf Bericht generieren um ein PDF-Dokument zu erstellen. Die PDF zeigt die allgemeine Zugänglichkeitsbewertung und was verwendet werden kann, um die Zugänglichkeitsbewertung insgesamt zu erhöhen.
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 Sie diese Daten exportieren möchten, klicken Sie auf die drei Schaltflächen auf der rechten Bildschirmseite und wählen Sie eine der verfügbaren Optionen aus.
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. Dieses Paket wird mit CRX installiert.
Package Manager-Benutzer können auf das Ultramarine-Design in AEM Forms zugreifen, indem sie zu Forms > Designs > Referenz-Designs > Ultramarine-Accessible.
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
Sie sind im Begriff, die Referenz-Site von We.Gov zu erkunden. Weitere Informationen zum Workflow und den Schritten der WeGov-Referenz-Website finden Sie unter Schrittweise Anleitung zur WeGov-Referenz-Website.