Utilizzare il modello dati del modulo

integrazione dei dati

L’editor per modelli di dati per moduli offre un’interfaccia utente intuitiva e strumenti per la modifica e la configurazione di un modello di dati per moduli. Utilizzando l’editor, è possibile aggiungere e configurare oggetti modello dati, proprietà e servizi 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 il binding con i 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 Adaptive Forms durante l'anteprima. È possibile verificare gli oggetti e i servizi del modello dati configurati in un modello dati modulo per garantirne la corretta integrazione con le origini dati.

Se si è nuovi utenti dell’integrazione dei dati Forms e non si è configurata un’origine dati o non è stato creato un modello di dati modulo, consultare i seguenti argomenti:

Continua a leggere per i dettagli sulle varie attività e configurazioni che è possibile eseguire utilizzando l’editor per modelli dati modulo.

NOTA

Devi essere membro di entrambi fdm-author e form-user gruppi per poter creare e utilizzare il modello dati del modulo. Contatta il tuo Experience Manager amministratore per diventare membro dei gruppi.

Aggiungi oggetti e servizi del modello dati

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

È possibile aggiungere oggetti modello dati e servizi 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. Accedi al Experience Manager istanza autore, passa a Forms > Integrazioni dati, quindi aprire il modello dati modulo in cui si desidera aggiungere oggetti 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 selezionati.

    oggetti selezionati

    Oggetti e servizi del modello dati selezionato

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

    scheda modello

    Modello visualizza gli oggetti del modello dati aggiunti nella scheda

    NOTA

    È possibile tenere premuto e trascinare caselle degli oggetti del modello dati intorno per organizzarli nell’area contenuto. Tutti gli oggetti del modello dati aggiunti nel modello dati modulo sono in grigio nel riquadro Origini dati.

    La Servizi elenchi a schede di servizi aggiunti.

    scheda servizi

    Servizi visualizza la scheda dei 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, consulta Utilizzo delle proprietà di navigazione dei servizi OData.

  4. Tocca 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 Invoke services dell'editor delle regole. Per ulteriori informazioni sull'utilizzo di questi servizi nelle regole del modulo adattivo, consulta Invoke Services and Set Value Of rules in editor di regole.

Creazione di oggetti modello dati e proprietà figlio

Creazione di oggetti modello dati

Mentre è 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. Accedi al Experience Manager istanza autore, passa a Forms > Integrazioni dati, quindi aprire il modello dati modulo in cui si desidera creare un oggetto o un'entità del modello dati.

  2. Tocca Crea entità.

  3. In Crea modello dati , specifica un nome per l’oggetto modello dati e tocca 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à

Successivamente, è possibile aggiungere proprietà figlio negli oggetti modello dati non associati.

Aggiungi proprietà figlio

L’editor per modelli 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à figlio con un’altra proprietà nell’oggetto 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. In Crea proprietà figlio specifica un nome e un tipo di dati per la proprietà nel Nome e Tipo rispettivamente. Facoltativamente, puoi specificare un titolo e una descrizione per la proprietà.

  3. Abilita Computed 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 principale con lo stesso nome e tipo di dati.

    Per eseguire il binding manuale di una proprietà figlio con una proprietà dell’oggetto modello dati, tocca l’icona Sfoglia accanto a Riferimento a un'associazione campo . La Seleziona oggetto elenca tutte le proprietà dell’oggetto modello dati principale. Seleziona una proprietà con cui eseguire il binding e tocca l’icona di spunta. È possibile selezionare solo una proprietà dello stesso tipo di dati della proprietà figlio.

  5. Tocca Fine per salvare la proprietà figlio e toccare 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 l'Adaptive Forms in base al 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 in Forms adattivo associato . Per ulteriori informazioni sulla creazione di Adaptive Forms utilizzando il modello dati modulo, vedi Utilizzare il modello dati del modulo.

Oggetti e proprietà del modello dati di binding

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

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

  2. Tocca Modifica proprietà.

  3. In Modifica proprietà tocca l’icona Sfoglia accanto a Binding campo . Apre la Seleziona oggetto finestra di dialogo in cui sono elencate le origini dati aggiunte nel modello dati del modulo.

    select-object

  4. Espandi la struttura ad albero delle origini dati e seleziona un oggetto del modello dati da associare, quindi tocca l’icona di spunta.

  5. Tocca Fine per salvare le proprietà, quindi tocca Salva per salvare il modello dati del modulo. L'oggetto modello dati è ora associato a un'origine dati. Osserva che l’oggetto modello dati non è più contrassegnato come non associato.

    bound-model-object

Configurare i servizi

Per leggere e scrivere i dati di un oggetto modello dati, effettuare le seguenti operazioni 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 tocca Modifica proprietà.

    edit-properties

    Modifica delle proprietà per configurare i servizi di lettura e scrittura per un oggetto modello dati

    La Modifica proprietà viene visualizzata la finestra di dialogo .

    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, in Form Data Model è 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 principale.

    Gli oggetti modello dati configurati in un modello dati 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 del modello dati, l'oggetto del modello dati a cui si sta associando viene nidificato sotto l'oggetto del modello dati a cui si sta associando nel Oggetti del modello dati scheda . Se il modello dati nidificato è un oggetto di livello superiore, viene visualizzato anche separatamente nella sezione Oggetti del modello dati scheda . Di conseguenza, è possibile visualizzare due voci, una all’interno e un’altra all’esterno della gerarchia nidificata, il che potrebbe confondere gli autori dei moduli. Per fare in modo che l'oggetto del modello dati associato venga visualizzato solo nella gerarchia nidificata, disattivare la proprietà Oggetto di livello superiore.

  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. Tocca aem_6_3_edit per l'argomento del servizio di lettura a associare l’argomento a un attributo profilo utente, un attributo di richiesta o un valore letterale e specificare il valore di binding.

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

Argomenti del servizio di lettura binding

Associazione dell'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.

Valore letterale

Seleziona Letterale dal Binding a e inserisci un valore nel menu a discesa Valore 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 argomento, vengono recuperati dall’origine dati. I dettagli associati, se passi il valore per un argomento relativo a un numero mobile, possono includere proprietà quali il nome del cliente, l’indirizzo del cliente e la città.

Valore letterale

Attributo profilo utente

Seleziona Attributo profilo utente dal Binding a nel menu a discesa e immetti il nome dell'attributo nel Valore binding campo . Dettagli dell’utente che ha effettuato l’accesso al Experience Manager L'istanza viene recuperata dall'origine dati in base al nome dell'attributo.

Il nome dell'attributo specificato nel Valore binding il campo deve includere il percorso di binding completo fino al nome dell’attributo per l’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 in Valore binding campo per grios utente.

Modifica argomento

La id prende il valore del empid attributo del profilo utente e passalo come argomento al servizio Read. Legge e restituisce i valori delle proprietà associate dall'oggetto modello dati dipendente per empid associato all'utente connesso.

Richiedi attributo

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

  1. Seleziona Attributo di richiesta dal Binding a nel menu a discesa e immetti il nome dell'attributo nel Valore binding campo .

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

    NOTA
    • 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 apps :

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

Ad esempio, specificando l'attributo come petid=100 nella richiesta recupera 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. È indicata come associazione uno-a-molti e rappresentata da 1:n sulla linea che collega gli oggetti del modello dati associati. Tuttavia, se un'associazione restituisce un nome dipendente univoco per un determinato 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 da linee freccia. È possibile aggiungere associazioni tra oggetti del modello dati in diverse origini dati in un modello dati del modulo.

NOTA

Le associazioni predefinite in un’origine dati JDBC non vengono mantenute nel modello dati del modulo. Devi crearli manualmente.

Per aggiungere un'associazione:

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

    associazione

    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, consulta Utilizzo delle proprietà di navigazione dei servizi OData.

    La Aggiungi associazione viene visualizzata la finestra di dialogo .

    add-Association-2

    Finestra di dialogo Aggiungi associazione

  2. Nel riquadro Aggiungi associazione :

    • Specifica un titolo per l’associazione.
    • Seleziona il tipo di associazione — Uno a uno o Da uno a molti.
    • Selezionare l'oggetto modello dati a cui associare.
    • 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 modello dati associato, che in questo esempio è Employeeid. Pertanto, Employeeid deve essere associato al id proprietà dell'oggetto del modello dati dipendente per recuperare i dettagli dei dipendenti associati dall'oggetto del modello dati Dependents.

    add-Association-example-2

    Argomento e binding aggiornati

    Tocca Fine per salvare l'argomento.

  3. Tocca 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.

NOTA

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

Per modificare un’associazione, seleziona la casella di controllo corrispondente e tocca Modifica associazione.

associazione

Modifica delle proprietà

È 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 modulo.

  2. Tocca Modifica proprietà. La Modifica proprietà viene visualizzato il riquadro relativo all'oggetto modello, alla proprietà o al servizio selezionato.

    • Oggetto del modello dati: Specificare i servizi di lettura e scrittura e gli argomenti di modifica.

    • Proprietà: Specifica 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, è possibile specificare se deve restituire una matrice.

      edit-properties-service
      Finestra di dialogo Modifica proprietà per un servizio get

  3. Tocca Fine per salvare le proprietà e 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 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, è possibile creare una proprietà calcolata FullName il cui valore è il risultato della concatenazione del Nome e LastName proprietà. Per eseguire questa operazione:

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

  2. Abilita Calcolato e toccare 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. Seleziona la proprietà FullName e tocca Modifica regola. Viene visualizzata una finestra dell’editor di regole.

  4. Nella finestra dell’editor delle regole, tocca Crea. A Imposta valore si apre la finestra della regola.

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

  5. Nell’espressione matematica, seleziona Nome e LastName rispettivamente nel primo e nel secondo oggetto. Seleziona plus come operatore.

    Tocca Fine quindi tocca Chiudi per chiudere la finestra dell’editor delle regole. La regola ha un aspetto simile al seguente.

    regola

  6. Nel modello dati del modulo, tocca Salva. La proprietà calcolata è 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. Queste proprietà sono definite in un tipo di entità o in un tipo complesso. Ad esempio, nel seguente estratto dal file di metadati del campione TripPin Servizi di esempio OData, l'entità persona contiene tre proprietà di navigazione: Amici, BestFriend e Viaggi.

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

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

nav-prop-service

Una volta aggiunto il GET LINK nella scheda Servizi del 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: GET LINK of Person /People nell'esempio seguente viene utilizzato Trip come oggetto modello di output e la proprietà navigation come Trips.

edit-prop-nav-prop

NOTA

I valori disponibili nel Valore predefinito campo NavigationPropertyName l'argomento dipende dallo stato del Restituire l'array? pulsante di attivazione/disattivazione. Quando è abilitato, mostra le proprietà di navigazione del tipo Raccolta.

In questo esempio, è inoltre possibile scegliere l'oggetto modello di output come Persona e l'argomento della proprietà di navigazione come Amici o BestFriend (a seconda se Restituire l'array? è attivato o disattivato).

edit-prop-nav-prop2

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

add-Association-nav-prop

Generare e modificare dati di esempio

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

Per generare e modificare i dati di esempio, procedi come segue:

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

    Genera dati di esempio

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

Test di oggetti e servizi del modello dati

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

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

    Viene visualizzata la finestra Modello dati modulo di prova.

    modello di prova-dati

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

  3. Specifica un valore di argomento nel codice di test e tocca Test. Un test di successo restituisce l'output nel riquadro Output.

    Risultati della prova

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

Convalida automatizzata dei dati di input

Il modello dati modulo convalida i dati ricevuti come input durante l’invocazione 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 la variabile ValidationOptionsbandiera, BASE la convalida viene eseguita sui dati di input.

Esempio di impostazione del flag di convalida su COMPLETO:

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 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 bandiera. Se il livello di registro è impostato su Debug, viene registrato un errore nel error.log file.

Il modello dati modulo convalida i dati di input in base a un elenco di vincoli relativi al 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 relativi ai dati di input in base all’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
esclusivoMaximum 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
esclusivoMinimum 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 della matrice 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, dove ogni elemento è univoco. Swagger, WSDL e Odata
enum (numero)

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, 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 log è impostato su Debug, viene registrato un errore nel 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

È ora disponibile un modello dati modulo funzionante pronto per l’uso in Forms adattivo flussi di lavoro. Per ulteriori informazioni, consulta Utilizzare il modello dati del modulo.

In questa pagina