Arbeiten mit einem Formulardatenmodell (FDM) work-with-form-data-model

Version
Artikel-Link
AEM 6.5
Hier klicken
AEM as a Cloud Service
Dieser Artikel

data-integration

Der Editor für Formulardatenmodelle (FDM) bietet eine intuitive Benutzeroberfläche sowie Tools zum Bearbeiten und Konfigurieren eines Formulardatenmodells (FDM). Mithilfe des Editors können Sie Datenmodellobjekte, Eigenschaften und Dienste aus verknüpften Datenquellen im Formulardatenmodell (FDM) hinzufügen und konfigurieren. Darüber hinaus können Sie Datenmodellobjekte und -eigenschaften ohne Datenquellen erstellen und später mit den entsprechenden Datenmodellobjekten und -eigenschaften verknüpfen. Sie können auch Beispieldaten für Datenmodellobjekteigenschaften generieren und bearbeiten, die Sie zum Vorbefüllen adaptiver Formulare während der Vorschau verwenden können. Sie können Datenmodellobjekte und Dienste testen, die in einem Formulardatenmodell (FDM) konfiguriert sind, um sicherzustellen, dass sie ordnungsgemäß in Datenquellen integriert sind.

Wenn Sie mit der Forms-Datenintegration noch nicht vertraut sind und keine Datenquelle konfiguriert oder kein Formulardatenmodell (FDM) erstellt haben, sehen Sie sich die folgenden Themen an:

Weitere Details zu verschiedenen Aufgaben und Konfigurationen, die Sie mit dem Formulardatenmodelleditor durchführen können, finden Sie im Folgenden.

NOTE
Sie müssen Mitglied der beiden Gruppen fdm-author und forms-user sein, um Formulardatenmodelle (FDM) erstellen und verwenden zu können. Wenden Sie sich an Ihre Experience Manager-Admins, um Mitglied der Gruppen zu werden.

Hinzufügen von Datenmodellobjekten und Services add-data-model-objects-and-services

Nachdem Sie ein Formulardatenmodell (FDM) mit Datenquellen erstellt haben, können Sie mit dem Formulardatenmodelleditor Datenmodellobjekte und Dienste hinzufügen, deren Eigenschaften konfigurieren, Verknüpfungen zwischen Datenmodellobjekten erstellen und das Formulardatenmodell (FDM) sowie die Dienste testen.

Sie können Datenmodellobjekte und Dienste aus verfügbaren Datenquellen zum Formulardatenmodell (FDM) hinzufügen. Dabei werden hinzugefügte Datenmodellobjekte auf der Registerkarte „Modell“ und hinzugefügte Services auf der Registerkarte „Services“ angezeigt.

Hinzufügen von Datenmodellobjekten und Services:

  1. Melden Sie sich bei der Experience Manager-Autoreninstanz an, navigieren Sie zu Formulare > Datenintegrationen und öffnen Sie das Formulardatenmodell (FDM), zu dem Sie Datenmodellobjekte hinzufügen möchten.

  2. Erweitern Sie im Bereich „Datenquellen“ die Datenquellen, um verfügbare Datenmodellobjekte und Dienste anzuzeigen.

  3. Wählen Sie Datenmodellobjekte und Dienste aus, die Sie zum Formulardatenmodell (FDM) hinzufügen möchten, und wählen Sie dann Ausgewählte hinzufügen.

    selected-objects

    Ausgewählte Datenmodellobjekte und Services

    Auf der Registerkarte Modell wird eine grafische Darstellung aller Datenmodellobjekte und ihrer Eigenschaften angezeigt, die zum Formulardatenmodell (FDM) hinzugefügt wurden. Jedes Datenmodellobjekt wird durch ein Feld im Formulardatenmodell (FDM) dargestellt.

    model-tab

    Registerkarte Modell mit hinzugefügten Datenmodellobjekten

    note note
    NOTE
    Sie können die Datenmodellobjektfelder durch Ziehen im Inhaltsbereich anordnen. Alle im Formulardatenmodell (FDM) hinzugefügten Datenmodellobjekte sind im Bereich „Datenquellen“ ausgegraut.

    Auf der Registerkarte Services wird eine Liste der hinzugefügten Services angezeigt.

    services-tab

    Registerkarte Services mit Datenmodell-Services

    note note
    NOTE
    Das OData-Service-Metadatendokument enthält außer den Datenmodellobjekten und Services Navigationseigenschaften, die die Verknüpfung zwischen zwei Datenmodellobjekten definieren. Weitere Informationen finden Sie unter Arbeiten mit Navigationseigenschaften von OData-Services.
  4. Wählen Sie Speichern aus, um das Formularmodellobjekt zu speichern.

    note note
    NOTE
    Sie können die auf der Registerkarte „Dienste“ eines Formulardatenmodells (FDM) konfigurierten Dienste mithilfe von Regeln für adaptive Formulare aufrufen. Die konfigurierten Services sind in der Aktion zum Aufrufen von Services im Regeleditor verfügbar. Weitere Informationen zum Verwenden dieser Services in Regeln für adaptive Formulare finden Sie unter „Aufrufen von Services und Festlegen von Werten für Regeln“ im Regeleditor.

Erstellen von Datenmodellobjekten und untergeordneten Eigenschaften create-data-model-objects-and-child-properties

Erstellen von Datenmodellobjekten create-data-model-objects

Sie können zwar Datenmodellobjekte aus konfigurierten Datenquellen hinzufügen, aber auch Datenmodellobjekte oder Entitäten ohne Datenquellen erstellen. Dies ist insbesondere dann hilfreich, wenn Sie in dem Formulardatenmodell (FDM) keine Datenquellen konfiguriert haben.

So erstellen Sie ein Datenmodellobjekt ohne Datenquellen:

  1. Melden Sie sich bei der Experience Manager-Autoreninstanz an, navigieren Sie zu Formulare > Datenintegrationen und öffnen Sie das Formulardatenmodell (FDM), in dem Sie ein Datenmodellobjekt oder eine Entität erstellen möchten.

  2. Wählen Sie Entität erstellen.

  3. Geben Sie im Dialog Datenmodell erstellen einen Namen für das Datenmodell ein und wählen Sie Hinzufügen. Ein Datenmodellobjekt wird zum Formulardatenmodell (FDM) hinzugefügt. Das neu hinzugefügte Datenmodellobjekt ist nicht an eine Datenquelle gebunden und weist keine Eigenschaften auf, wie in folgender Abbildung dargestellt.

    new-entity

Als Nächstes können Sie untergeordnete Eigenschaften zu ungebundenen Datenmodellobjekten hinzufügen.

Hinzufügen von untergeordneten Eigenschaften child-properties

Mit dem Formulardatenmodelleditor können Sie untergeordnete Eigenschaften in einem Datenmodellobjekt erstellen. Die Eigenschaft ist bei der Erstellung an keine Eigenschaft in einer Datenquelle gebunden. Sie können die untergeordnete Eigenschaft später mit einer anderen Eigenschaft im enthaltenen Datenmodellobjekt verknüpfen.

Erstellen einer untergeordneten Eigenschaft:

  1. Wählen Sie in einem Formulardatenmodell ein Datenmodellobjekt und dann Untergeordnete Eigenschaft erstellen aus.

  2. Geben Sie im Dialogfeld Untergeordnete Eigenschaft erstellen unter Name und Typ einen Namen bzw. einen Datentyp für die Eigenschaft an. Sie können optional einen Titel und eine Beschreibung für die Eigenschaft angeben.

  3. Aktivieren Sie die Option „Berechnet“, wenn die Eigenschaft eine berechnete Eigenschaft ist. Der Wert einer berechneten Eigenschaft wird anhand einer Regel oder eines Ausdrucks ausgewertet. Weitere Informationen finden Sie unter Bearbeiten von Eigenschaften.

  4. Wenn das Datenmodellobjekt an eine Datenquelle gebunden ist, wird die hinzugefügte untergeordnete Eigenschaft automatisch an die Eigenschaft des übergeordneten Datenmodellobjekts mit demselben Namen und Datentyp gebunden.

    Um eine untergeordnete Eigenschaft manuell mit einer Datenmodellobjekteigenschaft zu verknüpfen, wählen Sie das Symbol zum Durchsuchen neben dem Feld Bindungsverweis aus. Im Dialogfeld Objekt auswählen sind alle Eigenschaften des übergeordneten Datenmodellobjekts aufgeführt. Wählen Sie eine Eigenschaft aus, an die gebunden werden soll, und dann das Häkchensymbol. Beachten Sie, dass Sie nur eine Eigenschaft desselben Datentyps wie die untergeordnete Eigenschaft auswählen können.

  5. Wählen Sie Fertig, um die untergeordnete Eigenschaft zu speichern, und dann Speichern, um das Formulardatenmodell (FDM) zu speichern. Die untergeordnete Eigenschaft wird jetzt zum Datenmodellobjekt hinzugefügt.

Nachdem Sie Datenmodellobjekte und -eigenschaften erstellt haben, können Sie weiterhin adaptive Formulare auf Grundlage des Formulardatenmodells (FDM) erstellen. Wenn später Datenquellen verfügbar und konfiguriert sind, können Sie das Formulardatenmodell (FDM) mit Datenquellen verknüpfen. Die Bindung wird in zugeordneten adaptiven Formularen automatisch aktualisiert . Weitere Informationen zum Erstellen adaptiver Formulare mithilfe des Formulardatenmodells (FDM) finden Sie unter Verwenden eines Formulardatenmodells.

Binden von Datenmodellobjekten und -eigenschaften bind-data-model-objects-and-properties

Wenn die Datenquellen, die Sie in das Formulardatenmodell (FDM) integrieren möchten, verfügbar sind, können Sie sie zum Formulardatenmodell (FDM) hinzufügen, wie in Aktualisieren von Datenquellen beschrieben. Gehen Sie dann wie folgt vor, um die ungebundenen Datenmodellobjekte und -eigenschaften zu binden:

  1. Wählen Sie im Formulardatenmodell die ungebundene Datenquelle aus, die Sie an eine Datenquelle binden möchten.

  2. Wählen Sie Eigenschaften bearbeiten aus.

  3. Wählen Sie im Bedienfeld Eigenschaften bearbeiten das Symbol zum Durchsuchen neben dem Feld Bindung aus. Dadurch öffnet sich das Dialogfeld Objekt auswählen mit den Datenquellen, die zum Formulardatenmodell (FDM) hinzugefügt wurden.

    select-object

  4. Erweitern Sie die Datenquellenstruktur, wählen Sie ein Datenmodellobjekt aus, an das Sie eine Bindung herstellen möchten, und wählen Sie das Häkchensymbol aus.

  5. Wählen Sie Fertig aus, um die Eigenschaften zu speichern, und wählen Sie dann Speichern aus, um das Formulardatenmodell zu speichern. Das Datenmodellobjekt ist jetzt an eine Datenquelle gebunden. Beachten Sie, dass das Datenmodellobjekt nicht mehr als ungebunden markiert ist.

    bound-model-object

Konfigurieren von Services configure-services

Um Daten für ein Datenmodellobjekt zu lesen und zu schreiben, gehen Sie folgendermaßen vor, um Lese- und Schreib-Services zu konfigurieren:

  1. Wählen Sie das Kontrollkästchen am oberen Rand des Datenmodellobjekts und dann Eigenschaften bearbeiten aus.

    edit-properties

    Bearbeiten von Eigenschaften, um Lese- und Schreib-Services für Datenmodellobjekte zu konfigurieren

    Der Dialog Eigenschaften bearbeiten wird geöffnet.

    edit-properties-2

    Dialog „Eigenschaften bearbeiten“

    note note
    NOTE
    Das OData-Service-Metadatendokument enthält außer den Datenmodellobjekten und Services Navigationseigenschaften, die die Verknüpfung zwischen zwei Datenmodellobjekten definieren. Wenn Sie eine OData-Dienst-Datenquelle zu einem Formulardatenmodell (FDM) hinzufügen, steht im Formulardatenmodell (FDM) ein Dienst für alle Navigationseigenschaften in einem Datenmodellobjekt zur Verfügung. Mithilfe dieses Service können Sie die Navigationseigenschaften des entsprechenden Datenmodellobjekts lesen.
    Weitere Informationen zur Verwendung des Service finden Sie unter Arbeiten mit Navigationseigenschaften von OData-Services.
  2. Wechseln Sie zu Objekt auf oberster Ebene, um anzugeben, ob das Datenmodellobjekt ein Modellobjekt der obersten Ebene ist.

    Datenmodellobjekte, die in einem Formulardatenmodell (FDM) konfiguriert sind, stehen auf der Registerkarte „Datenmodellobjekte“ im Inhaltsbrowser für adaptive Formulare zur Verfügung, die auf dem Formulardatenmodell (FDM) basieren. Wenn Sie eine Verknüpfung zwischen zwei Datenmodellobjekten hinzufügen, wird das Ziel-Datenmodellobjekt auf der Registerkarte Datenmodellobjekte unter dem Ausgangs-Datenmodellobjekt geschachtelt. Wenn das verschachtelte Datenmodell ein Objekt der obersten Ebene ist, wird es auch separat auf der Registerkarte Datenmodellobjekte angezeigt. Daher werden zwei Einträge davon angezeigt, einer innerhalb und einer außerhalb der geschachtelten Hierarchie, was zu Verwirrung bei Formularautoren führen könnte. Damit das zugeordnete Datenmodellobjekt nur in der verschachtelten Hierarchie angezeigt wird, deaktivieren Sie die Eigenschaft „Objekt der obersten Ebene“.

  3. Wählen Sie Lese- und Schreib-Services für die ausgewählten Datenmodellobjekte aus. Die Argumente für die Services werden angezeigt.

    read-write-services

    Für die Mitarbeiterdatenquelle konfigurierte Lese- und Schreib-Services

  4. Wählen Sie aem_6_3_edit für das Argument des Lesedienstes aus, um dieses an ein Benutzerprofilattribut, ein Anforderungsattribut oder einen Literalwert zu binden, und geben Sie den Bindungswert an.

  5. Wählen Sie Fertig aus, um das Argument zu speichern. Wählen Sie dann erneut Fertig aus, um die Eigenschaften zu speichern, und wählen Sie schließlich Speichern aus, um das Formulardatenmodell (FDM) zu speichern.

Binden von Argumenten des Lese-Service bindargument

Binden Sie das Argument des Lese-Service an ein Benutzerprofilattribut, ein Anforderungsattribut oder einen Literalwert, basierend auf einem Bindungswert. Der Wert wird als Argument an den Service übergeben, um Details abzurufen, die mit dem angegebenen Wert aus der Datenquelle verknüpft sind.

Literalwert literal-value

Wählen Sie Literal aus dem Dropdownmenü Bindung an aus und geben Sie einen Wert in das Feld Bindungswert ein. Die mit dem Wert verknüpften Details werden aus der Datenquelle abgerufen. Verwenden Sie diese Option, um Details abzurufen, die mit einem statischen Wert verknüpft sind.

In diesem Beispiel werden die mit 4367655678 als Wert für das mobilenum-Argument verknüpften Details aus der Datenquelle abgerufen. Die verknüpften Details können beim Übergeben des Werts für ein Mobilnummerargument Eigenschaften wie Kundennamen, Kundenadresse und Ort enthalten.

Literalwert

Benutzerprofilattribut user-profile-attribute

Wählen Sie Benutzerprofilattribut aus dem Dropdownmenü Bindung an aus und geben Sie den Attributnamen in das Feld Bindungswert ein. Die Details des Benutzers, der bei der Experience Manager-Instanz angemeldet ist, werden auf Grundlage des Attributnamens aus der Datenquelle abgerufen.

Der im Feld Bindungswert angegebene Attributname muss den vollständigen Bindungspfad bis zum Attributnamen für den Benutzer enthalten. Öffnen Sie die folgende URL, um auf die Benutzerdetails in CRXDE zuzugreifen:

https://[server-name]:[port]/crx/de/index.jsp#/home/users/

Benutzerprofil

Geben Sie in diesem Beispiel profile.empid im Feld Bindungswert für den grios-Benutzer an.

Bearbeiten eines Arguments

In diesem Beispiel nimmt das Argument id den Wert des Attributs empid des Benutzerprofils und übergibt ihn als Argument an den Lese-Service. Dieser liest es und gibt Werte der zugehörigen Eigenschaften aus dem Mitarbeiter-Datenmodellobjekt für empid zurück, das mit dem angemeldeten Benutzer verknüpft ist.

Anforderungsattribut request-attribute

Verwenden Sie das Anforderungsattribut, um die verknüpften Eigenschaften aus der Datenquelle abzurufen.

  1. Wählen Sie Anforderungsattribut aus dem Dropdownmenü Bindung an aus und geben Sie den Attributnamen in das Feld Bindungswert ein.

  2. Erstellen Sie eine Überlagerung für head.jsp. Um die Überlagerung zu erstellen, öffnen Sie CRX DE und kopieren Sie die Datei https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp nach https://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jsp.

    note note
    NOTE
    • Wenn Sie eine statische Vorlage verwenden, überlagern Sie head.jsp unter:
      /libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
    • Wenn Sie eine bearbeitbare Vorlage verwenden, überlagern Sie die Datei aftemplatedpage.jsp unter:
      /libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp
  3. Legen Sie paramMap für das Anforderungsattribut fest. Fügen Sie beispielsweise folgenden Code in die JSP-Datei im Ordner „Apps“ ein:

    code language-javascript
    <%Map paraMap = new HashMap();
     paraMap.put("<request_attribute>",request.getParameter("<request_attribute>"));
     request.setAttribute("paramMap",paraMap);
    

    Verwenden Sie zum Beispiel folgenden Code, um den Wert von „petid“ aus der Datenquelle abzurufen:

    code language-javascript
    <%Map paraMap = new HashMap();
    paraMap.put("petId",request.getParameter("petId"));
    request.setAttribute("paramMap",paraMap);%>
    

Die Details werden auf Grundlage des in der Anforderung angegebenen Attributnamens aus der Datenquelle abgerufen.

Wenn Sie beispielsweise das Attribut petid=100 in der Anforderung angeben, werden Eigenschaften abgerufen, die mit dem Attributwert aus der Datenquelle verknüpft sind.

Hinzufügen von Verknüpfungen add-associations

In der Regel werden die Datenmodellobjekten in einer Datenquelle mit einander verknüpft. Die Zuordnung kann 1:1 oder 1:n sein. Beispielsweise können einem Mitarbeitenden mehrere abhängige Elemente zugeordnet sein. Dies wird als Eins-zu-Viele-Verknüpfung bezeichnet und in der Form 1:n auf der Linie dargestellt, die die zugeordneten Datenmodellobjekte verbindet. Wenn jedoch eine Verknüpfung einen eindeutigen Mitarbeiternamen für eine gegebene Mitarbeiter-ID zurückgibt, wird dies als Eins-zu-Eins-Verknüpfung bezeichnet.

Wenn Sie verknüpfte Datenmodellobjekte in einer Datenquelle einem Formulardatenmodell (FDM) hinzufügen, werden ihre Verknüpfungen beibehalten und mit Pfeillinien verbunden angezeigt.  In einem Formulardatenmodell (FDM) können Sie Verknüpfungen zwischen Datenmodellobjekten über unterschiedliche Datenquellen hinweg hinzufügen.

NOTE
Vordefinierte Verknüpfungen in einer JDBC-Datenquelle werden im Formulardatenmodell (FDM) nicht beibehalten. Sie müssen sie manuell erstellen.

So fügen Sie eine Verknüpfung hinzu:

  1. Wählen Sie das Kontrollkästchen am oberen Rand des Datenmodellobjekts und dann  Verknüpfung hinzufügen aus. Das Dialogfeld „Verknüpfung hinzufügen“ wird geöffnet.

    add-associated

    note note
    NOTE
    Das OData-Service-Metadatendokument enthält außer den Datenmodellobjekten und Services Navigationseigenschaften, die die Verknüpfung zwischen zwei Datenmodellobjekten definieren. Sie können diese Navigationseigenschaften beim Hinzufügen von Verknüpfungen im Formulardatenmodell (FDM) verwenden. Weitere Informationen finden Sie unter Arbeiten mit Navigationseigenschaften von OData-Services.

    Der Dialog Verknüpfung hinzufügen wird geöffnet.

    add-associated-2

    Dialogfeld „Verknüpfung hinzufügen“

  2. Tun Sie Folgendes im Bereich „Verknüpfung hinzufügen“:

    • Geben Sie einen Titel für die Verknüpfung ein.
    • Wählen Sie den Verknüpfungstyp: Eins-zu-Eins oder Eins-zu-Viele.
    • Wählen Sie das Datenmodellobjekt aus, mit dem verknüpft werden soll.
    • Wählen Sie den Lese-Service, der die Daten aus dem ausgewählten Modellobjekt lesen soll. Das Argument des Lese-Service wird angezeigt. Bearbeiten und ändern Sie das Argument bei Bedarf und binden Sie es an die Eigenschaft des gewünschten Datenmodellobjekts.

    Im folgenden Beispiel ist dependentid das Standardargument für den Lese-Service des Datenmodellobjekts „Angehörige“.

    add-associated-example

    Standardargument für den Lese-Service für „Angehörige“ ist „dependentid“

    Das Argument muss allerdings eine mit dem verknüpfenden Datenmodellobjekt gemeinsame Eigenschaft sein, in diesem Beispiel Employeeid. Daher muss das Argument Employeeid an die Eigenschaft id des Mitarbeiter-Datenmodellobjekts gebunden sein, damit die verknüpften Informationen zu Angehörigen aus dem Datenmodellobjekt für Angehörige abgerufen werden können.

    add-associated-example-2

    Aktualisiertes Argument und Bindung

    Wählen Sie Fertig aus, um das Argument zu speichern.

  3. Wählen Sie Fertig, um die Verknüpfung zu speichern, und wählen Sie dann Speichern aus, um das Formulardatenmodell (FDM) zu speichern.

  4. Wiederholen Sie die Schritte, um nach Bedarf weitere Verknüpfungen zu erstellen.

NOTE
Die hinzugefügte Verknüpfung wird im Feld „Datenmodellobjekt“ mit dem angegebenen Titel und einer Zeile angezeigt, die die verknüpften Datenmodellobjekte miteinander verbindet.
Sie können eine Verknüpfung bearbeiten, indem Sie das Kontrollkästchen neben der Verknüpfung und dann Verknüpfung bearbeiten auswählen.

added-association

Bearbeiten von Eigenschaften properties

Sie können Eigenschaften von Datenmodellobjekten, deren Eigenschaften sowie im Formulardatenmodell (FDM) hinzugefügte Dienste bearbeiten.

So bearbeiten Sie Eigenschaften:

  1. Aktivieren Sie im Formulardatenmodell (FDM) das Kontrollkästchen neben einem Datenmodellobjekt, einer Eigenschaft oder einem Dienst.

  2. Wählen Sie Eigenschaften bearbeiten aus. Der Bereich Eigenschaften bearbeiten für das Modellobjekt, die Eigenschaft oder den Service in der Auswahl wird geöffnet.

    • Datenmodellobjekt: Geben Sie die Lese- und Schreib-Services an und bearbeiten Sie Argumente.

    • Eigenschaft: Geben Sie den Typ, den Untertyp und das Format der Eigenschaft an. Sie können auch angeben, ob die ausgewählte Eigenschaft der Primärschlüssel für das Datenmodellobjekt ist.

    • Service: Geben Sie das Eingabemodellobjekt, den Ausgabetyp und Argumente für den Service an. Bei einem Get-Service können Sie angeben, ob ein Array als Rückgabe erwartet wird.

      edit-properties-service

    Dialog „Eigenschaften bearbeiten“ für einen Get-Service

  3. Wählen Sie Fertig aus, um die Eigenschaften zu speichern, und wählen Sie dann Speichern aus, um das Formulardatenmodell (FDM) zu speichern.

Erstellen berechneter Eigenschaften computed

Eine berechnete Eigenschaft ist diejenige, deren Wert anhand einer Regel oder eines Ausdrucks berechnet wird. Mithilfe einer Regel können Sie den Wert einer berechneten Eigenschaft auf ein Literal, eine Zahl, das Ergebnis eines mathematischen Ausdrucks oder den Wert einer anderen Eigenschaft im Formulardatenmodell (FDM) festlegen.

Beispielsweise können Sie eine berechnete Eigenschaft FullName erstellen, deren Wert ein Ergebnis der Verkettung der vorhandenen Eigenschaften FirstName und LastName ist. Gehen Sie dazu wie folgt vor:

  1. Erstellen Sie eine neue Eigenschaft mit dem Namen FullName, deren Datentyp „Zeichenfolge“ ist.

  2. Aktivieren Sie Berechnet und wählen Sie Fertig, um die Eigenschaft zu erstellen.

    computed

    Die berechnete FullName-Eigenschaft wird erstellt. Beachten Sie, dass das Symbol neben der Eigenschaft darstellt, dass es sich um eine berechnete Eigenschaft handelt.

    calculate-prop

  3. Wählen Sie die FullName-Eigenschaft und dann Regel bearbeiten aus. Ein Regeleditor-Fenster wird geöffnet.

  4. Wählen Sie im Fenster des Regeleditors Erstellen aus. Ein Regelfenster Wert festlegen wird geöffnet.

    Wählen Sie in der Dropdownliste Mathematischer Ausdruck. Weitere verfügbare Optionen sind Formulardatenmodellobjekt und Zeichenfolge.

  5. Wählen Sie im mathematischen Ausdruck FirstName und LastName als erstes bzw. zweites Objekt aus. Wählen Sie plus als Operator.

    Wählen Sie Fertig und dann Schließen aus, um das Regeleditorfenster zu schließen. Die Regel sieht ähnlich der Folgenden aus:

    rule

  6. Wählen Sie im Formulardatenmodell (FDM) Speichern aus. Die berechnete Eigenschaft wird konfiguriert.

Arbeiten mit Navigationseigenschaften von OData-Services work-with-navigation-properties-of-odata-services

In OData-Services werden Navigationseigenschaften verwendet, um Zuordnungen zwischen zwei Datenmodellobjekten zu definieren. Diese Eigenschaften werden für einen Entitätstyp oder einen komplexen Typ definiert. So enthält beispielsweise im folgenden Extract aus der Metadatendatei der TripPin-OData-Beispiel-Services die Entität „Person“ drei Navigationseigenschaften: „Friends“, „BestFriend“ und „Trips“.

Weitere Informationen zu Navigationseigenschaften finden Sie in der OData-Dokumentation.

<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>

Wenn Sie einen OData-Dienst in einem Formulardatenmodell (FDM) konfigurieren, werden alle Navigationseigenschaften in einem Entitäten-Container über einen Dienst im Formulardatenmodell (FDM) bereitgestellt. In diesem Beispiel können im OData-Dienst „TripPin“ die drei Navigationseigenschaften des Entitäten-Containers Person über ein und denselben GET LINK-Dienst im Formulardatenmodell (FDM) gelesen werden.

Im Folgenden wird der Dienst GET LINK of Person /People im Formulardatenmodell (FDM) hervorgehoben. Dies ist ein kombinierter Dienst für die drei Navigationseigenschaften in der Entität Person des OData-Dienstes „TripPin“.

nav-prop-service

Sobald Sie den GET LINK-Dienst auf der Registerkarte „Dienste“ im Formulardatenmodell (FDM) hinzufügen, können Sie die Eigenschaften bearbeiten, um das Modellobjekt für die Ausgabe und die im Dienst zu verwendende Navigationseigenschaft zu wählen. Im folgenden Beispiel nutzt der Service GET LINK of Person /People die Angabe „Trip“ als Ausgabemodellobjekt und die Navigationseigenschaft als „Trips“.

edit-prop-nav-prop

NOTE
Die im Feld Standardwert des Arguments NavigationPropertyName verfügbaren Werte hängen vom Status des Schalters Rückgabe-Array? ab. Wenn er aktiviert ist, werden die Navigationseigenschaften des Sammlungstyps angezeigt.

In diesem Beispiel können Sie auch „Person“ als Ausgabemodellobjekt und als Argument für die Navigationseigenschaft „Friends“ oder „BestFriend“ wählen (abhängig davon, ob Rückgabe-Array? aktiviert oder deaktiviert ist).

edit-prop-nav-prop2

Darüber hinaus können Sie beim Hinzufügen von Verknüpfungen im Formulardatenmodell (FDM) einen GET LINK-Dienst auswählen und die entsprechenden Navigationseigenschaften konfigurieren. Damit eine Navigationseigenschaft ausgewählt werden kann, müssen Sie jedoch darauf achten, dass im Feld Bindung an der Wert Literal eingestellt ist.

add-associated-nav-prop

Beispieldaten generieren und bearbeiten sample

Mit dem Editor für Formulardatenmodelle (FDM) können Sie Beispieldaten für alle Datenmodellobjekt-Eigenschaften, einschließlich berechneter Eigenschaften, in einem Formulardatenmodell (FDM) generieren. Es handelt sich um einen Satz zufälliger Werte, die dem für jede Eigenschaft konfigurierten Datentyp entsprechen. Sie können auch Daten bearbeiten und speichern, die auch dann beibehalten werden, wenn Sie die Beispieldaten neu generieren.

Gehen Sie wie folgt vor, um Beispieldaten zu generieren und zu bearbeiten:

  1. Öffnen Sie ein Formulardatenmodell (FDM) und wählen Sie Beispieldaten bearbeiten. Es werden Beispieldaten im Fenster „Beispieldaten bearbeiten“ generiert und angezeigt.

    Generieren von Musterdaten

  2. Bearbeiten Sie im Fenster Beispieldaten bearbeiten die Daten nach Bedarf und wählen Sie Speichern.

Testen von Datenmodellobjekten und Diensten test-data-model-objects-and-services

Ihr Formulardatenmodell (FDM) ist konfiguriert. Bevor Sie es verwenden, sollten Sie jedoch testen, ob die konfigurierten Datenmodellobjekte und Dienste erwartungsgemäß funktionieren. Testen von Datenmodellobjekten und Diensten

  1. Wählen Sie ein Datenmodellobjekt oder einen Dienst im Formulardatenmodell (FDM) aus und wählen Sie dann Modellobjekt testen bzw. Dienst testen.

    Das Fenster „Formulardatenmodell testen“ wird geöffnet.

    test-data-model

  2. Wählen Sie im Fenster Formulardatenmodell testen unter „Eingabe“ das zu testende Datenmodellobjekt bzw. den Service.

  3. Geben Sie einen Argumentwert im Test-Code an und wählen Sie Testen. Ist der Test erfolgreich, wird die Ausgabe im Bereich „Ausgabe“ angezeigt.

    Testergebnisse

Auf ähnliche Weise können Sie andere Datenmodellobjekte und Dienste im Formulardatenmodell (FDM) testen.

Automatisiertes Validieren von Eingabedaten automated-validation-of-input-data

Das Formulardatenmodell (FDM) validiert Daten, die als Eingabe beim Aufruf der DermisBridge-API empfangen werden (auf Grundlage der im Formulardatenmodell verfügbaren Validierungskriterien). Die Validierung basiert auf dem Flag-Satz ValidationOptions im Abfrageobjekt, das zum Aufrufen der API verwendet wird.

Das Flag kann auf einen der folgenden Werte eingestellt werden:

  • VOLLSTÄNDIG: FDM führt die Validierung anhand aller Begrenzungen durch
  • OFF: Keine Validierung
  • EINFACH: FDM führt die Validierung anhand der Begrenzungen „erforderlich“ und „löschbar“ durch

Wenn für das ValidationOptions-Flag kein Wert festgelegt ist, wird für die Eingabedaten eine EINFACH-Validierung durchgeführt.

Folgendes Beispiel zeigt, was passiert, wenn Sie für das Validierungs-Flag VOLLSTÄNDIG einstellen:

operationOptions.setValidationOptions(ValidationOptions.FULL);
NOTE
Der Wert, den Sie für ein Attribut in den Eingabedaten angeben, muss mit dem Datentyp übereinstimmen, der für das Attribut im Metadatendokument definiert ist.
Wenn der Wert nicht mit dem für das Attribut definierten Datentyp übereinstimmt, zeigt die DermisBridge-API eine Ausnahme an, unabhängig vom Wert des ValidationOptions-Flags. Wenn als Protokollebene „Debuggen“ festgelegt ist, wird ein Fehler in der Datei error.log protokolliert.

Das Formulardatenmodell (FDM) validiert Eingabedaten auf Grundlage einer Liste von Datentypeinschränkungen. Die Liste von Begrenzungen für Eingabedaten kann je nach Datenquelle variieren.

In folgender Tabelle sind die Begrenzungen für Eingabedaten auf Grundlage der Datenquelle aufgeführt:

Begrenzungen
Beschreibung
Eingabedatenquelle
required
Bei Wert „true“ muss der Parameter in die Eingabedaten aufgenommen werden.
Swagger, WSDL und Datenbank
nullable
Bei Wert „true“ kann der Wert für den Parameter in den Eingabedaten auf Null gesetzt werden.
WSDL, OData und Datenbank
maximum
Gibt die Obergrenze für numerische Werte an. Der als Obergrenze angegebene Wert kann auch dem Parameter in den Eingabedaten zugewiesen werden.
Swagger und WSDL
minimum
Gibt die Untergrenze für numerische Werte an. Der als Untergrenze angegebene Wert kann auch dem Parameter in den Eingabedaten zugewiesen werden.
Swagger und WSDL
exclusiveMaximum
Gibt die Obergrenze für numerische Werte an. Der als Obergrenze angegebene Wert darf nicht dem Parameter in den Eingabedaten zugewiesen werden.
Swagger und WSDL
exclusiveMinimum
Gibt die Untergrenze für numerische Werte an. Der als Untergrenze angegebene Mindestwert darf nicht dem Parameter in den Eingabedaten zugewiesen werden.
Swagger und WSDL
minLength
Gibt die Untergrenze für die Anzahl der Zeichen in einer Zeichenfolge an. Der als Untergrenze angegebene Wert kann auch dem Parameter in den Eingabedaten zugewiesen werden.
Swagger und WSDL
maxLength
Gibt die Obergrenze für die Anzahl der Zeichen in einer Zeichenfolge an. Der als Obergrenze angegebene Wert kann auch dem Parameter in den Eingabedaten zugewiesen werden.
Swagger, WSDL, OData und Datenbank
pattern
Gibt eine feste Sequenz an Zeichen an. Die Eingabezeichenfolge wird nur dann erfolgreich validiert, wenn die Zeichen dem angegebenen Muster entsprechen.
Swagger
minItems
Gibt die Mindestanzahl von Elementen in einem Array an. Der als Untergrenze angegebene Wert kann auch dem Parameter in den Eingabedaten zugewiesen werden.
Swagger und WSDL
maxItems
Gibt die maximale Anzahl von Elementen in einem Array an. Der als Obergrenze angegebene Wert kann auch dem Parameter in den Eingabedaten zugewiesen werden.
Swagger und WSDL
uniqueItems
Bei Wert „true“ müssen alle Elemente des Arrays in den Eingabedaten eindeutig sein.
Swagger
enum (string)
Beschränkt den Wert eines Parameters in den Eingabedaten auf einen festen Satz von Zeichenfolgewerten. Es muss sich um ein Array mit mindestens einem Element handeln, wobei jedes Element eindeutig ist.
Swagger, WSDL und OData
enum (number)
Beschränkt den Wert eines Parameters in den Eingabedaten auf einen festen Satz numerischer Werte. Es muss sich um ein Array mit mindestens einem Element handeln, wobei jedes Element eindeutig ist.
WSDL

In diesem Beispiel werden die Eingabedaten anhand der in der Swagger-Datei definierten Begrenzungen „maximum“, „minimum“ und „required“ validiert. Die Eingabedaten erfüllen die Validierungskriterien nur, wenn die Bestellnummer vorhanden ist und einen Wert von 1 bis 10 hat.

   parameters: [
   {
   name: "orderId",
   in: "path",
   description: "ID of pet that must be fetched",
   required: true,
   type: "integer",
   maximum: 10,
   minimum: 1,
   format: "int64"
   }
   ]

Eine Ausnahme wird angezeigt, wenn die Eingabedaten die Validierungskriterien nicht erfüllen. Wenn als Protokollebene Debuggen festgelegt ist, wird ein Fehler in der Datei error.log protokolliert. Beispiel:

21.01.2019 17:26:37.411 *ERROR* com.adobe.aem.dermis.core.validation.JsonSchemaValidator {"errorCode":"AEM-FDM-001-044","errorMessage":"Input validations failed during operation execution.","violations":{"/orderId":["numeric instance is greater than the required maximum (maximum: 10, found: 16)"]}}

Nächste Schritte next-steps

Sie haben ein funktionierendes Formulardatenmodell (FDM), das jetzt für die Verwendung in Workflows für adaptive Formulare bereit ist. Weitere Informationen finden Sie unter Verwenden eines Formulardatenmodells (FDM).

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab