Een schema maken met de Schema Editor

In de Adobe Experience Platform-gebruikersinterface kunt u Experience Data Model -schema's (XDM) maken en beheren in een interactief visueel canvas dat de Schema Editor wordt genoemd. In deze zelfstudie wordt uitgelegd hoe u een schema maakt met behulp van Schema Editor .

Voor demonstratiedoeleinden, impliceren de stappen in dit leerprogramma het creëren van een voorbeeldschema dat leden van een programma van de klantenloyaliteit beschrijft. Hoewel u deze stappen kunt gebruiken om een ander schema voor uw eigen doeleinden tot stand te brengen, adviseert u eerst samen met het creëren van het voorbeeldschema om de mogelijkheden van Schema Editor te leren.

Aan de slag

Deze zelfstudie vereist een goed begrip van de verschillende aspecten van Adobe Experience Platform die bij het maken van schema's betrokken zijn. Lees vóór het starten van deze zelfstudie de documentatie voor de volgende concepten:

De werkruimte van Schemas openen browse

De Schemas -werkruimte in de Platform -gebruikersinterface biedt een visualisatie van Schema Library , zodat u de schema's die voor uw organisatie beschikbaar zijn, kunt bekijken. De werkruimte bevat ook de Schema Editor , het canvas waarop u een schema kunt samenstellen tijdens deze zelfstudie.

Nadat u zich hebt aangemeld bij Experience Platform , selecteert u Schemas in de linkernavigatie om de werkruimte van Schemas te openen. Op het tabblad Browse wordt een lijst met schema's (een voorstelling van de Schema Library ) weergegeven die u kunt weergeven en aanpassen. De lijst bevat de naam, het type, de klasse en het gedrag (record of tijdreeks) waarop het schema is gebaseerd, evenals de datum en tijd waarop het schema voor het laatst is gewijzigd.

Zie de gids bij het onderzoeken van bestaande middelen XDM in UIvoor meer informatie.

Een schema maken en een naam geven create

Als u wilt beginnen met het samenstellen van een schema, selecteert u Create schema in de rechterbovenhoek van de Schemas -werkruimte.

Het dialoogvenster Create a schema wordt weergegeven. In dit dialoogvenster kunt u kiezen of u handmatig een schema wilt maken door velden en veldgroepen toe te voegen, of u kunt een CSV-bestand uploaden en XML-algoritmen gebruiken om een schema te genereren. Selecteer een workflow voor het maken van een schema in het dialoogvenster.

[​ Beta ​]{class="badge informative"} {type=Informative} Handboek of ML-bijgestaan schemaverwezenlijking manual-or-assisted

Leren hoe u een algoritme van XML kunt gebruiken om een schemastructuur te adviseren die op een geupload dossier wordt gebaseerd, zie de machine het leren-bijgewoonde gids van de schemaverwezenlijking. Deze UI-handleiding is gericht op de workflow voor handmatig maken.

Een basisklasse kiezen choose-a-class

De Create schema -workflow wordt weergegeven. Kies vervolgens een basisklasse voor het schema. U kunt kiezen tussen de kernklassen XDM Individual Profile en XDM ExperienceEvent , of Other als deze klassen niet geschikt zijn voor uw doeleinden. De Other klassenoptie staat u toe om of een nieuwe klassetot stand te brengen of van andere reeds bestaande klassen te kiezen.

Zie de documentatie XDM individual profile en XDM ExperienceEvent voor meer informatie over deze klassen. In deze zelfstudie selecteert u XDM Individual Profile gevolgd door Next .

Naam en revisie name-and-review

Nadat u een klasse hebt geselecteerd, wordt de sectie Name and review weergegeven. In deze sectie geeft u een naam en beschrijving op om uw schema te identificeren. Er zijn verscheidene belangrijke overwegingen om te maken wanneer het beslissen over een naam voor uw schema:

Dit leerprogramma stelt een schema samen om gegevens in te gaan met betrekking tot de leden van een loyaliteitsprogramma, en daarom wordt het schema genoemd "Loyalty Members".

​ De basisstructuur van het schema (verstrekt door de klasse) wordt getoond in het canvas voor u om uw geselecteerde klasse en schemastructuur te herzien en te verifiëren.

Voer in het tekstveld een mensvriendelijke Schema display name in. Voer vervolgens een geschikte beschrijving in om uw schema te identificeren. Wanneer u de schemastructuur hebt herzien en met uw montages gelukkig bent, uitgezocht Finish om uw schema tot stand te brengen.

Uw schema samenstellen compose-your-schema

De lus Schema Editor wordt weergegeven. Dit is het canvas waarop u het schema wilt samenstellen. Het schema met eigen naam wordt automatisch gemaakt in de Structure -sectie van het canvas wanneer u in de editor aankomt, samen met de standaardvelden die zijn opgenomen in de basisklasse die u hebt geselecteerd. De toegewezen klasse voor het schema wordt ook vermeld onder Class in Composition -sectie.

Een veldgroep toevoegen field-group

U kunt nu velden toevoegen aan uw schema door veldgroepen toe te voegen. Een veldgroep is een groep van een of meer velden die vaak samen worden gebruikt om een bepaald concept te beschrijven. Deze zelfstudie gebruikt veldgroepen om de leden van het loyaliteitsprogramma te beschrijven en belangrijke informatie zoals naam, verjaardag, telefoonaantal, adres, en meer te vangen.

Als u een veldgroep wilt toevoegen, selecteert u Add in de subsectie Field groups .

Er wordt een nieuw dialoogvenster weergegeven met een lijst met beschikbare veldgroepen. Elke veldgroep is alleen bedoeld voor gebruik met een specifieke klasse. Daarom worden in het dialoogvenster alleen veldgroepen weergegeven die compatibel zijn met de klasse die u hebt geselecteerd (in dit geval de klasse XDM Individual Profile ). Als u een standaard XDM-klasse gebruikt, wordt de lijst met veldgroepen op intelligente wijze gesorteerd op basis van de populariteit van het gebruik.

U kunt één van de filters in het linkerspoor selecteren om onderaan de lijst van standaardgebiedsgroepen aan specifieke industrieënzoals kleinhandel, financiële diensten, en gezondheidszorg te versmallen.

Als u een veldgroep in de lijst selecteert, wordt deze weergegeven in de rechtertrack. U kunt desgewenst meerdere veldgroepen selecteren en deze aan de lijst in de rechtertrack toevoegen voordat u de groep bevestigt. Bovendien wordt aan de rechterkant van de momenteel geselecteerde veldgroep een pictogram weergegeven waarmee u een voorvertoning kunt weergeven van de structuur van de velden die worden weergegeven.

Als u een voorbeeld van een veldgroep bekijkt, wordt een gedetailleerde beschrijving van het schema van de veldgroep weergegeven in de rechtertrack. U kunt ook door de velden van de veldgroep navigeren op het beschikbare canvas. Als u verschillende velden selecteert, wordt het rechterspoor bijgewerkt om details over het betreffende veld weer te geven. Selecteer Back wanneer u klaar bent met de voorvertoning om terug te keren naar het dialoogvenster voor het selecteren van veldgroepen.

Selecteer voor deze zelfstudie de veldgroep Demographic Details en selecteer vervolgens Add field group .

Het schemacanvas verschijnt opnieuw. De sectie Field groups bevat nu "Demographic Details" en de sectie Structure bevat de velden die zijn toegevoegd door de veldgroep. U kunt de naam van de veldgroep selecteren onder de sectie Field groups om de specifieke velden te markeren die worden weergegeven op het canvas.

NOTE

Binnen de Redacteur van het Schema, worden de standaard (Adobe-geproduceerde) klassen en de gebiedsgroepen vermeld met het hangslotpictogram ( . Het hangslot verschijnt in de linkerspoorstaaf naast de klasse of de naam van de gebiedsgroep, evenals naast om het even welk gebied in het schemadiagram dat een deel van een systeem-geproduceerde middel is.

Deze veldgroep voegt verschillende velden onder de naam op hoofdniveau person toe aan het gegevenstype "Person". In deze groep velden wordt informatie over een individu beschreven, zoals naam, geboortedatum en geslacht.

Het veld name heeft een gegevenstype of "Full name", wat betekent dat het ook een algemeen concept beschrijft en aan naam gerelateerde subvelden bevat zoals voornaam, achternaam, beleefdheidstitel en achtervoegsel.

Selecteer de verschillende velden op het canvas om extra velden weer te geven die worden toegevoegd aan de schemastructuur.

Meer veldgroepen toevoegen field-group-2

U kunt nu dezelfde stappen herhalen om een andere veldgroep toe te voegen. Wanneer u dit keer het dialoogvenster Add field group bekijkt, ziet u dat de veldgroep "Demographic Details" grijs is weergegeven en dat het selectievakje naast deze groep niet kan worden geselecteerd. Zo voorkomt u dat u per ongeluk veldgroepen dupliceert die u al in het huidige schema hebt opgenomen.

Selecteer in deze zelfstudie de standaardveldgroepen Personal Contact Details en Loyalty Details in de lijst en selecteer vervolgens Add field groups om deze aan het schema toe te voegen.

Het canvas verschijnt weer met de toegevoegde veldgroepen die onder Field groups in de Composition -sectie worden vermeld, en de samengestelde velden ervan worden toegevoegd aan de schemastructuur.

Een aangepaste veldgroep definiëren define-field-group

Het schema Loyalty Members is bedoeld om gegevens vast te leggen die betrekking hebben op de leden van een loyaliteitsprogramma. De standaardveldgroep van Loyalty Details die u aan het schema hebt toegevoegd, bevat de meeste hiervan, inclusief het programmatype. points, join-datum en meer.

Er kan echter een scenario zijn waarin u extra aangepaste velden wilt opnemen die niet door standaardveldgroepen worden gedekt om uw gebruiksgevallen te bereiken. Als u velden voor aangepaste loyaliteit toevoegt, hebt u twee opties:

Als u een nieuwe veldgroep wilt maken, selecteert u Add in de Field groups -subsectie zoals voorheen, maar selecteert u deze keer Create New Field group boven in het dialoogvenster dat verschijnt. Vervolgens wordt u gevraagd een weergavenaam en beschrijving op te geven voor de nieuwe veldgroep. Voor deze zelfstudie geeft u de nieuwe veldgroep de naam "Custom Loyalty Details" en selecteert u vervolgens Add field groups .

"Custom Loyalty Details" moet nu worden weergegeven onder Field groups aan de linkerkant van het canvas, maar er zijn nog geen velden aan gekoppeld en daarom verschijnen er geen nieuwe velden onder Structure .

Velden toevoegen aan de veldgroep field-group-fields

Nu u "Custom Loyalty Details"gebiedsgroep hebt gecreeerd, is het tijd om de gebieden te bepalen die de gebiedsgroep aan het schema zal bijdragen.

Om te beginnen, selecteer plus (+) pictogram naast de naam van het schema in het canvas.

De tijdelijke aanduiding "Untitled Field" wordt weergegeven op het canvas en de updates van de rechterrails om configuratieopties voor het veld weer te geven.

In dit scenario moet het schema een objecttype hebben field dat een gedetailleerde beschrijving geeft van de huidige loyaliteitslaag van de persoon . Start met de besturingselementen in de rechtertrack een loyaltyTier -veld met tekst. "Object " die wordt gebruikt voor de weergave van verwante velden.

Onder Assign to moet u een veldgroep selecteren waaraan u het veld wilt toewijzen. Houd er rekening mee dat alle schemavelden tot een klasse of een veldgroep behoren. Aangezien in dit schema een standaardklasse wordt gebruikt, kunt u alleen een veldgroep selecteren. Begin in de naam "Custom Loyalty Details" te typen, dan selecteer de gebiedsgroep van de lijst.

Selecteer Apply als u klaar bent.

De wijzigingen worden toegepast en het nieuwe loyaltyTier -object wordt weergegeven. Aangezien dit een douanegebied is, wordt het automatisch genest binnen een voorwerp genoemd aan huurder ID van uw organisatie, voorafgegaan door een onderstrepingsteken (_tenantId in dit voorbeeld).

Selecteer plus (+) pictogram naast het loyaltyTier voorwerp beginnen subfields toe te voegen. Er wordt een nieuwe plaatsaanduiding voor velden weergegeven en de sectie Field properties wordt aan de rechterkant van het canvas weergegeven.

Voor elk veld is de volgende informatie vereist:

Het eerste veld voor het loyaltyTier -object is een tekenreeks met de naam id die de id van de huidige laag van het loyaliteitslid vertegenwoordigt. Identiteitskaart van de rij zal uniek voor elk loyaliteitlid zijn, aangezien dit bedrijf verschillende die puntdrempels van de loyaliteitsrij voor elke klant plaatst op verschillende factoren wordt gebaseerd. Het type van het nieuwe veld instellen to "String" en de sectie Field properties wordt gevuld met verschillende opties voor het toepassen van beperkingen, zoals standaardwaarde, opmaak en maximumlengte. Zie de documentatie over beste praktijken voor de gebieden van de gegevensbevestigingom meer te leren.

Aangezien id een willekeurig gegenereerde vrije-vormtekenreeks wordt, zijn er geen verdere beperkingen nodig. Selecteer Apply om de wijzigingen toe te passen.

Meer velden toevoegen aan de veldgroep field-group-fields-2

Nu u het veld id hebt toegevoegd, kunt u aanvullende velden toevoegen om informatie over de loyaliteitsniveaus vast te leggen, zoals:

Om elk gebied aan het schema toe te voegen, selecteer plus (+) pictogram naast het loyalty voorwerp en vul de vereiste informatie in.

Wanneer dit is voltooid, bevat het object loyaltyTier velden voor id , currentThreshold , nextThreshold en effectiveDate .

Een opsommingsveld toevoegen aan de veldgroep enum

Bij het definiëren van velden in de Schema Editor zijn er enkele extra opties die u kunt toepassen op standaardveldtypen in om verdere beperkingen te bieden aan de gegevens die het veld kan bevatten. De gebruiksgevallen voor deze beperkingen worden in de volgende tabel uitgelegd:

Voor deze zelfstudie vereist het loyaltyTier -object in het schema een nieuw opsommingsveld dat de klasse tier beschrijft, waarbij de waarde slechts een van de vier mogelijke opties kan zijn. Om dit gebied aan het schema toe te voegen, selecteer plus (+) pictogram naast het loyaltyTier voorwerp en vul de vereiste gebieden voor Field name en Display name in. Selecteer voor Type "String".

Er worden extra selectievakjes voor het veld weergegeven nadat het type is geselecteerd, waaronder selectievakjes voor Array , Enum & Suggested Values , Identity en Relationship .

Selecteer het selectievakje Enum & Suggested Values en selecteer vervolgens Enum . Hier kunt u Value (in camelCase) en Display Name (een optionele, leesvriendelijke naam in Alles Beginhoofdletter) invoeren voor elke acceptabele klasse van de loyaliteitslaag.

Wanneer u alle veldeigenschappen hebt voltooid, selecteert u Apply om het tierClass veld aan het loyaltyTier -object toe te voegen.

Een object met meerdere velden omzetten in een gegevenstype datatype

Het loyaltyTier -object bevat nu verschillende velden en vertegenwoordigt een algemene gegevensstructuur die nuttig kan zijn in andere schema's. Met Schema Editor kunt u gemakkelijk herbruikbare objecten met meerdere velden toepassen door de structuur van die objecten om te zetten in gegevenstypen.

De types van gegevens staan voor het verenigbare gebruik van multi-gebiedsstructuren toe en verstrekken meer flexibiliteit dan een gebiedsgroep omdat zij overal binnen een schema kunnen worden gebruikt. Dit wordt gedaan door de waarde Type van het gebied aan dat van om het even welk gegevenstype te plaatsen die in Schema Registry wordt bepaald.

Als u het loyaltyTier -object wilt omzetten in een gegevenstype, selecteert u het loyaltyTier -veld op het canvas en selecteert u vervolgens Convert to new data type rechts van de editor onder Field properties .

Er wordt een melding weergegeven waarin wordt bevestigd dat het object is geconverteerd. Op het canvas kunt u nu zien dat het veld loyaltyTier nu een koppelingspictogram heeft en de rechterspoorlijn geeft aan dat het een gegevenstype "Loyalty Tier" heeft.

In een toekomstig schema, kon u een gebied als "Loyalty Tier"type nu toewijzen en het zou automatisch gebieden voor identiteitskaart, rijklasse, puntdrempels, en efficiënte datum omvatten.

Schema-velden zoeken en filteren

Het schema bevat nu diverse veldgroepen naast de velden die door de basisklasse worden verschaft. Wanneer u met grotere schema's werkt, kunt u de selectievakjes naast veldgroepnamen in de linkerrail selecteren om de weergegeven velden te filteren op de velden die alleen worden weergegeven door de veldgroepen waarin u geïnteresseerd bent.

Als u een specifiek veld in uw schema zoekt, kunt u ook de zoekbalk gebruiken om weergegeven velden op naam te filteren, ongeacht de veldgroep waarin ze staan.

Een schemaveld instellen als een identiteitsveld identity-field

De standaard gegevensstructuur die schema's verstrekken kan worden gebruikt om gegevens te identificeren die tot het zelfde individu over veelvoudige bronnen behoren, die voor diverse stroomafwaartse gebruiksgevallen zoals segmentatie, rapportering, gegevenswetenschapsanalyse, en meer toestaan. Als u gegevens op basis van individuele identiteiten wilt koppelen, moeten sleutelvelden worden gemarkeerd als Identity -velden binnen de toepasselijke schema's.

Experience Platform maakt het gemakkelijk om een identiteitsveld aan te duiden door het selectievakje Identity in het Schema Editor te gebruiken. U moet echter bepalen welk veld de beste kandidaat is om als identiteit te gebruiken, op basis van de aard van uw gegevens.

Bijvoorbeeld, kunnen er duizenden leden van het loyaliteitsprogramma tot het zelfde loyaliteitsniveau behoren, en verscheidene die het zelfde fysieke adres kunnen delen. In dit scenario, echter, bij inschrijving verstrekt elk lid van het loyaliteitsprogramma zijn persoonlijk e-mailadres. Aangezien persoonlijke e-mailadressen meestal door één persoon worden beheerd, is het veld personalEmail.address (opgegeven door de Personal Contact Details -veldgroep) een goede kandidaat voor een identiteitsveld.

Selecteer het veld personalEmail.address op het canvas en schakel het selectievakje Identity onder Field properties in. Schakel het selectievakje in en kies de optie om deze in te stellen terwijl de Primary identity wordt weergegeven. Selecteer dit vak ook.

Vervolgens moet u een Identity namespace opgeven uit de lijst met vooraf gedefinieerde naamruimten in het vervolgkeuzemenu. Aangezien dit veld het e-mailadres van de klant is, selecteert u "Email" in de vervolgkeuzelijst. Selecteer Apply om de updates voor het veld personalEmail.address te bevestigen.

Nadat de wijziging is toegepast, wordt op het pictogram voor personalEmail.address een vingerafdruksymbool weergegeven om aan te geven dat het nu een identiteitsveld is. Het veld wordt ook weergegeven in de linkertrack onder Identities .

Alle gegevens die in het veld personalEmail.address worden ingevoerd, worden nu gebruikt om die persoon te identificeren en één weergave van die klant samen te voegen. Raadpleeg de documentatie van Identity Service voor meer informatie over het werken met identiteiten in Experience Platform .

Het schema inschakelen voor gebruik in Real-Time Customer Profile profile

Real-Time Customer Profile gebruikt identiteitsgegevens in Experience Platform voor een holistische weergave van elke afzonderlijke klant. De service maakt robuuste, 360°-profielen van klantkenmerken en tijdstempelde accounts van elke interactie die klanten hebben gehad in elk systeem dat is geïntegreerd met Experience Platform .

Een schema kan alleen worden ingeschakeld voor gebruik met Real-Time Customer Profile als er een primaire identiteit is gedefinieerd. Er wordt een foutbericht weergegeven als u een schema wilt inschakelen zonder eerst een primaire identiteit te definiëren.

Als u het schema 'Loyalty-leden' wilt inschakelen voor gebruik in Profile , selecteert u eerst de schematitel op het canvas.

Rechts in de editor wordt informatie over het schema weergegeven, inclusief de weergavenaam, beschrijving en type. Naast deze informatie is er een schakelknop Profile .

Selecteer Profile en er verschijnt een pop-up met de vraag of u het schema wilt inschakelen voor Profile .

Selecteer Enable om uw keuze te bevestigen. U kunt desgewenst de schakeloptie Profile opnieuw selecteren om het schema uit te schakelen, maar als het schema is opgeslagen terwijl Profile is ingeschakeld, kan het niet meer worden uitgeschakeld.

Meer handelingen more

In de Schema-editor kunt u ook snel handelingen uitvoeren om de JSON-structuur van het schema te kopiëren of het schema te verwijderen. Selecteer More boven aan de weergave om een vervolgkeuzelijst met snelle acties weer te geven.

Schema verwijderen delete-a-schema

Een schema kan binnen UI van de Redacteur van het Schema worden geschrapt gebruikend More acties en ook van de schemadetails op het Browse lusje. Er zijn bepaalde voorwaarden die voorkomen dat een schema wordt verwijderd. Een schema kan niet worden verwijderd als:

JSON-structuur kopiëren copy-json-structure

Selecteer Copy JSON structure om een exportlading voor om het even welk schema in de Bibliotheek van het Schema te produceren. Met deze handeling wordt de JSON-structuur naar het klembord gekopieerd. Uw geëxporteerde JSON kan vervolgens worden gebruikt om het schema en eventuele gerelateerde bronnen te importeren in een andere sandbox of organisatie. Dit maakt het delen en hergebruiken van schema's tussen verschillende milieu's eenvoudig en efficiënt.

Volgende stappen en extra bronnen

Nu u klaar bent met het samenstellen van het schema, kunt u het volledige schema in het canvas zien. Selecteer Save en het schema wordt opgeslagen in Schema Library , waardoor het toegankelijk wordt voor Schema Registry .

Het nieuwe schema kan nu worden gebruikt om gegevens in te voeren in Platform . Herinner dat zodra het schema is gebruikt om gegevens in te voeren, slechts de additieve veranderingen kunnen worden aangebracht. Zie de grondbeginselen van schemacompositievoor meer informatie over schema versioning.

U kunt het leerprogramma nu volgen op bepalend een schemaverhouding in UIom een nieuw relatiegebied aan het schema van de Leden van de "Loyalty"toe te voegen.

Het schema "Loyalty Member" is ook beschikbaar voor weergave en beheer met de API Schema Registry . Beginnen werkend met API, begin door de Schema Registry API ontwikkelaarsgidste lezen.

Videobronnen

In de volgende video ziet u hoe u een eenvoudig schema maakt in de gebruikersinterface van Platform .

De volgende video is bedoeld om u meer inzicht te geven in het werken met veldgroepen en klassen.

Bijlage

In de volgende secties vindt u aanvullende informatie over het gebruik van de Schema Editor .

Een nieuwe klasse maken create-new-class

Experience Platform biedt de flexibiliteit om een schema te definiëren op basis van een klasse die uniek is voor uw organisatie. Leren hoe te om een nieuwe klasse tot stand te brengen, zie de gids bij het creëren van en het uitgeven van klassen in UI.

De klasse van een schema wijzigen change-class

U kunt de klasse van een schema op om het even welk punt tijdens het aanvankelijke samenstellingsproces veranderen alvorens het schema is bewaard.

Leren hoe te om de klasse van een schema te veranderen, zie de gids op het leiden schema's in UI.