Utilizzare il modello dati del modulo work-with-form-data-model

L’editor FDM (Form Data Model) fornisce un’interfaccia utente e strumenti intuitivi per la modifica e la configurazione di un modello dati modulo (FDM). Utilizzando l’editor, puoi aggiungere e configurare oggetti, proprietà e servizi del modello dati dalle origini dati associate nel modello dati del modulo (FDM). Inoltre, consente di creare oggetti e proprietà del modello dati senza origini dati e di associarli successivamente ai rispettivi oggetti e proprietà del modello dati. È inoltre possibile generare e modificare dati di esempio per le proprietà dell'oggetto modello dati che è possibile utilizzare per precompilare il Forms adattivo durante l'anteprima. Puoi testare gli oggetti e i servizi del modello dati configurati in un modello dati modulo (FDM) per assicurarti che sia correttamente integrato con le origini dati.

Se hai poca esperienza con l’integrazione dei dati in Forms e non hai configurato un’origine dati o creato un modello dati del modulo (FDM), consulta i seguenti argomenti:

Continua a leggere per i dettagli sulle varie attività e configurazioni che puoi eseguire utilizzando l’editor del modello dati modulo.

Aggiungere oggetti e servizi del modello dati add-data-model-objects-and-services

Se è stato creato un modello dati modulo (FDM) con origini dati, è possibile utilizzare l'editor modello dati modulo per aggiungere servizi e oggetti modello dati, configurarne le proprietà, creare associazioni tra oggetti modello dati e testare il modello dati modulo (FDM) e i servizi.

È possibile aggiungere oggetti e servizi modello dati da origini dati disponibili nel modello dati modulo (FDM). Gli oggetti modello dati aggiunti vengono visualizzati nella scheda Modello, mentre i servizi aggiunti vengono visualizzati nella scheda Servizi.

Per aggiungere oggetti e servizi del modello dati:

Creare oggetti modello dati e proprietà figlio create-data-model-objects-and-child-properties

Creare oggetti modello dati create-data-model-objects

Sebbene sia possibile aggiungere oggetti modello dati da origini dati configurate, è anche possibile creare oggetti modello dati o entità senza origini dati. È utile in particolare se non hai configurato le origini dati nel modello dati del modulo (FDM).

Per creare un oggetto modello dati senza origini dati:

Successivamente, puoi aggiungere proprietà secondarie negli oggetti modello dati non associati.

Aggiungi proprietà figlio child-properties

L’editor modello dati modulo consente di creare proprietà secondarie in un oggetto modello dati. La proprietà creata non è associata ad alcuna proprietà in un'origine dati. In seguito, potrai associare la proprietà figlio a un’altra proprietà nell’oggetto modello dati contenitore.

Per creare una proprietà figlio:

Dopo aver creato gli oggetti e le proprietà del modello dati, è possibile continuare a creare il Forms adattivo in base al modello dati del modulo (FDM). Successivamente, quando saranno disponibili e configurate le origini dati, sarà possibile associare il modello dati del modulo (FDM) alle origini dati. Il binding viene aggiornato automaticamente nel Forms adattivo associato . Per ulteriori informazioni sulla creazione di un Forms adattivo tramite il modello dati modulo, vedere Utilizzare il modello dati modulo.

Associare oggetti e proprietà del modello dati bind-data-model-objects-and-properties

Quando le origini dati che si desidera integrare con il modello dati modulo sono disponibili, è possibile aggiungerle al modello dati modulo come descritto in Aggiorna origini dati. Quindi, per associare gli oggetti e le proprietà del modello di dati non associati, effettua le seguenti operazioni:

Configurare i servizi configure-services

Per leggere e scrivere dati per un oggetto modello dati, eseguire le operazioni seguenti per configurare i servizi di lettura e scrittura:

Associa argomenti servizio di lettura bindargument

Associare l'argomento del servizio di lettura a un attributo del profilo utente, a un attributo della richiesta o a un valore letterale basato su un valore di associazione. Il valore viene passato al servizio come argomento per recuperare i dettagli associati al valore specificato dall'origine dati.

Valore letterale literal-value

Selezionare Letterale dal menu a discesa Associazione a e immettere un valore nel campo Valore associazione. I dettagli associati al valore vengono recuperati dall’origine dati. Utilizza questa opzione per recuperare i dettagli associati a un valore statico.

In questo esempio, i dettagli associati a 4367655678, come valore per l'argomento mobilenum, vengono recuperati dall'origine dati. I dettagli associati se si passa il valore per un argomento numero di cellulare possono includere proprietà quali nome cliente, indirizzo cliente e città.

Attributo profilo utente user-profile-attribute

Selezionare Attributo profilo utente dal menu a discesa Associazione a e immettere il nome dell'attributo nel campo Valore associazione. I dettagli dell'utente connesso all'istanza Experience Manager vengono recuperati dall'origine dati in base al nome dell'attributo.

Il nome dell'attributo specificato nel campo Valore di binding deve includere il percorso di binding completo fino al nome dell'attributo dell'utente. Apri il seguente URL per accedere ai dettagli utente su CRXDE:

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

In questo esempio, specificare profile.empid nel campo Valore binding per l'utente grios.

L'argomento id accetta il valore dell'attributo empid del profilo utente e lo trasmette come argomento al servizio di lettura. Legge e restituisce i valori delle proprietà associate dall'oggetto modello dati dipendente per empid associato all'utente connesso.

Richiedi attributo request-attribute

Utilizza l’attributo request per recuperare le proprietà associate dall’origine dati.

I dettagli vengono recuperati dall’origine dati in base al nome dell’attributo specificato nella richiesta.

Ad esempio, specificando l'attributo come petid=100 nella richiesta, vengono recuperate le proprietà associate al valore dell'attributo dall'origine dati.

Aggiungi associazioni add-associations

In genere, esistono associazioni create tra oggetti modello dati in un'origine dati. L’associazione può essere uno a uno o uno a molti. Ad esempio, a un dipendente possono essere associate più persone a carico. È definita associazione uno-a-molti ed è rappresentata da 1:n sulla linea che collega gli oggetti modello dati associati. Tuttavia, se un'associazione restituisce un nome di dipendente univoco per un determinato ID dipendente, viene definita associazione uno-a-uno.

Quando si aggiungono oggetti modello dati associati in un'origine dati a un modello dati modulo (FDM), le relative associazioni vengono mantenute e visualizzate come collegate da linee freccia. È possibile aggiungere associazioni tra oggetti modello dati tra origini dati diverse in un modello dati modulo (FDM).

Per aggiungere un'associazione:

Modifica proprietà properties

È possibile modificare le proprietà degli oggetti modello dati, le relative proprietà e i servizi aggiunti nel modello dati modulo (FDM).

Per modificare le proprietà:

Creare proprietà calcolate computed

Una proprietà calcolata è quella il cui valore viene calcolato in base a una regola o a un'espressione. Utilizzando una regola è possibile impostare il valore di una proprietà calcolata su una stringa letterale, un numero, il risultato di un'espressione matematica o il valore di un'altra proprietà nel modello dati del modulo (FDM).

Ad esempio, puoi creare una proprietà calcolata FullName il cui valore è il risultato della concatenazione delle proprietà esistenti FirstName e LastName. Per eseguire questa operazione:

Utilizzare le proprietà di navigazione dei servizi OData work-with-navigation-properties-of-odata-services

Nei servizi OData, le proprietà di navigazione vengono utilizzate per definire le associazioni tra due oggetti modello dati. Queste proprietà sono definite su un tipo di entità o su un tipo complesso. Ad esempio, nell'estratto seguente dal file di metadati dei servizi di esempio OData TripPin di esempio, l'entità persona contiene tre proprietà di navigazione: Friends, BestFriend e Trips.

Per ulteriori informazioni sulle proprietà di navigazione, vedere la documentazione OData.

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

Quando si configura un servizio OData in un modello dati modulo (FDM), tutte le proprietà di navigazione in un contenitore di entità vengono rese disponibili tramite un servizio nel modello dati modulo (FDM). In questo esempio del servizio OData TripPin, le tre proprietà di navigazione nel contenitore di entità Person possono essere lette utilizzando un servizio GET LINK nel modello di dati del modulo (FDM).

Di seguito viene evidenziato il servizio GET LINK of Person /People nel Form Data Model (FDM), che è un servizio combinato per le tre proprietà di navigazione nell'entità Person del servizio OData TripPin.

Dopo aver aggiunto il servizio GET LINK alla scheda Servizi nel Form Data Model (FDM), è possibile modificare le proprietà per scegliere l'oggetto modello di output e la proprietà di navigazione da utilizzare nel servizio. Ad esempio, il servizio GET LINK of Person /People seguente nell'esempio seguente utilizza Trip come oggetto modello di output e la proprietà di navigazione come Trips.

In questo esempio, è inoltre possibile scegliere l'oggetto modello di output come oggetto Person e l'argomento proprietà di navigazione come Friends o BestFriend (a seconda che l'array Return sia o meno? è abilitato o disabilitato).

Analogamente, è possibile scegliere un servizio GET LINK e configurarne le proprietà di navigazione quando si aggiungono associazioni nel modello di dati del modulo (FDM). Tuttavia, per poter selezionare una proprietà di navigazione, verificare che il campo Associazione a sia impostato su Letterale.

Generare e modificare i dati di esempio sample

L’editor FDM (Form Data Model) consente di generare dati di esempio per tutte le proprietà dell’oggetto modello dati, incluse le proprietà calcolate, in un modello dati modulo. Si tratta di un set di valori casuali conformi al tipo di dati configurato per ogni proprietà. È inoltre possibile modificare e salvare i dati, che vengono mantenuti anche se si rigenerano i dati di esempio.

Per generare e modificare i dati di esempio, effettuare le seguenti operazioni:

Test di servizi e oggetti del modello dati test-data-model-objects-and-services

Il modello dati del modulo (FDM) è configurato, ma prima di metterlo in uso, è possibile verificare se gli oggetti e i servizi del modello dati configurati funzionano come previsto. Per testare gli oggetti e i servizi del modello dati:

Analogamente, è possibile eseguire il test di altri servizi e oggetti del modello dati nel modello dati del modulo (FDM).

Convalida automatica dei dati di input automated-validation-of-input-data

Il Form Data Model (FDM) convalida i dati ricevuti come input durante il richiamo dell’API DermisBridge (in base ai criteri di convalida disponibili nel Form Data Model). La convalida si basa sul flag ValidationOptions impostato nell'oggetto query utilizzato per richiamare l'API.

Il flag può essere impostato su uno qualsiasi dei seguenti valori:

Se non viene impostato alcun valore per il flag ValidationOptions, viene eseguita la convalida BASIC sui dati di input.

Di seguito è riportato un esempio di impostazione del flag di convalida su FULL:

operationOptions.setValidationOptions(ValidationOptions.FULL);

Il modello di dati del modulo convalida i dati di input in base a un elenco di vincoli del tipo di dati. L’elenco dei vincoli per i dati di input può variare in base all’origine dati.

Nella tabella seguente sono elencati i vincoli per i dati di input basati sull'origine dati:

In questo esempio, i dati di input vengono convalidati in base ai vincoli massimi, minimi e obbligatori definiti nel file Swagger. I dati di input soddisfano i criteri di convalida solo se è presente l’ID ordine e il suo valore è compreso tra 1 e 10.

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

Se i dati di input non soddisfano i criteri di convalida, viene visualizzata un'eccezione. Se il livello di registro è impostato su Debug, viene registrato un errore nel file error.log. Ad esempio:

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)"]}}

Passaggi successivi next-steps

Si dispone di un modello di dati del modulo di lavoro (FDM) pronto per l'uso nei flussi di lavoro di Forms adattivi. Per ulteriori informazioni, vedere Utilizzare il modello di dati del modulo (FDM).