Einrichten und Konfigurieren der Referenzseite "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 auf den 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-ANBIETER DIENSTVERSION 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:

  • Es wird erwartet, dass das Paket auf einem sauberen Server installiert wird, der frei von anderen Demopaketen oder älteren Demopaketversionen ist
  • Das Paket wird voraussichtlich auf einem OSGI-Server installiert und im Autorenmodus ausgeführt

Was beinhaltet 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 umfasst 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, Beispielbenutzer, Workflow-Modelle usw.

      • we-gov-forms.core-<version>.jar - Enthält alle OSGI-Dienste, Implementierung benutzerdefinierter Arbeitsablaufschritte usw.

      • we-gov-forms.derby<version>.jar - Enthält alle OSGI-Dienste, Datenbank-Schema usw.

      • core.wcm.components.all-2.0.4.zip - Auflistung von WCM-Beispielkomponenten

      • grid-aem.ui.apps-1.0-SNAPSHOT.zip - AEM Sites-Rasterlayoutpaket für Seitenspaltensteuerung für Sites

    • we-gov-forms.ui.content-<version>.zip - Enthält alle Inhalte, Seiten, Bilder, Formulare, interaktiven Kommunikationselemente 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 Standardkonfigurationsknoten einschließlich Platzhalter-Cloud-Konfigurationen, um Formulardatenmodelle und Service-Bindungsprobleme zu vermeiden.

Zu den in diesem Paket enthaltenen Assets gehören:

  • AEM von Seiten mit bearbeitbaren Vorlagen
  • AEM Forms Adaptives Forms
  • AEM Forms Interactive Communications (Print and Web Kanal)
  • AEM Forms XDP-Dokument aus Datensatz
  • AEM Forms MS Dynamics Forms Datenmodell
  • Adobe Sign-Integration
  • AEM Workflow-Modell
  • AEM Assets-Beispielbilder
  • Beispiel-Apache-Derby-Datenbank (In-Memory-Datenbank)
  • Apache Derby-Datenquelle (zur Verwendung mit dem Formulardatenmodell)

Installation des Demopakets

Dieser Abschnitt enthält Informationen zum Installieren des Demopakets.

Von der 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 die Ergebnisse auch mit der Option Downloads suchen filtern.
  4. Tippen Sie auf den Paketnamen we-gov-forms.pkg.all-<version>.zip, wählen Sie EULA-Begriffe akzeptieren und tippen Sie auf Herunterladen.

  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. Warten Sie, bis der Installationsprozess abgeschlossen ist.

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

    Paketoption hochladen

  4. Verwenden Sie den Dateibrowser, um zur heruntergeladenen ZIP-Datei zu navigieren und diese 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. Warten Sie, bis der Installationsprozess abgeschlossen ist.

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

Installieren neuer Paketversionen

Gehen Sie wie in 4.1 und 4.2 beschrieben vor, um eine neue Paketversion zu installieren. Es ist möglich, eine neuere Paketversion zu installieren, während ein anderes älteres Paket bereits 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 aus der Dropdownliste die Option "Deinstallieren".

    Deinstallieren des WeGov-Pakets

  5. Wählen Sie bei der Bestätigung erneut "Deinstallieren"und lassen Sie den Deinstallationsprozess abschließen.

Demopaket-Konfiguration

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 stehenden Aufgaben durchzuführen.

  3. Blättern Sie nach unten bis zum Ende der Seite, um alle Benutzergruppen zu laden.

  4. Suchen Sie nach "workflow".

  5. Wählen Sie die Gruppe "workflow-users"und klicken Sie auf "Eigenschaften".

  6. Navigieren Sie zur Registerkarte "Mitglieder".

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

  8. Wählen Sie aus der Dropdownliste "We.Gov Forms Users".

    Bearbeiten von Gruppeneinstellungen für Workflow-Benutzer

  9. Klicken Sie in der Menüleiste auf "Speichern & 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 "Formularbenutzer"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 diesmal die Gruppe "We.Gov Users"als Mitglied hinzufügen.

E-Mail-Serverkonfiguration

  1. Überprüfen Sie die Setup-Dokumentation E-Mail-Benachrichtigung konfigurieren

  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, um eine Verbindung zum SMTP-Server Ihrer Wahl herzustellen:

    1. Hostname des SMTP-Servers: z. B. (smtp.gmail.com)
    2. Serveranschluss: z. B. (465) für Gmail mit SSL
    3. SMTP-Benutzer: 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 zum Konfigurieren 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)

Hinweise:

  1. Navigieren Sie zu https://<aemserver>:<port>/aem/inbox, wo Sie den unter dem Link zur Referenzdokumentation beschriebenen Prozess abschließen können.

  2. Das we-gov-forms.pkg.all-[version].zip-Paket enthält einen SSL-Beispielschlüssel und ein Zertifikat, auf das zugegriffen werden kann, indem der we-gov-forms.pkg.all-[version].zip/ssl-Ordner extrahiert wird, der Teil des Pakets ist.

  3. SSL-Zertifikat und Schlüsseldetails:

    1. herausgegeben an "CN=localhost"
    2. 10-jährige Gültigkeit
    3. password value of "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 eingestellt werden.

  8. Der Anschluss sollte auf einen Anschluss eingestellt sein, der vom System offen gelegt wurde.

(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. Die erforderliche SSL-Konfiguration finden Sie unter AEM SSL-Konfiguration.

  2. Navigieren 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 Adobe Sign OAuth-Umleitungs-URI konfiguriert ist, um Konfigurationsprobleme zu vermeiden (z. https://<aemserver>:<port>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html)

  3. Wählen Sie die Konfiguration "We.gov Adobe Sign".

  4. Klicken Sie auf "Eigenschaften".

  5. Navigieren Sie zur Registerkarte "Einstellungen".

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

  7. Geben Sie die konfigurierte Client-ID und den geheimen Clientschlüssel aus der konfigurierten Adobe Sign-Instanz ein.

  8. Klicken Sie auf "Mit Adobe Sign verbinden".

  9. Klicken Sie nach erfolgreicher Verbindung auf "Speichern & 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. Konfigurieren von Microsoft Dynamics for AEM Forms

MS Dynamics OData Cloud Service

  1. Navigieren 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 mit derselben Umleitungs-URL zugreifen, die in der Registrierung der MS Dynamics-Anwendung konfiguriert ist.
  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 zur Erfassung 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. Authentifizierungskopfzeile - Autorisierungsanbieter
      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.

MS Dynamics Cloud-Konfigurationseinstellungen

Die Schritte, die in diesem Abschnitt beschrieben werden, helfen Ihnen, die Client-ID, den geheimen Clientschlüssel und Details aus Ihrer MS Dynamics Cloud-Instanz zu finden.

  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 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 Antworten-URLs zu konfigurieren.

    1. Diese URL muss mit der URL übereinstimmen, die beim Konfigurieren des OData-Dienstes für den Zugriff auf Ihren AEM-Server verwendet wird.
  7. Klicken Sie in der Ansicht "Einstellungen"auf "Schlüssel", um einen neuen Schlüssel zu erstellen (dieser wird als geheimer Clientschlüssel in AEM verwendet).

    1. Achten Sie darauf, eine Kopie des Schlüssels zu behalten, da Sie nicht in der Lage sein, es später in Azurblaus oder AEM.
  8. Um die Ressourcen-URL/Dienststamm-URL zu suchen, navigieren Sie zum Dashboard MS Dynamics-Instanz.

  9. Klicken Sie in der oberen Navigationsleiste auf "Vertrieb"oder Ihren eigenen Instanztyp und "Einstellungen auswählen".

  10. Klicken Sie unten rechts auf "Anpassungen" und "Entwicklerressourcen".

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

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

  12. Details zur Aktualisieren- und Zugriffstoken-URL finden Sie hier:

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

Testen des Forms-Datenmodells (Dynamics)

Nach Abschluss der Cloud-Konfiguration sollten 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 Microsoft Dynamics CRM FDM" und wählen Sie "Eigenschaften".

    Eigenschaften von Dynamics CRM FDM

  3. Navigieren Sie zur Registerkarte "Quelle aktualisieren".

  4. Stellen Sie sicher, dass die "Context-Aware-Konfiguration"auf "/conf/we-gov"eingestellt ist und dass die konfigurierte Datenquelle "ms-dynamik-odata-cloud-service"lautet.

    Konfigurierte Datenquelle

  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 unbeabsichtigte Änderungen nicht an das Formulardatenmodell weitergegeben werden.

    HINWEIS

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

Testen des Forms-Datenmodells (Derby)

Nach Abschluss der Cloud-Konfiguration sollten Sie das Formulardatenmodell testen.

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

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

    Eigenschaften von Dynamics CRM FDM

  3. Navigieren Sie zur Registerkarte Quelle aktualisieren.

  4. Stellen Sie sicher, dass die Context-Aware-Konfiguration auf /conf/we-gov eingestellt ist und dass die konfigurierte Datenquelle We.Gov Derby DS lautet.

    Eigenschaften von 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 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-Dienstkonfiguration

Dieses Paket ist für die Verbindung mit Adobe Analytics vorkonfiguriert. Die folgenden Schritte werden zur Aktualisierung dieser Konfiguration bereitgestellt.

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

  2. Suchen Sie im Abschnitt "Adobe Analytics"den Link "Konfigurationen anzeigen".

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

    Konfiguration des Analytics-Cloud-Dienstes

  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 "Verbindung zu Analytics herstellen", 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 Authoring zu aktivieren).

Adobe Analytics mit 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.
    • Anmelden mit Ihren Administratoranmeldeinformationen
  2. Wählen Sie im Hauptmenü das Symbol Adobe Analytics aus.
    Schnellzugriff
  3. Navigieren Sie zur Registerkarte "Admin"und wählen Sie das Element "Benutzerverwaltung (Legacy)"aus.
    Berichte
  4. Wählen Sie die Registerkarte Benutzer.
    Benutzerverwaltung
  5. Wählen Sie in der Liste der Benutzer den gewünschten Benutzer aus.
  6. Blättern 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 Shared-Secret-Informationen werden auf der rechten Seite des Berechtigungsfelds 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 Name der Firma.
    • Hier ein Beispiel: Benutzername: Name der Firma

Einrichten der Benutzerauthentifizierung in Adobe Analytics

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

  1. Navigieren Sie zum Adobe Admin Console.

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

    • Dieser befindet sich auf der Hauptseite der Admin-Seite.
  3. Wählen Sie Analytics mit vollem Administratorzugriff.

  4. hinzufügen einem Benutzer zum Profil.

    Vollständiger Admin-Zugriff in Analytics

  5. Klicken Sie auf die Registerkarte "Berechtigungen", nachdem die Benutzer-ID dem Profil zugeordnet wurde.

  6. Vergewissern Sie sich, dass dem Profil alle Berechtigungen zugeordnet sind.

    Berechtigungen bearbeiten

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

Adobe Analytics Berichte

Ansicht Adobe Analytics Sites Berichte

HINWEIS

AEM Forms Analytics-Daten sind im 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 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", um die Seiten der Website Ansicht.

  3. Wählen Sie eine der Siteseiten (z.B. Home) und wählen Sie "Analytics & Recommendations".

    Analyse und Recommendations

  4. Auf dieser Seite sehen Sie Informationen aus Adobe Analytics, die zur Seite AEM Sites gehören (Hinweis: Diese Informationen werden von Adobe Analytics regelmäßig aktualisiert und nicht in Echtzeit angezeigt.

    AEM Sites Analyse

  5. Zurück auf der Seite "Ansicht"(Zugriff in Schritt 3) können Sie die Seiteninformationen auch durch Ändern der Anzeigeeinstellung in "Ansicht"-Elemente in der Ansicht "Liste" Ansicht der Ansicht ändern.

  6. Suchen Sie das Dropdown-Menü "Ansicht"und wählen Sie "Liste Ansicht".

    Listenansicht

  7. Wählen Sie im gleichen Menü die Option "Ansicht einstellen"und wählen Sie die anzuzeigenden Spalten im Bereich "Analytics"aus.

    Spalten konfigurieren

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

    Anzeige neuer Spalten

Ansicht Adobe Analytics Forms Berichte

HINWEIS

AEM Forms Analytics-Daten sind im 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 ist jedoch eine aktive Cloud-Konfiguration erforderlich.

  1. Navigieren Sie zu

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

  2. Wählen Sie das adaptive Formular "Registrierungsantrag für Gesundheitsvorteile"und dann die Option "Analytics-Bericht".

    Analytics-Bericht

  3. Warten Sie, bis die Seite geladen wurde, und Ansicht der Analytics-Berichtsdaten.

    Ansicht Analytics-Berichtsdaten

Adobe-Automatisierte Forms-Konfigurationsaktivierung

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

  1. Zugang zu Adobe I/O.

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

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

Bitte lesen Sie die folgenden Hinweise, bevor Sie weitere Anweisungen lesen:

Erstellen einer IMS-Konfiguration Teil 1

Um den Dienst für eine korrekte Kommunikation mit dem Formular-Konvertierungstool zu konfigurieren, müssen die Benutzer den Dienst Identity Management System (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 > Security > Adobe IMS Configuration.

  2. Klicken Sie auf Erstellen.

  3. Führen Sie die Aktionen in der Abbildung unten durch.

    Konfiguration des technischen IMS-Kontos

  4. Laden Sie das Zertifikat unbedingt herunter.

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

HINWEIS

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

Integration in Adobe I/O

Vergewissern Sie sich, 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-Konsole.

  2. Klicken Sie auf Integration erstellen.

  3. Wählen Sie Zugriff auf eine API.

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

  5. Wählen Sie im Bereich Experience Cloud das Forms-Konvertierungstool.

  6. Klicken Sie auf Weiter.

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

  8. Mit dem öffentlichen Schlüssel aus Abschnitt 2.1 fügen Sie ihn in die Integration des Schlüssels ein.

  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, können wir die Installation der IMS-Konfiguration abschließen.

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

  2. Navigieren Sie zu Ihrer IMS-Konfiguration in AEM ("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 geheimen Clientschlüssel ein (muss auf der Integration in Adobe I/O offen legen klicken, damit er angezeigt wird).

  7. Klicken Sie in Adobe I/O auf die Registerkarte JWT, um die JWT-Nutzlast abzurufen und in die Nutzlast der IMS-Konfiguration einzufügen.

    Payload-IMS-Konfiguration

  8. Nach der Erstellung klicken Sie auf die IMS-Konfiguration und wählen Sie Health Check aus. Benutzer sollten das folgende Ergebnis sehen.

    Gesundheitsbestätigung

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

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://<domain_name>:<system_port>

  2. Klicken Sie in der oberen linken Ecke des Bildschirms auf Adobe Experience Manager > Extras > Cloud Services > Automatisierte Forms-Konversationskonfiguration.

  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 in den Screenshot unten ein.

    AFC-Produktion

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

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

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

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

  10. Klicken Sie auf Weiter.

  11. Für diese Konfiguration bleiben die beiden Kontrollkästchenwerte leer.

Konfigurieren der Cloud-Konfiguration (We.Finance AFC Production)

Sobald die IMS-Konfiguration abgeschlossen ist, können wir die Cloud-Konfiguration in AEM erstellen.

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

  2. Klicken Sie in der oberen linken Ecke des Bildschirms auf Adobe Experience Manager > Extras > Cloud Services > Automatisierte Forms-Konversationskonfiguration.

  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 in den Screenshot unten ein.

    We.Finance AFC Production

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

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

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

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

  10. Klicken Sie auf Weiter.

  11. Für diese Konfiguration bleiben die beiden Kontrollkästchenwerte leer.

Testen der Formularumrechnung (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://<domain_name>:<system_port>

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

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

  4. Klicken Sie oben rechts auf die Schaltfläche Beginn Automatisierte Konversion.

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

    Konvertiertes adaptives Formular

  6. Nach Auswahl der Schaltfläche werden den Benutzern die folgenden Optionen angezeigt

    • Stellen Sie sicher, dass die Benutzer die Konfiguration We.Gov AFC Production auswählen

    Konvertierungseinstellungen

    Erweiterte Konvertierungseinstellungen

  7. Wählen Sie die Konvertierung des Beginns aus, nachdem Sie alle gewünschten Optionen konfiguriert haben.

  8. Wenn der Konvertierungsprozess beginnt, sollte den Benutzern der folgende Bildschirm angezeigt werden:

    Konvertierungseinstellungen

  9. Nach Abschluss der Konvertierung wird dem Benutzer der folgende Bildschirm angezeigt:

    Konvertiertes adaptives Formular

    Klicken Sie auf den Ordner Output, um das erstellte adaptive Formular Ansicht.

Bekannte Probleme und Hinweise

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

  1. Generieren Sie das Formular mit aktivierten Generate adaptive form(s) without data bindings, wenn Sie das Formular nach der Konvertierung an ein FDM binden möchten.

  2. Vergewissern Sie sich, dass im Vorlagenordner die Berechtigung "jcr:read"aktiviert ist. Andernfalls kann der Dienstbenutzer die Vorlage nicht aus dem Repository lesen, und die Konvertierung schlägt fehl.

Anpassung des Demopakets

Dieser Abschnitt enthält Anweisungen zur Anpassung der Demo.

Vorlagenanpassung

Bearbeitbare Vorlagen finden Sie unter:

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 werden, die Sie finden unter:

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

Stilsystem

Auf dieser Website finden Sie auch Client-Bibliotheken, von denen einer 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 in diesem Paket enthaltenen bearbeitbaren Vorlagen sind auch mit Vorlagen-/Seitenrichtlinien vorkonfiguriert, die die CSS-Klassen von Bootstrap 4 für Paginierung, Formatierung usw. verwenden. Nicht alle Klassen wurden den Vorlagenrichtlinien hinzugefügt, aber alle Klassen, die von Bootstrap 4 unterstützt werden, können 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

Vorlagenlogos

Die DAM Assets des Projekts enthalten auch We.Gov-Logos und -Bilder. Diese Assets sind verfügbar unter:

https://<aemserver>:<port>/assets.html

Beim Bearbeiten der Seiten- und Formularvorlagen können Sie die Markenlogos durch Bearbeiten der Komponenten Navigation und Fußzeile aktualisieren. Diese Komponenten Angebot eines konfigurierbaren Dialogfelds für Marke und Logo, mit dem Logos aktualisiert werden können:

Vorlagen-Logos

Weitere Informationen finden Sie unter Bearbeiten von Seiteninhalten:

Bearbeiten des Seiteninhalts

Seiten-Anpassung

Alle Siteseiten stehen zur Verfügung unter: https://<aemserver>:<port>/sites.html/content/we-gov

Diese Siteseiten nutzen auch das AEM-Rasterpaket, 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 auch unter Templates customization style system.

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 Verwendungsfälle angepasst werden. Beachten Sie, dass bestimmte Felder und Übermittlungslogik nicht geändert werden sollten, um sicherzustellen, dass das Formular weiterhin korrekt funktioniert. Hierzu gehört Folgendes:

Antrag auf Zulassung von Gesundheitsleistungen:

  • contact_id - Ausgeblendetes Feld, das zum Empfangen der MS Dynamics-Kontakt-ID während der Übermittlung verwendet wird
  • Senden - Für die Logik der Senden-Schaltfläche ist eine Anpassung erforderlich, um Rückrufe zu unterstützen. Die Anpassung ist dokumentiert, es war jedoch ein umfangreiches Skript erforderlich, um das Formular zu senden und gleichzeitig eine POST und GET über das Forms-Datenmodell an MS Dynamics durchzuführen.
  • Stammebene - Das Ereignis Initialisieren wird verwendet, um dem AEM-Posteingang eine MS Dynamics-Schaltfläche hinzuzufügen, die so wenig wie möglich eingreift, da alle Inbox-Granite-UI-Komponenten nicht verändert werden können.

Adaptiver Formularstil

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

Workflow-Anpassung

Das adaptive Registrierungsformular wird zur Verarbeitung an einen OSGI-Workflow gesendet. Dieser Arbeitsablauf 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 allgemeine Schritte erstellt und nicht mit Konfigurationsdialogen 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 Demo-Funktionen und Designentscheidungen, die während des Demonstrationsprozesses besondere Überlegungen erfordern können.

Überlegungen zur Demo

  • Stellen Sie gemäß AGRS-159 sicher, dass der Name (erster, mittlerer und letzter) des Kontakts, der im adaptiven Registrierungsformular verwendet wird, eindeutig ist.
  • Das adaptive Registrierungsformular sendet die Adobe Sign-E-Mail an die im E-Mail-Feld des Formulars angegebene E-Mail-Adresse. Diese E-Mail-Adresse darf nicht mit der E-Mail-Adresse übereinstimmen, mit der die Adobe Sign-Cloud-Konfiguration konfiguriert wurde.

Bekannte Probleme

  • (AGRS-120) Die Komponente "Site-Navigation"unterstützt derzeit keine verschachtelten untergeordneten Seiten mit einer Tiefe von mehr als 2 Ebenen.
  • (AGRS-159) Der aktuelle MS Dynamics FDM muss zunächst zwei Vorgänge durchführen, um die Daten des adaptiven Formulars für die Registrierung auf Dynamics POST und dann den Benutzerdatensatz abzurufen, um die Kontakt-ID abzurufen. In ihrem aktuellen Zustand schlägt das Abrufen der Kontakt-ID fehl, wenn in Dynamics mehr als zwei Benutzer mit demselben Namen vorhanden sind. Dies verhindert, dass das adaptive Registrierungsformular gesendet werden kann.

Konfigurieren der Barrierefreiheitsprüfung

Aktivieren der Barrierefreiheitsprüfung von Chrome Hinzufügen

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

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 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 Audits Registerkarte. Dort können Entwickler den Typ der Prüfung auswählen, die vom Plugin für Ein-/Ausgabehilfe durchgeführt werden soll. Nachdem alle gewünschten Optionen ausgewählt wurden, kann der Benutzer die Schaltfläche Bericht erstellen auswählen. Dadurch wird ein PDF-Dokument generiert, das die Gesamteinstiegsberechtigung und die zur Verbesserung der Barrierefreiheit insgesamt verwendbaren Werte anzeigt.

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

Zugänglichkeitsbericht

Die Anzahl, die vor den Benutzern angezeigt wird, ist die Gesamtzahl der Zugriffsberechtigungen, die sie erworben haben. Es gibt auch eine Beschreibung, wie dies nach dem Ergebnis berechnet wurde.

Wenn Sie diese Datei exportieren möchten, können Sie auf die drei Schaltflächen rechts neben dem Bildschirm klicken und aus den weiteren Optionen auswählen, die das Plugin Angebot.

Zugänglichkeitsbericht

Ultramarine-Design

Das öffentlich zugängliche Ultramarine-Thema, das von der Adobe gepflegt wird, ist in der
we-gov-forms.pkg.all-<version>.zip installierbare ZIP-Datei. Sobald dieses Paket mit CRX installiert wurde.

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

Ultramarine-Design

Konfigurationsoptionen

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

  1. Microsoft Dynamics Entry
  2. Adobe Sign
  3. AEM benutzerdefiniertes Kommunikationsmanagement
  4. Adobe Analytics

Damit sie im Workflow aktiviert werden können, müssen die Benutzer die folgenden Aufgaben ausführen.

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

  2. Suchen Sie die Konfigurationen WeGov.

  3. Öffnen Sie die Dienstdefinition und aktivieren Sie den Aufruf der ausgewählten Dienste im Workflow.

    HINWEIS

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

    wir gov Forms-Paket

  4. Klicken Sie nach Abschluss des Vorgangs auf die Schaltfläche Speichern, um die Einstellungen zu speichern.

Nächste Schritte

Jetzt sind Sie alle bereit, die Web.Gov Referenz-Website zu erkunden. Weitere Informationen über den Arbeitsablauf und die Schritte der Web.Gov-Referenz-Website finden Sie unter Wir.Gov-Referenz-Website - Umgehungslösung.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free