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.
OPMERKINGAan 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:
- Experience Data Model (XDM): Het gestandaardiseerde framework waarmee Experience Platform gegevens voor de klantervaring indeelt.
- Grondbeginselen van schemacompositie: Een overzicht van schema's XDM en hun bouwstenen, met inbegrip van klassen, groepen van het schemagebied, gegevenstypes, en individuele gebieden.
- Real-Time Customer Profile: biedt een uniform, real-time consumentenprofiel dat is gebaseerd op geaggregeerde gegevens van meerdere bronnen.
De werkruimte van Schemas openen
De Schemas -werkruimte in de Experience 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
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 Handboek of ML-bijgestaan schemaverwezenlijking
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
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
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:
- De namen van het schema zouden kort en beschrijvend moeten zijn zodat het schema later gemakkelijk kan worden gevonden.
- Schemenamen moeten uniek zijn, wat betekent dat ze ook specifiek genoeg moeten zijn om in de toekomst niet opnieuw te worden gebruikt. Bijvoorbeeld, als uw organisatie afzonderlijke loyaliteitsprogramma's voor verschillende merken had, zou het verstandig zijn om uw schema "Merk A Loyalty Leden"te noemen om het gemakkelijk te maken om van andere loyaliteits-verwante regelingen onderscheid te maken u zou kunnen later bepalen.
- U kunt de schemabeschrijving ook gebruiken om het even welke extra contextafhankelijke informatie betreffende het schema te verstrekken.
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
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.
OPMERKING
OPMERKINGEen veldgroep toevoegen
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.
OPMERKING
Deze veldgroep draagt verschillende velden onder de naam op hoofdniveau person bij met het gegevenstype "Person". In deze groep velden wordt informatie over een individu beschreven, zoals naam, geboortedatum en geslacht.
OPMERKINGHet veld name heeft het gegevenstype "Full name". Dit houdt in dat het ook een algemeen concept beschrijft en aan namen gerelateerde subvelden bevat, zoals voornaam, achternaam, hoffelijkheidstitel en achtervoegsel.
Selecteer de verschillende velden op het canvas om extra velden weer te geven die worden toegevoegd aan de schemastructuur.
Meer veldgroepen toevoegen
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
Het schema Loyalty Members is bedoeld om gegevens te vangen met betrekking tot de leden van een loyaliteitsprogramma, en de standaard Loyalty Details gebiedsgroep die u aan het schema toevoegde verstrekt de meesten van deze, met inbegrip van het programmatype, de punten, de verbindingsdatum, 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:
- Maak een nieuwe aangepaste veldgroep om deze velden vast te leggen. Dit is de methode die in deze zelfstudie wordt behandeld.
- De standaardveldgroep van Loyalty Details uitbreiden met aangepaste velden. Hierdoor wordt Loyalty Details geconverteerd naar een aangepaste veldgroep en is de oorspronkelijke standaardveldgroep niet meer beschikbaar. Zie de Schemas gids UI voor meer informatie over toevoegend douanegebieden aan de structuur van standaardgebiedsgroepen.
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 .
OPMERKING"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
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 voorwerp-type gebied hebben dat de huidige loyaliteitsrij van de persoon in detail beschrijft. Gebruikend de controles in het juiste spoor, begin een loyaltyTier gebied met type "Object"te creëren dat zal worden gebruikt om uw verwante gebieden te houden.
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).
OPMERKINGSelecteer 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:
- Field Name: De naam van het gebied, bij voorkeur geschreven in camelCase. Spaties zijn niet toegestaan. Dit is de naam die wordt gebruikt om in code en in andere downstreamtoepassingen naar het veld te verwijzen.
- Voorbeeld: loyaltyLevel
- Display Name: De naam van het gebied, geschreven in titelgeval. Dit is de naam die op het canvas wordt weergegeven wanneer u het schema weergeeft of bewerkt.
- Voorbeeld: Loyaliteitsniveau
- Type: Het gegevenstype van het veld. Dit zijn elementaire scalaire typen en alle gegevenstypen die in de Schema Registry zijn gedefinieerd. Voorbeelden: String , Integer , Boolean , Person , Address , Phone number , enzovoort.
- Description: Een optionele beschrijving van het veld moet maximaal 200 tekens bevatten.
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. Stel het type van het nieuwe veld in op "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.
