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älvstudien 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:
- Experience Data Model (XDM): Det standardiserade ramverket som Platform organiserar kundupplevelsedata med.
- Grundläggande om schemakomposition: En översikt över XDM-scheman och deras byggstenar, inklusive klasser, schemafältgrupper, datatyper och enskilda fält.
- Real-Time Customer Profile: Tillhandahåller en enhetlig konsumentprofil i realtid baserad på aggregerade data från flera källor.
Öppna arbetsytan Schemas browse
Arbetsytan Schemas i användargränssnittet för Platform 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 också Schema Editor, arbetsytan som du kan komponera ett schema på i hela den här självstudiekursen.
När du har loggat in på Experience Platform väljer du Schemas i den vänstra navigeringen för att öppna arbetsytan i Schemas. På fliken Browse visas en lista med scheman (en representation av Schema Library) som 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.
Mer information finns i guiden Utforska befintliga XDM-resurser i användargränssnittet.
Skapa och namnge ett schema create
Om du vill börja komponera ett schema väljer du Create schema i det övre högra hörnet av arbetsytan i Schemas.
Arbetsflödet Create schema visas. Välj sedan en basklass för schemat. Du kan välja mellan huvudklasserna för XDM Individual Profile och XDM ExperienceEvent, eller Other om dessa klasser inte passar dina syften. Med klassalternativet Other kan du antingen skapa en ny klass eller välja bland andra befintliga klasser.
Mer information om de här klasserna finns i dokumentationen för den enskilda XDM-profilen och XDM ExperienceEvent . I den här självstudien väljer du XDM Individual Profile följt av Next.
När du har valt en klass visas avsnittet Name and review. 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:
- Schemanamn ska vara korta och beskrivande så att schemat kan hittas senare.
- Schemanamn måste vara unika, vilket innebär att de också måste vara tillräckligt specifika för att de inte ska återanvändas i framtiden. Om din organisation till exempel har separata lojalitetsprogram för olika varumärken är det klokt att kalla ditt schema"Varumärke A lojalitetsmedlemmar" för att göra det enkelt att skilja på dem från andra lojalitetsrelaterade scheman som du kan definiera senare.
- Du kan också använda schemabeskrivningen för att tillhandahålla ytterligare sammanhangsberoende information om 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 har 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 en Schema display name som är användarvänlig i textfältet. Ange sedan en lämplig beskrivning för att identifiera schemat. När du har granskat din schemastruktur och är nöjd med dina inställningar väljer du Finish för att skapa ditt schema.
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 valde. Den tilldelade klassen för schemat listas också under Class i avsnittet Composition.
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 underavsnittet Field groups.
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 klassen XDM Individual Profile) i dialogrutan. 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 om du vill begränsa listan över 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 fältgruppsval.
För den här självstudiekursen väljer du fältgruppen Demographic Details och sedan Add field group.
Arbetsytan för schemat visas igen. Avsnittet Field groups innehåller nu en lista över Demographic Details och avsnittet Structure innehåller fälten från fältgruppen. Du kan markera fältgruppens namn under avsnittet Field groups för att markera de specifika fält som finns på arbetsytan.
Den här fältgruppen bidrar med flera fält under namnet person på den översta nivån med datatypen Person. Den här gruppen med fält beskriver information om en individ, inklusive namn, födelsedatum och kön.
Observera att fältet name har datatypen Full name, vilket innebär att det 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 dialogrutan Add field group den här gången kan du lägga märke till att fältgruppen Demographic Details är nedtonad och att kryssrutan bredvid den inte kan markeras. Detta förhindrar att du av misstag duplicerar fältgrupper som du redan har inkluderat i det aktuella schemat.
För den här självstudien väljer du standardfältgrupperna Personal Contact Details och Loyalty Details i listan och sedan Add field groups för att lägga till dem i schemat.
Arbetsytan visas igen med de tillagda fältgrupperna som listas under Field groups i avsnittet Composition och deras sammansatta fält läggs till i schemastrukturen.
Definiera en anpassad fältgrupp define-field-group
Schemat Loyalty Members är avsett att samla in data som är relaterade till medlemmarna i ett lojalitetsprogram, och standardfältgruppen Loyalty Details som du har lagt till i schemat innehåller de flesta av dessa, inklusive programtypen, punkter, kopplingsdatum och mycket annat.
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:
- Skapa en ny anpassad fältgrupp för att hämta dessa fält. Det här är den metod som kommer att beskrivas i den här självstudiekursen.
- Utöka standardfältgruppen Loyalty Details med anpassade fält. Detta gör att Loyalty Details konverteras till en anpassad fältgrupp och den ursprungliga standardfältgruppen kommer inte längre att vara tillgänglig. Mer information om hur du lägger till anpassade fält i strukturen för standardfältgrupper finns i användargränssnittshandboken för Schemas.
Om du vill skapa en ny fältgrupp väljer du Add i underavsnittet Field groups som tidigare, men den här gången väljer du 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 namnet Custom Loyalty Details och väljer sedan 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 än 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 skapat fältgruppen Custom Loyalty Details är det dags att definiera fälten som fältgruppen ska bidra till schemat.
Börja med att markera ikonen plus (+) bredvid schemanamnet på arbetsytan.
En Untitled Field-platshållare visas 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. Använd kontrollerna i den högra listen och börja skapa ett loyaltyTier-fält med typen Object som ska användas för dina relaterade fält.
Under Assign to måste du välja en fältgrupp att tilldela fältet till. 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 namnet Custom Loyalty Details och välj sedan fältgruppen i listan.
När du är klar väljer du Apply.
Ändringarna tillämpas och det loyaltyTier-objekt som skapades visas. Eftersom det här är ett anpassat fält kapslas det automatiskt i ett objekt som namnges efter organisationens klientorganisations-ID, föregånget av ett understreck (_tenantId i det här exemplet).
Välj ikonen plus (+) bredvid objektet loyaltyTier för att börja lägga till underfält. En ny fältplatshållare visas och avsnittet Field properties visas till höger på arbetsytan.
Varje fält kräver följande information:
- Field Name: Fältets namn, helst skrivet i camelCase. Inga blankstegstecken tillåts. Det här namnet används som referens för fältet i koden och i andra program längre fram i kedjan.
- Exempel: loyaltyLevel
- Display Name: Fältets namn, skrivet med inledande versal. Det här namnet visas på arbetsytan när du visar eller redigerar schemat.
- Exempel: Lojalitetsnivå
- Type: Fältets datatyp. Detta inkluderar grundläggande skalära typer och alla datatyper som definieras i Schema Registry. Exempel: String, Integer, Boolean, Person, Address, Phone number osv.
- Description: En valfri beskrivning av fältet får innehålla högst 200 tecken.
Det första fältet för objektet loyaltyTier blir en sträng med namnet 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. Ange det nya fältets typ till String, och avsnittet Field properties fylls i med flera alternativ för att tillämpa begränsningar, inklusive standardvärde, format och maximal längd. Mer information finns i dokumentationen om bästa praxis för datavalideringsfält.
Eftersom id kommer att vara en slumpmässigt genererad friformssträng behövs inga ytterligare begränsningar. Välj Apply om du vill tillämpa ändringarna.
Lägg till fler fält i fältgruppen field-group-fields-2
Nu när du har lagt till fältet id kan du lägga till ytterligare fält för att hämta information om lojalitetsnivån, till exempel:
- Aktuellt poängtröskelvärde (heltal): Det minsta antalet förmånspunkter som medlemmen måste behålla för att förbli i den aktuella nivån.
- Tröskelvärde för nästa skiktpunkt (heltal): Antalet förmånspoäng som medlemmen måste uppnå för att kunna ta examen vid nästa skikt.
- Giltighetsdatum (datum-tid): Det datum då förmånsmedlemmen anslöt till den här nivån.
Om du vill lägga till varje fält i schemat markerar du ikonen plus (+) bredvid objektet loyalty och fyller i den obligatoriska informationen.
När det är klart innehåller objektet loyaltyTier fält för id, currentThreshold, nextThreshold och effectiveDate.
Lägg till ett uppräkningsfält i fältgruppen enum
När du definierar fält i Schema Editor finns det ytterligare alternativ som du kan tillämpa på grundläggande fälttyper för att tillhandahålla 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:
I den här självstudien kräver objektet loyaltyTier i schemat ett nytt uppräkningsfält som beskriver klassen tier, 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 markerar du ikonen plus (+) bredvid objektet loyaltyTier och fyller i de obligatoriska fälten för Field name och Display name. För Type väljer du 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.
Markera kryssrutan Enum & Suggested Values och välj sedan Enum. Här kan du ange Value (i camelCase) och Display Name (ett valfritt, läsvä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 fältet tierClass i objektet loyaltyTier.
Konvertera ett flerfältsobjekt till en datatyp datatype
Objektet loyaltyTier innehåller nu flera fält och representerar en gemensam datastruktur som kan vara användbar i andra scheman. Med Schema Editor 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ärde på värdet för alla datatyper som definieras i Schema Registry.
Om du vill konvertera objektet loyaltyTier till en datatyp markerar du fältet loyaltyTier på arbetsytan och väljer sedan 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 fältet loyaltyTier nu har en länkikon och att den högra listen anger att den har datatypen Loyalty Tier.
I ett framtida schema kan du nu tilldela ett fält som typen Loyalty 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å enskilda identiteter måste nyckelfält markeras som Identity fält i tillämpliga scheman.
Experience Platform gör det enkelt att ange ett identitetsfält med hjälp av en Identity-kryssruta 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 fältgruppen Personal Contact Details) en bra kandidat för ett identitetsfält.
identityMap-fält för att innehålla identitetsinformation i stället.identityMap bör du tänka på att den åsidosätter alla primära identiteter som du lägger till i schemat direkt. Mer information finns i avsnittet om identityMap i grunderna i schemakompositionsguiden.Markera fältet personalEmail.address på arbetsytan och kryssrutan Identity visas under Field properties. Markera kryssrutan och alternativet att ange att Primary identity ska visas. Markera även den här rutan.
Därefter måste du ange 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 fältet personalEmail.address.
När du har tillämpat ändringen visas en fingeravtryckssymbol med ikonen för personalEmail.address, vilket anger att det nu är ett identitetsfält. Fältet visas även i den vänstra listen under Identities.
Nu kommer alla data som hämtas in till fältet personalEmail.address att användas för att identifiera den enskilda personen och sammanfoga en enda vy av den kunden. Läs Identity Service-dokumentationen om du vill veta mer om hur du arbetar med identiteter i Experience Platform.
Aktivera schemat för användning i Real-Time Customer Profile profile
Real-Time Customer Profile utnyttjar 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 Profile måste en primär identitet ha definierats. Du får ett felmeddelande om du försöker aktivera ett schema utan att först definiera en primär identitet.
Om du vill aktivera schemat "Förmånsmedlemmar" för användning i Profile bö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 den här informationen finns det en Profile-växlingsknapp.
Välj Profile så visas en portfölj som ber dig bekräfta att du vill aktivera schemat för Profile.
Välj Enable för att bekräfta ditt val. Om du vill kan du avaktivera schemat genom att välja Profile-växeln igen, men när schemat har sparats när Profile är aktiverat kan det inte längre inaktiveras.
Fler åtgärder more
I Schemaredigeraren kan du också utföra snabba åtgärder för att kopiera JSON-strukturen för schemat eller ta bort schemat. Välj More högst upp i vyn om du vill visa en listruta med snabbåtgärder.
Ta bort ett schema delete-a-schema
Ett schema kan tas bort inom användargränssnittet från schemaredigeraren med hjälp av More-åtgärder och även från schemainformationen på fliken Browse. Det finns vissa villkor som förhindrar att ett schema tas bort. Ett schema kan inte tas bort om:
- Schemat är aktiverat för profilen.
- Schemat är aktiverat för profilen och har associerade datauppsättningar.
- Schemat har associerade datauppsättningar men har inte aktiverats för profilen.
Kopiera JSON-struktur copy-json-structure
Välj Copy JSON structure om du vill generera en exportnyttolast för ett schema i schemabiblioteket. Den här åtgärden kopierar JSON-strukturen till Urklipp. Din exporterade JSON kan sedan användas för att importera schemat och alla relaterade resurser till en annan sandlåda eller organisation. Detta gör det enkelt och effektivt att dela och återanvända scheman mellan olika miljöer.
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 så sparas schemat 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. Mer information om schemaversion finns i Grunderna för schemakomposition.
Nu kan du följa självstudiekursen om att definiera en schemarelation i användargränssnittet för att lägga till ett nytt relationsfält i schemat"Förmånsmedlemmar".
Schemat "Förmånsmedlemmar" är också tillgängligt för att visas och hanteras med API:t Schema Registry. Börja med att läsa Schema Registry API utvecklarhandboken för att börja arbeta med API:t.
Videoresurser
I följande video visas hur du skapar ett enkelt schema i användargränssnittet för Platform.
Följande video är tänkt att förstärka din förståelse för att arbeta med fältgrupper och klasser.
Bilaga
I följande avsnitt finns 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.
Mer information om hur du ändrar klassen för ett schema finns i handboken Hantera scheman i användargränssnittet.