Skapa ett schema med Schema Editor

Med Adobe Experience Platform användargränssnitt kan du skapa och hantera Experience Data Model (XDM) scheman på en interaktiv visuell arbetsyta som kallas Schema Editor. I den här självstudiekursen beskrivs hur du skapar ett schema med Schema Editor.

I demonstrationssyfte handlar stegen i den här självstudien om att skapa ett exempelschema som beskriver medlemmar i ett kundlojalitetsprogram. Du kan använda de här stegen för att skapa ett annat schema för dina egna syften, men vi rekommenderar att du först följer med när du skapar exempelschemat för att lära dig funktionerna i Schema Editor.

Komma igång

Den här självstudiekursen kräver en fungerande förståelse för de olika aspekter av Adobe Experience Platform som används för att skapa scheman. Innan du börjar med den här självstudiekursen bör du läsa om följande koncept i dokumentationen:

Öppna Schemas arbetsyta browse

The Schemas arbetsytan i Platform Gränssnittet ger en visualisering av Schema Library, så att du kan visa hur du hanterar de scheman som är tillgängliga för din organisation. Arbetsytan innehåller även Schema Editor, arbetsytan som du kan använda för att skapa ett schema genom hela kursen.

Efter inloggning Experience Platform, markera Schemas i den vänstra navigeringen för att öppna Schemas arbetsyta. The Browse -fliken visar en lista med scheman (en representation av Schema Library) så att du kan visa och anpassa. Listan innehåller namn, typ, klass och beteende (post- eller tidsserie) som schemat baseras på samt datum och tid då schemat senast ändrades.

Se guiden på undersöka befintliga XDM-resurser i användargränssnittet för mer information.

Skapa och namnge ett schema create

Börja skapa ett schema genom att välja Create schema i det övre högra hörnet av Schemas arbetsyta.

The Create schema arbetsflödet visas. Välj sedan en basklass för schemat. Du kan välja mellan huvudklasserna i XDM Individual Profile och XDM ExperienceEvent, eller Other om dessa klasser inte passar dina syften. The Other kan du antingen skapa en ny klass eller välj bland andra befintliga klasser.

Se XDM-individuell profil och XDM ExperienceEvent mer information om dessa klasser. I den här självstudiekursen väljer du XDM Individual Profile följt av Next.

När du har valt en klass Name and review visas. I det här avsnittet anger du ett namn och en beskrivning som identifierar ditt schema. Det finns flera viktiga saker att tänka på när du ska bestämma ett namn för schemat:

I den här självstudiekursen skapas ett schema för att importera data som är relaterade till medlemmarna i ett lojalitetsprogram, och schemat får därför namnet "Loyalty Members".

​ Schemats grundstruktur (tillhandahålls av klassen) visas på arbetsytan så att du kan granska och verifiera den valda klass- och schemastrukturen.

Ange ett användarvänligt Schema display name i textfältet. Ange sedan en lämplig beskrivning för att identifiera schemat. När du har granskat schemastrukturen och är nöjd med dina inställningar väljer du Finish för att skapa ditt schema.

The Schema Editor visas. Det här är arbetsytan som du kommer att komponera ditt schema på. Det självskrivna schemat skapas automatiskt i Structure -delen av arbetsytan när du kommer till redigeraren, tillsammans med standardfälten som ingår i den basklass som du har valt. Den tilldelade klassen för schemat listas också under Class in Composition -avsnitt.

Lägg till en fältgrupp field-group

Nu kan du börja lägga till fält i schemat genom att lägga till fältgrupper. En fältgrupp är en grupp med ett eller flera fält som ofta används tillsammans för att beskriva ett visst koncept. I den här självstudiekursen används fältgrupper för att beskriva medlemmarna i bonusprogrammet och samla in viktig information som namn, födelsedag, telefonnummer, adress med mera.

Om du vill lägga till en fältgrupp väljer du Add i Field groups undersektion.

En ny dialogruta visas med en lista över tillgängliga fältgrupper. Varje fältgrupp är endast avsedd att användas med en viss klass. Därför visas bara fältgrupper som är kompatibla med den klass du valde (i det här fallet visas XDM Individual Profile klass). Om du använder en standard-XDM-klass sorteras listan med fältgrupper på ett intelligent sätt baserat på användningens popularitet.

Du kan välja ett av filtren i den vänstra listen för att begränsa listan med standardfältgrupper till specifika branscher som detaljhandel, finansiella tjänster och hälso- och sjukvård.

Om du väljer en fältgrupp i listan visas den i den högra listen. Om du vill kan du markera flera fältgrupper och lägga till var och en i listan i den högra listen innan du bekräftar. Dessutom visas en ikon till höger om den markerade fältgruppen där du kan förhandsgranska strukturen för de fält som gruppen innehåller.

När du förhandsgranskar en fältgrupp visas en detaljerad beskrivning av fältgruppens schema i den högra listen. Du kan även navigera genom fältgruppens fält på den angivna arbetsytan. När du väljer olika fält uppdateras den högra listen så att information om fältet i fråga visas. Välj Back när du är klar med förhandsgranskningen för att återgå till dialogrutan för val av fältgrupp.

För den här självstudiekursen väljer du Demographic Details fältgrupp och sedan markera Add field group.

Arbetsytan för schemat visas igen. The Field groups sektioner nu listor "Demographic Details" och Structure -avsnittet innehåller fälten från fältgruppen. Du kan välja fältgruppens namn under Field groups för att markera specifika fält på arbetsytan.

Den här fältgruppen bidrar med flera fält under namnet på den översta nivån person med datatypen "Person". Den här gruppen med fält beskriver information om en individ, inklusive namn, födelsedatum och kön.

Observera att name fältet har datatypen "Full name", vilket innebär att det också beskriver ett vanligt koncept och innehåller namnrelaterade underfält som förnamn, efternamn, titel och suffix.

Markera de olika fälten på arbetsytan för att visa eventuella ytterligare fält som de bidrar till schemastrukturen.

Lägg till fler fältgrupper field-group-2

Nu kan du upprepa samma steg för att lägga till en annan fältgrupp. När du visar Add field group lägg märke till attDemographic Details"fältgruppen är nedtonad och det går inte att markera kryssrutan intill den. Detta förhindrar att du av misstag duplicerar fältgrupper som du redan har inkluderat i det aktuella schemat.

Välj standardfältgrupper för den här självstudiekursen Personal Contact Details och Loyalty Details i listan och välj Add field groups för att lägga till dem i schemat.

Arbetsytan visas igen med de nya fältgrupperna som listas under Field groups i Composition och deras sammansatta fält läggs till i schemastrukturen.

Definiera en anpassad fältgrupp define-field-group

The Loyalty Members schemat är avsett att samla in data som är relaterade till medlemmarna i ett lojalitetsprogram och till standardprogrammet Loyalty Details fältgrupp som du har lagt till i schemat innehåller de flesta av dessa, inklusive programtyp, punkter, kopplingsdatum med mera.

Det kan dock finnas ett scenario där du vill inkludera ytterligare anpassade fält som inte täcks av standardfältgrupper för att uppnå dina användningsfall. Om du vill lägga till anpassade bonusfält har du två alternativ:

Om du vill skapa en ny fältgrupp väljer du Add i Field groups underavsnitt som tidigare, men den här gången väljer Create New Field group i den övre delen av dialogrutan som visas. Du ombeds sedan ange ett visningsnamn och en beskrivning för den nya fältgruppen. I den här självstudiekursen ger du den nya fältgruppen namnetCustom Loyalty Details", välj Add field groups.

"Custom Loyalty Details" ska nu visas under Field groups till vänster på arbetsytan, men det finns inga fält som är kopplade till den ännu och därför visas inga nya fält under Structure.

Lägg till fält i fältgruppen field-group-fields

Nu när du har skapatCustom Loyalty Detailsfältgruppen är det dags att definiera de fält som fältgruppen ska bidra till schemat.

Börja med att välja plus (+) -ikonen bredvid namnet på schemat på arbetsytan.

An "Untitled Field" visas som platshållare på arbetsytan, och den högra listen uppdateras för att visa konfigurationsalternativen för fältet.

I det här scenariot måste schemat ha ett objekttypsfält som beskriver personens aktuella lojalitetsnivå i detalj. Börja skapa en loyaltyTier fält med typen "Object" som kommer att användas för dina relaterade fält.

Under Assign to måste du välja en fältgrupp som fältet ska tilldelas. Kom ihåg att alla schemafält tillhör antingen en klass eller en fältgrupp, och eftersom schemat använder en standardklass är det enda alternativet att välja en fältgrupp. Börja skriva in namnetCustom Loyalty Details" och välj sedan fältgruppen i listan.

När du är klar väljer du Apply.

Ändringarna används och de nyskapade loyaltyTier visas. Eftersom detta är ett anpassat fält kapslas det automatiskt in i ett objekt som namnges efter organisationens klientorganisations-ID, föregånget av ett understreck (_tenantId i det här exemplet).

Välj plus (+) -ikonen bredvid loyaltyTier -objekt som ska börja läggas till underfält. En ny fältplatshållare visas och Field properties -avsnittet visas till höger på arbetsytan.

Varje fält kräver följande information:

Det första fältet för loyaltyTier objektet blir en sträng som anropas id, som representerar ID:t för förmånsmedlemmens aktuella nivå. Nivå-ID är unikt för varje lojalitetsmedlem, eftersom det här företaget anger olika tröskelvärden för lojalitetsskikt för varje kund baserat på olika faktorer. Ställ in det nya fältets typ tillString", och Field properties -avsnittet fylls i med flera alternativ för att tillämpa begränsningar, inklusive standardvärde, format och maximal längd. Läs dokumentationen om bästa praxis för datavalideringsfält om du vill veta mer.

Sedan id kommer att vara en slumpmässigt genererad friformssträng, inga ytterligare begränsningar krävs. Välj Apply för att tillämpa ändringarna.

Lägg till fler fält i fältgruppen field-group-fields-2

Nu när du har lagt till id kan du lägga till ytterligare fält för att hämta information om lojalitetsnivån, till exempel:

Om du vill lägga till varje fält i schemat väljer du plus (+) -ikonen bredvid loyalty och fylla i den information som krävs.

När det är klart loyaltyTier objektet innehåller fält för id, currentThreshold, nextThresholdoch effectiveDate.

Lägg till ett uppräkningsfält i fältgruppen enum

När du definierar fält i Schema EditorDet finns dock ytterligare alternativ som du kan använda för grundläggande fälttyper för att ge ytterligare begränsningar för de data som fältet kan innehålla. Användningsexempel för dessa begränsningar förklaras i följande tabell:

För den här självstudiekursen loyaltyTier -objektet i schemat kräver ett nytt uppräkningsfält som beskriver skiktklassen, där värdet bara kan vara ett av fyra möjliga alternativ. Om du vill lägga till det här fältet i schemat väljer du plus (+) -ikonen bredvid loyaltyTier objekt och fylla i obligatoriska fält för Field name och Display name. För Type, välj "String".

Ytterligare kryssrutor visas för fältet när dess typ har valts, inklusive kryssrutor för Array, Enum & Suggested Values, Identity och Relationship.

Välj Enum & Suggested Values kryssruta och sedan markera Enum. Här kan du ange Value (i camelCase) och Display Name (ett valfritt, läsarvänligt namn i Title Case) för varje godtagbar lojalitetsklass.

När du har slutfört alla fältegenskaper väljer du Apply för att lägga till tierClass fält till loyaltyTier -objekt.

Konvertera ett flerfältsobjekt till en datatyp datatype

The loyaltyTier objektet innehåller nu flera fält och representerar en gemensam datastruktur som kan vara användbar i andra scheman. The Schema Editor Med kan du enkelt tillämpa återanvändbara flerfältsobjekt genom att konvertera strukturen för dessa objekt till datatyper.

Datatyper möjliggör konsekvent användning av flerfältsstrukturer och ger större flexibilitet än en fältgrupp eftersom de kan användas var som helst inom ett schema. Detta görs genom att ställa in fältets Type värdet på alla datatyper som definieras i Schema Registry.

Konvertera loyaltyTier till en datatyp, markera loyaltyTier på arbetsytan och sedan markera Convert to new data type till höger om redigeraren under Field properties.

Ett meddelande visas som bekräftar att objektet har konverterats. På arbetsytan ser du nu att loyaltyTier fältet har nu en länkikon och den högra listen anger att det har datatypen "Loyalty Tier".

I ett framtida schema kan du nu tilldela ett fält somLoyalty Tier" och det skulle automatiskt inkludera fält för ID, skiktklass, poängtrösklar och giltighetsdatum.

Söka efter och filtrera schemafält

Schemat innehåller nu flera fältgrupper förutom de fält som anges i basklassen. När du arbetar med större scheman kan du markera kryssrutorna intill fältgruppsnamnen i den vänstra listen för att filtrera de visade fälten så att de bara visas för de fältgrupper du är intresserad av.

Om du letar efter ett specifikt fält i ditt schema kan du även använda sökfältet för att filtrera visade fält efter namn, oavsett vilken fältgrupp de ingår i.

Ange ett schemafält som identitetsfält identity-field

Den standarddatastruktur som scheman ger kan utnyttjas för att identifiera data som tillhör samma individ i flera olika källor, vilket möjliggör olika användningsfall i senare led, som segmentering, rapportering, datavetenskapsanalys med mera. För att sammanfoga data baserat på individuella identiteter måste nyckelfälten markeras som Identity fält inom tillämpliga scheman.

Experience Platform gör det enkelt att ange ett identitetsfält med en Identity kryssrutan i Schema Editor. Du måste dock bestämma vilket fält som är det bästa alternativet att använda som identitet, baserat på vilken typ av data du har.

Det kan till exempel finnas tusentals lojalitetsprogrammedlemmar som tillhör samma lojalitetsnivå och flera som delar samma fysiska adress. I det här scenariot anger dock varje medlem i lojalitetsprogrammet sin personliga e-postadress vid registreringen. Eftersom personliga e-postadresser vanligtvis hanteras av en person är fältet personalEmail.address (tillhandahålls av Personal Contact Details fältgrupp) är en bra kandidat för ett identitetsfält.

Välj personalEmail.address på arbetsytan och Identity kryssrutan visas under Field properties. Markera kryssrutan och alternativet för att ange den som Primary identity visas. Markera även den här rutan.

Sedan måste du ange en Identity namespace i listan med fördefinierade namnutrymmen i listrutan. Eftersom det här fältet är kundens e-postadress väljer du "Email" i listrutan. Välj Apply för att bekräfta uppdateringarna av personalEmail.address fält.

När du har tillämpat ändringen visas ikonen för personalEmail.address visar en fingeravtryckssymbol som anger att det nu är ett identitetsfält. Fältet visas även i den vänstra listen under Identities.

Nu kan alla data hämtas till personalEmail.address ska användas för att identifiera den enskilda personen och sammanfoga en enda bild av kunden. Mer information om att arbeta med identiteter i Experience Platformkan du läsa Identity Service dokumentation.

Aktivera schemat för användning i Real-Time Customer Profile profile

Real-Time Customer Profile använder identitetsdata i Experience Platform för att ge en helhetsbild av varje enskild kund. Tjänsten bygger robusta 360-gradersprofiler av kundattribut samt tidsstämplade konton för varje interaktion som kunderna har haft i alla system som är integrerade med Experience Platform.

För att ett schema ska kunna aktiveras för användning med Real-Time Customer Profilemåste den ha en primär identitet definierad. Du får ett felmeddelande om du försöker aktivera ett schema utan att först definiera en primär identitet.

Så här aktiverar du schemat "Bonusmedlemmar" för användning i Profilebörjar du med att välja schemanamnet på arbetsytan.

Till höger om redigeraren visas information om schemat, inklusive visningsnamn, beskrivning och typ. Förutom denna information finns det en Profile växlingsknapp.

Välj Profile och en pover visas, där du ombeds bekräfta att du vill aktivera schemat för Profile.

Välj Enable för att bekräfta ditt val. Du kan välja Profile växla igen för att inaktivera schemat om du vill, men när schemat har sparats samtidigt Profile är aktiverat kan det inte längre inaktiveras.

Fler åtgärder more

I Schemaredigeraren kan du även utföra snabba åtgärder för att kopiera JSON-strukturen för schemat eller ta bort schemat om det inte har aktiverats för kundprofilen i realtid eller har associerade datauppsättningar. Välj More längst upp i vyn om du vill visa en listruta med snabbåtgärder.

Med strukturfunktionen Kopiera JSON kan du se hur en exempelnyttolast skulle se ut när du fortfarande skapar schemat och dina dataledningar. Det är särskilt användbart i situationer där det finns komplexa objektmappningsstrukturer i schemat, till exempel en identitetskarta.

Nästa steg och ytterligare resurser

Nu när du är klar med att komponera schemat kan du se hela schemat på arbetsytan. Välj Save och schemat sparas i Schema Library, så att det blir tillgängligt för Schema Registry.

Ditt nya schema kan nu användas för att importera data till Platform. Kom ihåg att när schemat väl har använts för att importera data får endast additiva ändringar göras. Se grunderna för schemakomposition om du vill ha mer information om schemaversion.

Nu kan du följa självstudiekursen på definiera en schemarelation i användargränssnittet om du vill lägga till ett nytt relationsfält i schemat"Förmånsmedlemmar".

Schemat "Bonusmedlemmar" är också tillgängligt för att visas och hanteras med Schema Registry API. Börja med att läsa Schema Registry API utvecklarhandbok.

Videoresurser

I följande video visas hur du skapar ett enkelt schema i Platform Gränssnitt.

Följande video är tänkt att förstärka din förståelse för att arbeta med fältgrupper och klasser.

Bilaga

Följande avsnitt innehåller ytterligare information om användningen av Schema Editor.

Skapa en ny klass create-new-class

Experience Platform ger flexibilitet att definiera ett schema baserat på en klass som är unik för din organisation. Mer information om hur du skapar en ny klass finns i handboken skapa och redigera klasser i användargränssnittet.

Ändra klassen för ett schema change-class

Du kan ändra schemaklassen när som helst under den inledande dispositionsprocessen innan schemat har sparats.

Om du vill lära dig hur du ändrar klassen för ett schema kan du läsa guiden på hantera scheman i användargränssnittet.