Definire una relazione uno-a-uno tra due schemi utilizzando l’Schema Editor relationship-ui
La capacità di comprendere le relazioni tra i clienti e le loro interazioni con il brand attraverso vari canali è una parte importante di Adobe Experience Platform. Definizione di queste relazioni all'interno della struttura Experience Data Model Gli schemi (XDM) consentono di ottenere informazioni complesse sui dati dei clienti.
Anche se le relazioni tra schemi possono essere dedotte tramite l’utilizzo dello schema di unione e Real-Time Customer Profile, applicabile solo agli schemi che condividono la stessa classe. Per stabilire una relazione tra due schemi appartenenti a classi diverse, è necessario aggiungere a uno schema di origine un campo relazione dedicato che faccia riferimento all’identità dell’altro schema correlato.
Questo documento fornisce un tutorial per definire una relazione tra due schemi utilizzando l’Editor di schema nel Experience Platform dell'utente. Per informazioni sulla definizione delle relazioni tra schemi tramite l’API, consulta l’esercitazione su definizione di una relazione tramite l’API Schema Registry.
Introduzione
Questo tutorial richiede una buona conoscenza di XDM System e l’Editor di schema nel Experience Platform UI. Prima di iniziare questo tutorial, consulta la seguente documentazione:
- Sistema XDM in Experience Platform: panoramica di XDM e della relativa implementazione in Experience Platform.
- Nozioni di base sulla composizione dello schema: introduzione dei blocchi predefiniti degli schemi XDM.
- Creare uno schema utilizzando Schema Editor: tutorial che illustra le nozioni di base sull’utilizzo di Schema Editor.
Definire uno schema di origine e di riferimento
È previsto che tu abbia già creato i due schemi che verranno definiti nella relazione. A scopo dimostrativo, questa esercitazione crea una relazione tra i membri del programma fedeltà di un’organizzazione (definito in un’ "Loyalty Members") e il loro hotel preferito (definito in una "Hotels").
Le relazioni tra schemi sono rappresentate da un campo dedicato all’interno di un schema di origine che punta a un altro campo all’interno di un schema di riferimento. Nei passaggi successivi, "Loyalty Members" sarà lo schema di origine, mentre "Hotels" fungerà da schema di riferimento.
Le sezioni seguenti descrivono la struttura di ogni schema utilizzato in questa esercitazione prima della definizione di una relazione.
Loyalty Members schema
Lo schema di origine "Loyalty Members" si basa sul XDM Individual Profile classe, contenente un campo che descrive i membri di un programma fedeltà. Uno di questi campi, personalEmail.addess
, funge da identità primaria per lo schema nella sezione E-mail spazio dei nomi. Come mostrato nella Proprietà schema, questo schema è stato abilitato per l’utilizzo in Real-Time Customer Profile.
Hotels schema
Lo schema di riferimento "Hotels" si basa su un personalizzato "Hotels" e contiene campi che descrivono un hotel. Per poter partecipare a una relazione, lo schema di riferimento deve anche avere un’identità primaria definita ed essere abilitato per Profilo. In questo caso, _tenantId.hotelId
funge da identità primaria per lo schema, utilizzando un tag personalizzato "Hotel ID" spazio dei nomi delle identità.
Creare un gruppo di campi relazione
Per definire una relazione tra due schemi, lo schema di origine deve disporre di un campo dedicato che indicherà l’identità primaria dello schema di riferimento. È possibile aggiungere questo campo allo schema di origine creando un nuovo gruppo di campi schema o estendendone uno esistente.
Nel caso di Loyalty Members schema, un nuovo preferredHotel
verrà aggiunto il campo per indicare l’hotel preferito dal membro fedeltà per le visite aziendali. Per iniziare, seleziona l’icona più (+) accanto al nome dello schema di origine.
Nell’area di lavoro viene visualizzato un nuovo segnaposto di campo. Sotto Proprietà campo, fornire un nome di campo e un nome visualizzato per il campo e impostarne il tipo su "Stringa". Sotto Assegna a, selezionare un gruppo di campi esistente da estendere o digitare un nome univoco per creare un nuovo gruppo di campi. In questo caso, un nuovo "Preferred Hotel"viene creato un gruppo di campi.
Al termine, seleziona Applica.
Il valore aggiornato preferredHotel
viene visualizzato nell’area di lavoro, sotto a _tenantId
poiché è un campo personalizzato. Seleziona Salva per finalizzare le modifiche apportate allo schema.
Definire un campo relazione per lo schema di origine relationship-field
Una volta definito un campo di riferimento dedicato per lo schema di origine, puoi designarlo come campo di relazione.
Seleziona la preferredHotel
nell’area di lavoro, quindi scorri verso il basso in Proprietà campo fino al Relazione viene visualizzata la casella di controllo. Selezionare la casella di controllo per visualizzare i parametri richiesti per la configurazione di un campo relazione.
Seleziona il menu a discesa per Schema di riferimento e seleziona lo schema di riferimento per la relazione ("Hotels" in questo esempio). Sotto Spazio dei nomi dell’identità di riferimento, seleziona lo spazio dei nomi del campo di identità dello schema di riferimento (in questo caso, "Hotel ID"). Seleziona Applica al termine.
Il preferredHotel
viene ora evidenziato come relazione nell’area di lavoro, con il nome dello schema di riferimento. Seleziona Salva per salvare le modifiche e completare il flusso di lavoro.
Passaggi successivi
Seguendo questa esercitazione, hai creato correttamente una relazione uno-a-uno tra due schemi utilizzando Schema Editor. Per i passaggi su come definire le relazioni utilizzando l’API, consulta l’esercitazione su definizione di una relazione tramite l’API Schema Registry.