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

Versione
Collegamento articolo
AEM as a Cloud Service
Fai clic qui
AEM 6.5
Questo articolo

integrazione dei dati

L’editor del modello per dati modulo fornisce un’interfaccia utente e strumenti intuitivi per la modifica e la configurazione di un modello per dati modulo. Utilizzando l’editor, puoi aggiungere e configurare oggetti, proprietà e servizi del modello dati dalle origini dati associate nel modello dati del modulo. 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 da utilizzare per precompilare moduli adattivi e comunicazioni interattive durante l’anteprima. È possibile testare gli oggetti e i servizi del modello dati configurati in un modello dati del modulo per assicurarsi 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 per moduli, consulta i seguenti argomenti:

Continua a leggere per i dettagli sulle varie attività e configurazioni che puoi eseguire utilizzando l’editor dei modelli di dati dei moduli.

NOTE
Devi essere membro di entrambi fdm-author e forms-user gruppi per creare e utilizzare il modello dati del modulo. Contatta il tuo amministratore AEM per diventare membro dei gruppi.

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

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

È possibile aggiungere oggetti e servizi del modello dati da origini dati disponibili nel modello dati del modulo. 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:

  1. Accedi all’istanza di authoring dell’AEM e passa a Forms > Integrazioni dati e aprire il modello dati del modulo in cui si desidera aggiungere oggetti modello dati.

  2. Nel riquadro Origini dati espandere Origini dati per visualizzare i servizi e gli oggetti modello dati disponibili.

  3. Seleziona gli oggetti e i servizi del modello dati che desideri aggiungere al modello dati del modulo e seleziona Aggiungi selezionati.

    selected-objects

    Servizi e oggetti modello dati selezionati

    note note
    NOTE
    Se il modello dati di Forms contiene un oggetto che è una parola chiave riservata per il database relazionale, può causare problemi di aggiunta, aggiornamento o recupero di dati. Evita quindi di utilizzare tali oggetti nel modello dati del modulo.

    Nella scheda Modello viene visualizzata una rappresentazione grafica di tutti gli oggetti modello dati e delle relative proprietà aggiunti al modello dati del modulo. Ogni oggetto modello dati è rappresentato da una casella nel modello dati del modulo.

    model-tab

    Nella scheda Modello vengono visualizzati gli oggetti modello dati aggiunti

    note note
    NOTE
    È possibile tenere e trascinare le caselle degli oggetti modello dati per organizzarle nell'area del contenuto. Tutti gli oggetti modello dati aggiunti nel modello dati del modulo sono disattivati nel riquadro Origini dati.

    Nella scheda Servizi sono elencati i servizi aggiunti.

    services-tab

    Nella scheda Servizi vengono visualizzati i servizi del modello dati

    note note
    NOTE
    Oltre agli oggetti modello dati e ai servizi, il documento metadati servizio OData include proprietà di navigazione che definiscono l'associazione tra due oggetti modello dati. Per ulteriori informazioni, consulta Utilizzo delle proprietà di navigazione dei servizi OData.
  4. Seleziona Salva per salvare l'oggetto modello modulo.

    note note
    NOTE
    È possibile richiamare i servizi configurati nella scheda Servizi di un modello dati del modulo utilizzando le regole del modulo adattivo. I servizi configurati sono disponibili nell’azione Richiama servizi dell’editor di regole Per ulteriori informazioni sull’utilizzo di questi servizi nelle regole dei moduli adattivi, consulta Richiama servizi e Imposta valore delle regole in editor di regole.

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 soprattutto se non hai configurato le origini dati nel modello dati del modulo.

Per creare un oggetto modello dati senza origini dati:

  1. Accedi all’istanza di authoring dell’AEM e passa a Forms > Integrazioni dati e aprire il modello dati del modulo in cui si desidera creare un oggetto o un'entità modello dati.

  2. Seleziona Crea entità.

  3. Nella finestra di dialogo Crea modello dati, specifica un nome per l’oggetto modello dati e seleziona Aggiungi. Un oggetto modello dati viene aggiunto al modello dati del modulo. L’oggetto modello dati appena aggiunto non è associato a un’origine dati e non dispone di proprietà come mostrato nell’immagine seguente.

    new-entity

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

Aggiungi proprietà figlio child-properties

L’editor del 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:

  1. In un modello dati modulo, seleziona un oggetto modello dati e fai clic su Crea proprietà figlio.

  2. In Crea proprietà figlio , specifica un nome e un tipo di dati per la proprietà nella finestra di dialogo Nome e Tipo rispettivamente. Facoltativamente, puoi specificare un titolo e una descrizione per la proprietà.

  3. Abilita Calcolato se la proprietà è una proprietà calcolata. Il valore di una proprietà calcolata viene valutato in base a una regola o a un'espressione. Per ulteriori informazioni, consulta Modifica proprietà.

  4. Se l’oggetto modello dati è associato a un’origine dati, la proprietà figlio aggiunta viene automaticamente associata alla proprietà dell’oggetto modello dati padre con lo stesso nome e tipo di dati.

    Per associare manualmente una proprietà figlio a una proprietà dell’oggetto modello dati, seleziona l’icona Sfoglia accanto a Riferimento binding campo. Il Seleziona oggetto nella finestra di dialogo sono elencate tutte le proprietà dell’oggetto modello dati principale. Seleziona una proprietà a cui associarti e fai clic sull’icona di spunta. È possibile selezionare solo una proprietà dello stesso tipo di dati della proprietà figlio.

  5. Seleziona Fine per salvare la proprietà figlio e selezionare Salva per salvare il modello dati del modulo. La proprietà figlio viene ora aggiunta all’oggetto modello dati.

Dopo aver creato oggetti e proprietà del modello dati, puoi continuare a creare moduli adattivi e comunicazioni interattive basate sul modello dati del modulo. Successivamente, quando saranno disponibili e configurate le origini dati, sarà possibile associare il modello dati del modulo alle origini dati. Il binding verrà aggiornato automaticamente nei moduli adattivi associati e nelle comunicazioni interattive. Per ulteriori informazioni sulla creazione di moduli adattivi e comunicazioni interattive utilizzando il modello dati del modulo, consulta Usa 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 del modulo sono disponibili, è possibile aggiungerle al modello dati del modulo come descritto in Aggiornare le origini dati. Quindi, per associare gli oggetti e le proprietà del modello di dati non associati, effettua le seguenti operazioni:

  1. Nel modello dati del modulo selezionare l'origine dati non associata che si desidera associare a un'origine dati.

  2. Seleziona Modifica proprietà.

  3. In Modifica proprietà , selezionare l'icona Sfoglia accanto al Binding campo. Apre il Seleziona oggetto finestra di dialogo che elenca le origini dati aggiunte nel modello dati del modulo.

    select-object

  4. Espandi la struttura delle origini dati e seleziona un oggetto modello dati da associare, quindi fai clic sull’icona di spunta.

  5. Seleziona Fine per salvare le proprietà e quindi selezionare Salva per salvare il modello dati del modulo. L’oggetto modello dati è ora associato a un’origine dati. L’oggetto modello dati non è più contrassegnato come Non associato.

    bound-model-object

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:

  1. Seleziona la casella di controllo nella parte superiore di un oggetto modello dati per selezionarlo e quindi Modifica proprietà.

    edit-properties

    Modificare le proprietà per configurare i servizi di lettura e scrittura per un oggetto modello dati

    Viene visualizzata la finestra di dialogo Modifica proprietà.

    edit-properties-2

    Finestra di dialogo Modifica proprietà

    note note
    NOTE
    Oltre agli oggetti modello dati e ai servizi, il documento metadati servizio OData include proprietà di navigazione che definiscono l'associazione tra due oggetti modello dati. Quando si aggiunge un'origine dati del servizio OData a un modello dati del modulo, nel modello dati del modulo è disponibile un servizio per tutte le proprietà di navigazione in un oggetto modello dati. È possibile utilizzare questo servizio per leggere le proprietà di navigazione dell'oggetto modello dati corrispondente.
    Per ulteriori informazioni sull’utilizzo del servizio, consulta Utilizzo delle proprietà di navigazione dei servizi OData.
  2. Attiva/Disattiva Oggetto di primo livello per specificare se l'oggetto modello dati è un oggetto modello di livello superiore.

    Gli oggetti modello dati configurati in un modello dati modulo sono disponibili per l’utilizzo nella scheda Oggetti modello dati nel browser Contenuto di un modulo adattivo basato sul modello dati modulo. Quando si aggiunge un'associazione tra due oggetti modello dati, l'oggetto modello dati a cui si sta effettuando l'associazione viene nidificato sotto l'oggetto modello dati a cui si sta associando nella scheda Oggetti modello dati. Se il modello dati nidificato è un oggetto di livello principale, verrà visualizzato separatamente anche nella scheda Oggetti modello dati. Pertanto, ne verranno visualizzate due voci, una all’interno e un’altra all’esterno della gerarchia nidificata, il che potrebbe confondere gli autori del modulo. Per fare in modo che l'oggetto modello dati associato venga visualizzato solo nella gerarchia nidificata, disattivare la proprietà Oggetto di livello superiore.

  3. Selezionare i servizi di lettura e scrittura per gli oggetti modello dati selezionati. Vengono visualizzati gli argomenti per i servizi.

    read-write-services

    Servizi di lettura e scrittura configurati per l'origine dati dipendente

  4. Seleziona aem_6_3_edit per l'argomento servizio di lettura a associare l’argomento a un attributo del profilo utente, un attributo di richiesta o un valore letterale e specifica il valore di binding.

  5. Seleziona Fine per salvare l'argomento, Fine per salvare le proprietà, quindi Salva per salvare il modello dati del modulo.

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

Seleziona Letterale dal Associazione a e immettere un valore nel campo Valore di binding campo. 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 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à.

Valore letterale

Attributo profilo utente user-profile-attribute

Seleziona Attributo profilo utente dal Associazione a e immettere il nome dell'attributo nel menu a discesa Valore di binding campo. I dettagli dell’utente connesso all’istanza AEM vengono recuperati dall’origine dati in base al nome dell’attributo.

Il nome attributo specificato nel 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/

Profilo utente

In questo esempio, specifica profile.empid nel Valore di binding campo per grios utente.

Modifica argomento

Il id l'argomento assume il valore di empid del profilo utente e trasmetterlo 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.

  1. Seleziona Richiedi attributo dal Associazione a e immettere il nome dell'attributo nel menu a discesa Valore di binding campo.

  2. Creare un sovrapposizione per head.jsp. Per creare la sovrapposizione, aprite CRX DE e copiate la https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp file in https://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jsp

    note note
    NOTE
    • Se utilizzi un modello statico, sovrapponi head.jsp in:
      /libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
    • Se utilizzi un modello modificabile, sovrapponi aftemplatedpage.jsp in:
      /libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp
  3. Imposta paramMap per l’attributo di richiesta. Ad esempio, includi il seguente codice nel file .jsp nella cartella delle app:

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

    Ad esempio, utilizza il codice seguente per recuperare il valore petid dall’origine dati:

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

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

Ad esempio, specificando attributo come petid=100 nella richiesta recupera 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 del modulo, le relative associazioni vengono mantenute e visualizzate come collegate da linee freccia. È possibile aggiungere associazioni tra oggetti modello dati in origini dati diverse in un modello dati modulo.

NOTE
Le associazioni predefinite in un'origine dati JDBC non vengono mantenute nel modello dati del modulo. Creale manualmente.

Per aggiungere un'associazione:

  1. Seleziona la casella di controllo nella parte superiore di un oggetto modello dati per selezionarlo e quindi Aggiungi associazione. Viene visualizzata la finestra di dialogo Aggiungi associazione.

    associazione di componenti aggiuntivi

    note note
    NOTE
    Oltre agli oggetti modello dati e ai servizi, il documento metadati servizio OData include proprietà di navigazione che definiscono l'associazione tra due oggetti modello dati. È possibile utilizzare queste proprietà di navigazione quando si aggiungono associazioni in Modello dati modulo. Per ulteriori informazioni, consulta Utilizzo delle proprietà di navigazione dei servizi OData.

    Viene visualizzata la finestra di dialogo Aggiungi associazione.

    add-association-2

    Finestra di dialogo Aggiungi associazione

  2. Nel riquadro Aggiungi associazione:

    • Specificare un titolo per l'associazione.
    • Selezionare il tipo di associazione: Da uno a uno o Da uno a molti.
    • Seleziona l’oggetto modello dati da associare.
    • Selezionare il servizio di lettura per leggere i dati dall'oggetto modello selezionato. Viene visualizzato l'argomento del servizio di lettura. Se necessario, modificare l'argomento e associarlo alla proprietà dell'oggetto modello dati da associare.

    Nell’esempio seguente, l’argomento predefinito per il servizio di lettura dell’oggetto modello dati Dependents è dependentid.

    add-association-example

    L'argomento predefinito per il servizio di lettura Dipendenti è dependentid

    Tuttavia, l’argomento deve essere una proprietà comune tra l’oggetto modello dati associato, che in questo esempio è Employeeid. Pertanto, la Employeeid deve essere associato al id proprietà dell'oggetto modello dati Employee per recuperare i dettagli dei dipendenti associati dall'oggetto modello dati Dependents.

    add-association-example-2

    Argomento e associazione aggiornati

    Seleziona Fine per salvare l'argomento.

  3. Seleziona Fine per salvare l'associazione e quindi Salva per salvare il modello dati del modulo.

  4. Ripeti i passaggi per creare altre associazioni, in base alle esigenze.

NOTE
L’associazione aggiunta viene visualizzata nella casella dell’oggetto modello dati con il titolo specificato e una linea che collega gli oggetti modello dati associati.
È possibile modificare un’associazione selezionando la relativa casella di controllo e selezionando Modifica associazione.

add-association

Modifica proprietà properties

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

Per modificare le proprietà:

  1. Selezionare la casella di controllo accanto a un oggetto modello dati, a una proprietà o a un servizio nel modello dati del modulo.

  2. Seleziona Modifica proprietà. Il Modifica proprietà viene aperto un riquadro per l'oggetto modello, la proprietà o il servizio selezionato.

    • Oggetto modello dati: specifica i servizi di lettura e scrittura e modifica gli argomenti.
    • Proprietà: specifica il tipo, il sottotipo e il formato per la proprietà. È inoltre possibile specificare se la proprietà selezionata è la chiave primaria per l'oggetto modello dati.
    • Servizio: specifica l’oggetto modello di input, il tipo di output e gli argomenti per il servizio. Per un servizio Get, è possibile specificare se deve restituire un array.

    edit-properties-service

    Finestra di dialogo Modifica proprietà per un servizio di recupero

  3. Seleziona Fine per salvare le proprietà e quindi Salva per salvare il modello dati del modulo.

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.

Ad esempio, puoi creare una proprietà calcolata NomeCompleto il cui valore è il risultato della concatenazione del FirstName e Cognome proprietà. Per eseguire questa operazione:

  1. Creare una proprietà con il nome FullName il cui tipo di dati è String.

  2. Abilita Calcolato e seleziona Fine per creare la proprietà.

    calcolato

    Viene creata la proprietà calcolata FullName. Osserva l’icona accanto alla proprietà per rappresentare una proprietà calcolata.

    computed-prop

  3. Selezionare la proprietà FullName e selezionare Modifica regola. Viene visualizzata una finestra dell’editor di regole.

  4. Nella finestra dell’editor delle regole, seleziona Crea. A Imposta valore viene visualizzata la finestra regola.

    Dall’elenco a discesa Seleziona opzione, seleziona Espressione matematica. Altre opzioni disponibili sono Oggetto modello dati modulo e Stringa.

  5. Nell'espressione matematica, selezionare FirstName e Cognome rispettivamente nel primo e nel secondo oggetto. Seleziona più come operatore.

    Seleziona Fine e quindi seleziona Chiudi per chiudere la finestra dell'editor di regole. La regola è simile alla seguente.

    regola

  6. Nel modello dati del modulo, seleziona Salva. Proprietà calcolata configurata.

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 dell’esempio TripPin Servizi di esempio OData, l’entità persona contiene tre proprietà di navigazione: Friends, BestFriend e Trips.

Per ulteriori informazioni sulle proprietà di navigazione, consulta 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, tutte le proprietà di navigazione in un contenitore di entità vengono rese disponibili tramite un servizio nel modello dati modulo. In questo esempio del servizio OData TripPin, le tre proprietà di navigazione in Person il contenitore di entità può essere letto utilizzando uno GET LINK nel modello dati del modulo.

Di seguito viene evidenziata la GET LINK of Person /People nel modello dati modulo, un servizio combinato per le tre proprietà di navigazione in Person entità del servizio OData TripPin.

nav-prop-service

Dopo aver aggiunto GET LINK nella scheda Servizi del modello dati modulo, è possibile modificare le proprietà per scegliere l'oggetto modello di output e la proprietà di spostamento da utilizzare nel servizio. Ad esempio, i seguenti GET LINK of Person /People nell'esempio seguente viene utilizzato Trip come oggetto del modello di output e la proprietà di navigazione come Trips.

edit-prop-nav-prop

NOTE
I valori disponibili nella Valore predefinito campo del NavigationPropertyName dipende dallo stato del Restituire l’array? interruttore. Quando è abilitata, mostra le proprietà di navigazione del tipo Raccolta.

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 Restituire l’array? è abilitato o disabilitato).

edit-prop-nav-prop2

Allo stesso modo, puoi scegliere un GET LINK e configurarne le proprietà di navigazione quando si aggiungono associazioni nel modello dati del modulo. Tuttavia, per poter selezionare una proprietà di navigazione, assicurati che Campo Associazione a è impostato su Letterale.

add-association-nav-prop

Generare e modificare i dati di esempio sample

L’editor del modello dati modulo 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:

  1. Apri un modello di dati del modulo e seleziona Modifica dati di esempio. Genera e visualizza i dati di esempio nella finestra Modifica dati di esempio.

    Genera dati di esempio

  2. In entrata Modifica dati di esempio finestra, modifica i dati in base alle esigenze e seleziona Salva.

Successivamente, puoi utilizzare i dati di esempio per precompilare e testare le comunicazioni interattive in base al modello di dati del modulo. Per ulteriori informazioni, consulta Usa modello dati modulo.

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

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

  1. Seleziona un oggetto modello dati o un servizio nel modello dati del modulo, quindi fai clic su Oggetto modello di test o Servizio di prova, rispettivamente.

    Viene visualizzata la finestra Test modello dati modulo.

    test-data-model

  2. Nella finestra Test modello dati modulo, selezionare l'oggetto o il servizio modello dati da verificare nel riquadro di input.

  3. Specifica un valore di argomento nel codice del test e seleziona Test. In caso di esito positivo, il test restituisce l’output nel riquadro Output.

    Risultati del test

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

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

Il modello per dati modulo convalida i dati ricevuti come input durante la chiamata dell’API DermisBridge (in base ai criteri di convalida disponibili nel modello per dati modulo). La convalida si basa sulla ValidationOptions flag impostato nell’oggetto query utilizzato per richiamare l’API.

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

  • COMPLETO: FDM esegue la convalida in base a tutti i vincoli
  • DISATTIVATO: nessuna convalida
  • BASE: FDM esegue la convalida in base ai vincoli "required" e "nullable"

Se non viene impostato alcun valore per ValidationOptionsbandiera, BASE la convalida viene eseguita sui dati di input.

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

operationOptions.setValidationOptions(ValidationOptions.FULL);
NOTE
Il valore fornito per un attributo nei dati di input deve corrispondere al tipo di dati definito per l'attributo nel documento di metadati.
Se il valore non corrisponde al tipo di dati definito per l’attributo, l’API DermisBridge visualizza un’eccezione indipendentemente dal valore del ValidationOptions flag. Se il livello di registro è impostato su Debug, viene registrato un errore in error.log file.

Il modello per dati modulo convalida i dati di input in base a un elenco di vincoli per i tipi 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:

Vincoli
Descrizione
Input origine dati
obbligatorio
Se true, il parametro deve essere incluso nei dati di input.
Swagger, WSDL e database
nullable
Se true, il valore del parametro può essere impostato su Null nei dati di input.
WSDL, Odata e database
massimo
Specifica il limite superiore per i valori numerici. Il valore massimo specificato come limite superiore può essere assegnato anche al parametro nei dati di input.
Swagger e WSDL
minimo
Specifica il limite inferiore per i valori numerici. Il valore minimo specificato come limite inferiore può anche essere assegnato al parametro nei dati di input.
Swagger e WSDL
exclusiveMaximum
Specifica il limite superiore per i valori numerici. Il valore massimo specificato come limite superiore non deve essere assegnato al parametro nei dati di input.
Swagger e WSDL
exclusiveMinimum
Specifica il limite inferiore per i valori numerici. Il valore minimo specificato come limite inferiore non deve essere assegnato al parametro nei dati di input.
Swagger e WSDL
minLength
Specifica il limite inferiore per il numero di caratteri inclusi in una stringa. Il valore minimo specificato come limite inferiore può anche essere assegnato al parametro nei dati di input.
Swagger e WSDL
maxLength
Specifica il limite superiore per il numero di caratteri inclusi in una stringa. Il valore massimo specificato come limite superiore può essere assegnato anche al parametro nei dati di input.
Swagger, WSDL, Odata e database
pattern
Specifica una sequenza fissa di caratteri. La stringa di input viene convalidata correttamente solo se i caratteri sono conformi al modello specificato.
Swagger
minItems
Specifica il numero minimo di elementi in un array. Il valore minimo specificato come limite inferiore può anche essere assegnato al parametro nei dati di input.
Swagger e WSDL
maxItems
Specifica il numero massimo di elementi in un array. Il valore massimo specificato come limite superiore può essere assegnato anche al parametro nei dati di input.
Swagger e WSDL
uniqueItems
Se true, tutti gli elementi dell'array devono essere univoci nei dati di input.
Swagger
enum (stringa)
Limita il valore di un parametro nei dati di input a un set fisso di valori stringa. Deve essere un array con almeno un elemento, in cui ogni elemento è univoco.
Swagger, WSDL e Odata
enum (number)
Limita il valore di un parametro nei dati di input a un set fisso di valori numerici. Deve essere un array con almeno un elemento, in cui ogni elemento è univoco.
WSDL

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 needs to 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 in error.log file. 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

Ora disponi di un modello dati modulo di lavoro pronto per essere utilizzato nei moduli adattivi e nei flussi di lavoro di comunicazioni interattive. Per ulteriori informazioni, consulta Usa modello dati modulo.

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