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. La definizione di queste relazioni all'interno della struttura degli schemi Experience Data Model (XDM) consente di ottenere informazioni complesse sui dati dei clienti.
Sebbene sia possibile dedurre le relazioni tra schemi tramite lo schema di unione e Real-Time Customer Profile, questo vale solo per gli 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'esercitazione per definire una relazione tra due schemi utilizzando l'Editor di schema nell'interfaccia utente Experience Platform. Per i passaggi relativi alla definizione delle relazioni tra schemi tramite l'API, vedere il tutorial su definizione di una relazione tramite l'API Schema Registry.
Introduzione
Questo tutorial richiede una buona conoscenza di XDM System e dell'Editor di schema nell'interfaccia utente di Experience Platform. Prima di iniziare questo tutorial, consulta la seguente documentazione:
- Sistema XDM nell'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.
- Crea uno schema utilizzando Schema Editor: un 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 uno schema "Loyalty Members") e il loro hotel preferito (definito in uno schema "Hotels").
Le relazioni tra schemi sono rappresentate da un campo dedicato all'interno di uno schema di origine che punta a un altro campo all'interno di uno schema di riferimento. Nei passaggi seguenti, "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.
Schema Loyalty Members
Lo schema di origine "Loyalty Members" è basato sulla classe XDM Individual Profile, contenente un campo che descrive i membri di un programma fedeltà. Uno di questi campi, personalEmail.addess, funge da identità primaria per lo schema nello spazio dei nomi E-mail. Come visto in Proprietà schema, questo schema è stato abilitato per l'utilizzo in Real-Time Customer Profile.
Schema Hotels
Lo schema di riferimento "Hotels" è basato su una classe "Hotels" personalizzata e contiene campi che descrivono un hotel. Per poter partecipare a una relazione, lo schema di riferimento deve inoltre avere un'identità primaria definita ed essere abilitato per Profilo. In questo caso, _tenantId.hotelIdfunge da identità primaria per lo schema, utilizzando uno spazio dei nomi di identità "Hotel ID" personalizzato.
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 dello schema Loyalty Members, verrà aggiunto un nuovo campo preferredHotel per indicare l'hotel preferito del 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. In Proprietà campo, fornire un nome di campo e un nome visualizzato per il campo e impostarne il tipo su "Stringa". In 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, viene creato un nuovo gruppo di campi "Preferred Hotel".
Al termine, selezionare Applica.
Il campo preferredHotel aggiornato viene visualizzato nell'area di lavoro, che si trova sotto un oggetto _tenantId poiché è un campo personalizzato. Seleziona Salva per finalizzare le modifiche 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 il campo preferredHotel nell'area di lavoro, quindi seleziona Aggiungi relazione nella barra laterale Proprietà campo.
Viene visualizzata la finestra di dialogo Aggiungi relazione. Da questa finestra di dialogo è possibile impostare i parametri richiesti per la configurazione di un campo relazione. Per gli utenti di Real-Time CDP B2C, puoi only impostare una relazione uno-a-uno tra lo schema di origine e quello di riferimento.
Utilizza il menu a discesa per Schema di riferimento e seleziona lo schema di riferimento per la relazione ("Hotels" in questo esempio).
Lo spazio dei nomi dell'identità dello schema di riferimento (in questo caso, "Hotel ID") viene popolato automaticamente in Spazio dei nomi dell'identità di riferimento. Al termine, seleziona Applica.
Il campo preferredHotel è 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.
Modifica un campo relazione esistente edit-relationship
Per modificare lo schema di riferimento, selezionare un campo con una relazione esistente, quindi selezionare Modifica relazione nella barra laterale Proprietà campo.
Viene visualizzata la finestra di dialogo Modifica relazione. Da qui puoi seguire il processo descritto in definizione di un campo relazione o eliminare la relazione. Selezionare Elimina relazione per rimuovere la relazione con lo schema di riferimento.
Filtrare e cercare relazioni filter-and-search
Puoi filtrare e cercare relazioni specifiche all'interno degli schemi dalla scheda Relazioni dell'area di lavoro Schemi. È possibile utilizzare questa visualizzazione per individuare e gestire rapidamente le relazioni. Per istruzioni dettagliate sulle opzioni di filtro, leggi il documento su esplorazione delle risorse dello schema.
Passaggi successivi
Seguendo questa esercitazione, è stata creata una relazione uno-a-uno tra due schemi utilizzando Schema Editor. Per i passaggi su come definire le relazioni utilizzando l'API, vedere l'esercitazione su definizione di una relazione mediante l'API Schema Registry.