Utilizzare il modello dati del modulo

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 modulo e selezionare Aggiungi selezionati.

Servizi e oggetti modello dati selezionati

Nella scheda Modello viene visualizzata 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).

Nella scheda Modello vengono visualizzati gli oggetti modello dati aggiunti

NOTA

È 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 modulo (FDM) sono disattivati nel riquadro Origini dati.

Nella scheda Servizi sono elencati i servizi aggiunti.

Nella scheda Servizi sono visualizzati i servizi del modello dati

NOTA

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

Seleziona Salva per salvare l'oggetto modello modulo.

NOTA

Puoi richiamare i servizi configurati nella scheda Servizi di un modello dati modulo (FDM) utilizzando le regole del modulo adattivo. I servizi configurati sono disponibili nell'azione Richiama servizi dell'editor di regole Per ulteriori informazioni sull'utilizzo di questi servizi nelle regole dei moduli adattivi, vedere Richiama servizi e Imposta valore delle regole nell'editor di regole.

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 del modulo (FDM). L’oggetto modello dati appena aggiunto non è associato a un’origine dati e non dispone di proprietà come mostrato nell’immagine seguente.

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

Abilita Calcolato se la proprietà è una proprietà calcolata. Il valore di una proprietà calcolata viene valutato in base a una regola o a un'espressione. Per ulteriori informazioni, 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.

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.

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

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. Viene aperta la finestra di dialogo Seleziona oggetto in cui sono elencate le origini dati aggiunte nel modello dati del modulo.

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

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

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à

NOTA

Oltre agli oggetti modello dati e ai servizi, il documento metadati servizio OData include proprietà di navigazione che definiscono l'associazione tra due oggetti modello dati. Quando si aggiunge un'origine dati del servizio OData a un modello dati del modulo (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 sotto l'oggetto modello dati a cui si sta associando nella scheda Oggetti modello dati. Se il modello dati nidificato è un oggetto di livello principale, verrà visualizzato separatamente anche nella scheda Oggetti modello dati. Di conseguenza, vengono visualizzate due voci, una all'interno e un'altra all'esterno della gerarchia nidificata, che potrebbero confondere gli autori del modulo. Per fare in modo che l'oggetto modello dati associato venga visualizzato solo nella gerarchia nidificata, disattivare la proprietà Oggetto di livello superiore.

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

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

Selezionare per l'argomento del servizio di lettura per associare l'argomento a un attributo del profilo utente, un attributo di richiesta o un valore letterale e specificare il valore di associazione.

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

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.jsp in 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

Imposta paramMap per l'attributo di richiesta. Ad esempio, includi 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, utilizza il codice seguente per recuperare il valore petid dall’origine dati:

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

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

Selezionare 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 gli argomenti di modifica.

• Proprietà: specificare il tipo, il sottotipo e il formato per la proprietà. È inoltre possibile specificare se la proprietà selezionata è la chiave primaria per l'oggetto modello dati.

• Servizio: specificare l'oggetto modello di input, il tipo di output e gli argomenti per il servizio. Per un servizio Get, è possibile specificare se deve restituire un array.

  

Finestra di dialogo Modifica proprietà per un servizio di recupero

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

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

Abilita Computed e seleziona Done per creare la proprietà.

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

Selezionare la proprietà FullName e selezionare Modifica regola. Viene visualizzata una finestra dell’editor di 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. Altre opzioni disponibili sono Oggetto modello dati modulo e Stringa.

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

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

Nel modello dati modulo (FDM), selezionare Salva. Proprietà calcolata configurata.

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

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

Selezionare un oggetto modello dati o un servizio nel modello dati modulo (FDM) e selezionare rispettivamente Oggetto modello test o Servizio 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 verificare nel riquadro di input.

Specificare un valore di argomento nel codice di test e selezionare Test. In caso di esito positivo, il test restituisce l’output nel riquadro Output.