Skapa och redigera scheman i användargränssnittet
Den här guiden ger en översikt över hur du skapar, redigerar och hanterar XDM-scheman (Experience Data Model) för din organisation i Adobe Experience Platform användargränssnitt.
Förutsättningar prerequisites
Handboken kräver en fungerande förståelse för XDM System. Se XDM - översikt en introduktion till XDM:s roll i Experience Platform-ekosystemet, och grunderna för schemakomposition för en översikt över hur scheman är uppbyggda.
Skapa ett nytt schema create
I Schemas arbetsyta, välja Create schema längst upp till höger.
The Create schema arbetsflödet visas. Du kan välja en basklass för schemat genom att välja antingen Individual Profile, Experience Event, eller Other, följt av Next för att bekräfta ditt val. Se XDM-individuell profil och XDM ExperienceEvent mer information om dessa klasser.
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. Schemats grundstruktur (tillhandahålls av klassen) visas på arbetsytan så att du kan granska och verifiera den valda klassen 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 Browse visas. Ditt nyligen skapade schema visas nu i schemabiblioteket och kan redigeras i Schema Editor.
Redigera ett befintligt schema edit
Om du vill redigera ett befintligt schema väljer du Browse och markera sedan namnet på schemat som du vill redigera. Du kan även använda sökfältet för att begränsa listan med tillgängliga alternativ.
När du har valt ett schema visas Schema Editor visas med schemats struktur på arbetsytan. Nu kan du lägg till fältgrupper till schemat (eller lägg till enskilda fält från dessa grupper), redigera fältvisningsnamn, eller redigera befintliga anpassade fältgrupper om schemat använder något.
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.
Växla visningsnamn display-name-toggle
För enkelhetens skull kan du växla mellan de ursprungliga fältnamnen och de mer läsbara visningsnamnen i Schemaredigeraren. Tack vare den här flexibiliteten blir det enklare att hitta och redigera dina scheman. Växlingsknappen finns längst upp till höger i vyn Schemaredigeraren.
Visningsnamnen för standardfältgrupper genereras av systemet men kan anpassas enligt beskrivningen i visningsnamn -avsnitt. Visningsnamn visas i flera olika gränssnittsvyer, inklusive mappning och förhandsvisningar av datauppsättningar. Standardinställningen är inaktiverad och fältnamnen visas med sina ursprungliga värden.
Lägga till fältgrupper i ett schema add-field-groups
När du har öppnat ett schema i Schema Editorkan du lägga till fält i schemat med hjälp av fältgrupper. Börja genom att välja Add nästa Field groups till vänster.
En dialogruta visas med en lista över fältgrupper som du kan välja för schemat. Eftersom fältgrupper endast är kompatibla med en klass, visas endast de fältgrupper som är associerade med schemats valda klass. Som standard sorteras listade fältgrupper baserat på hur populära de är i din organisation.
Om du känner till den allmänna aktiviteten eller affärsområdet för de fält som du vill lägga till, väljer du en eller flera av de branschlodräta kategorierna i den vänstra listen för att filtrera den visade listan med fältgrupper.
Du kan också använda sökfältet för att hitta den fältgrupp du vill använda. Fältgrupper vars namn matchar frågan visas högst upp i listan. Under Standard Fields visas fältgrupper som innehåller fält som beskriver önskade dataattribut.
Markera kryssrutan bredvid namnet på den fältgrupp som du vill lägga till i schemat. Du kan markera flera fältgrupper i listan, där varje markerad fältgrupp visas i den högra listen.
När du har valt fältgrupper väljer du Add field groups för att lägga till dem i schemat.
The Schema Editor visas igen med fälten som tillhandahålls av fältgruppen och som visas på arbetsytan.
När du har lagt till en fältgrupp i ett schema kan du välja att ta bort befintliga fält eller lägg till nya anpassade fält till de grupperna, beroende på dina behov.
Ta bort fält som lagts till från fältgrupper remove-fields
När du har lagt till en fältgrupp i ett schema kan du ta bort fält som du inte behöver.
I följande exempel är standardfältgruppen Demographic Details har lagts till i ett schema. Ta bort ett enskilt fält som taxId
markerar du fältet på arbetsytan och väljer Remove i rätt spår.
Om det finns flera fält som du vill ta bort kan du hantera fältgruppen som helhet. Markera ett fält som tillhör gruppen på arbetsytan och välj sedan Manage related fields i rätt spår.
En dialogruta visas med strukturen för fältgruppen i fråga. Härifrån kan du använda de angivna kryssrutorna för att markera eller avmarkera de fält som du behöver. När du är nöjd väljer du Confirm.
Arbetsytan visas igen med endast de markerade fälten i schemastrukturen.
Lägg till anpassade fält i fältgrupper add-fields
När du har lagt till en fältgrupp i ett schema kan du definiera ytterligare fält för den gruppen. Alla fält som läggs till i en fältgrupp i ett schema visas emellertid också i alla andra scheman som använder samma fältgrupp.
Om ett anpassat fält dessutom läggs till i en standardfältgrupp, kommer den fältgruppen att konverteras till en anpassad fältgrupp och den ursprungliga standardfältgruppen kommer inte längre att vara tillgänglig.
Om du vill lägga till ett anpassat fält i en standardfältgrupp, se avsnitt nedan för specifika instruktioner. Om du lägger till fält i en anpassad fältgrupp, se avsnittet om redigera anpassade fältgrupper i fältgruppsguiden för användargränssnitt.
Om du inte vill ändra några fältgrupper kan du skapa en ny anpassad fältgrupp om du vill definiera ytterligare fält i stället.
Lägga till enskilda fält i ett schema add-individual-fields
Med Schemaredigeraren kan du lägga till enskilda fält direkt i ett schema om du inte vill lägga till en hel fältgrupp för ett visst användningsfall. Du kan lägga till enskilda fält från standardfältgrupper eller lägga till egna fält i stället.
Lägg till standardfält add-standard-fields
Du kan lägga till fält från standardfältgrupper direkt i ett schema utan att först behöva känna till deras motsvarande fältgrupp. Om du vill lägga till ett standardfält i ett schema väljer du plustecknet (+) bredvid schemats namn på arbetsytan. An Untitled Field platshållaren visas i schemastrukturen och uppdaterar den högra listen för att visa kontroller för att konfigurera fältet.
Under Field name börjar du skriva namnet på det fält som du vill lägga till. Systemet söker automatiskt efter standardfält som matchar frågan och listar dem under Recommended Standard Fields, inklusive de fältgrupper som de tillhör.
Vissa standardfält har samma namn, men strukturen kan variera beroende på vilken fältgrupp de kommer ifrån. Om ett standardfält är kapslat i ett överordnat objekt i fältgruppsstrukturen, kommer det överordnade fältet också att inkluderas i schemat om det underordnade fältet läggs till.
Välj förhandsvisningsikonen ( ) bredvid ett standardfält för att visa strukturen för dess fältgrupp och bättre förstå hur den kan kapslas. Om du vill lägga till standardfältet i schemat väljer du plusikonen ( ).
Arbetsytan uppdateras för att visa det standardfält som lagts till i schemat, inklusive alla överordnade fält som är kapslade i fältgruppsstrukturen. Namnet på fältgruppen visas också under Field groups till vänster. Om du vill lägga till fler fält från samma fältgrupp väljer du Manage related fields i rätt spår.
Lägg till anpassade fält add-custom-fields
På samma sätt som arbetsflödet för standardfält kan du även lägga till egna anpassade fält direkt i ett schema.
Om du vill lägga till fält på rotnivån för ett schema väljer du plustecknet (+) bredvid schemats namn på arbetsytan. An Untitled Field platshållaren visas i schemastrukturen och uppdaterar den högra listen för att visa kontroller för att konfigurera fältet.
Börja skriva in namnet på det fält som du vill lägga till så börjar systemet automatiskt att söka efter matchande standardfält. Om du vill skapa ett nytt anpassat fält i stället väljer du det översta alternativet som bifogas med (New Field).
När du har angett ett visningsnamn och en datatyp för fältet är nästa steg att tilldela fältet till en överordnad XDM-resurs. Om schemat använder en anpassad klass kan du välja att lägg till fältet i den tilldelade klassen eller en fältgrupp i stället. Om schemat använder en standardklass kan du bara tilldela ett anpassat fält till en fältgrupp.
Tilldela fältet till en anpassad fältgrupp add-to-field-group
Under Assign to väljer du Field Group. Om schemat använder en standardklass är detta det enda tillgängliga alternativet och markeras som standard.
Sedan måste du välja en fältgrupp för det nya fältet som ska kopplas. Börja skriva in namnet på fältgruppen i den angivna textinmatningen. Om du har befintliga anpassade fältgrupper som matchar indata visas de i listrutan. Du kan också skriva ett unikt namn för att skapa en ny fältgrupp i stället.
När du har valt fältgruppen i listan väljer du Apply.
Det nya fältet läggs till på arbetsytan och får ett namn under klient-ID för att undvika konflikter med XDM-standardfält. Fältgruppen som du har associerat det nya fältet med visas också under Field groups till vänster.
Tilldela fältet till en anpassad klass add-to-class
Under Assign to väljer du Class. Indatafältet nedan ersätts med namnet på det aktuella schemats anpassade klass, vilket anger att det nya fältet kommer att tilldelas den här klassen.
Fortsätt konfigurera fältet efter behov och välj Apply när du är klar.
Det nya fältet läggs till på arbetsytan och får ett namn under klient-ID för att undvika konflikter med XDM-standardfält. Om du väljer klassnamnet i den vänstra listen visas det nya fältet som en del av klassens struktur.
Lägga till anpassade fält i strukturen för standardfältgrupper custom-fields-for-standard-groups
Om schemat du arbetar med har ett objekttypsfält från en standardfältgrupp, kan du lägga till egna anpassade fält till det standardobjektet.
Börja med att välja plustecknet (+) bredvid roten för objektet som anges av standardfältgruppen.
Ett varningsmeddelande visas som uppmanar dig att bekräfta om du vill konvertera standardfältgruppen. Välj Continue creating field group för att fortsätta.
Arbetsytan visas igen med en namnlös platshållare för det nya fältet. Observera att namnet på standardfältgruppen har lagts till med "(Extended)" för att ange att den har ändrats från den ursprungliga versionen. Använd kontrollerna i den högra listen för att definiera fältets egenskaper.
När du har gjort ändringarna visas det nya fältet under ditt innehavar-ID-namnutrymme i standardobjektet. Det här kapslade namnutrymmet förhindrar konflikter mellan fält och namn inom själva fältgruppen för att undvika att bryta ändringar i andra scheman som använder samma fältgrupp.
Aktivera ett schema för kundprofil i realtid profile
Kundprofil i realtid sammanfogar data från olika källor för att skapa en komplett bild av varje enskild kund. Om du vill att de data som hämtas av ett schema ska delta i processen måste du aktivera schemat för användning i Profile.
Aktivera schemat genom att först markera schemats namn i den vänstra listen och sedan välja Profile till höger.
En pover visas som varnar om att när ett schema väl har aktiverats och sparats kan det inte inaktiveras. Välj Enable för att fortsätta.
Arbetsytan visas igen med Profile växla aktiverat.
Avsluta processen genom att välja Save för att spara schemat.
Schemat är nu aktiverat för användning i kundprofilen i realtid. När Platform samlar in data i datauppsättningar som baseras på det här schemat, kommer dessa data att införlivas i dina sammanställda profildata.
Redigera visningsnamn för schemafält display-names
När du har tilldelat en klass och lagt till fältgrupper till ett schema kan du redigera visningsnamnen för alla fält i schemat, oavsett om dessa fält har tillhandahållits av standard eller anpassade XDM-resurser.
Om du vill redigera visningsnamnet för ett schemafält markerar du fältet på arbetsytan. Ange det nya namnet under Display name.
Välj Apply till höger och arbetsytan uppdateras för att visa fältets nya visningsnamn. Välj Save för att tillämpa ändringarna i schemat.
Ändra en schemaklass change-class
Du kan ändra schemaklassen när som helst under den inledande dispositionsprocessen innan schemat har sparats.
Om du vill tilldela om en klass väljer du Assign till vänster på arbetsytan.
En dialogruta visas med en lista över alla tillgängliga klasser, inklusive alla som definierats av organisationen (ägaren ärCustomer") samt standardklasser som definieras av Adobe.
Välj en klass i listan för att visa dess beskrivning till höger i dialogrutan. Du kan också välja Preview class structure om du vill visa de fält och metadata som är associerade med klassen. Välj Assign class för att fortsätta.
En ny dialogruta öppnas där du ombeds bekräfta att du vill tilldela en ny klass. Välj Assign för att bekräfta.
När du har bekräftat klassändringen återställs arbetsytan och alla dispositionsförlopp går förlorade.
Nästa steg next-steps
Det här dokumentet innehåller grunderna för att skapa och redigera scheman i plattformsgränssnittet. Vi rekommenderar att du granskar självstudiekurs om att skapa scheman för ett omfattande arbetsflöde för att skapa ett komplett schema i användargränssnittet, inklusive att skapa anpassade fältgrupper och datatyper för unika användningsfall.
Mer information om funktionerna i Schemas arbetsytan, se Schemas arbetsyta - översikt.
Så här hanterar du scheman i Schema Registry API, se slutpunktshandbok för scheman.