Opsommingen en voorgestelde waarden definiëren in de gebruikersinterface enums-and-suggested-values
In het Model van Gegevens van de Ervaring (XDM), kan een koordgebied een vooraf bepaalde reeks toegelaten of voorgestelde waarden worden gegeven om beter te controleren welke waarden in dat gebied worden opgenomen of hoe het in segmentatie zal gedragen.
Enums beperkt de waarden die voor een tekenreeksveld kunnen worden ingevoerd tot een vooraf gedefinieerde set. Als u probeert gegevens in te voeren in een opsommingsveld en de waarde niet overeenkomt met een van de gedefinieerde waarden in de configuratie, wordt invoer geweigerd.
In tegenstelling tot opsommingen, staat de Suggested values optie toe om een reeks geadviseerde waarden voor een koordgebied te wijzen dat niet de waarden beperkt die het kan opnemen. In plaats daarvan, beïnvloeden de voorgestelde waarden welke vooraf bepaalde waarden in Segmentatie UIbeschikbaar zijn wanneer het omvatten van het koordgebied als attribuut.
Wanneer het bepalen van een nieuw gebiedin het gebruikersinterface van Adobe Experience Platform en het plaatsen van het type aan String, wordt u gegeven de optie om een enumof gesuggereerde waardenvoor dat gebied te bepalen.
In dit document wordt beschreven hoe u opsommingen en voorgestelde waarden definieert in de gebruikersinterface van Schemas . Bekijk de volgende video voor een snel overzicht van opsommingen en voorgestelde waarden, inclusief hoe u deze kunt configureren in de gebruikersinterface en de bijbehorende downstreameffecten:
Een opsomming definiëren enum
Selecteer Enums and Suggested Values en selecteer vervolgens Enums . Er worden extra besturingselementen weergegeven, zodat u de waardebeperkingen voor de opsomming kunt opgeven. Selecteer Add row als u een restrictie wilt toevoegen.
Onder de kolom Value moet u de exacte waarde opgeven waarnaar u het veld wilt beperken. U kunt optioneel ook een gebruiksvriendelijke Display Name versie van de beperking opgeven, die bepaalt hoe de waarde in de segmentatie wordt weergegeven.
Ga verder om Add row te gebruiken om de gewenste beperkingen en facultatieve etiketten aan de opsomming toe te voegen, of het schrappingspictogram (
Het canvas wordt bijgewerkt met de wijzigingen. Wanneer u dit schema in de toekomst verkent, kunt u de beperkingen voor het enum gebied binnen het juiste spoor bekijken en uitgeven.
Voorgestelde waarden definiëren suggested-values
Selecteer Enums and Suggested Values en selecteer vervolgens Suggested Values om extra besturingselementen weer te geven. Selecteer van hieruit Add row om voorgestelde waarden toe te voegen.
Geef onder de kolom Display Name een mensvriendelijke naam voor de waarde op zoals u deze wilt weergeven in de segmenteringsinterface. Als u meer gesuggereerde waarden wilt toevoegen, selecteert u Add row nogmaals en herhaalt u zo nodig het proces. Om een eerder toegevoegde rij te verwijderen, selecteer
Als u klaar bent, selecteert u Apply om de wijzigingen toe te passen op het schema.
Voorgestelde waarden voor standaardvelden beheren
Sommige gebieden van standaardXDM componenten bevatten hun eigen gesuggereerde waarden, zoals eventType van de XDM ExperienceEvent klasse. Hoewel u aanvullende voorgestelde waarden voor een standaardveld kunt maken, kunt u voorgestelde waarden die niet door uw organisatie zijn gedefinieerd, niet wijzigen of verwijderen. Als u een standaardveld in de gebruikersinterface weergeeft, worden de voorgestelde waarden weergegeven, maar alleen-lezen.
Selecteer Add row als u nieuwe voorgestelde waarden voor een standaardveld wilt toevoegen. Om een gesuggereerde waarde te verwijderen die eerder door uw organisatie werd toegevoegd, selecteer
Evolutieregels voor opsommingen en voorgestelde waarden evolution
Nadat een schema met een enum gebied is gebruikt om gegevens in Platform in te voeren, moeten om het even welke verdere veranderingen die in de schemadefinitie worden aangebracht aan de gegevens reeds in het systeem voldoen. In het algemeen, kunnen de veranderingen die aan een bestaand gebied worden aangebracht slechts dat gebied minder restrictief maken. Een veld kan niet restrictiever worden gemaakt dan het al is.
Wanneer het over aantallen en voorgestelde waarden aankomt, zijn de volgende regels post-ingesetion van toepassing:
- U KUNT voorgestelde waarden voor standaard en douanevelden met bestaande voorgestelde waarden toevoegen.
- U KUNT voorgestelde waarden uit douanegebieden met bestaande voorgestelde waarden verwijderen.
- U KUNT nieuwe opsommingswaarden voor een bestaand gebied van het douanenum toevoegen.
- U KUNT schakelaar de enum waarden van een douanegebied aan gesuggereerde waarden slechts, of het in een koord zonder opsomming of voorgestelde waarden omzetten. deze schakelaar kan niet worden ongedaan gemaakt zodra toegepast.
- U KAN lijsten of gesuggereerde waarden van standaardgebieden NIET verwijderen.
- U KAN enumwaarden aan een gebied zonder bestaand enum NIET toevoegen.
- U KAN minder dan alle bestaande enumwaarden voor een douanegebied NIET verwijderen.
- U KAN schakelaar van voorgestelde waarden aan een opsomming NIET.
Regels samenvoegen voor opsommingen en voorgestelde waarden merging
Als de veelvoudige schema's het zelfde enum gebied met verschillende configuraties gebruiken, en die schema's inbegrepen in een unie zijn, zijn bepaalde regels van toepassing wanneer het over hoe de enum verschillen met elkaar in overeenstemming worden gebracht. De exacte regels zijn afhankelijk van het feit of de schema's verwijzen naar hetzelfde standaardveld (zoals eventType ) of dat er wordt verwezen naar hetzelfde aangepaste veldpad in verschillende veldgroepen.
Bij verwijzing naar hetzelfde standaardveld:
- Om het even welke extra voorgestelde waarden worden TOEGEVOEGD in de unie.
- De updates die aan de voorgestelde waarden voor de zelfde enum sleutel worden gemaakt zijn BIJGEWERKT in de unie.
Als in verschillende veldgroepen wordt verwezen naar hetzelfde aangepaste veldpad:
- Om het even welke extra voorgestelde waarden worden TOEGEVOEGD in de unie.
- Als de zelfde extra gesuggereerde waarde in meer dan één schema wordt bepaald, zijn die waarden GEMERGED in de unie. Met andere woorden, dezelfde voorgestelde waarde wordt niet twee keer na het samenvoegen weergegeven.
Beperkingen voor validatie
Vanwege de huidige systeembeperkingen zijn er twee gevallen waarin een enum niet door het systeem wordt gevalideerd tijdens inname:
- Het enum wordt bepaald op een seriegebied.
- De opsomming wordt meer dan één niveau diep gedefinieerd in de schemahiërarchie.
Volgende stappen
In deze handleiding wordt beschreven hoe u opsommingen en voorgestelde waarden voor tekenreeksvelden in de gebruikersinterface definieert. Voor informatie over hoe te om lijsten en voorgestelde waarden te beheren gebruikend de Registratie API van het Schema, verwijs naar het volgende leerprogramma.
Leren hoe te om andere XDM gebiedstypes in Schema Editor te bepalen, zie het overzicht op bepalend gebieden in UI.