XDM-velden definiëren in de UI
De Schema Editor in de gebruikersinterface van Adobe Experience Platform kunt u uw eigen velden definiëren binnen de klassen van het aangepaste Experience Data Model (XDM) en de schemaveldgroepen. 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. Zie de XDM-overzicht voor een inleiding op de rol van XDM binnen het ecosysteem van het Experience Platform, en grondbeginselen van de schemacompositie om te leren hoe de klassen en de gebiedsgroepen gebieden aan schema's XDM bijdragen.
Hoewel dit niet nodig is voor deze handleiding, wordt u aangeraden de zelfstudie ook op te volgen samenstellen van een schema in UI om vertrouwd te maken met de verschillende mogelijkheden van de Schema Editor.
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 het dialoogvenster Schema Editor. Afhankelijk van welke schema's momenteel beschikbaar zijn in de Schema Library, kunt u een nieuw schema maken of een bestaand schema selecteren om te bewerken.
Als u eenmaal Schema Editor openen, worden besturingselementen voor het toevoegen van velden weergegeven 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.
Als u een nieuw veld aan de bron wilt toevoegen, selecteert u de optie plus (+) naast de naam van het schema op het canvas of naast het veld voor het objecttype dat u wilt definiëren onder.
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, an Untitled field wordt weergegeven in het canvas.
In de rechterspoorlijn 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 veld in code en in andere downstreamtoepassingen te identificeren en ernaar te verwijzen
De naam moet idealiter in camelCase worden geschreven. Het kan alfanumerieke, streepje- of onderstrepingstekens bevatten, maar het kan mag begint met een onderstrepingsteken.
- Juist:
fieldName
- Aanvaardbaar:
field_name2
,Field-Name
,field-name_3
- Onjuist:
_fieldName
Opmerking: als u het gegevenstype Kaart selecteert, Map value type wordt weergegeven.
U kunt ook Advanced type search om bestaande gegevenstypen te zoeken en te filteren en het gewenste type gemakkelijker te vinden.
Meer informatie over type-specifieke veldeigenschappenZie het overzicht met gedefinieerde velden.
U kunt ook een beschrijving en notities opgeven voor elk veld. Gebruik de Description veld om context toe te voegen en de functionaliteit van het gegevenstype map 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. |
Nadat u het veld hebt geconfigureerd, selecteert u Apply.
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
Wanneer u een nieuw veld definieert, kunnen er aanvullende configuratieopties worden weergegeven in de rechterraster, afhankelijk van de Type kiest u voor het veld. In de volgende tabel worden deze extra veldeigenschappen in combinatie met de compatibele typen weergegeven:
![De Schema-editor met de velden Type- en Kaartwaardetype gemarkeerd.](./media_12c9b1990c1616d4b8bbce05274dacc099199409d.png?width=750&format=png&optimize=medium)
Opmerking: alle gegevenstypen die via de API zijn gemaakt en die geen tekenreeks of geheel getal zijn, worden weergegeven als een 'Complex' gegevenstype. U kunt geen 'Complex'gegevenstypen via de gebruikersinterface.
De standaardwaarden worden niet opgeslagen in de gegevensset op het moment van inname, omdat ze in de loop der tijd kunnen veranderen. De standaardwaarden die in het schema worden geplaatst worden afgeleid door de stroomafwaartse diensten en de toepassingen van het Platform wanneer zij de gegevens van de dataset lezen. Bijvoorbeeld, wanneer het vragen van de gegevens gebruikend de Dienst van de Vraag, als de attributen een ONGELDIGE waarde hebben, maar het gebrek wordt geplaatst aan
5
op het schemaniveau, wordt verwacht dat de Dienst van de Vraag zal terugkeren 5
in plaats van NULL. Dit gedrag is momenteel niet uniform voor alle AEP-services.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:
Technisch gezien is dit geen speciaal veldtype, maar u kunt het beste de handleiding raadplegen op definiëren, van objecttype voor meer informatie over het definiëren van geneste subvelden als uw schema is gestructureerd.
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. Raadpleeg de handleidingen bij het maken en bewerken van deze bronnen voor meer informatie over het beheren van deze bronnen in de gebruikersinterface klassen en veldgroepen.
Voor meer informatie over de mogelijkheden van de Schemas werkruimte, zie de Schemas werkruimte - overzicht.