DokumentationAEM 6.5Benutzerhandbuch

Einrichten und Konfigurieren der Referenz-Website We.Gov und WeFinance set-up-and-configure-we-gov-reference-site

Last update: Sun Mar 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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:

AEM-VERSION
AEM FORMS-PAKET-VERSION
STATUS
6.4
5.0.86
Unterstützt
6.5
6.0.80
Unterstützt
6.5.3
6.0.122
Unterstützt

Dieses Paket enthält eine Cloud-Konfiguration, die die folgenden Plattformversionen unterstützt:

CLOUD-PROVIDER
SERVICE-VERSION
STATUS
Adobe Sign
v5-API
Unterstützt
Microsoft® Dynamics 365
1710 (9.1.0.3020)
Unterstützt
Adobe Analytics
v1.4-Rest-API
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

  1. Öffnen Sie Software Distribution. Zum Anmelden bei Software Distribution benötigen Sie eine Adobe ID.

  2. Wählen Sie im Kopfzeilenmenü Adobe Experience Manager aus.

  3. Im Abschnitt Filter:

    1. Wählen Sie Formulare aus der Dropdown-Liste Lösung aus.
    2. 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.

  4. Wählen Sie den Paketnamen we-gov-forms.pkg.all-<version>.zip, dann EULA-Bedingungen akzeptieren und schließlich Herunterladen aus.

  5. Öffnen Sie Package Manager und klicken Sie auf Paket hochladen, um das Paket hochzuladen.

  6. Wählen Sie das Paket aus und klicken Sie auf Installieren.

    WeGov-Formularpaket

  7. Lassen Sie den Abschluss des Installationsprozesses zu.

  8. 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

  1. Laden Sie die Datei we-gov-forms.pkg.all-<version>.zip herunter und suchen Sie sie.

  2. Gehen Sie zu https://<aemserver>:<port>/crx/packmgr/index.jsp.

  3. Wählen Sie die Option „Paket hochladen“.

    Option „Paket hochladen“

  4. Verwenden Sie den Datei-Browser, um zur heruntergeladenen ZIP-Datei zu gelangen und sie auszuwählen.

  5. Klicken Sie zum Hochladen auf „Öffnen“.

  6. Wählen Sie nach dem Hochladen die Option „Installieren“, um das Paket zu installieren.

    WeGov Forms-Paket installieren

  7. Lassen Sie den Abschluss des Installationsprozesses zu.

  8. 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.

  1. Navigieren Sie zu https://<aemserver>:<port>/crx/packmgr/index.jsp

  2. Suchen Sie die ältere Datei we-gov-forms.pkg.all-<version>.zip.

  3. Wählen Sie die Option „Mehr“.

  4. Wählen Sie im Dropdown-Menü die Option „Deinstallieren“.

    WeGov-Paket deinstallieren

  5. 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

  1. Navigieren Sie zu https://<aemserver>:<port>/libs/granite/security/content/groupadmin.html

  2. Melden Sie sich als Admin an, um die unten aufgeführten Aufgaben durchzuführen.

  3. Scrollen Sie nach unten zum Ende der Seite, um alle Benutzergruppen zu laden.

  4. Suchen Sie nach „Workflow“.

  5. Wählen Sie die Gruppe workflow-users aus und klicken Sie auf „Eigenschaften“.

  6. Navigieren Sie zu der Registerkarte „Mitglieder“.

  7. Geben Sie wegov in das Feld „Benutzer oder Gruppe wählen“ ein.

  8. Wählen Sie im Dropdown-Menü „We.Gov Forms Users“.

    Bearbeiten der Gruppeneinstellungen für Workflow-Benutzer

  9. Klicken Sie in der Menüleiste auf „Speichern und schließen“.

  10. 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.

  11. 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.

  12. 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

  1. Lesen Sie die Einrichtungsdokumentation Konfigurieren von E-Mail-Benachrichtigungen

  2. Melden Sie sich als Administrator an, um diese Aufgabe durchzuführen.

  3. Navigieren Sie zu  https://<aemserver>:<port>/system/console/configMgr

  4. Suchen Sie den Day CQ Mail Service und klicken Sie darauf, um ihn zu konfigurieren.

    Konfigurieren des Day CQ Mail Service

  5. Konfigurieren Sie den Service für die Verbindung mit dem gewünschten SMTP-Server:

    1. Hostname des SMTP-Servers: zum Beispiel (smtp.gmail.com)
    2. Server-Port: zum Beispiel (465) für Gmail mit SSL
    3. SMTP User: (SMTP-Benuztende) demo@ <companyname> .com
    4. „Von“-Adresse: aemformsdemo@adobe.com

    Konfigurieren von SMTP

  6. 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:

  1. Die Funktion „SSL By Default“ (SSL als Standard)

Anmerkungen:

  1. Navigieren Sie zu „https://<aemserver>:<port>/aem/inbox“. Darüber können Sie den im obigen Link zur Referenzdokumentation beschriebenen Vorgang abschließen.

  2. 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 Ordner we-gov-forms.pkg.all-[version].zip/ssl extrahieren, der Teil des Pakets ist.

  3. SSL-Zertifikat und Schlüsseldetails:

    1. ausgegeben an „CN=localhost“
    2. Gültigkeit von 10 Jahren
    3. Kennwortwert von „Kennwort“

  4. Der private Schlüssel ist localhostprivate.der.

  5. Das Zertifikat ist localhost.crt.

  6. Klicken Sie auf Weiter.

  7. Der HTTPS-Hostname sollte auf localhost gesetzt werden.

  8. 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:

  1. Integrieren von Adobe Sign mit AEM Forms

Cloud-Konfiguration cloud-configuration

  1. Überprüfen Sie die Voraussetzungen. Siehe AEM-SSL-Konfiguration für die erforderliche SSL-Konfiguration.

  2. 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)

  3. Wählen Sie die Konfiguration „We.gov Adobe Sign“ aus.

  4. Klicken Sie auf „Eigenschaften“.

  5. Navigieren Sie zur Registerkarte „Einstellungen“.

  6. Geben Sie die oAuth-URL ein, z. B.: https://secure.na1.echosign.com/public/oauth

  7. Geben Sie die konfigurierte Client-ID und das Client-Geheimnis aus der konfigurierten Adobe Sign-Instanz an.

  8. Klicken Sie auf „Mit Adobe Sign verbinden“.

  9. 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:

  1. Microsoft
  2. Konfigurieren von Microsoft® Dynamics für AEM Forms

MS® Dynamics OData-Cloud-Service ms-dynamics-odata-cloud-service

  1. Gehen Sie zu:

    https://<aemserver>:<port>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov

    1. 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.

  2. Wählen Sie die Konfiguration „Microsoft® Dynamics OData Cloud-Dienst“.

  3. Klicken Sie auf „Eigenschaften“.

    Eigenschaften für den Microsoft OData-Cloud-Service

  4. Navigieren Sie zur Registerkarte „Authentifizierungseinstellungen“.

  5. Geben Sie die folgenden Details ein:

    1. Dienststamm: zum Beispiel: https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

    2. Authentifizierungstyp: OAuth 2.0

    3. Authentifizierungseinstellungen (siehe Cloud-Konfigurationseinstellungen für MS® Dynamics, um diese Informationen zu sammeln):

      1. Client-ID – auch als Programm-ID bezeichnet
      2. Client-Geheimnis
      3. OAuth-URL: beispielsweise https://login.microsoftonline.com/common/oauth2/authorize
      4. Aktualisieren der Token-URL: beispielsweise https://login.windows.net/common/oauth2/token
      5. Zugriffstoken-URL: beispielsweise https://login.windows.net/common/oauth2/token
      6. Genehmigungsumfang – openid
      7. Authentifizierungs-Header – Autorisierungsanbieter
      8. Ressource: zum Beispiel https://msdynamicsserver.api.crm3.dynamics.com

    4. Klicken Sie auf „Mit OAuth verbinden“.

  6. 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.

  1. Navigieren Sie zu https://portal.azure.com/ und melden Sie sich an.

  2. Wählen Sie im Menü links „Alle Dienste“.

  3. Suchen Sie nach „App-Registrierung“ oder navigieren Sie dorthin.

  4. Erstellen oder wählen Sie eine bestehende Programmregistrierung aus.

  5. Kopieren Sie die Programm-ID zur Verwendung als OAuth-Client-ID in der AEM Cloud-Konfiguration

  6. Klicken Sie auf „Einstellungen“ oder „Manifest“, um die Antwort-URLs zu konfigurieren.

    1. Diese URL muss mit der URL übereinstimmen, die für den Zugriff auf Ihren AEM-Server beim Konfigurieren des OData-Services verwendet wird.

  7. Klicken Sie in der Einstellungsansicht auf „Schlüssel“, um einen neuen Schlüssel anzuzeigen (dieser wird in AEM als Client-Geheimnis verwendet).

    1. Achten Sie darauf, eine Kopie des Schlüssels zu behalten, da Sie ihn später in Azure oder AEM nicht anzeigen können.

  8. Um die Ressourcen-URL/Dienststamm-URL zu finden, navigieren Sie zum Dashboard der MS® Dynamics-Instanz.

  9. Klicken Sie in der oberen Navigationsleiste auf „Verkauf“ oder Ihren eigenen Instanztyp und dann auf „Einstellungen auswählen“.

  10. Klicken Sie unten rechts auf „Anpassungen“ und dann auf „Entwicklungsressourcen“.

  11. Dort finden Sie die Dienststamm-URL, z. B.:

    *https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

  12. 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.

  1. Gehen Sie zu

    https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov

  2. Wählen Sie „We.gov Microsoft® Dynamics CRM FDM“ und dann „Eigenschaften“ aus.

    Eigenschaften des Dynamics CRM-FDM

  3. Navigieren Sie zur Registerkarte „Quelle aktualisieren“.

  4. Stellen Sie sicher, dass die „kontextsensitive Konfiguration“ auf „/conf/we-gov“ festgelegt ist und dass die konfigurierte Datenquelle „ms-dynamics-odata-cloud-service“ lautet.

    Datenquelle konfiguriert

  5. Bearbeiten Sie das Formulardatenmodell.

  6. 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 Tastaturbefehl „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.

  1. Navigieren Sie zu https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov

  2. Wählen Sie die We.gov Enrollment FDM und wählen Sie Eigenschaften.

    Eigenschaften des Dynamics CRM-FDM

  3. Navigieren Sie zur Registerkarte Quelle aktualisieren.

  4. Stellen Sie sicher, dass die Kontextabhängige Konfiguration auf /conf/we-gov gesetzt ist und dass die konfigurierte Datenquelle We.Gov Derby DS ist.

    Eigenschaften des Dynamics CRM-FDM

  5. Klicken Sie auf Speichern und schließen.

  6. 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.

  1. Navigieren Sie zu https://<aemserver>:<port>/libs/cq/core/content/tools/cloudservices.html

  2. Suchen Sie den Abschnitt „Adobe Analytics“ und wählen Sie den Link „Konfigurationen anzeigen“.

  3. Wählen Sie die Konfiguration „We.Gov Adobe Analytics (Analytics-Konfiguration)“ aus.

    Analytics Cloud-Service-Konfiguration

  4. 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.

    We.Gov Adobe Analytics

  5. 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.

  1. Navigieren Sie zum Adobe Experience Cloud-Portal.
    • Melden Sie sich mit Ihren Administrator-Anmeldeinformationen an.
  2. Wählen Sie im Haupt-Dashboard das Adobe Analytics-Symbol aus.
    Schnellzugriff
  3. Navigieren Sie zur Registerkarte „Admin“ und wählen Sie das Element „User Management (Legacy)“ aus.
    Berichte
  4. Wählen Sie die Registerkarte Benutzer aus.
    Benutzerverwaltung
  5. Wählen Sie den gewünschten Benutzer aus der Liste der Benutzer aus.
  6. Scrollen Sie nach unten auf der Seite, und die Authentifizierungsinformationen des Benutzers werden unten auf der Seite angezeigt.
    Zugriff verwalten
  7. Der Benutzername und die Informationen zum gemeinsamen geheimen Schlüssel werden rechts im Berechtigungsfeld angezeigt.
  8. 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.

  1. Navigieren Sie zur Adobe Admin Console.

  2. Klicken Sie auf die Analytics-Instanz, die in der Admin Console angezeigt wird.

    • Diese befindet sich auf der Hauptseite der Admin-Seite.

  3. Wählen Sie den vollständigen Administratorzugriff für Analytics aus.

  4. Fügen Sie einen Benutzer zum Profil hinzu.

    Vollständiger Administratorzugriff für Analytics

  5. Klicken Sie auf die Registerkarte „Berechtigungen“, sobald die Benutzer-ID dem Profil zugeordnet wurde.

  6. Stellen Sie sicher, dass alle Berechtigungen dem Profil zugeordnet sind.

    Bearbeiten von Berechtigungen

  7. 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

NOTE
AEM Forms-Analytics-Daten sind offline oder ohne Adobe Analytics-Cloud-Konfiguration verfügbar, wenn das Paket we-gov-forms.ui.analytics-<version>.zip installiert ist. Für AEM Sites-Daten ist jedoch eine aktive Cloud-Konfiguration erforderlich.

  1. Navigieren Sie zu https://<aemserver>:<port>/sites.html/content

  2. Wählen Sie die „AEM Forms We.Gov-Site“ aus, um die Seiten der Site anzuzeigen.

  3. Wählen Sie eine der Seiten der Site aus (z. B. die Startseite) und klicken Sie auf „Analysen und Empfehlungen“.

    Analyse und Empfehlungen

  4. 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.)

    AEM Sites-Analyse

  5. 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.

  6. Suchen Sie das Dropdown-Menü „Ansicht“ und wählen Sie „Listenansicht“ aus.

    Listenansicht

  7. Wählen Sie im gleichen Menü „Ansichtseinstellung“ aus und wählen Sie die Spalten aus, die Sie anzeigen möchten, aus dem Abschnitt „Analysen“.

    Konfigurieren der Spalten

  8. Klicken Sie auf „Aktualisieren“, um die neuen Spalten verfügbar zu machen.

    Anzeige neuer Spalten

Anzeigen von Adobe Analytics-Formularberichten view-adobe-analytics-forms-reporting

NOTE
AEM Forms Analytics-Daten sind offline oder ohne Adobe Analytics Cloud-Konfiguration verfügbar, wenn das Paket we-gov-forms.ui.analytics-<version>.zip installiert ist, für AEM Sites-Daten ist jedoch eine aktive Cloud-Konfiguration erforderlich.

  1. Gehen Sie zu

    https://<aemserver>:<port>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms

  2. Wählen Sie das adaptive Formular „Registrierungsantrag für Gesundheitsleistungen“ aus und dann die Option „Analytics-Bericht“.

    Analytics-Bericht

  3. Warten Sie, bis die Seite geladen wurde, und zeigen Sie die Daten des Analytics-Berichts an.

    Anzeigen von Analytics-Berichtsdaten

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.

  1. Zugriff auf Adobe Developer.

  2. Berechtigung zum Erstellen einer Integration mit dem Adobe Forms-Konvertierungs-Service.

  3. 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.

  1. Navigieren Sie zu https://<aemserver>:<port> und klicken Sie links oben auf „Adobe Experience Manager“ > „Tools“ > „Sicherheit“ > „Adobe IMS-Konfiguration“.

  2. Klicken Sie auf „Erstellen“.

  3. Führen Sie die Aktionen im folgenden Bild aus.

    Konfiguration des technischen IMS-Kontos

  4. Stellen Sie sicher, dass Sie das Zertifikat herunterladen.

  5. Fahren Sie nicht mit dem Rest der Konfiguration fort, sondern lesen Sie den Abschnitt Erstellen der Integration in Adobe I/O

NOTE
Das in diesem Abschnitt erstellte Zertifikat wird verwendet, um den Integrations-Service in Adobe I/O zu erstellen. Sobald Benutzer den Integrations-Service erstellt haben, können Benutzer diese Informationen aus Adobe I/O verwenden, um die Konfiguration abzuschließen.

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.

  1. Navigieren Sie zur Adobe I/O-Konsole.

  2. Klicken Sie auf Integration erstellen.

  3. Wählen Sie „Auf eine API zugreifen“ aus.

  4. Vergewissern Sie sich, dass Sie sich in der richtigen Gruppe befinden (Dropdown-Liste oben rechts).

  5. Wählen Sie im Bereich „Experience Cloud“ das Forms-Konvertierungs-Tool aus.

  6. Klicken Sie auf Weiter.

  7. Geben Sie den Namen und die Beschreibung Ihrer Integration ein.

  8. Durch Verwendung des öffentlichen Schlüssels aus Abschnitt 2.1 wird dieser in die Integration des Schlüssels eingefügt.

  9. Wählen Sie ein Profil für Ihre automatische Formularkonvertierung aus.

    Erstellen einer neuen Integration

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.

  1. Klicken Sie in Adobe I/O auf Ihre Integration, um die Verbindungsdetails anzuzeigen.

  2. Navigieren Sie in AEM zu Ihrer IMS-Konfiguration („Tools“ > „Sicherheit“ > „IMS“)

  3. Klicken Sie im Bildschirm „IMS-Konfiguration“ auf „Weiter“.

  4. Geben Sie den Autorisierungs-Server ein (im Screenshot angezeigter Wert).

  5. Geben Sie den API-Schlüssel ein.

  6. 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).

  7. 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.

    Payload-IMS-Konfiguration

  8. Klicken Sie nach der Erstellung auf die IMS-Konfiguration und wählen Sie „Konsistenzprüfung“ aus. Die Benutzenden sollten das folgende Ergebnis sehen.

    Statusbestätigung

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:

  1. Öffnen Sie den Browser und navigieren Sie zur System-URL https://<domain_name>:<system_port>

  2. Klicken Sie oben links im Bildschirm auf „Adobe Experience Manager“ > „Tools“ > „Cloud Services“ > „Konfiguration der automatisierten Formularkonvertierung“.

  3. Wählen Sie den Konfigurationsordner aus, in dem die Konfiguration abgelegt werden soll.

  4. Klicken Sie auf „Erstellen“.

  5. Geben Sie die Informationen im folgenden Screenshot ein.

    AFC-Produktion

  6. Geben Sie der Konfiguration einen Titel und einen Namen.

  7. Die Service-URL für das System ist auf https://aemformsconversion.adobe.io/ festgelegt.

  8. Vorlagen-URL /conf/we-gov/settings/wcm/templates/we-gov-flamingo-template.

  9. Design-URL: /content/dam/formsanddocuments-themes/adobe-gov-forms-themes/we-gov-theme

  10. Klicken Sie auf Weiter.

  11. Für diese Konfiguration haben wir die beiden Kontrollkästchenwerte leer gelassen.

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.

  1. Öffnen Sie den Browser und navigieren Sie zur System-URL https://<domain_name>:<system_port>

  2. Klicken Sie oben links im Bildschirm auf „Adobe Experience Manager“ > „Tools“ > „Cloud Services“ > „Konfiguration der automatisierten Formularkonvertierung“.

  3. Wählen Sie den Konfigurationsordner aus, in dem die Konfiguration abgelegt werden soll.

  4. Klicken Sie auf „Erstellen“.

  5. Geben Sie die Informationen im folgenden Screenshot ein.

    We.Finance AFC-Produktion

  6. Geben Sie der Konfiguration einen Titel und einen Namen.

  7. Die Service-URL für das System ist auf https://aemformsconversion.adobe.io/ festgelegt.

  8. Vorlagen-URL: /conf/we-finance/settings/wcm/templates/we-finance-adaptive-form

  9. Design-URL: /content/dam/formsanddocuments-themes/adobe-finance-forms-themes/we-finance-theme

  10. Klicken Sie auf Weiter.

  11. Für diese Konfiguration haben wir die beiden Kontrollkästchenwerte leer gelassen.

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.

  1. Navigieren Sie zum AEM-System https://<domain_name>:<system_port>

  2. Klicken Sie auf „Formulare“ > „Formulare und Dokumente“ > „AEM Forms We.gov-Formulare“ > „AFC“.

  3. Wählen Sie die PDF der We.Gov Enrollment Application aus.

  4. Klicken Sie oben rechts auf die Option zum Starten der automatischen Konvertierung.

  5. Benutzer sollten die Option wie unten dargestellt sehen können.

    Konvertiertes adaptives Formular

  6. 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.

    Konvertierungseinstellungen

    Erweiterte Konvertierungseinstellungen

  7. Wählen Sie „Konvertierung starten“ aus, nachdem Sie alle gewünschten Optionen konfiguriert haben.

  8. Wenn der Konvertierungsprozess beginnt, sollten die Benutzer den folgenden Bildschirm sehen:

    Konvertierungseinstellungen

  9. Wenn die Konvertierung abgeschlossen ist, sehen die Benutzer den folgenden Bildschirm:

    Konvertiertes adaptives Formular

    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.

  1. 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.

  2. 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:

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:

Vorlagen-Logos

Weitere Informationen hierzu finden Sie unter „Bearbeiten von Seiteninhalten“:

Bearbeiten des Seiteninhalts

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:

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:

Zugänglichkeitsbericht

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.

Zugänglichkeitsbericht

Ultramarine-Design ultramarine-theme

Das öffentlich verfügbare Ultramarine-Design, das von Adobe gepflegt wird, ist in die
we-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.

Ultramarine-Design

Konfigurationsoptionen configuration-options

Anwender haben die Möglichkeit, verschiedene Workflow-Service-Optionen zu konfigurieren, darunter die folgenden:

  1. Microsoft® Dynamics-Eintrag
  2. Adobe Sign
  3. AEM Custom Communication Management
  4. Adobe Analytics

Um sie so zu konfigurieren, dass sie im Workflow aktiviert werden, müssen Benutzende die folgenden Aufgaben ausführen.

  1. Gehen Sie zu https://'[server]:[port]'/system/console/configMgr.

  2. Suchen Sie die WeGov-Konfigurationen.

  3. Ö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.

    WeGov-Formularpaket

  4. 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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2