Utforska schemaresurser i användargränssnittet
I Adobe Experience Platform lagras alla XDM-schemaresurser (Experience Data Model) i Schema Library, inklusive standardresurser från Adobe och anpassade resurser som definierats av din organisation. I Experience Platform-gränssnittet kan du visa strukturen och fälten för befintliga scheman, klasser, fältgrupper eller datatyper i Schema Library. Detta är särskilt användbart när du planerar och förbereder för dataöverföring, eftersom användargränssnittet ger information om de förväntade datatyperna och användningsexemplen för varje fält som tillhandahålls av dessa XDM-resurser.
Den här självstudiekursen beskriver stegen för att utforska befintliga scheman, klasser, fältgrupper och datatyper i Experience Platform användargränssnitt.
Söka efter en schemaresurs lookup
I Experience Platform-gränssnittet väljer du Schemas i den vänstra navigeringen. På arbetsytan Schemas finns en Browse-flik som du kan använda för att utforska alla scheman i organisationen, tillsammans med ytterligare dedikerade flikar för utforska Classes, Field groups, Data types och Relationships.
Filterikonen (
På fliken Browse i arbetsytan Schemas kan du filtrera schemalagret. Använd växlingsknappen Included in Profile om du bara vill visa scheman som har aktiverats för användning i Kundprofil för realtid. Använd växlingsknappen Show adhoc schemas för att filtrera listan med scheman som skapats med fält som namngetts för att endast användas av en enskild datauppsättning.
På fliken Relationship i arbetsytan Schemas kan du filtrera listan över relationer baserat på fyra kriterier. Filtren innehåller Source schema, Destination schema, Source class och Destination class. Tabellen nedan innehåller en beskrivning av filtren.
Du kan även använda sökfältet för att begränsa resultaten ytterligare.
Resurserna som visas i sökresultaten ordnas först efter matchningar av titel och sedan efter matchningar av beskrivning. Ju fler ord som matchar i någon av dessa kategorier, desto högre visas resursen i listan.
När du har hittat resursen som du vill utforska väljer du resursens namn i listan för att visa dess struktur på arbetsytan.
Hantera scheman, klasser, fältgrupper och datatyper: åtgärder och borttagning xdm-resource-actions
Använd det här avsnittet när du behöver hantera eller ta bort XDM-resurser, eller när en åtgärd (till exempel ta bort) inte är tillgänglig och du behöver förstå varför.
Var du hittar åtgärder (textbunden eller detaljsida) where-to-find-actions
Om du vill utföra åtgärder som att ta bort, exportera eller kopiera en resurs använder du någon av följande startpunkter:
På flikarna Browse, Classes, Field groups och Data types finns hanteringsåtgärder på två platser:
- Inline i tabellen: Varje resursrad innehåller en åtgärdsmeny (till exempel …) som ger direktåtkomst till tillgängliga åtgärder.
- Resursdetaljvy: Om du vill få tillgång till fullständiga åtgärder i detaljvyn måste du välja en anpassad (innehavardefinierad) -resurs. Standardresurser (som tillhandahålls av Adobe) har begränsade åtgärder och visar inte alternativ som Ta bort, Kopiera JSON-struktur eller Lägg till i paket. Välj en anpassad resurs i lagret för att öppna dess detaljvy och använd sedan menyn More i sidhuvudet för att få tillgång till samma tillgängliga åtgärder.
Dessa åtgärder är konsekventa över båda startpunkterna för de resurstyper som stöds (scheman, klasser, fältgrupper och datatyper).
Tillgängliga åtgärder available-actions
Beroende på resurstypen och dina behörigheter kan följande åtgärder vara tillgängliga:
- Delete - Ta bort en anpassad resurs permanent från organisationen (när begränsningarna tillåter det). Om borttagning blockeras, se Begränsningar.
- Download sample file - Generera en exempeldatafil baserat på resursstrukturen. Steg för steg: Generera XDM-exempeldata.
- Copy JSON structure - Kopiera resursdefinitionen i JSON-format för återanvändning, export eller inspektion. Steg för steg: Exportera XDM-scheman.
- Add to package - Inkludera resursen i ett sandlådepaket för export eller import över sandlådor. Steg för steg: Exportera objekt till ett paket.
Följande gäller för olika resurstyper:
-
Alla åtgärder ovan kan vara tillgängliga för anpassade (innehavardefinierade)-scheman, klasser, fältgrupper och datatyper.
-
För klasser, fältgrupper och datatyper i standard (Adobe-definierad):
- Endast Download sample file är tillgängligt.
- Delete, Kopiera JSON-struktur och Lägg till i paket är inte tillgängliga.
Ta bort beteende delete-behavior
Använd åtgärden Delete när du vill ta bort en anpassad resurs som inte längre behövs.
Så här tar du bort en resurs:
- Leta reda på resursen i tabellen eller öppna dess detaljvy.
- Välj åtgärdsmenyn (… eller More).
- Välj Delete.
- Bekräfta åtgärden i dialogrutan genom att välja Delete igen.
Resursen tas bort permanent från organisationen när den har bekräftats.
Om det inte går att ta bort en resurs visas alternativet inaktiverat med ett verktygstips som förklarar varför åtgärden inte kan utföras.
Begränsningar (datauppsättning, profil, RBAC, klientorganisation kontra global) delete-constraints
Om en åtgärd som Delete inte är tillgänglig eller inaktiverad beror det vanligtvis på något av följande:
-
Behörigheter (RBAC): Du måste ha nödvändig behörighet (till exempel Manage Schemas) för att kunna utföra hanteringsåtgärder. Om behörigheter saknas visas funktionsmakron som inaktiverade med verktygstips. Mer information om hur behörigheter konfigureras finns i översikt över användargränssnittet för åtkomstkontroll.
-
Datauppsättningsassociation: Resurser som används av en eller flera datauppsättningar (till exempel scheman som är kopplade till datauppsättningar) kan inte tas bort. Information om hur du identifierar och tar bort datauppsättningsberoenden finns i Ta bort en datauppsättning.
-
Profilaktivering: Det går inte att ta bort scheman som har aktiverats för kundprofil i realtid. Mer information om hur profilaktiveringen påverkar ditt schema finns i Planering för kundprofilaktivering i realtid.
-
Klientorganisationen kontra globala resurser: Klientdefinierade (anpassade) resurser kan tas bort (beroende på begränsningar), medan standardklasser (Adobe), fältgrupper och datatyper inte kan tas bort.
Dessa begränsningar återspeglas direkt i användargränssnittet. När en åtgärd inte är tillgänglig visas den som inaktiverad och innehåller ett verktygstips som förklarar den specifika begränsningen.
Om du inte kan ta bort en resurs går du igenom villkoren ovan för att avgöra om du behöver uppdatera behörigheter, ta bort beroenden eller justera datamodellen.
Ytterligare arbetsflöden för schemaredigering på arbetsytan finns i Skapa och redigera scheman i gränssnittet.
Utforska en XDM-resurs på arbetsytan explore
När du har valt en resurs öppnas dess struktur på arbetsytan.
Alla objekttypsfält som innehåller underegenskaper komprimeras som standard när de först visas på arbetsytan. Om du vill visa underegenskaperna för ett fält markerar du ikonen bredvid namnet.
Standardklass och fältgruppsindikator standard-class-and-field-group-indicator
I Schemaredigeraren anges standardklasser (Adobe-genererade) och fältgrupper med hänglåsikonen (
Mer information finns i Lägg till anpassade fält i standardfältgrupper -dokumentationen. Du kan inte redigera en standardklass.
Systemgenererade fält system-fields
Vissa fältnamn har ett understreck som _repo och _id. Dessa representerar platshållare för fält som systemet automatiskt genererar och tilldelar när data hämtas.
Därför bör de flesta av dessa fält uteslutas från datastrukturen vid import till Experience Platform. Det huvudsakliga undantaget för den här regeln är fältet _{TENANT_ID} , som alla XDM-fält som skapats under din organisation måste namnges under.
Datatyper data-types
För varje fält som visas på arbetsytan visas dess motsvarande datatyp bredvid namnet, vilket i en snabbtitt anger vilken typ av data som fältet förväntar sig för inmatning.
Alla datatyper som läggs till med hakparenteser ([]) representerar en matris med den aktuella datatypen. En datatyp på String[] anger till exempel att en matris med strängvärden förväntas för fältet. Datatypen Payment Item[] anger en array med objekt som överensstämmer med datatypen Payment Item.
Om ett matrisfält baseras på en objekttyp kan du markera dess ikon på arbetsytan för att visa de förväntade attributen för varje matrisobjekt.
Field properties field-properties
När du markerar namnet på ett fält på arbetsytan uppdateras den högra listen så att information om det fältet visas under Field properties. Detta kan innehålla en beskrivning av fältets avsedda användningsfall, standardvärden, mönster, format, om fältet är obligatoriskt, med mera. När du utforskar en fältgrupp kan även etikettrelaterade detaljer för det valda fältet visas här; se Etiketter i strukturvyn.
Om fältet som du inspekterar är ett uppräkningsfält, visar den högra listen även de värden som fältet förväntar sig att ta emot.
Identitetsfält identity
När du inspekterar scheman som innehåller identitetsfält visas dessa fält i den vänstra listen under den klass eller fältgrupp som tillhandahåller dem till schemat. Markera namnet på identitetsfältet i den vänstra listen för att visa fältet på arbetsytan, oavsett hur djupt det är kapslat.
Identitetsfält markeras på arbetsytan med en fingeravtrycksikon (
Relationsfält relationship
Om du inspekterar ett schema som innehåller ett relationsfält visas fältet i den vänstra listen under Relationships. Markera relationsfältets namn i den vänstra listen för att visa fältet på arbetsytan, oavsett hur djupt det är kapslat. Relationsfält markeras också unikt på arbetsytan och visar namnet på referensschemat som fältet länkar till. För organisationer med B2B-funktioner kan anpassade relationsnamn skrivas och visas på arbetsytan i dessa fall.
Om du vill visa identitetsnamnområdet för referensschemats primära identitet markerar du relationsfältet och sedan Edit relationship i sidofältet Field properties. Parametrarna för relationen visas i dialogrutan Edit relationship som visas.
Mer information om hur du använder relationer i XDM-scheman finns i självstudiekursen Skapa en relation i användargränssnittet.
Utforska fältgrupper: användning och metadata explore-field-groups
Navigera till Schemas > Field groups för att utforska fältgrupper. På fliken Field groups hjälper ytterligare funktioner dig att förstå var en fältgrupp används i olika scheman och vad den innehåller, till exempel kompatibilitet, obligatoriska fält (som framtvingar krav på inmatning) och styrningssignaler.
Med de här funktionerna kan du utvärdera påverkan innan du gör ändringar och identifiera relevanta fältgrupper effektivare under schemadesignen.
Visa schemaanvändning för fältgrupper view-schema-usage-for-field-groups
I tabellen Field groups väljer du en fältgrupp för att öppna dess detaljvy. Arbetsytan uppdateras för att visa fältgruppsstrukturen och egenskapsfältet visar ytterligare information om den valda resursen.
Scheman som använder den här fältgruppen
I den högra egenskapsfältet visar avsnittet Schemas using this field group scheman som för närvarande innehåller fältgruppen.
- Om fältgruppen används av tre eller färre scheman visas alla schemanamn.
- Om den används av mer än tre scheman visas bara vissa namn tillsammans med ett alternativ för att visa hela listan.
Välj ett schemanamn för att öppna dess detaljvy på en ny flik och kontrollera hur fältgruppen implementeras i det schemat.
Visa fler och fullständiga schemalistor
Om det finns fler scheman än vad som kan visas infogat väljer du View more för att öppna den fullständiga dialogrutan.
Dialogrutan Schemas using this field group visas med en fullständig lista över scheman som använder fältgruppen.
I dialogrutan Schemas using this field group kan du:
- Bläddra bland alla scheman som använder fältgruppen
- Bläddra igenom stora resultatuppsättningar
- Välj ett schema för att öppna detaljvyn på en ny flik
Du kan visa schemainformation som schemanamn, klass och andra attribut.
Det här arbetsflödet är endast avsett för effektanalys och utforskning. Scheman eller fältgrupper ändras inte. Information om hur du ändrar schemastrukturen finns i Skapa och redigera scheman i användargränssnittet.
Metadata och filtrering för fältgrupper field-group-metadata-and-filtering
Fliken Field groups innehåller metadata och filtreringsverktyg som hjälper dig att hitta och utvärdera fältgrupper innan du markerar dem.
Bläddra i tabeller och filter
Fältgruppens lagertabell innehåller ytterligare kolumner som visar metadata direkt i listvyn, till exempel Compatible classes, som anger vilka klasser en fältgrupp kan användas på. Fältgrupper kan bara läggas till i scheman som använder en av de listade kompatibla klasserna, baserat på beteendet hos de data de representerar (t.ex. postbaserade data eller tidsseriedata). Tabellen kan visa All när fältgruppen är kompatibel med alla klasser. Industry tags hjälper till att kategorisera fältgrupper för identifiering.
Om du vill förfina listan väljer du filterikonen (
På filterpanelen kan du:
- Compatible classes - Använd listrutan för att filtrera fältgrupper efter klasskompatibilitet
- Industry tags - Använd kryssrutor för att filtrera efter en eller flera branschkategorier
När du bläddrar markerar du en rad i tabellen för att uppdatera informationsfältet. Informationsfältet visar metadata som kompatibla klasser och branschmärkord så att du kan granska viktig information utan att öppna fältgruppen.
Metadata för fältgruppsinformation
När du öppnar en fältgrupp visar egenskapsfältet ytterligare metadata som är associerade med resursen.
Egenskapsfältet kan visa följande metadata:
- Compatible classes - Klasser som fältgruppen kan utöka
- Required attributes - Attribut som måste ha giltiga värden när det krävs av fältgruppen vid datainmatning. Kraven beror på datastrukturen och poster med saknade eller ogiltiga obligatoriska värden kan inte valideras
- Labels - Etiketter visas inte på fältgruppsnivå. Välj ett fält om du vill visa etikettinformation i Field properties-spåret
Den här informationen hjälper dig att förstå begränsningar och krav innan du använder eller ändrar fältgruppen.
Etiketter i strukturvyn
När en fältgrupp är öppen på arbetsytan kan du visa etikettinformation direkt i strukturen. Välj inställningsikonen (
Markera ett fält på arbetsytan om du vill visa etikettdetaljer i Field properties-rälen, inklusive etiketter som används i det fältet.
Etiketterna grupperas efter kategori (t.ex. identitets- och känsliga etiketter) och ger synlighet i styrnings- eller åtkomstrelaterade begränsningar som tillämpas på data.
De här indikatorerna är bara synliga och ändrar inte schemastrukturen. Mer information finns i Hantera dataanvändningsetiketter för ett schema.
Nästa steg
I det här dokumentet beskrivs hur du utforskar befintliga XDM-resurser i Experience Platform användargränssnitt. Mer information om de olika funktionerna på arbetsytan Schemas och Schema Editor finns i Schemas-arbetsytans översikt.