Einrichten und Konfigurieren der Referenz-Website We.Gov und We.Finance

Details zum Demopaket

Installationsvoraussetzungen

Dieses Paket wurde für AEM Forms 6.4 OSGI Author erstellt, wurde getestet und wird daher für die folgenden Plattformversionen unterstützt:

AEM VERSION AEM Forms-PACKAGE-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:
  • Das Paket wird voraussichtlich auf einem sauberen Server installiert, der frei von anderen Demopaketen oder älteren Demopaketversionen ist
  • Das Paket wird voraussichtlich auf einem OSGi-Server installiert und im Autorenmodus ausgeführt

Was enthält dieses Paket?

Das AEM Forms We.Gov-Demopaket (we-gov-forms.pkg.all-<version>.zip) wird als Paket bereitgestellt, das mehrere weitere Unterpakete und Dienste enthält. Das Paket enthält die folgenden Module:

  • we-gov-forms.pkg.all-<version>.zip - Umfassendes Demopaket

    • we-gov-forms.ui.apps-<version>.zip - Enthält alle Komponenten, Client-Bibliotheken, Beispielbenutzer, Workflow-Modelle usw.

      • we-gov-forms.core-<version>.jar - Enthält alle OSGi-Dienste, die Implementierung benutzerdefinierter Workflow-Schritte usw.

      • we-gov-forms.derby<version>.jar - Enthält alle OSGi-Dienste, Datenbankschemata 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 package for Sites page column control

    • we-gov-forms.ui.content-<version>.zip - Enthält alle Inhalte, Seiten, Bilder, Formulare, interaktiven Kommunikations-Assets usw.

    • we-gov-forms.ui.analytics-<version>.zip - Enthält alle We.Gov Forms Analytics-Daten, die im Repository gespeichert werden sollen.

    • we-gov-forms.config.public-<version>.zip - Enthält alle standardmäßigen Konfigurationsknoten, einschließlich Platzhalter-Cloud-Konfigurationen, um Formulardatenmodelle und Service-Bindungsprobleme zu vermeiden.

Zu den in diesem Paket enthaltenen Assets gehören:

  • AEM von Seiten der Site mit bearbeitbaren Vorlagen
  • Adaptives AEM Forms Forms
  • Interaktive Kommunikation mit AEM Forms (Druck und Webkanal)
  • AEM Forms XDP-Datensatzdokument
  • AEM Forms MS Dynamics Forms-Datenmodell
  • 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

Dieser Abschnitt enthält Informationen zur Installation des Demopakets.

Aus Softwareverteilung

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

  2. Tippen Sie im Kopfzeilenmenü auf Adobe Experience Manager.

  3. Im Abschnitt Filter:

    1. Wählen Sie Formulare aus der Dropdown-Liste Lösung.
    2. Wählen Sie die Version und den Typ für das Paket aus. Sie können auch die Option Downloads suchen verwenden, um die Ergebnisse zu filtern.
  4. Tippen Sie auf den Paketnamen we-gov-forms.pkg.all-<version>.zip, wählen Sie EULA-Begriffe akzeptieren und tippen Sie auf Download.

  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.

    Wir gov Forms-Paket

  7. Lassen Sie den Installationsprozess abzuschließen.

  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

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

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

  3. Wählen Sie die Option "Paket hochladen".

    Option "Paket hochladen"

  4. Verwenden Sie den Dateibrowser, um zur heruntergeladenen ZIP-Datei zu navigieren 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.

    Installieren des WeGov Forms-Pakets

  7. Lassen Sie den Installationsprozess abzuschließen.

  8. Navigieren Sie zu https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled, um sicherzustellen, dass die Installation erfolgreich war.

Installieren neuer Paketversionen

Um eine neue Paketversion zu installieren, führen Sie die in 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 bei der Bestätigung erneut "Deinstallieren"aus und lassen Sie den Abschluss des Deinstallationsprozesses zu.

Konfiguration des Demopakets

Dieser Abschnitt enthält Details und Anweisungen zur Konfiguration des Demopakets nach der Bereitstellung vor der Präsentation.

Fakultative Benutzerkonfiguration

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

  2. Melden Sie sich als Administrator 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 zur Registerkarte "Mitglieder".

  7. Geben Sie wegov in das Feld "Benutzer oder Gruppe auswählen"ein.

  8. Wählen Sie aus dem Dropdown-Menü "We.Gov Forms Users"aus.

    Gruppeneinstellungen für Workflow-Benutzer bearbeiten

  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 users"suchen, die Gruppe "forms-power-users"auswählen und die Gruppe "We.Gov Forms Users"als Mitglied hinzufügen.

  12. Wiederholen Sie die Schritte 2-7, indem Sie nach "forms-users"suchen, die Gruppe "forms-users"auswählen und dieses Mal die Gruppe "We.Gov Users"als Mitglied hinzufügen.

E-Mail-Serverkonfiguration

  1. Überprüfen Sie die Einrichtungsdokumentation Konfigurieren der E-Mail-Benachrichtigung

  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 Dienst Day CQ Mail Service und klicken Sie darauf, um ihn zu konfigurieren.

    Konfigurieren des Day CQ Mail Service

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

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

    SMTP konfigurieren

  6. Klicken Sie auf "Speichern", um die Konfiguration zu speichern.

(Optional) AEM SSL-Konfiguration

Dieser Abschnitt enthält Details zur Konfiguration von SSL auf der AEM-Instanz, um die Adobe Sign Cloud-Konfiguration konfigurieren zu können.

Verweise:

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

Anmerkungen:

  1. Navigieren Sie zu https://<aemserver>:<port>/aem/inbox , wo Sie den im obigen Referenzdokumentations-Link erläuterten Prozess abschließen können.

  2. Das Paket we-gov-forms.pkg.all-[version].zip enthält einen SSL-Beispielschlüssel und ein Zertifikat, auf das 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 "password"
  4. Der private Schlüssel ist localhostprivate.der.

  5. Zertifikat ist localhost.crt.

  6. Klicken Sie auf Weiter.

  7. HTTPS-Hostname sollte auf localhost gesetzt werden.

  8. Der Port sollte auf einen Port eingestellt sein, den das System offen gelegt hat.

(Optional) Adobe Sign-Cloud-Konfiguration

Dieser Abschnitt enthält Details und Anweisungen zur Adobe Sign Cloud-Konfiguration.

Verweise:

  1. Integrieren von Adobe Sign mit AEM Forms

Cloud-Konfiguration

  1. Überprüfen Sie die Voraussetzungen. Informationen zur erforderlichen SSL-Konfiguration finden Sie unter AEM SSL-Konfiguration .

  2. Gehen Sie zu:

    https://<aemserver>:<port>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov

    HINWEIS

    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

Dieser Abschnitt enthält Details und Anweisungen zur MS Dynamics Cloud-Konfiguration.

Verweise:

  1. Microsoft Dynamics OData-Konfiguration
  2. Microsoft Dynamics für AEM Forms konfigurieren

MS Dynamics OData-Cloud-Dienst

  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 der MS Dynamics-Anwendung konfiguriert wurde.
  2. Wählen Sie die Konfiguration "Microsoft Dynamics OData Cloud Service".

  3. Klicken Sie auf "Eigenschaften".

    Eigenschaften für Microsoft OData Cloud Service

  4. Navigieren Sie zur Registerkarte "Authentifizierungseinstellungen".

  5. Geben Sie die folgenden Details ein:

    1. Dienststamm: z. B. https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/

    2. Authentifizierungstyp: OAuth 2.0

    3. Authentifizierungseinstellungen (siehe MS Dynamics-Cloud-Konfigurationseinstellungen zum Erfassen dieser Informationen):

      1. Client-ID - auch als Anwendungs-ID bezeichnet
      2. Client-Geheimnis
      3. OAuth-URL - z. B. https://login.windows.net/common/oauth2/authorize
      4. Aktualisieren der Token-URL, z. B. https://login.windows.net/common/oauth2/token
      5. Zugriffstoken-URL - z. B. https://login.windows.net/common/oauth2/token
      6. Autorisierungsbereich - openid
      7. Authentifizierungs-Header - Autorisierungsbearer
      8. Ressource - z. B. 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

Die in diesem Abschnitt beschriebenen Schritte enthalten 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" aus.

  3. Suchen Sie nach "App-Registrierung"oder navigieren Sie zu "App-Registrierung".

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

  5. Kopieren Sie die Anwendungs-ID, die als OAuth Client-ID in der AEM Cloud-Konfiguration verwendet werden soll.

  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 beim Konfigurieren des OData-Dienstes verwendet wird.
  7. Klicken Sie in der Einstellungsansicht auf "Schlüssel", um einen neuen Schlüssel zu erstellen (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 "Einstellungen auswählen".

  10. Klicken Sie unten rechts auf "Anpassungen"und "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 Zugriffstoken finden Sie hier:

    https://docs.microsoft.com/en-us/rest/api/datacatalog/authenticate-a-client-app

Testen des Forms-Datenmodells (Dynamics)

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"aus und wählen Sie "Eigenschaften".

    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 Dienste, um sicherzustellen, dass sie erfolgreich eine Verbindung zur konfigurierten Datenquelle herstellen.

    HINWEIS

    Klicken Sie nach dem Testen der Dienste auf Abbrechen, um sicherzustellen, dass unwillkürliche Änderungen nicht an das Formulardatenmodell weitergeleitet werden.

    HINWEIS

    Es wurde berichtet, dass ein AEM Server-Neustart erforderlich war, damit die Datenquelle erfolgreich an das FDM gebunden werden konnte.

Testen des Forms-Datenmodells (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 We.gov Enrollment FDM und wählen Sie Properties aus.

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

    Eigenschaften des Dynamics CRM-FDM

  5. Klicken Sie auf Speichern und schließen.

  6. Testen Sie die Dienste, um sicherzustellen, dass sie erfolgreich eine Verbindung zur konfigurierten Datenquelle herstellen.

    • Um die Verbindung zu testen, wählen Sie HOMEMORTGAGEACCOUNT aus und geben Sie ihr einen get-Dienst. Testen Sie den Dienst und Systemadministratoren können sehen, wie Daten abgerufen werden.

Adobe Analytics-Konfiguration (optional)

Dieser Abschnitt enthält Details und Anweisungen zur Adobe Analytics Cloud-Konfiguration.

Verweise:

Adobe Analytics Cloud Service-Konfiguration

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.

    Konfiguration des Analytics Cloud Service

  4. Klicken Sie auf die Schaltfläche "Bearbeiten", um die Adobe Analytics-Konfiguration zu aktualisieren (Sie müssen das Shared Secret angeben). Klicken Sie auf "Mit Analytics verbinden", um eine Verbindung herzustellen, und auf "OK", um die Verbindung 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 Sie AEM Authoring, um die Bearbeitung zu aktivieren).

Adobe Analytics - Suchen von Benutzeranmeldeinformationen

Um die Benutzeranmeldeinformationen für ein Adobe Analytics-Konto zu finden, muss der Kontoadministrator die folgenden Aufgaben ausführen.

  1. Navigieren Sie zum Adobe Experience Cloud-Portal.
    • Melden Sie sich mit Ihren Administratorberechtigungen an
  2. Wählen Sie im Haupt-Dashboard das Symbol Adobe Analytics 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 für Benutzer werden unten auf der Seite angezeigt.
    Zugriff verwalten
  7. Der Benutzername und die gemeinsamen geheimen Informationen werden rechts im Berechtigungsfeld angezeigt.
  8. Beachten Sie, dass der Benutzername einen Doppelpunkt im Namen enthält. Alle Informationen links vom Doppelpunkt sind der Benutzername und alle Informationen rechts vom Doppelpunkt sind der Firmenname.
    • Im Folgenden finden Sie ein Beispiel dafür: Benutzername : Firmenname

Einrichten der Benutzerauthentifizierung in Adobe Analytics

Administratoren können Benutzern AEM Analyseberechtigungen erteilen, indem sie die folgenden Aktionen ausführen.

  1. Navigieren Sie zur Adobe Admin Console.

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

    • Dies befindet sich auf der Hauptseite der Admin-Seite.
  3. Wählen Sie Vollständiger 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.

    Berechtigungen bearbeiten

  7. Beachten Sie, dass es nach der Zuweisung der Berechtigungen einige Stunden dauern kann, bis sich ein Benutzer anmelden kann.

Adobe Analytics Reporting

Anzeigen von Adobe Analytics Sites-Berichten

HINWEIS

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

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

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

  3. Wählen Sie eine der Seiten der Site aus (z. B. Startseite) und wählen Sie "Analytics und Recommendations".

    Analyse und Recommendations

  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 (Zugriff 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".

    Listenansicht

  7. Wählen Sie im selben Menü "Anzeigeeinstellung"aus und wählen Sie die Spalten, die Sie anzeigen möchten, aus dem Abschnitt "Analytics"aus.

    Spalten konfigurieren

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

    Anzeige neuer Spalten

Anzeigen von Adobe Analytics forms-Berichten

HINWEIS

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

  1. Gehen Sie zu

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

  2. Wählen Sie das adaptive Formular "Registrierungsanwendung für Gesundheitsvorteile"und dann die Option "Analysebericht".

    Analytics-Bericht

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

    Analytics-Berichtsdaten anzeigen

Aktivierung der automatischen Forms-Konfiguration für Adobe

Um AEM Forms mit der Adobe Forms zu installieren und zu konfigurieren, müssen Benutzer des Konvertierungs-Tools über Folgendes verfügen.

  1. Zugriff auf Adobe I/O.

  2. Berechtigung zum Erstellen einer Integration mit dem Adobe Forms Conversion-Dienst.

  3. Adobe AEM 6.5 neuestes Service Pack, das als Autor ausgeführt wird.

Lesen Sie vor dem Lesen weiterer Anweisungen Folgendes:

Erstellen einer IMS-Konfiguration Teil 1

Damit der Dienst ordnungsgemäß mit dem Konvertierungs-Tool für Formulare kommunizieren kann, müssen die Benutzer den Identity Management-Systemdienst (IMS) konfigurieren, damit sie sich bei Adobe I/O registrieren können.

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

  2. Klicken Sie auf Erstellen.

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

    Technische Kontokonfiguration für IMS

  4. Laden Sie das Zertifikat herunter.

  5. Fahren Sie nicht mit dem Rest der Konfiguration fort - siehe Abschnitt Erstellen einer Integration in Adobe I/O

HINWEIS

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

Erstellen der Integration in Adobe I/O

Stellen Sie sicher, dass Sie die Möglichkeit haben, eine Integration in Ihrer Adobe-Domäne zu erstellen, wenn Sie sich hierzu nicht an Ihren Systemadministrator wenden.

  1. Navigieren Sie zur Adobe I/O Console.

  2. Klicken Sie auf Integration erstellen.

  3. Wählen Sie Auf 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-Konvertierungstool 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 automated forms conversion aus.

    Neue Integration erstellen

Erstellen der IMS-Konfiguration Teil 2

Nachdem Sie eine Integration erstellt haben, sollten wir 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 Autorisierungsserver ein (im Screenshot angezeigter Wert).

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

  6. Geben Sie den Client-Geheimnis ein (klicken Sie auf In Adobe I/O verfügbar machen , damit er 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 Benutzer sollten das folgende Ergebnis sehen.

    Konsistenzbestätigung

Konfigurieren der Cloud-Konfiguration (We.Gov-AFC-Produktion)

Sobald die IMS-Konfiguration abgeschlossen ist, können wir 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://<Domänenname>:<Systemport>.

  2. Klicken Sie oben links im Bildschirm auf Adobe Experience Manager > Tools > Cloud Services > Konfiguration der automatisierten Forms-Konversation .

  3. Wählen Sie den Konfigurationsordner aus, in dem Sie die Konfiguration ablegen möchten.

  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 Dienst-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)

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://<Domänenname>:<Systemport>.

  2. Klicken Sie oben links im Bildschirm auf Adobe Experience Manager > Tools > Cloud Services > Konfiguration der automatisierten Forms-Konversation .

  3. Wählen Sie den Konfigurationsordner aus, in dem Sie die Konfiguration ablegen möchten.

  4. Klicken Sie auf Erstellen.

  5. Geben Sie die Informationen im folgenden Screenshot ein.

    We.Finance AFC Production

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

  7. Die Dienst-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-Registrierungsanwendung)

Sobald die Konfiguration eingerichtet ist, können Benutzer sie testen, indem sie ein PDF-Dokument hochladen.

  1. Navigieren Sie zum AEM System https://<Domänenname>:<Systemport>.

  2. Klicken Sie auf Forms > Forms & Documents > AEM Forms We.gov Forms > AFC.

  3. Wählen Sie die PDF-Datei "We.Gov Enrollment Application"aus.

  4. Klicken Sie oben rechts auf die Schaltfläche Automatische Konversion starten .

  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 Benutzer die Konfiguration We.Gov AFC Production auswählen.

    Konvertierungseinstellungen

    Erweiterte Konvertierungseinstellungen

  7. Wählen Sie Konvertierung starten aus, sobald Sie alle Optionen konfiguriert haben, die Sie verwenden möchten.

  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 Output , um das generierte adaptive Formular anzuzeigen.

Bekannte Probleme und Hinweise

Der Automated forms conversion-Dienst umfasst bestimmte Best Practices, bekannte komplexe Muster und bekannte Probleme. Lesen Sie diese, bevor Sie mit der Verwendung des AEM Forms Automated forms conversion-Dienstes beginnen.

  1. Generieren Sie das Formular mit Adaptive(s) Formular(e) erzeugen ohne Datenbindungen aktiviert zu haben, 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 kann der Dienstbenutzer die Vorlage nicht aus dem Repository lesen, und die Konvertierung schlägt fehl.

Anpassung von Demopaketen

Dieser Abschnitt enthält Anweisungen zur Anpassung der Demo.

Vorlagenanpassung

Bearbeitbare Vorlagen finden Sie unter folgenden Adressen:

https://<aemserver>:<port>/libs/wcm/core/content/sites/templates.html/conf/we-gov

Zu diesen Vorlagen gehören die Vorlagen für AEM Site, adaptive Formulare und interaktive Kommunikation, die mit Komponenten erstellt und zusammengestellt wurden, die Sie unter folgenden Adressen finden:

https://<aemserver>:<port>/crx/de/index.jsp#/apps/we-gov/components

Stilsystem

Auf dieser Website finden Sie auch Client-Bibliotheken, von denen eine Bootstrap 4 ( https://getbootstrap.com/ ) importiert. 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 Package enthalten sind, sind auch mit Vorlagen-/Seitenrichtlinien vorkonfiguriert, die die CSS-Klassen von Bootstrap 4 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 Seite Erste Schritte :

https://getbootstrap.com/docs/4.1/getting-started/introduction/

Die in diesem Paket enthaltenen Vorlagen unterstützen auch das Stilsystem:

Stilsystem

Vorlagen-Logos

Projekt-DAM-Assets umfassen auch We.Gov-Logos und -Bilder. 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 Marken- und Logo-Dialogfeld, mit dem Logos aktualisiert werden können:

Vorlagen-Logos

Weitere Informationen finden Sie unter Bearbeiten des Seiteninhalts :

Bearbeiten des Seiteninhalts

Siteseiten-Anpassung

Alle Webseiten sind verfügbar unter: https://<aemserver>:<port>/sites.html/content/we-gov

Auf diesen Seiten wird auch das AEM Grid-Paket verwendet, um das Layout einiger Komponenten zu steuern.

Stilsystem

Die in diesem Paket enthaltenen Seiten unterstützen auch das Stilsystem:

Stilsystem

Die Dokumentation zu unterstützten Stilen finden Sie unter Vorlagenanpassungsstilsystem .

Anpassung adaptiver Formulare

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:

Registrierungsantrag für Gesundheitsleistungen:

  • contact_id - Ausgeblendetes Feld, das zum Empfangen der MS Dynamics-Kontakt-ID während der Übermittlung verwendet wird
  • Senden - Die Logik der Sendeschaltfläche muss angepasst werden, um Rückrufe zu unterstützen. Die Anpassung ist dokumentiert, es war jedoch ein großes Skript erforderlich, um das Formular zu senden, während sowohl eine POST als auch ein GET über das Forms-Datenmodell an MS Dynamics durchgeführt wurde.
  • Stammbereich - Das Initialisierungsereignis wird verwendet, um dem AEM Posteingang eine MS Dynamics-Schaltfläche hinzuzufügen, da alle Komponenten der Benutzeroberfläche von Inbox Granite nicht geändert werden können.

Adaptive Formularstile

Adaptive Formulare können auch mit dem Stileditor oder dem Design-Editor formatiert werden:

Workflow-Anpassung

Das adaptive Registrierungsformular sendet zur Verarbeitung an einen OSGi-Workflow. Dieser 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 allgemeine Schritte erstellt und nicht mit Konfigurationsdialogfeldern erstellt. Derzeit beruht die Konfiguration der Workflow-Schritte auf Prozessargumenten.

Der gesamte Java-Code für den Workflow-Schritt ist im Bundle we-gov-forms.core-<version>.jar enthalten.

Überlegungen zur Demo und bekannte Probleme

Dieser Abschnitt enthält Informationen zu Demofunktionen und Designentscheidungen, die während des Demonstrationsprozesses möglicherweise besondere Überlegungen erfordern.

Überlegungen zur Demo

  • Stellen Sie gemäß AGRS-159 sicher, dass der Name (erster, mittlerer und letzter) des Kontakts, der im adaptiven Formular für die Registrierung verwendet wird, eindeutig ist.
  • Das adaptive Registrierungsformular 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

  • (AGRS-120) Die Site-Navigationskomponente unterstützt derzeit keine verschachtelten untergeordneten Seiten, die mehr als zwei Ebenen tief sind.
  • (AGRS-159) Das aktuelle MS Dynamics FDM muss zwei Vorgänge ausführen, um zuerst die Daten des adaptiven Formulars für die Registrierung in Dynamics POST und dann den Benutzerdatensatz abzurufen, um die Kontakt-ID abzurufen. 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 Registrierungsformulars nicht zulässt.

Konfigurieren der Barrierefreiheitstests

Aktivieren der Barrierefreiheitsprüfung Chrome Add On

Um Barrierefreiheitstests durchzuführen, müssen Sie zunächst das Chrome-Plug-in installieren. Dies finden Sie hier hier.

Laden Sie nach der Installation die Seite, die Sie im Chrome-Browser testen möchten (Hinweis: Wenn mehrere Tabs geöffnet sind, kann sich dies auf Ihre Punktzahl auswirken. Es ist empfehlenswert, nur eine Registerkarte zu öffnen.) Sobald die Seite geladen wurde
Klicken Sie mit der rechten Maustaste auf auf der Seite und wählen Sie die Registerkarte Audits . Es können Entwickler den Typ der Prüfung auswählen, die vom Plug-in für Barrierefreiheit durchgeführt werden soll. Nachdem alle gewünschten Optionen ausgewählt wurden, kann der Benutzer die Schaltfläche Bericht generieren auswählen. Dadurch wird ein PDF-Dokument generiert, das die Gesamtbewertung der Barrierefreiheit und die Möglichkeiten zur Steigerung der Barrierefreiheit insgesamt anzeigt.

Sobald der Bericht ausgeführt wurde, können die Benutzer Folgendes erwarten:

Zugänglichkeitsbericht

Die Zahl, die vor den Benutzern angezeigt wird, ist die Gesamtbewertung der Barrierefreiheit, die sie erworben haben. Es gibt auch eine Beschreibung, wie diese Berechnung auf der Grundlage des Ergebnisses vorgenommen wurde.

Wenn Benutzer dies exportieren möchten, können sie auf die drei Schaltflächen rechts vom Bildschirm klicken und aus den weiteren Optionen auswählen, die das Plug-in bietet.

Zugänglichkeitsbericht

Ultramarine-Design

Das öffentlich verfügbare Ultramarine-Thema, das von der Adobe verwaltet wird, ist in die
we-gov-forms.pkg.all-<version>.zip installierbare ZIP-Datei. Sobald dieses Paket mit CRX installiert ist.

Package Manager können Benutzer auf das Ultramarine-Design in AEM Forms zugreifen, indem sie zu Forms > Designs > Referenzthemen > Ultramarine-Accessible navigieren.

Ultramarine-Design

Konfigurationsoptionen

Benutzer haben die Möglichkeit, verschiedene Workflow-Dienstoptionen zu konfigurieren, darunter die folgenden:

  1. Microsoft Dynamics-Einstieg
  2. Adobe Sign
  3. AEM Benutzerdefinierte Kommunikationsverwaltung
  4. Adobe Analytics

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

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

  2. Suchen Sie die WeGov-Konfigurationen.

  3. Öffnen Sie die Dienstdefinition und aktivieren Sie den Aufruf der ausgewählten Dienste innerhalb des Workflows.

    HINWEIS

    Nur weil ein Benutzer den Dienst auf der Seite "Configuration Manager"aktiviert, müssen Benutzer weiterhin eine Dienstkonfiguration einrichten, um mit den angeforderten externen Diensten kommunizieren zu können.

    Wir gov Forms-Paket

  4. Klicken Sie anschließend auf die Schaltfläche Speichern , um die Einstellungen zu speichern.

Nächste Schritte

Jetzt können Sie alle die Referenz-Site "We.Gov"durchsuchen. Weitere Informationen zum Workflow und den Schritten der We.Gov-Referenz-Website finden Sie unter Schrittweise Anleitung zur We.Gov-Referenz-Website.

Auf dieser Seite