Uso del modello dati del modulo

integrazione dei dati

L'editor dei modelli di dati per i moduli offre un'interfaccia utente intuitiva e strumenti per la modifica e la configurazione di un modello di dati per i moduli. Utilizzando l'editor, è possibile aggiungere e configurare oggetti, proprietà e servizi del modello dati da origini dati associate nel modello dati del modulo. Inoltre, consente di creare oggetti e proprietà del modello dati senza origini dati e di eseguire successivamente un binding con i rispettivi oggetti e proprietà del modello dati. È inoltre possibile generare e modificare dati di esempio per le proprietà degli oggetti del modello dati che è possibile utilizzare per precompilare moduli adattivi e comunicazioni interattive durante la visualizzazione dell'anteprima. È possibile sottoporre a test 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 non si è esperti nell'integrazione dei dati Forms e non si è configurata un'origine dati o non è stato creato un modello dati modulo, consultare i seguenti argomenti:

Per informazioni dettagliate sulle varie attività e configurazioni che è possibile eseguire utilizzando l'editor modelli dati del modulo, consultare.

Nota

È necessario essere membri sia dei gruppi fdm-author che form-user per poter creare e utilizzare il modello dati del modulo. Contattate il vostro amministratore AEM per diventare membro dei gruppi.

Aggiunta di oggetti e servizi del modello dati

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

È possibile aggiungere oggetti e servizi del modello dati da origini dati disponibili nel modello dati del modulo. Mentre gli oggetti modello dati aggiunti vengono visualizzati nella scheda Modello, i servizi aggiunti vengono visualizzati nella scheda Servizi.

Per aggiungere oggetti e servizi del modello dati:

  1. Accedere all'istanza di creazione AEM, accedere a Forms > Integrazioni dati e aprire il modello dati del modulo in cui si desidera aggiungere gli oggetti del modello dati.

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

  3. Selezionare gli oggetti del modello dati e i servizi che si desidera aggiungere al modello dati del modulo e toccare Aggiungi selezionato.

    selected-objects

    Oggetti e servizi del modello dati selezionati

    La scheda Modello visualizza una rappresentazione grafica di tutti gli oggetti del modello dati e delle relative proprietà aggiunte al modello dati del modulo. Ciascun oggetto del modello dati è rappresentato da una casella nel modello dati del modulo.

    model-tab

    Scheda Modello visualizza oggetti modello dati aggiunti

    Nota

    È possibile tenere premuti e trascinare i riquadri oggetti del modello dati per organizzarli nell'area contenuto. Tutti gli oggetti del modello dati aggiunti nel modello dati del modulo sono disabilitati nel riquadro Origini dati.

    Nella scheda Servizi sono elencati i servizi aggiunti.

    services-tab

    La scheda Servizi visualizza i servizi del modello dati

    Nota

    Oltre agli oggetti e ai servizi del modello dati, il documento di metadati del servizio OData include proprietà di navigazione che definiscono l'associazione tra due oggetti del modello dati. Per ulteriori informazioni, vedere Uso delle proprietà di navigazione dei serviziOData.

  4. Toccare Salva per salvare l'oggetto modello di modulo.

    Nota

    È possibile richiamare i servizi configurati nella scheda Servizi di un modello dati modulo utilizzando le regole del modulo adattivo. I servizi configurati sono disponibili nell'azione di attivazione dei servizi dell'editor delle regole. Per ulteriori informazioni sull'utilizzo di questi servizi nelle regole dei moduli adattivi, vedere Invocare servizi e Impostare il valore delle regole nell'editor delleregole.

Creazione di oggetti modello dati e proprietà figlio

Creazione di oggetti modello dati

Anche se è possibile aggiungere oggetti modello dati da origini dati configurate, è anche possibile creare oggetti modello dati o entità senza origini dati. È utile soprattutto se non sono state configurate origini dati nel modello dati del modulo.

Per creare un oggetto modello dati senza origini dati:

  1. Accedere all'istanza di creazione AEM, accedere a Forms > Integrazioni dati e aprire il modello dati del modulo in cui si desidera creare un oggetto o un'entità del modello dati.

  2. Toccate Crea entità.

  3. Nella finestra di dialogo Crea modello dati, specificare un nome per l'oggetto modello dati e toccare 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 illustrato nell'immagine seguente.

    nuova entità

È quindi possibile aggiungere proprietà figlio negli oggetti modello dati non associati.

Aggiungi proprietà figlio

L'editor dei modelli di dati modulo consente di creare proprietà figlio in un oggetto modello dati. La proprietà creata non è associata ad alcuna proprietà in un'origine dati. In seguito è possibile eseguire un binding della proprietà figlia con un'altra proprietà nell'oggetto del modello dati contenitore.

Per creare una proprietà figlio:

  1. In un modello dati modulo, selezionare un oggetto modello dati e toccare Crea proprietà figlio.

  2. Nella finestra di dialogo Crea proprietà figlio, specificate un nome e un tipo di dati per la proprietà rispettivamente nei campi Nome e Tipo . Facoltativamente è possibile specificare un titolo e una descrizione per la proprietà.

  3. Abilitare Computed se la proprietà è una proprietà calcolata. Il valore di una proprietà calcolata viene valutato in base a una regola o un'espressione. Per ulteriori informazioni, vedere Modificare le proprietà.

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

    Per eseguire un binding manuale di una proprietà figlia con una proprietà oggetto modello dati, toccare l'icona Sfoglia accanto al campo Riferimento ​binding. Nella finestra di dialogo Seleziona oggetto sono elencate tutte le proprietà dell'oggetto modello dati principale. Selezionare una proprietà con cui eseguire il binding e toccare l'icona del segno di spunta. È possibile selezionare solo una proprietà dello stesso tipo di dati della proprietà figlio.

  5. Toccate Fine per salvare la proprietà figlio e toccate 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, è possibile continuare a creare moduli adattivi e comunicazioni interattive basate sul modello dati del modulo. Successivamente, quando sono disponibili e configurate origini dati, è possibile eseguire il binding del modello dati del modulo con origini dati. Il binding viene aggiornato automaticamente nei moduli adattivi associati e nelle comunicazioni interattive. Per ulteriori informazioni sulla creazione di moduli adattivi e sulle comunicazioni interattive mediante il modello dati del modulo, vedere Uso del modellodati del modulo.

Binding di oggetti del modello dati e proprietà

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

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

  2. Toccate Modifica proprietà.

  3. Nel riquadro Modifica proprietà , toccare l'icona Sfoglia accanto al campo Binding . Si apre la finestra di dialogo Seleziona oggetto in cui sono elencate le origini dati aggiunte nel modello dati del modulo.

    select-object

  4. Espandere la struttura delle origini dati e selezionare un oggetto modello dati con cui eseguire il binding e toccare l'icona di spunta.

  5. Toccate Fine per salvare le proprietà, quindi toccate Salva per salvare il modello dati del modulo. L'oggetto del modello dati è ora associato a un'origine dati. Tenere presente che l'oggetto del modello dati non è più contrassegnato come Non associato.

    bound-model-object

Configurare i servizi

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

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

    edit-properties

    Modifica delle 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à

    Nota

    Oltre agli oggetti e ai servizi del modello dati, il documento di metadati del servizio OData include proprietà di navigazione che definiscono l'associazione tra due oggetti del modello dati. Quando si aggiunge un'origine dati del servizio OData a un modello dati modulo, è disponibile un servizio nel modello dati modulo 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, vedere Uso delle proprietà di navigazione dei serviziOData.

  2. Attiva/disattiva l'oggetto di livello superiore per specificare se l'oggetto del modello dati è un oggetto modello di livello principale.

    Gli oggetti del modello dati configurati in un modello dati del modulo sono disponibili per l'uso nella scheda Oggetti modello dati del browser Contenuto di un modulo adattivo basato sul modello dati del modulo. Quando si aggiunge un'associazione tra due oggetti modello dati, l'oggetto modello dati a cui si sta associando è nidificato sotto l'oggetto modello dati da cui si sta associando nella scheda Oggetti modello dati. Se il modello dati nidificato è un oggetto di primo livello, verrà visualizzato anche separatamente nella scheda Oggetti modello dati. Di conseguenza, verranno visualizzate due voci di esso, una all'interno e l'altra all'esterno della gerarchia nidificata, che potrebbero confondere gli autori dei moduli. Per fare in modo che l'oggetto del modello dati associato venga visualizzato solo nella gerarchia nidificata, disabilitare la proprietà Oggetto di primo livello.

  3. Selezionare Servizi di lettura e scrittura per gli oggetti del modello dati selezionati. Vengono visualizzati gli argomenti relativi ai servizi.

    servizi di lettura/scrittura

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

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

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

Binding degli argomenti del servizio di lettura

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

Literal value

Selezionare Letterale dal menu a discesa Binding a e immettere un valore nel campo Valore ​binding. I dettagli associati al valore vengono recuperati dall'origine dati. Utilizzare questa opzione per recuperare i dettagli associati a un valore statico.

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

Valore letterale

Attributo profilo utente

Selezionare Attributo profilo utente dal menu a discesa Binding a e immettere il nome dell'attributo nel campo Valore ​binding. I dettagli dell'utente che ha eseguito l'accesso all'istanza AEM 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 per l'utente. Aprite 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, specificare profile.empid nel campo Valore di binding per l' grios utente.

Modifica argomento

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

Richiedi attributo

Utilizzare l'attributo request per recuperare le proprietà associate dall'origine dati.

  1. Selezionare Richiedi attributo dal menu a discesa Binding a e immettere il nome dell'attributo nel campo Valore ​binding.

  2. Create una sovrapposizione per head.jsp. Per creare la sovrapposizione, aprite CRX DE e copiate il 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

    Nota
    • Se usate un modello statico, sovrapponete head.jsp in:
      /libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
    • Se usate un modello modificabile, sovrapponete aftemplatedpage.jsp a:
      /libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp
  3. Impostato paramMap per l’attributo request. Ad esempio, includete il seguente codice nel file .jsp nella cartella delle app:

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

    Ad esempio, utilizzare il codice seguente per recuperare il valore di petid dall'origine dati:

    <%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 attributo specificato nella richiesta.

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

Aggiungi associazioni

In genere, esistono associazioni create tra gli oggetti del modello dati in un'origine dati. L'associazione può essere uno a uno o uno a molti. Ad esempio, possono essere associati più dipendenti a un dipendente. Viene definita associazione uno-a-molti e rappresentata dalla linea che collega 1:n gli oggetti del modello dati associati. Tuttavia, se un'associazione restituisce un nome univoco del dipendente per un dato ID dipendente, viene definita associazione uno-a-uno.

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

Nota

Le associazioni predefinite in un'origine dati JDBC non vengono mantenute nel modello dati del modulo. È necessario crearli manualmente.

Per aggiungere un'associazione:

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

    add-Association

    Nota

    Oltre agli oggetti e ai servizi del modello dati, il documento di metadati del servizio OData include proprietà di navigazione che definiscono l'associazione tra due oggetti del modello dati. È possibile utilizzare queste proprietà di navigazione quando si aggiungono associazioni nel modello dati modulo. Per ulteriori informazioni, vedere Uso delle proprietà di navigazione dei serviziOData.

    Viene visualizzata la finestra di dialogo Aggiungi associazione.

    add-Association-2

    Aggiungi associazione, finestra di dialogo

  2. Nel riquadro Aggiungi associazione:

    • Specificate un titolo per l'associazione.
    • Selezionare il tipo di associazione — Da uno a uno o da uno a molti.
    • Selezionare l'oggetto del modello dati a cui associarsi.
    • Selezionare il servizio di lettura per leggere i dati dall'oggetto modello selezionato. Viene visualizzato l'argomento del servizio di lettura. Modificare l'argomento, se necessario, 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 del modello dati associato, che in questo esempio è Employeeid. Pertanto, l' Employeeid argomento deve essere associato alla id proprietà dell'oggetto del modello dati Dipendente per recuperare i dettagli relativi ai dipendenti associati dall'oggetto del modello dati Dipendenti.

    add-Association-example-2

    Argomento e binding aggiornati

    Toccate Fine per salvare l’argomento.

  3. Toccate Fine per salvare l'associazione, quindi Salva per salvare il modello dati del modulo.

  4. Ripetere i passaggi per creare ulteriori associazioni come necessario.

Nota

L'associazione aggiunta viene visualizzata nella casella dell'oggetto modello dati con il titolo specificato e una linea che collega gli oggetti del modello dati associati.

Per modificare un'associazione, selezionate la casella di controllo e toccate Modifica associazione.

associazione

Modifica delle proprietà

È possibile modificare le proprietà degli oggetti del 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 del modello dati, a una proprietà o a un servizio nel modello dati del modulo.

  2. Toccate Modifica proprietà. Viene visualizzato il riquadro Modifica proprietà per l'oggetto modello, la proprietà o il servizio selezionato.

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

    edit-properties-service

    Finestra di dialogo Modifica proprietà per un servizio get

  3. Toccare Fine per salvare le proprietà, quindi Salva per salvare il modello dati del modulo.

Creare proprietà calcolate

Una proprietà calcolata è quella il cui valore viene calcolato in base a una regola o 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, è possibile creare una proprietà calcolata FullName il cui valore è il risultato della concatenazione delle proprietà esistenti FirstName e LastName . A questo scopo:

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

  2. Attivate Calcolato e toccate Fine per creare la proprietà.

    calcolato

    Viene creata la proprietà calcolata FullName. Osservate l'icona accanto alla proprietà per rappresentare una proprietà calcolata.

    computed-prop

  3. Selezionate la proprietà FullName e toccate Modifica regola. Si apre una finestra dell'editor di regole.

  4. Nella finestra Editor regole, toccate Crea. Viene visualizzata la finestra Imposta regola valore .

    Dal menu a discesa Seleziona opzione, selezionate Espressione ​matematica. Altre opzioni disponibili sono Oggetto modello dati modulo e Stringa.

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

    Toccate Fine e quindi Chiudi per chiudere la finestra dell'editor di regole. La regola ha un aspetto simile al seguente.

    regola

  6. Nel modello dati del modulo, toccare Salva. La proprietà computed è configurata.

Operazioni con le proprietà di navigazione dei servizi OData

Nei servizi OData, le proprietà di navigazione vengono utilizzate per definire le associazioni tra due oggetti modello dati. Tali proprietà sono definite in un tipo di entità o in un tipo complesso. Ad esempio, nel seguente estratto dal file di metadati dei servizi di esempio di TripPin OData, l'entità persona contiene tre proprietà di navigazione: Amici, Migliori amici e Viaggi.

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

Di seguito viene evidenziato il GET LINK of Person /People servizio nel modello dati modulo, che è un servizio combinato per le tre proprietà di navigazione nell' Person entità del servizio TripPin OData.

nav-prop-service

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

edit-prop-nav-prop

Nota

I valori disponibili nel campo Valore ​predefinito dell'argomento NavigationPropertyName dipendono dallo stato dell'array Return? pulsante di attivazione/disattivazione. Quando è attivato, mostra le proprietà di navigazione del tipo Collection.

In questo esempio, è anche possibile scegliere l'oggetto modello di output come argomento Persona e proprietà di navigazione come Amici o Migliore amico (a seconda se array Return? è abilitata o disabilitata).

edit-prop-nav-prop2

Allo stesso modo, è possibile scegliere un GET LINK servizio e configurarne le proprietà di navigazione quando si aggiungono associazioni nel modello dati modulo. Tuttavia, per poter selezionare una proprietà di navigazione, assicurarsi che il campo ​Binding a sia impostato su Letterale.

add-Association-nav-prop

Generazione e modifica di dati di esempio

L'editor dei modelli di dati modulo consente di generare dati di esempio per tutte le proprietà degli oggetti del modello di dati, incluse le proprietà calcolate, in un modello di dati del modulo. Si tratta di un insieme di valori casuali conformi al tipo di dati configurato per ciascuna proprietà. È inoltre possibile modificare e salvare i dati, che vengono conservati anche se si rigenerano i dati di esempio.

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

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

    Genera dati di esempio

  2. Nella finestra Modifica dati di esempio, modificare i dati in base alle esigenze e toccare Salva.

È quindi possibile utilizzare i dati di esempio per precompilare e testare le comunicazioni interattive basate sul modello di dati del modulo. Per ulteriori informazioni, vedere Uso del modellodati del modulo.

Test di oggetti e servizi del modello dati

Il modello dati del modulo è configurato, ma prima di utilizzarlo, potrebbe essere necessario verificare se gli oggetti e i servizi del modello dati configurati funzionano come previsto. Per verificare gli oggetti e i servizi del modello dati:

  1. Selezionare un oggetto modello dati o un servizio nel modello dati del modulo e toccare, rispettivamente, Oggetto modello di prova o Servizio di prova.

    Viene visualizzata la finestra Modello dati modulo di prova.

    test-data-model

  2. Nella finestra Modello dati modulo di prova, selezionare l'oggetto o il servizio del modello dati da verificare dal riquadro Input.

  3. Specificate un valore di argomento nel codice di prova e toccate Test. Un test di successo restituisce l'output nel riquadro Output.

    Risultati della prova

Allo stesso modo, è possibile verificare altri oggetti e servizi del modello dati nel modello dati del modulo.

Convalida automatizzata dei dati di input

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

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

  • COMPLETO: FDM esegue la convalida in base a tutti i vincoli
  • OFF: Nessuna convalida
  • BASE: FDM esegue la convalida in base ai vincoli "obbligatori" e "nullable"

Se non viene impostato alcun valore per il ValidationOptionsflag, ai dati di input viene eseguita la convalida BASIC .

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

operationOptions.setValidationOptions(ValidationOptions.FULL);
Nota

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 nel file error.log .

Il modello dati del modulo convalida i dati di input in base a un elenco di vincoli relativi al tipo di dati. L'elenco di 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 Origine dati di input
required 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ò essere assegnato anche al parametro nei dati di input. Swagger e WSDL
excludeMaximum 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
excludeMinimum 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ò essere assegnato anche 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 pattern specificato. Swagger
minItems Specifica il numero minimo di elementi in una matrice. Il valore minimo specificato come limite inferiore può essere assegnato anche al parametro nei dati di input. Swagger e WSDL
maxItems Specifica il numero massimo di elementi in una matrice. 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 insieme fisso di valori stringa. Deve essere un array con almeno un elemento, dove ogni elemento è univoco. Swagger, WSDL e Odata
enum (numero)

Limita il valore di un parametro nei dati di input a un insieme fisso di valori numerici. Deve essere un array con almeno un elemento, dove 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 l'ID ordine è presente 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 nel file error.log . 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

È disponibile un modello dati modulo di lavoro che è ora pronto per essere utilizzato nei moduli adattivi e nei flussi di lavoro di comunicazione interattiva. Per ulteriori informazioni, vedere Uso del modellodati del modulo.

In questa pagina