Skapa och redigera datatyper med användargränssnittet ui-create-and-edit
I Experience Data Model (XDM) är datatyper återanvändbara fält som innehåller flera underfält. Även om datatyperna liknar schemafältgrupper på så sätt att de medger konsekvent användning av en flerfältsstruktur, är datatyperna mer flexibla eftersom de kan inkluderas var som helst i schemastrukturen medan fältgrupper bara kan läggas till på rotnivån.
Adobe Experience Platform har många standarddatatyper som kan användas för ett stort antal vanliga användningsfall för upplevelsehantering. Men du kan också definiera egna anpassade datatyper för att tillgodose dina unika affärsbehov.
I den här självstudiekursen beskrivs stegen för att skapa och redigera anpassade datatyper i användargränssnittet för plattformen.
Förhandskrav prerequisites
Handboken kräver en fungerande förståelse för XDM System. Se XDM-översikten för en introduktion till XDM-rollen i ekosystemet Experience Platform och grunderna i schemakomposition för hur datatyper bidrar till XDM-scheman.
Även om det inte krävs för den här guiden rekommenderar vi att du också följer självstudiekursen om att komponera ett schema i användargränssnittet för att bekanta dig med de olika funktionerna i Schema Editor.
Öppna Schema Editor för en datatyp data-type
I plattformsgränssnittet väljer du Schemas i den vänstra navigeringen för att öppna arbetsytan i Schemas och sedan fliken Data types. En lista över tillgängliga datatyper visas. Listan med datatyper filtreras automatiskt baserat på hur de skapades. Standardinställningen visar de datatyper som definieras av Adobe. Du kan även filtrera listan så att den visar de som har skapats av din organisation.
Här har du följande alternativ:
Skapa en ny datatyp create
På fliken Data types väljer du Create data type.
Schema Editor visas med den aktuella strukturen för den nya datatypen på arbetsytan. Till höger om redigeraren kan du ange ett visningsnamn och en valfri beskrivning av datatypen. Se till att du anger ett unikt och koncist namn för din datatyp, eftersom det är så det identifieras när du lägger till den i ett schema.
I den här självstudien skapas en datatyp som beskriver en restaurangegenskap, så datatypen får visningsnamnet "Restaurant".
Härifrån kan du hoppa fram till nästa avsnitt för att börja lägga till fält i den nya datatypen.
Filtrera datatyper filter
Listan med tillgängliga datatyper filtreras i förväg baserat på hur de skapades. Välj alternativknappen för att välja mellan alternativen Standard och Custom. Alternativet Standard visar entiteter som skapats av Adobe och alternativet Custom visar entiteter som skapats i din organisation.
Redigera en befintlig datatyp edit
Endast anpassade datatyper som definieras av din organisation kan redigeras. Välj Custom om du bara vill visa anpassade datatyper som ägs av din organisation.
Välj den datatyp som du vill redigera i listan för att öppna den högra listen och visa information om datatypen. På informationspanelen kan du även hämta en exempelfil, kopiera JSON-strukturen eller lägga till datatypen i ett paket.
Markera namnet på datatypen i den högra listen för att öppna dess struktur i Schema Editor.
Lägg till fält i datatypen add-fields
Om du vill börja lägga till fält i datatypen väljer du ikonen plus (+) bredvid rotnivåfältet på arbetsytan. Ett nytt fält visas nedan och den högra listen uppdateras för att visa kontroller för det nya fältet.
Använd kontrollerna i den högra listen för att konfigurera information om det nya fältet. I guiden om att definiera fält i användargränssnittet finns mer information om hur du konfigurerar och lägger till fältet i datatypen.
Datatypen Restaurant kräver ett strängfält som representerar restaurangens namn. Därför anges Field name som"name" och Type som String. Välj Apply om du vill använda ändringarna i fältet.
Fortsätt lägga till fler fält till datatypen efter behov. Datatypen Restaurant har nu ytterligare fält för märke, sittplatskapacitet och golvutrymme.
Förutom grundläggande fält kan du även kapsla in ytterligare datatyper i din anpassade datatyp. Datatypen Restaurant kräver till exempel ett fält som representerar egenskapens fysiska adress. I det här scenariot kan du lägga till ett nytt adressfält som har tilldelats standarddatatypen Postal address.
Detta visar hur flexibla datatyper kan vara när det gäller att beskriva dina data: datatyperna kan använda fält som också är datatyper, som i sin tur kan innehålla fler datatyper, och så vidare. På så sätt kan du abstrahera och återanvända vanliga datamönster i hela XDM-scheman, vilket gör det enklare att representera komplexa datastrukturer.
När du har lagt till fält till datatypen väljer du Save för att spara ändringarna och lägga till datatypen i Schema Library.
Lägg till datatypen i ett schema add-data-type
När du har skapat en datatyp kan du börja använda den i dina scheman. Eftersom XDM-scheman består av en klass och noll eller flera fältgrupper, kan fält som tillhandahålls av en datatyp inte läggas till direkt i ett schema. De måste i stället inkluderas i en klass eller en fältgrupp.
Börja med att följa stegen som ingår i att lägga till ett fält i en klass eller lägga till ett fält i en fältgrupp. Du kan också börja med att lägga till ett fält direkt i ett schema och välja den överordnade klassen eller fältgruppen därifrån. När du väljer Type för det nya fältet väljer du namnet på datatypen i listrutan.
Konvertera ett flerfältsobjekt till en datatyp convert
När du skapar ett fält av objekttyp med flera delfält i Schema Editor kan du konvertera det fältet till en datatyp så att du kan använda samma fältstruktur i en annan klass eller fältgrupp.
Om du vill konvertera ett fält av objekttyp till en datatyp, markerar du fältet på arbetsytan. Innan du konverterar fältet måste du se till att Display name är beskrivande av de data som objektet kommer att innehålla, eftersom detta blir namnet på datatypen. När du är redo att konvertera fältet väljer du Convert to new data type i den högra listen.
Arbetsytan uppdaterar datatypen för fältet från Object till den nya datatypen. Den här strukturen kan nu återanvändas i andra klasser och fältgrupper genom att välja den här datatypen i listrutan Type när du definierar ett nytt fält.
Nästa steg next-steps
I den här handboken beskrivs hur du skapar och redigerar datatyper med hjälp av användargränssnittet för plattformen. Mer information om funktionerna för arbetsytan Schemas finns i översikten för arbetsytan Schemas.
Mer information om hur du hanterar datatyper med Schema Registry-API:t finns i slutpunktshandboken för datatyper.