Definiera uppräkningar och föreslagna värden i användargränssnittet enums-and-suggested-values
I Experience Data Model (XDM) kan ett strängfält få en fördefinierad uppsättning godkända eller föreslagna värden för att bättre kontrollera vilka värden som hämtas till det fältet eller hur det fungerar i segmenteringen.
Enums begränsar de värden som kan importeras för ett strängfält till en fördefinierad uppsättning. Om du försöker importera data till ett uppräkningsfält och värdet inte matchar någon av dem som definierats i konfigurationen, nekas intag.
Till skillnad från enum kan alternativet Suggested values ange en uppsättning rekommenderade värden för ett strängfält som inte begränsar de värden som kan importeras. Föreslagna värden påverkar i stället vilka fördefinierade värden som är tillgängliga i segmenteringsgränssnittet när strängfältet inkluderas som ett attribut.
När du definierar ett nytt fält i Adobe Experience Platform-användargränssnittet och anger typen till String får du alternativet att definiera ett enum- eller föreslaget värde för det fältet.
Det här dokumentet beskriver hur du definierar uppräkningar och föreslagna värden på arbetsytan i användargränssnittet för Schemas. Titta på följande video om du vill få en snabb översikt över uppräkningar och föreslagna värden, inklusive hur du konfigurerar dem i användargränssnittet och deras underordnade effekter:
Definiera en uppräkning enum
Välj Enums and Suggested Values och sedan Enums. Ytterligare kontroller visas, så att du kan ange värdebegränsningar för uppräkningen. Välj Add row om du vill lägga till en begränsning.
Under kolumnen Value måste du ange det exakta värde som du vill begränsa fältet till. Du kan även ange en användarvänlig Display Name för begränsningen, vilket påverkar hur värdet kommer att representeras i segmenteringen.
Fortsätt att använda Add row för att lägga till önskade begränsningar och valfria etiketter i uppräkningen, eller markera ikonen Ta bort (
Arbetsytan uppdateras för att återspegla ändringarna. När du utforskar det här schemat i framtiden kan du visa och redigera begränsningarna för uppräkningsfältet i den högra listen.
Definiera föreslagna värden suggested-values
Välj Enums and Suggested Values och välj sedan Suggested Values för att få fler kontroller att visas. Här väljer du Add row för att börja lägga till föreslagna värden.
Under kolumnen Display Name anger du ett användarvänligt namn för värdet så som du vill att det ska visas i segmenteringsgränssnittet. Om du vill lägga till fler föreslagna värden väljer du Add row igen och upprepar processen efter behov. Om du vill ta bort en rad som lagts till tidigare väljer du
När du är klar väljer du Apply för att tillämpa ändringarna på schemat.
Hantera föreslagna värden för standardfält
Vissa fält från standard-XDM-komponenter innehåller egna föreslagna värden, till exempel eventType från XDM ExperienceEvent class. Du kan skapa ytterligare föreslagna värden för ett standardfält, men du kan inte ändra eller ta bort föreslagna värden som inte har definierats av organisationen. När du visar ett standardfält i användargränssnittet visas de föreslagna värdena, men de är skrivskyddade.
Om du vill lägga till nya föreslagna värden för ett standardfält väljer du Add row. Om du vill ta bort ett föreslaget värde som tidigare lagts till av din organisation väljer du
Utvecklingsregler för enum och föreslagna värden evolution
När ett schema med ett uppräkningsfält har använts för att importera data till plattformen, måste alla ytterligare ändringar som görs i schemadefinitionen överensstämma med de data som redan finns i systemet. I allmänhet kan ändringar som görs i ett befintligt fält bara göra fältet mindre begränsat. Ett fält kan inte göras mer restriktivt än det redan är.
När det gäller enum och föreslagna värden gäller följande regler för postinmatning:
- Du KAN lägga till föreslagna värden för standardfält och anpassade fält med befintliga föreslagna värden.
- Du KAN ta bort föreslagna värden från anpassade fält med befintliga föreslagna värden.
- Du KAN lägga till nya uppräkningsvärden för ett befintligt anpassat uppräkningsfält.
- Du KAN växla uppräkningsvärdena för ett anpassat fält till endast föreslagna värden, eller konvertera det till en sträng utan uppräkning eller föreslagna värden. Det går inte att ångra den här växeln när den har använts.
- Du KAN INTE ta bort uppräkningar eller föreslagna värden från standardfält.
- Du KAN INTE lägga till uppräkningsvärden i ett fält utan befintlig uppräkning.
- Du KAN INTE ta bort färre än alla befintliga uppräkningsvärden för ett anpassat fält.
- Du KAN INTE växla från föreslagna värden till en uppräkning.
Sammanfoga regler för uppräkningar och föreslagna värden merging
Om flera scheman använder samma uppräkningsfält med olika konfigurationer, och dessa scheman ingår i en union, gäller vissa regler när det gäller hur uppräkningsskillnader avstäms. De exakta reglerna beror på om scheman refererar till samma standardfält (som eventType) eller om de refererar till samma anpassade fältsökväg i olika fältgrupper.
Om samma standardfält refereras:
- Eventuella ytterligare föreslagna värden är APPENDED i unionen.
- Uppdateringar av de föreslagna värdena för samma uppräkningsnyckel är UPPDATERADE i unionen.
Om samma anpassade fältsökväg refereras i olika fältgrupper:
- Eventuella ytterligare föreslagna värden är APPENDED i unionen.
- Om samma ytterligare föreslagna värde definieras i mer än ett schema är dessa värden MERGED i unionen. Med andra ord visas inte samma föreslagna värde två gånger efter sammanslagningen.
Valideringsbegränsningar
På grund av nuvarande systembegränsningar finns det två fall där en uppräkning inte valideras av systemet vid intag:
- Uppräkningen definieras i ett matrisfält.
- Uppräkningen definieras mer än en nivå djupt i schemahierarkin.
Nästa steg
I den här handboken beskrivs hur du definierar enum och föreslagna värden för strängfält i användargränssnittet. Mer information om hur du hanterar uppräkningar och föreslagna värden med API:t för schemaregister finns i följande självstudiekurs.
Mer information om hur du definierar andra XDM-fälttyper i Schema Editor finns i översikten om att definiera fält i användargränssnittet.