XDM-velden definiëren in de UI
Met Schema Editor in de Adobe Experience Platform-gebruikersinterface kunt u uw eigen velden definiëren binnen XDM-klassen (Custom Experience Data Model) en groepen schemavelden. In deze handleiding worden de stappen beschreven voor het definiëren van XDM-velden in de gebruikersinterface, inclusief de beschikbare configuratieopties voor elk veldtype.
Vereisten
Deze handleiding vereist een goed begrip van XDM System. Verwijs naar het XDM overzichtvoor een inleiding aan de rol van XDM binnen het Experience Platform ecosysteem, en de grondbeginselen van schemacompositieom te leren hoe de klassen en de gebiedsgroepen gebieden aan XDM schema's bijdragen.
Terwijl niet vereist voor deze gids, wordt het geadviseerd dat u ook het leerprogramma volgt op samenstellend een schema in UIom zich met de diverse mogelijkheden van Schema Editor vertrouwd te maken.
Selecteer een bron waaraan u velden wilt toevoegen select-resource
Als u nieuwe XDM-velden in de gebruikersinterface wilt definiëren, moet u eerst een schema openen in de Schema Editor . Afhankelijk van welke schema's momenteel beschikbaar aan u in Schema Library zijn, kunt u verkiezen om een nieuw schematot stand te brengen of een bestaand schema te selecteren om uit te geven.
Als u Schema Editor hebt geopend, verschijnen er besturingselementen voor het toevoegen van velden op het canvas. Deze besturingselementen worden naast de naam van het schema weergegeven, evenals alle velden van het objecttype die zijn gedefinieerd onder de geselecteerde klasse of veldgroep.
Om een nieuw gebied aan het middel toe te voegen, selecteer plus (+) pictogram naast de naam van het schema in het canvas, of naast het voorwerp-type gebied dat u het gebied onder wilt bepalen.
Afhankelijk van het feit of u een veld rechtstreeks aan een schema of aan de deel-klasse en -veldgroepen toevoegt, variëren de vereiste stappen voor het toevoegen van het veld. De rest van dit document richt zich op hoe te om de eigenschappen van een gebied ongeacht te vormen waar dat gebied in het schema verschijnt. Voor meer informatie over de verschillende manieren dat de gebieden aan een schema kunnen worden toegevoegd, verwijs naar de volgende secties in de gids van schema's UI:
De eigenschappen van een veld definiëren define
Na het selecteren van plus (+) pictogram, verschijnt placeholder Untitled field in het canvas.
In de rechterrail onder Field properties kunt u de details van het nieuwe veld configureren. Voor elk veld is de volgende informatie vereist:
Een unieke, beschrijvende naam voor het veld. De naam van het veld kan niet worden gewijzigd nadat het schema is opgeslagen. Deze waarde wordt gebruikt om het gebied in code en in andere stroomafwaartse toepassingen te identificeren en van verwijzingen te voorzien
De naam zou idealiter in camelCase moeten worden geschreven. Het kan alfanumerieke, streepje, of onderstrepingstekens bevatten, maar het kan niet met een onderstrepingsteken beginnen.
- Correct:
fieldName - Acceptable:
field_name2,Field-Name,field-name_3 - Onjuist:
_fieldName
Nota: Als u het gegevenstype van de Kaart selecteert, dan verschijnt het Map value type bezit.
u kunt Advanced type search ook selecteren om bestaande gegevenstypes te zoeken en te filtreren en van het gewenste type gemakkelijker de plaats te bepalen.
om meer over type-specifieke gebiedseigenschappente leren, zie het bepalen gebiedsoverzicht.
U kunt ook een beschrijving en notities opgeven voor elk veld. Gebruik het veld Description om context toe te voegen en de functionaliteit van het gegevenstype toewijzing te beschrijven. Dit draagt bij tot het onderhoud en de leesbaarheid van de implementatie. U kunt ook notities toevoegen als aanvulling op de oorspronkelijke beschrijving. Dit zou korrelige en specifieke informatie moeten aanbieden om ontwikkelaars te helpen bij het begrijpen, onderhouden en effectief gebruiken van de kaart binnen de context van codebase. |
Selecteer Apply nadat u de configuratie van het veld hebt voltooid.
Het canvas wordt bijgewerkt om het nieuwe toegevoegde veld weer te geven dat zich binnen een object bevindt dat een naamruimte heeft naar uw unieke huurder-id (weergegeven als _tenantId in het onderstaande voorbeeld). Alle aangepaste velden die aan een schema worden toegevoegd, worden automatisch binnen deze naamruimte geplaatst om conflicten met andere velden van door de Adobe verschafte klassen en veldgroepen te voorkomen. Het rechterspoor geeft nu naast de andere eigenschappen ook het pad van het veld weer.
U kunt de bovenstaande stappen blijven volgen om meer velden aan het schema toe te voegen. Zodra het schema wordt bewaard, worden zijn basisklasse en gebiedsgroepen ook bewaard als om het even welke veranderingen in hen zijn aangebracht.
Eigenschappen van specifieke velden type-specific-properties
Als u een nieuw veld definieert, kunnen er aanvullende configuratieopties worden weergegeven in de rechterraster, afhankelijk van de Type die u voor het veld kiest. In de volgende tabel worden deze extra veldeigenschappen in combinatie met de compatibele typen weergegeven:
Nota: Om het even welke types van kaartgegevens die door API worden gecreeerd die of geen Koord of een type van Geheel zijn worden getoond als gegevenstype 'Complex'. U kunt geen "Complex"gegevenstypes door UI tot stand brengen.
Selecteer een optie in een lijst met vooraf gedefinieerde indelingen voor tekenreeksen die de waarde moet bevatten. Beschikbare indelingen zijn:
Speciale veldtypen special
Het rechterspoor biedt verschillende selectievakjes voor het aanwijzen van speciale rollen voor het geselecteerde veld. De gebruiksgevallen voor sommige van deze opties vereisen belangrijke overwegingen met betrekking tot uw strategie voor het modelleren van gegevens en hoe u de downstream services van het Platform wilt gebruiken.
Raadpleeg de volgende documentatie voor meer informatie over deze speciale typen:
Terwijl technisch niet een speciaal gebiedstype, wordt het ook geadviseerd dat u de gids op het bepalen van objecten-type gebiedenbezoekt om meer over het bepalen van genestelde subfields te leren als uw schemastructuren.
Volgende stappen
Deze handleiding gaf een overzicht van hoe u XDM-velden in de gebruikersinterface kunt definiëren. Vergeet niet dat velden alleen aan schema's kunnen worden toegevoegd met behulp van klassen en veldgroepen. Meer over leren hoe te om deze middelen in UI te beheren, zie de gidsen bij het creëren van en het uitgeven van klassenen gebiedsgroepen.
Voor meer informatie over de mogelijkheden van de Schemas werkruimte, zie het Schemas overzicht van de werkruimte.