Definiera XDM-fält i användargränssnittet
Med Schema Editor i Adobe Experience Platform användargränssnitt kan du definiera egna fält i anpassade XDM-klasser (Experience Data Model) och schemafältgrupper. Den här guiden beskriver stegen för att definiera XDM-fält i användargränssnittet, inklusive tillgängliga konfigurationsalternativ för varje fälttyp.
Förhandskrav
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 att lära dig hur klasser och fältgrupper bidrar till fält i 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.
Välj en resurs att lägga till fält i select-resource
Om du vill definiera nya XDM-fält i användargränssnittet måste du först öppna ett schema i Schema Editor. Beroende på vilka scheman som är tillgängliga för dig i Schema Library kan du välja att skapa ett nytt schema eller välja ett befintligt schema att redigera.
När du har Schema Editor öppet visas kontroller för att lägga till fält på arbetsytan. Dessa kontroller visas intill schemats namn, liksom alla objekttypsfält som har definierats under den valda klassen eller fältgruppen.
Om du vill lägga till ett nytt fält i resursen väljer du ikonen plus (+) bredvid schemats namn på arbetsytan eller bredvid det objekttypsfält som du vill definiera fältet under.
Beroende på om du lägger till ett fält direkt i ett schema eller dess klass och fältgrupper för beståndsdelar, varierar stegen som krävs för att lägga till fältet. Resten av det här dokumentet fokuserar på hur du konfigurerar ett fälts egenskaper oavsett var det fältet visas i schemat. Mer information om olika sätt att lägga till fält i ett schema finns i följande avsnitt i gränssnittshandboken för scheman:
Definiera egenskaperna för ett fält define
När du har valt ikonen plus (+) visas en Untitled field platshållare på arbetsytan.
I den högra listen under Field properties kan du konfigurera informationen för det nya fältet. Följande information krävs för varje fält:
Ett unikt, beskrivande namn för fältet. Observera att fältets namn inte kan ändras när schemat har sparats. Det här värdet används för att identifiera och referera till fältet i koden och i andra efterföljande program
Namnet bör helst skrivas i camelCase. Det kan innehålla alfanumeriska tecken, bindestreck eller understreck, men får inte börja med ett understreck.
- Korrigera:
fieldName - Godtagbart:
field_name2,Field-Name,field-name_3 - Felaktigt:
_fieldName
Obs! Om du väljer datatypen Map visas egenskapen Map value type .
Du kan också välja Advanced type search om du vill söka efter och filtrera befintliga datatyper och hitta den önskade typen enklare.
Mer information om typspecifika fältegenskaper finns i översikten över definierade fält.
Du kan också välja att ange en beskrivning och anteckningar för varje fält. Använd fältet Description för att lägga till kontext och beskriva funktionerna för mappningsdatatypen. Detta bidrar till att implementeringen blir enkel och lättläst. Du kan också lägga till anteckningar som komplement till den inledande beskrivningen. Detta bör ge mer detaljerad och specifik information för att hjälpa utvecklare att förstå, underhålla och använda kartan effektivt i kodbasen. |
När du har konfigurerat fältet väljer du Apply.
Arbetsytan uppdateras för att visa det nya fältet, som finns i ett objekt som har ett namn som är kopplat till ditt unika klientorganisations-ID (visas som _tenantId i exemplet nedan). Alla anpassade fält som läggs till i ett schema placeras automatiskt i det här namnutrymmet för att förhindra konflikter med andra fält från klasser och fältgrupper som tillhandahålls av Adobe. Den högra listen visar nu fältets sökväg förutom dess andra egenskaper.
Du kan fortsätta följa stegen ovan för att lägga till fler fält i schemat. När schemat har sparats sparas även dess basklass och fältgrupper om några ändringar har gjorts i dem.
Typspecifika fältegenskaper type-specific-properties
När du definierar ett nytt fält kan ytterligare konfigurationsalternativ visas i den högra listen beroende på vilken Type du väljer för fältet. I följande tabell visas de här extra fältegenskaperna tillsammans med deras kompatibla typer:
Obs! Alla mappningsdatatyper som skapas via API som inte är antingen en sträng eller en heltalstyp visas som datatypen Complex. Du kan inte skapa datatyperna Complex via användargränssnittet.
Standardvärdena sparas inte i datauppsättningen vid tidpunkten för inmatningen eftersom de kan ändras över tid. De standardvärden som anges i schemat härleds av plattformstjänster och program som är längre fram i kedjan när de läser data från datauppsättningen. Om attributet har ett NULL-värde och standardvärdet är
5 på schemanivå när data efterfrågas med hjälp av frågetjänsten, förväntas frågetjänsten returnera 5 i stället för NULL. Observera att detta för närvarande inte är enhetligt i alla AEP-tjänster.Välj i en lista över fördefinierade format för strängar som värdet måste överensstämma med. Tillgängliga format:
Speciella fälttyper special
Den högra listen innehåller flera kryssrutor för att ange speciella roller för det markerade fältet. Användningsexempel för vissa av dessa alternativ inbegriper viktiga överväganden som rör er datamodelleringsstrategi och hur ni tänker använda plattformstjänster längre fram i kedjan.
Mer information om dessa specialtyper finns i följande dokumentation:
Även om det inte är en speciell fälttyp rekommenderar vi att du går till guiden definierar objekttypsfält för att lära dig mer om hur du definierar kapslade underfält om schemastrukturen används.
Nästa steg
Den här guiden ger en översikt över hur du definierar XDM-fält i användargränssnittet. Kom ihåg att fält bara kan läggas till i scheman med hjälp av klasser och fältgrupper. Mer information om hur du hanterar de här resurserna i användargränssnittet finns i handböckerna om hur du skapar och redigerar klasser och fältgrupper.
Mer information om funktionerna för arbetsytan Schemas finns i översikten för arbetsytan Schemas.