[AEM Forms]{class="badge positive" title="Si applica ad AEM Forms)."}
Utilizzare il modello dati modulo (FDM) work-with-form-data-model
L’editor FDM (Form Data Model) fornisce un’interfaccia utente intuitiva e strumenti integrati per la creazione, la modifica e la configurazione di un FDM (Form Data Model) in Adobe Experience Manager (AEM) Forms. Utilizzando l’editor, aggiungere e configurare oggetti modello dati, proprietà e servizi dalle origini dati associate direttamente nel modello dati del modulo (FDM).
Funzionalità dell’editor modello dati modulo
L’editor modello dati modulo supporta le seguenti attività chiave:
- Aggiungere e configurare oggetti, proprietà e servizi del modello dati dalle origini dati associate in FDM.
- Creare oggetti e proprietà del modello dati senza origini dati. È possibile definire prima questi oggetti e associarli successivamente ai rispettivi oggetti e proprietà del modello di dati, separando la progettazione dalla configurazione di origine.
- Genera e modifica dati di esempio per le proprietà dell’oggetto modello dati. Questi dati di esempio sostituiscono Forms adattivo durante l’anteprima, pertanto autori e tester convalidano il comportamento del modulo con valori realistici prima della distribuzione.
- Verifica i servizi e gli oggetti del modello dati configurati in FDM per verificare che siano correttamente integrati con le origini dati sottostanti.
Prerequisiti
Se hai poca esperienza con l’integrazione dei dati in Forms e non hai configurato un’origine dati o creato un modello dati del modulo (FDM), consulta i seguenti argomenti:
Continua a leggere per i dettagli sulle varie attività e configurazioni che puoi eseguire utilizzando l’editor del modello dati modulo.
Aggiungere oggetti e servizi del modello dati add-data-model-objects-and-services
Se è stato creato un modello dati modulo (FDM) con origini dati, è possibile utilizzare l’editor modello dati modulo per aggiungere servizi e oggetti modello dati, configurarne le proprietà, creare associazioni tra oggetti modello dati e testare il modello dati modulo (FDM) e i servizi. Questo consente di assemblare un modello dati completo e funzionale direttamente dalle origini dati collegate all’interno di un unico ambiente di editing.
È possibile aggiungere oggetti e servizi del modello dati da origini dati disponibili nel modello dati del modulo (FDM). Gli oggetti modello dati aggiunti vengono visualizzati nella scheda Modello, mentre i servizi aggiunti vengono visualizzati nella scheda Servizi, mantenendo i due tipi di oggetto chiaramente separati per semplificare la configurazione e i test.
Per aggiungere oggetti e servizi del modello dati:
-
Accedi all’istanza di authoring Experience Manager, passa a Forms > Integrazioni dati e apri il modello dati modulo (FDM) in cui desideri aggiungere oggetti modello dati.
-
Nel riquadro Origini dati espandere Origini dati per visualizzare i servizi e gli oggetti modello dati disponibili.
-
Selezionare gli oggetti e i servizi del modello dati che si desidera aggiungere al modello dati del modulo (FDM) e selezionare Aggiungi selezionati. In questo modo gli oggetti e i servizi selezionati vengono aggiunti a FDM in modo che sia possibile configurarne le proprietà e creare associazioni tra di essi.
Servizi e oggetti modello dati selezionati
La scheda Modello visualizza una rappresentazione grafica di tutti gli oggetti modello dati e delle relative proprietà aggiunti al modello dati del modulo (FDM). Ogni oggetto modello dati è rappresentato da una casella nel modello dati del modulo (FDM), che semplifica la scansione visiva della struttura del modello.
Nella scheda Modello vengono visualizzati gli oggetti modello dati aggiunti
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 (FDM) sono disattivati nel riquadro Origini dati, a indicare che sono già stati aggiunti e a impedire voci duplicate. Nella scheda Servizi sono elencati i servizi aggiunti.
Nella scheda Servizi sono visualizzati i servizi del modello dati
note NOTE Oltre agli oggetti e ai servizi del modello dati, il documento di metadati del servizio OData (Open Data Protocol) include proprietà di navigazione che definiscono l’associazione tra due oggetti del modello dati e consentono l’attraversamento dei dati correlati. Per ulteriori informazioni, vedere Utilizzo delle proprietà di navigazione dei servizi OData. -
Seleziona Salva per salvare l’oggetto modello modulo.
note NOTE I servizi configurati nella scheda Servizi di un modello dati modulo (FDM) possono essere richiamati direttamente utilizzando le regole del modulo adattivo, consentendo agli autori dei moduli di attivare operazioni sui dati, ad esempio il recupero o la scrittura di dati in fase di esecuzione. I servizi configurati sono disponibili nell’azione Richiama servizi dell’editor di regole. Per ulteriori informazioni sull'utilizzo di questi servizi nelle regole del modulo adattivo, vedere Richiama servizi e Imposta valore delle regole nell'editor regole.
Creare oggetti modello dati e proprietà figlio create-data-model-objects-and-child-properties
Un modello dati organizza le informazioni in unità strutturate riutilizzabili denominate oggetti, ognuna delle quali può contenere proprietà figlio che descrivono i singoli attributi dell’oggetto. La creazione di oggetti ben definiti e la nidificazione di proprietà secondarie al di sotto di essi è un passaggio fondamentale per la creazione di qualsiasi modello di dati, in quanto stabilisce una rappresentazione chiara e gerarchica delle informazioni che verranno memorizzate, convalidate e scambiate dall’applicazione.
Cosa sono gli oggetti modello dati e le proprietà figlio?
- Un oggetto modello dati è un contenitore denominato che raggruppa i campi correlati in un’unica entità logica. Gli oggetti rappresentano elementi concettuali o reali, ad esempio un cliente, un ordine o un prodotto, e fungono da struttura di primo livello a cui sono collegati altri elementi.
- Le proprietà secondarie sono i singoli campi nidificati all’interno di un oggetto. Ogni proprietà figlio definisce un attributo dell’oggetto padre, insieme a caratteristiche quali il nome, il tipo di dati e se il valore è obbligatorio. La nidificazione delle proprietà sotto un oggetto padre mantiene i dati correlati raggruppati, migliorando la chiarezza e facilitando la gestione del modello.
Questa relazione padre-figlio è ciò che dà a un modello di dati la sua gerarchia. L’oggetto funge da padre e le proprietà figlio ereditano il contesto da esso, assicurandosi che ogni attributo sia associato in modo inequivocabile all’entità descritta.
Creare un oggetto modello dati
Per definire un nuovo oggetto nel modello dati, segui la procedura riportata di seguito.
- Denomina l’oggetto. Scegliere un nome chiaro e descrittivo che identifichi l’entità rappresentata dall’oggetto. La denominazione coerente semplifica la lettura del modello e il suo riferimento in un secondo momento.
- Definisci l’oggetto come contenitore. Imposta l’oggetto come elemento di livello superiore che conterrà le proprietà figlio associate.
- Aggiungi proprietà figlio. Allegare i singoli campi che descrivono gli attributi dell’oggetto, definendo ciascuno in successione.
- Assegnare un tipo di dati a ogni proprietà. Specifica il tipo di valore accettato da ogni proprietà secondaria, ad esempio testo, numero o booleano, in modo che i dati possano essere convalidati correttamente.
- Imposta regole di fabbisogno. Indicare le proprietà figlio obbligatorie e quelle facoltative, in modo che il modello applichi i vincoli da cui dipende l’applicazione.
Aggiunta di proprietà figlio
Quando si aggiungono proprietà figlio a un oggetto, definire ogni proprietà con i dettagli seguenti:
- Nome proprietà: etichetta descrittiva e univoca per l’attributo all’interno dell’oggetto padre.
- Tipo di dati: il tipo di valore memorizzato dalla proprietà, che determina il modo in cui il valore viene convalidato ed elaborato.
- Stato obbligatorio o facoltativo - se la proprietà deve sempre avere un valore.
- Struttura nidificata (se applicabile): una proprietà figlio può essere essa stessa un oggetto con proprietà figlio proprie, consentendo di modellare dati complessi a più livelli. Questa nidificazione consente ai modelli di dati di rappresentare informazioni con struttura approfondita.
Applicazioni pratiche e vantaggi
La strutturazione di un modello dati con oggetti e proprietà figlio offre diversi vantaggi pratici:
- Coerenza: il raggruppamento dei campi correlati in un oggetto condiviso garantisce la memorizzazione e l’interpretazione uniforme dei dati nell’applicazione.
- Riutilizzabilità: è possibile fare riferimento a oggetti ben definiti in più posizioni, riducendo la duplicazione.
- Convalida — l’assegnazione di tipi di dati e regole dei requisiti alle proprietà figlio consente al sistema di rilevare automaticamente dati non validi o incompleti.
- Scalabilità: poiché gli oggetti supportano proprietà figlio nidificate, il modello può crescere e rappresentare relazioni sempre più complesse senza essere disorganizzato.
Best practice
- Utilizza nomi chiari e descrittivi sia per gli oggetti che per le relative proprietà secondarie per mantenere l’autocertificazione del modello.
- Raggruppare gli attributi correlati nello stesso oggetto padre anziché distribuirli tra strutture non correlate.
- Definire anticipatamente i tipi di dati e le regole dei requisiti, poiché in questo modo viene stabilita una convalida affidabile fin dall’inizio.
- Mantieni la nidificazione mirata: nidifica le proprietà figlio solo quando la gerarchia aggiuntiva riflette in modo significativo la struttura dei dati.
Definendo con attenzione gli oggetti e le relative proprietà figlio, si crea un modello dati organizzato, gestibile e in grado di rappresentare con precisione le entità con cui lavora l’applicazione.
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, denominati anche entità, senza origini dati. Un oggetto modello dati è un’entità strutturata all’interno del modello dati modulo (FDM) che rappresenta un raggruppamento logico di proprietà, che in seguito possono essere associate a campi di origine dati o utilizzate in modo indipendente. Questa funzionalità è particolarmente utile quando non hai ancora configurato le origini dati nel modello dati del modulo (FDM), perché consente di iniziare a progettare la struttura dati prima che sia presente qualsiasi integrazione back-end.
Passaggi per creare un oggetto modello dati senza origini dati
Per creare un oggetto modello dati senza origini dati:
-
Accedi all’istanza di authoring Experience Manager, passa a Forms > Integrazioni dati e apri il modello dati modulo (FDM) in cui desideri creare un oggetto o un’entità modello dati.
-
Seleziona Crea entità.
-
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 modulo (FDM). L’oggetto modello dati appena aggiunto non è associato a un’origine dati e non dispone di proprietà, come illustrato nell’immagine seguente. Poiché non è associato, questo oggetto esiste puramente come segnaposto strutturale fino a quando non ne definisci le proprietà o non lo connetti a un’origine dati.
Passaggi successivi next-steps-data-model-object
Dopo la creazione dell’oggetto modello dati non associato, aggiungi le proprietà secondarie per definirne la struttura. Queste proprietà secondarie ti consentono di specificare i campi e gli attributi che l’oggetto contiene e possono essere associati alle origini dati in un secondo momento, una volta configurate le integrazioni di dati. In questo modo l’oggetto modello dati diventa completamente funzionale e pronto per essere utilizzato nei moduli.
Aggiungi proprietà figlio child-properties
L’editor del modello dati modulo (FDM) consente di creare proprietà secondarie all’interno di un oggetto modello dati. Per impostazione predefinita, una proprietà figlio appena creata non è associata ad alcuna proprietà in un’origine dati. In seguito, sarà possibile associare la proprietà figlio a un’altra proprietà nell’oggetto modello dati che la contiene.
Per creare una proprietà figlio:
-
In un modello dati modulo, selezionare un oggetto modello dati e selezionare Crea proprietà figlio.
-
Nella finestra di dialogo Crea proprietà secondaria, specifica un nome e un tipo di dati per la proprietà rispettivamente nei campi Nome e Tipo. Facoltativamente, puoi specificare un titolo e una descrizione per la proprietà.
-
Abilitare Calcolata se la proprietà è una proprietà calcolata, ovvero una proprietà il cui valore viene valutato in base a una regola o a un’espressione anziché essere immesso direttamente. Per ulteriori informazioni, vedere Modifica proprietà.
-
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. Questo binding automatico corrisponde sia al nome che al tipo di dati, garantendo che la proprietà figlio rimanga coerente con la relativa proprietà padre senza passaggi manuali aggiuntivi.
Per associare manualmente una proprietà figlio a una proprietà oggetto modello dati, selezionare l’icona Sfoglia accanto al campo Associa riferimento. Nella finestra di dialogo Seleziona oggetto sono elencate tutte le proprietà dell’oggetto modello dati padre. 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, perché per un’associazione valida è necessaria una corrispondenza del tipo di dati.
-
Seleziona Fine per salvare la proprietà figlio e seleziona Salva per salvare il modello dati del modulo (FDM). La proprietà figlio viene ora aggiunta all’oggetto modello dati.
Dopo aver creato gli oggetti e le proprietà del modello dati, puoi continuare a creare un Forms adattivo basato sul modello dati del modulo (FDM). Successivamente, quando saranno disponibili e configurate le origini dati, sarà possibile associare il modello dati del modulo (FDM) alle origini dati. Di conseguenza, l’associazione viene aggiornata automaticamente in tutti i Forms adattivi associati, in modo che le modifiche si propaghino senza la riconfigurazione manuale. Per ulteriori informazioni sulla creazione di un Forms adattivo tramite il modello dati del modulo (FDM), vedere Utilizzare il modello dati del 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 Aggiorna origini dati. Un oggetto o una proprietà del modello dati non associato esiste nel modello dati modulo (FDM) ma non è ancora mappato a un campo in un’origine dati connessa, pertanto non può leggere o scrivere dati finché non viene stabilita un’associazione. Quindi, per associare gli oggetti e le proprietà del modello di dati non associati, effettua le seguenti operazioni:
-
Nel modello dati del modulo selezionare l’origine dati non associata che si desidera associare a un’origine dati.
-
Seleziona Modifica proprietà.
-
Nel riquadro Modifica proprietà selezionare l’icona Sfoglia accanto al campo Associazione. L’icona Sfoglia apre la finestra di dialogo Seleziona oggetto, in cui sono elencate le origini dati aggiunte nel modello dati del modulo (FDM).
-
Espandi la struttura delle origini dati e seleziona un oggetto modello dati da associare, quindi seleziona l’icona di spunta.
-
Seleziona Fine per salvare le proprietà, quindi seleziona Salva per salvare il modello di dati del modulo. L’oggetto modello dati è ora associato a un’origine dati. In questo modo l’oggetto è in grado di leggere e scrivere nell’origine dati connessa in fase di esecuzione. In seguito al salvataggio, l’oggetto modello dati non viene più contrassegnato come Non associato, a conferma del completamento dell’associazione.
Configurare i servizi configure-services
La configurazione dei servizi di lettura e scrittura consente a un oggetto modello dati di leggere e scrivere dati all’interno di un modello dati modulo (FDM). La procedura seguente illustra come configurare i servizi di lettura e scrittura per un oggetto modello dati:
-
Selezionare la casella di controllo nella parte superiore di un oggetto modello dati per selezionarlo e selezionare Modifica proprietà.
Modificare le proprietà per configurare i servizi di lettura e scrittura per un oggetto modello dati
Viene visualizzata la finestra di dialogo Modifica proprietà.
Finestra di dialogo Modifica proprietà
note NOTE Oltre agli oggetti e ai servizi del modello dati, il documento dei metadati del servizio OData (Open Data Protocol) 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 del modulo (FDM), è disponibile un servizio in Modello dati modulo (FDM) 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 Utilizzo delle proprietà di navigazione dei servizi OData. -
Attiva Oggetto di primo livello per specificare se l’oggetto modello dati è un oggetto modello di primo livello.
Gli oggetti modello dati configurati in un modello dati modulo (FDM) sono disponibili per l’utilizzo nella scheda Oggetti modello dati nel browser Contenuto di un modulo adattivo basato sul modello dati modulo (FDM). Quando si aggiunge un’associazione tra due oggetti modello dati, l’oggetto modello dati a cui si sta effettuando l’associazione è nidificato nell’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. Di conseguenza, l’oggetto viene visualizzato due volte, una voce all’interno della gerarchia nidificata e un’altra all’esterno di essa, il che può confondere gli autori dei moduli. Per fare in modo che l’oggetto modello dati associato venga visualizzato solo nella gerarchia nidificata, disabilitare la proprietà Oggetto di primo livello. In questo modo gli autori dei moduli visualizzano una singola voce univoca, riducendo la confusione durante l’authoring dei moduli.
-
Selezionare i servizi Lettura e Scrittura per l’oggetto modello dati selezionato. Gli argomenti per i servizi selezionati vengono quindi visualizzati per la configurazione.
Servizi di lettura e scrittura configurati per l’origine dati dipendente
-
Selezionare
-
Seleziona Fine per salvare l’argomento, Fine per salvare le proprietà, quindi Salva per salvare il modello di dati del modulo.
Associa argomenti servizio di lettura bindargument
Associare un argomento del servizio di lettura a uno dei tre tipi di associazione, un attributo profilo utente, un attributo richiesta o un valore letterale, in base a un valore di associazione. Il servizio di lettura utilizza questo valore come argomento per recuperare i dettagli associati al valore specificato dall’origine dati. Ogni tipo di associazione determina la posizione di origine del valore dell’argomento: un input fisso, il profilo dell’utente connesso o la richiesta in ingresso.
Valore letterale literal-value
Selezionare Letterale dal menu a discesa Associazione a e immettere un valore nel campo Valore associazione. I dettagli associati al valore vengono recuperati dall’origine dati. Utilizzare questa opzione per recuperare i dettagli associati a un valore statico, poiché un’associazione letterale fornisce un input fisso e immutabile che non dipende dall’utente o dalla richiesta.
In questo esempio, i dettagli associati a 4367655678, come valore per l’argomento mobilenum, vengono recuperati dall’origine dati. I dettagli associati restituiti quando si passa il valore per un argomento numero di cellulare possono includere proprietà quali nome cliente, indirizzo cliente e città.
Attributo profilo utente user-profile-attribute
Selezionare Attributo profilo utente dal menu a discesa Associazione a e immettere il nome dell’attributo nel campo Valore associazione. I dettagli dell’utente connesso all’istanza Experience Manager vengono recuperati dall’origine dati in base al nome dell’attributo.
Il nome attributo specificato nel campo Valore binding deve includere il percorso di binding completo fino al nome attributo dell’utente. Apri il seguente URL per accedere ai dettagli utente su CRXDE:
https://[server-name]:[port]/crx/de/index.jsp#/home/users/
In questo esempio, specificare profile.empid nel campo Valore binding per l’utente grios.
L’argomento id prende il valore dell’attributo empid dal profilo utente e lo trasmette come argomento al servizio di lettura. Il 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
Utilizzare l’associazione Attributo richiesta per recuperare le proprietà associate dall’origine dati in base a un valore specificato nella richiesta in ingresso.
-
Selezionare Richiedi attributo dal menu a discesa Associazione a e immettere il nome dell’attributo nel campo Valore associazione.
-
Crea una sovrapposizione per head.jsp. Per creare la sovrapposizione, aprire CRX DE e copiare il file
https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jspinhttps://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jspnote 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
- Se utilizzi un modello statico, sovrapponi head.jsp in:
-
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 di petId dall’origine dati:
code language-javascript <%Map paraMap = new HashMap(); paraMap.put("petId",request.getParameter("petId")); request.setAttribute("paramMap",paraMap);%>
Di conseguenza, il servizio Read recupera i dettagli dall’origine dati in base al nome dell’attributo specificato nella richiesta.
Ad esempio, specificando l’attributo come petid=100 nella richiesta, vengono recuperate le proprietà associate a tale valore dell’attributo dall’origine dati.
Aggiungi associazioni add-associations
Le associazioni vengono in genere create tra oggetti modello dati in un’origine dati e vengono mantenute quando gli oggetti vengono inseriti in un modello dati del modulo (FDM). Un’associazione definisce la relazione tra due oggetti modello dati e può essere uno a uno o uno a molti.
Esiste un’associazione uno-a-molti quando un singolo record è correlato a più record. Ad esempio, un dipendente può avere più dipendenti associati al record dipendente. Questa relazione è definita associazione uno-a-molti ed è rappresentata da 1:n sulla linea che collega gli oggetti modello dati associati. Esiste un’associazione uno-a-uno quando una relazione restituisce esattamente un record corrispondente, ad esempio quando un’associazione restituisce un nome di dipendente univoco per un determinato ID dipendente, si tratta di un’associazione uno-a-uno.
Quando si aggiungono oggetti modello dati associati da un’origine dati a un modello dati del modulo (FDM), le relative associazioni vengono mantenute e visualizzate come collegate da linee freccia. È inoltre possibile aggiungere associazioni tra oggetti modello dati di diverse origini dati all’interno di un singolo modello dati modulo (FDM), che consente di combinare dati correlati provenienti da diversi sistemi back-end.
Per aggiungere un’associazione:
-
Selezionare la casella di controllo nella parte superiore di un oggetto modello dati per selezionarlo, quindi selezionare Aggiungi associazione. Viene visualizzata la finestra di dialogo Aggiungi associazione.
note NOTE Oltre agli oggetti modello dati e ai servizi, un documento di metadati del servizio Open Data Protocol (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 un modello dati modulo (FDM). Per ulteriori informazioni, vedere Utilizzo delle proprietà di navigazione dei servizi OData. Viene visualizzata la finestra di dialogo Aggiungi associazione.
Finestra di dialogo Aggiungi associazione
-
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 che si desidera associare.
Nell’esempio seguente, l’argomento predefinito per il servizio di lettura dell’oggetto modello dati Dependents è
dependentid.
L’argomento predefinito per il servizio di lettura Dipendenti è dependentid
Tuttavia, l’argomento deve essere una proprietà comune condivisa tra gli oggetti del modello dati di associazione, che in questo esempio è
Employeeid. Pertanto, poiché l’associazione dipende da una chiave corrispondente, l’argomentoEmployeeiddeve essere associato alla proprietàiddell’oggetto modello dati Employee. Questa associazione consente al sistema di recuperare i dettagli dei dipendenti associati dall’oggetto modello dati Dipendenti.
Argomento e associazione aggiornati
Seleziona Fine per salvare l’argomento.
-
Seleziona Fine per salvare l’associazione, quindi seleziona Salva per salvare il modello dati del modulo (FDM).
-
Ripeti i passaggi per creare associazioni aggiuntive, in base alle esigenze.
Modifica proprietà properties
La modifica delle proprietà consente di configurare il comportamento degli oggetti modello dati, delle relative proprietà e dei servizi all’interno del modello dati modulo (FDM). Tramite il riquadro Modifica proprietà è possibile definire i servizi, i tipi di dati, le chiavi e gli argomenti che determinano il modo in cui FDM legge, scrive e restituisce i dati.
Per modificare le proprietà:
-
Selezionare la casella di controllo accanto a un oggetto modello dati, una proprietà o un servizio nel modello dati modulo (FDM).
-
Seleziona Modifica proprietà. Viene aperto il riquadro Modifica proprietà per l’oggetto modello, la proprietà o il servizio selezionato.
-
Oggetto modello dati: specificare i servizi di lettura e scrittura e modificare gli argomenti. Questi servizi determinano il modo in cui i dati vengono recuperati e memorizzati nell’origine dati sottostante per l’oggetto.
-
Proprietà: specificare tipo, sottotipo e formato per la proprietà. È inoltre possibile designare la proprietà selezionata come chiave primaria per l’oggetto modello dati, che identifica in modo univoco ogni record.
-
Servizio: specificare l’oggetto modello di input, il tipo di output e gli argomenti per il servizio. Per un servizio Get, è possibile indicare se restituisce un array, assicurandosi che il servizio gestisca correttamente più record.
Finestra di dialogo Modifica proprietà per un servizio di recupero
-
-
Seleziona Fine per salvare la configurazione della proprietà, quindi seleziona Salva per salvare il modello dati modulo (FDM). Con questo salvataggio finale tutte le modifiche di proprietà vengono confermate in FDM.
Creare proprietà calcolate computed
Una proprietà calcolata deriva automaticamente il relativo valore da una regola o da 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 modulo (FDM). Poiché il valore viene calcolato anziché immesso manualmente, le proprietà calcolate riducono gli errori di immissione dei dati e mantengono coerenti i campi dipendenti quando i dati sottostanti cambiano.
Esempio: creare una proprietà calcolata FullName
Ad esempio, puoi creare una proprietà calcolata FullName il cui valore è il risultato della concatenazione delle proprietà esistenti FirstName e LastName. Per farlo, segui questi passaggi:
-
Creare una nuova proprietà denominata
FullNameil cui tipo di dati è String. -
Abilita Computed e seleziona Done per creare la proprietà.
La proprietà calcolata FullName è stata creata. Accanto alla proprietà viene visualizzata un’icona per indicare che si tratta di una proprietà calcolata.
-
Seleziona la proprietà FullName, quindi seleziona Modifica regola. Viene visualizzata la finestra dell’editor delle regole.
-
Nella finestra dell’editor di regole, seleziona Crea. Viene visualizzata una finestra della regola Imposta valore.
Dall’elenco a discesa Seleziona opzione, selezionare Espressione matematica. Le altre opzioni disponibili sono Oggetto modello dati modulo e Stringa.
-
Nell’espressione matematica, selezionare FirstName come primo oggetto e LastName come secondo oggetto. Seleziona più come operatore.
Seleziona Fine, quindi seleziona Chiudi per chiudere la finestra dell’editor di regole. La regola completata è simile alla seguente.
-
Nel Modello dati modulo (FDM), selezionare Salva. Proprietà calcolata configurata. In questo modo il valore FullName viene aggiornato automaticamente ogni volta che FirstName o LastName viene modificato, in modo che il nome completo concatenato rimanga sempre sincronizzato con i campi di origine.
Utilizzare le proprietà di navigazione dei servizi OData work-with-navigation-properties-of-odata-services
Le proprietà di navigazione nei servizi OData definiscono le associazioni tra due oggetti modello dati, stabilendo il modo in cui un’entità si relaziona e può passare a un’altra. Queste proprietà sono definite in un tipo di entità o un tipo complesso e consentono a un client di passare da un record ai record correlati. Nell’estratto seguente del file di metadati dei servizi di esempio OData TripPin di esempio, l’entità Person contiene tre proprietà di navigazione: Friends, BestFriend e Trips.
Per ulteriori informazioni sulle proprietà di navigazione, vedere la documentazione OData.
<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>
Visualizzazione delle proprietà di navigazione nel modello dati del modulo
Quando si configura un servizio OData in un Modello dati modulo (FDM), tutte le proprietà di navigazione in un contenitore di entità vengono rese automaticamente disponibili tramite un singolo servizio in FDM. Questo consolidamento significa che non è necessario un servizio separato per ogni associazione, in quanto l’FDM li affianca insieme. In questo esempio del servizio OData TripPin, le tre proprietà di navigazione nel contenitore di entità Person possono essere lette tutte utilizzando un servizio GET LINK in FDM.
Di seguito viene evidenziato il servizio GET LINK of Person /People in FDM, che è un servizio combinato per le tre proprietà di navigazione: Friends, BestFriend e Trips nell’entità Person del servizio OData TripPin.
Configurazione del servizio GET LINK
Dopo aver aggiunto il servizio GET LINK alla scheda Servizi in FDM, è possibile modificarne le proprietà per scegliere l’oggetto modello di output e la proprietà di navigazione da utilizzare nel servizio. Ad esempio, il servizio GET LINK of Person /People seguente utilizza Trip come oggetto modello di output e Trips come proprietà di navigazione.
In questo esempio, puoi anche scegliere Persona come oggetto modello di output e impostare l’argomento della proprietà di navigazione su Friends o BestFriend, a seconda che sia Restituisci array? è abilitato o disabilitato.
Utilizzo delle proprietà di navigazione nelle associazioni
Analogamente, è possibile scegliere un servizio GET LINK e configurarne le proprietà di navigazione quando si aggiungono associazioni in FDM. Tuttavia, la selezione di una proprietà di navigazione è possibile solo quando il campo Associazione a è impostato su Letterale; a causa di questo requisito, le opzioni della proprietà di navigazione non diventano selezionabili finché l’associazione non viene configurata correttamente.
Generare e modificare i dati di esempio sample
L’editor FDM (Form Data Model) genera dati di esempio per tutte le proprietà dell’oggetto modello dati in un modello dati modulo, incluse proprietà calcolate. Questi dati di esempio sono costituiti da un set di valori casuali conformi al tipo di dati configurato per ogni proprietà, che fornisce valori di test realistici senza richiedere una connessione a un’origine dati attiva.
Dati di esempio
I dati di esempio fungono da input di test pronto per l’uso e consentono di visualizzare in anteprima e convalidare il comportamento di un modello di dati modulo prima di associarlo ai dati di produzione. Poiché ogni valore generato rispetta il tipo di dati configurato della relativa proprietà, il set di esempi riflette la struttura e il formato previsti dei record reali, consentendo di verificare le associazioni, la logica calcolata e il comportamento dei moduli nelle prime fasi di sviluppo.
Puoi anche modificare i valori generati e salvare le modifiche. I dati salvati vengono conservati anche se rigenerate i dati di esempio, in modo che i test case curati manualmente persistano tra le rigenerazioni. Questo consente di creare scenari di test stabili e riutilizzabili, senza perdere le modifiche ogni volta che vengono prodotti nuovi valori casuali.
Passaggi per generare e modificare i dati di esempio
-
Apri un modello dati modulo (FDM) e seleziona Modifica dati di esempio. L’editor FDM genera e visualizza i dati di esempio nella finestra Modifica dati di esempio.
-
Nella finestra Modifica dati di esempio, modificare i dati come richiesto e selezionare Salva. I dati di esempio modificati vengono salvati e conservati, rimanendo disponibili anche dopo la rigenerazione dei dati di esempio.
Test di servizi e oggetti del modello dati test-data-model-objects-and-services
Una volta configurato il modello dati del modulo (FDM), testa gli oggetti e i servizi del modello dati configurato prima di distribuirlo in un modulo live per verificare che funzioni come previsto. Il test prima della distribuzione verifica che ogni oggetto e servizio restituisca i dati corretti, riducendo il rischio di errori di runtime quando il modulo viene messo in produzione.
Per testare gli oggetti e i servizi del modello dati:
-
Selezionare un oggetto modello dati o un servizio nel modello dati modulo (FDM), quindi selezionare rispettivamente Oggetto modello di test o Servizio di test.
Viene visualizzata la finestra Test modello dati modulo.
-
Nella finestra Test modello dati modulo, selezionare l’oggetto o il servizio del modello dati da testare dal riquadro Input. Questo identifica l’oggetto o il servizio specifico che desideri convalidare.
-
Specifica un valore di argomento nel codice di test, quindi seleziona Test. In caso di esito positivo, il test restituisce l’output nel riquadro Output, confermando che l’oggetto o il servizio selezionato è configurato correttamente e in grado di recuperare o elaborare i dati come previsto.
Seguendo la stessa procedura, è possibile convalidare oggetti e servizi del modello dati aggiuntivi nel modello dati modulo (FDM) per garantire che l’intero modello funzioni in modo affidabile prima dell’uso.
Convalida automatica dei dati di input automated-validation-of-input-data
Il Modello dati modulo (FDM) convalida automaticamente i dati ricevuti come input ogni volta che viene richiamata l’API DermisBridge, applicando i criteri di convalida definiti nel modello dati del modulo. Questa convalida è controllata dal flag ValidationOptions impostato nell’oggetto query utilizzato per richiamare l’API. Per impostazione predefinita, se non viene impostato alcun valore per il flag ValidationOptions, FDM esegue la convalida BASIC sui dati di input.
Livelli del flag ValidationOptions
Il flag ValidationOptions accetta uno dei tre valori seguenti, ciascuno dei quali definisce il livello di rigorosità con cui FDM convalida l’input:
- FULL: FDM convalida l’input rispetto a tutti i vincoli definiti. Utilizzare questo livello per applicare ogni tipo di dati e vincolo della regola business prima dell’elaborazione dei dati.
- OFF: FDM non esegue alcuna convalida. I dati di input vengono trasmessi senza alcun controllo dei vincoli.
- BASE: FDM convalida solo i vincoli
requiredenullable. In questo modo i campi obbligatori sono presenti e le regole di gestione dei valori Null vengono rispettate senza valutare l’intero set di vincoli.
Se non viene impostato alcun valore per il flag ValidationOptions, FDM applica la convalida BASIC per impostazione predefinita.
Impostazione del flag di convalida
Nell’esempio seguente il flag di convalida viene impostato su FULL e viene abilitata la convalida rispetto a tutti i vincoli:
operationOptions.setValidationOptions(ValidationOptions.FULL);
ValidationOptions. Quando il livello di registro è impostato su Debug, l'API registra l'errore corrispondente nel file error.log.Vincoli del tipo di dati per origine dati
Il modello dati modulo (FDM) convalida i dati di input in base a un elenco definito di vincoli per i tipi di dati. Questo elenco di vincoli può variare a seconda dell’origine dati sottostante, pertanto i vincoli esatti applicati durante la convalida sono determinati dall’origine dati associata al modello dati del modulo.
Nella tabella seguente sono elencati i vincoli dei tipi di dati applicati ai dati di input per ogni origine dati supportata:
Convalida dei dati di input tramite vincoli Swagger
I dati di input superano la convalida solo se è presente l’ID ordine e il relativo valore rientra nell’intervallo 1-10. In questo esempio, i dati di input vengono convalidati in base ai vincoli maximum, minimum e required definiti nel file Swagger (OpenAPI). I tre tipi di vincolo seguenti determinano l’input accettato:
- obbligatorio — è necessario specificare il parametro. Un
orderIdmancante non riesce la convalida. - minimum — il valore non deve essere inferiore a 1.
- max — il valore non deve superare 10.
Poiché i vincoli vengono dichiarati direttamente nella definizione API, la convalida viene applicata automaticamente a livello di schema prima dell’esecuzione dell’operazione. In questo modo solo le richieste ben formate raggiungono il servizio sottostante.
parameters: [
{
name: "orderId",
in: "path",
description: "ID of pet that must be fetched",
required: true,
type: "integer",
maximum: 10,
minimum: 1,
format: "int64"
}
]
Comportamento di errore di convalida e registrazione degli errori
Il sistema genera un’eccezione di convalida quando i dati di input non soddisfano questi criteri. In seguito a questo errore e quando il livello di registro è impostato su Debug, viene scritto un errore nel file error.log. Questo comportamento di registrazione consente agli sviluppatori di diagnosticare esattamente quale vincolo è stato violato, poiché la voce di registro identifica il parametro che ha generato l’errore, il vincolo violato e il valore che ha causato l’errore.
Ad esempio, l’invio di un orderId di 16 supera il massimo dichiarato di 10, generando la seguente voce di registro:
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)"]}}
La voce di errore acquisisce il codice di errore AEM-FDM-001-044, il messaggio "Input validations failed during operation execution." e un blocco violations che indica il campo /orderId, il massimo richiesto di 10 e il valore trovato (16). Grazie a questa struttura, identificare e correggere gli ingressi non compresi nell’intervallo è più semplice.
Passaggi successivi next-steps
Hai un Modello dati modulo (FDM) funzionante che è ora pronto per l’utilizzo nei flussi di lavoro di Forms adattivi. Un modello per dati modulo rappresenta la struttura e le relazioni dei dati che i moduli acquisiscono e scambiano con origini dati collegate, fornendo uno schema unificato e riutilizzabile a cui Forms adattivo può associarsi direttamente. Poiché il modello astrae i servizi dati sottostanti in un unico livello coerente, consente ai moduli di leggere e scrivere in tali origini senza richiedere la ricostruzione della logica di integrazione per ogni nuovo modulo.
Con il modello attivo, è ora possibile applicarlo alle attività di creazione dei moduli. I passaggi successivi comuni includono:
- Associa i campi modulo al modello in modo che i componenti del modulo adattivo vengano mappati direttamente agli attributi dei dati definiti in FDM, garantendo un’acquisizione e un invio coerenti dei dati.
- Precompila moduli con dati esistenti recuperati tramite il modello, il che migliora l’esperienza utente riducendo l’immissione manuale dei dati.
- Configura invio modulo per riscrivere i dati acquisiti nelle origini dati connesse tramite il modello, mantenendo i record sincronizzati.
- Riutilizzare il modello in più moduli per mantenere la coerenza e ridurre le operazioni di configurazione duplicate.
Il riutilizzo di un singolo modello di dati modulo tra flussi di lavoro promuove la coerenza e riduce la manutenzione continua, perché gli aggiornamenti al modello si propagano a ogni modulo che dipende da esso. Per istruzioni dettagliate sull’applicazione del modello nel Forms adattivo, vedi Utilizzare il modello dati del modulo (FDM).