Werken met schema's gs-ac-schemas

De fysieke en logische structuur van de data die in de applicatie worden overgedragen, wordt in XML beschreven. Het volgt een grammatica specifiek voor Adobe Campaign, genoemd een schema.

Een schema is een XML-document dat is gekoppeld aan een databasetabel. De code definieert de gegevensstructuur en beschrijft de SQL-definitie van de tabel:

Hierin wordt ook de XML-structuur beschreven die wordt gebruikt om gegevens op te slaan:

Met schema's kunt u een entiteit in de database definiëren. Er is een schema voor elke entiteit.

Adobe Campaign past gegevensschema's toe op:

Voor een beter inzicht in ingebouwde lijsten van de Campagne en hun interactie, verwijs naar deze sectie.

Syntaxis van schema's syntax-of-schemas

Het hoofdelement van het schema is <srcschema>. Het bevat de <element> en <attribute> subelementen.

De eerste <element> het subelement samenvalt met de hoofdmap van de entiteit.

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <attribute name="lastName"/>
    <attribute name="email"/>
    <element name="location">
      <attribute name="city"/>
   </element>
  </element>
</srcSchema>

De <element> -tags definiëren de namen van entiteitselementen. <attribute> de labels van het schema definiëren de namen van de kenmerken in het <element> tags waaraan zij zijn gekoppeld.

Identificatie van een schema identification-of-a-schema

Een gegevensschema wordt geïdentificeerd door zijn naam en zijn namespace.

Met een naamruimte kunt u een set schema's groeperen op interessegebied. Bijvoorbeeld de cus namespace wordt gebruikt voor klant-specifieke configuratie (klanten).

Gereserveerde naamruimten reserved-namespaces

Bepaalde naamruimten zijn gereserveerd voor beschrijvingen van de systeementiteiten die vereist zijn voor de werking van de Adobe Campaign-toepassing. De volgende naamruimte mag niet worden gebruikt om een nieuw schema, in om het even welke hogere/lagere combinatie te identificeren:

De identificatiesleutel van een schema is een tekenreeks die is samengesteld met behulp van de naamruimte en de naam gescheiden door een dubbele punt, bijvoorbeeld: nms:ontvanger.

Campagne-schema's maken of uitbreiden create-or-extend-schemas

Als u een veld of ander element wilt toevoegen aan een van de kerngegevensschema's in Campagne, zoals de ontvangende tabel (nms:ontvanger), moet u dat schema uitbreiden.

Raadpleeg voor meer informatie hierover Een schema uitbreiden.

Als u een geheel nieuw type gegevens wilt toevoegen dat niet bestaat in Adobe Campaign (bijvoorbeeld een contracttabel), kunt u rechtstreeks een aangepast schema maken.

Raadpleeg voor meer informatie hierover Een nieuw schema maken.

Nadat u een schema hebt gemaakt of uitgebreid om in te werken, kunt u het beste de XML-inhoudselementen definiëren in dezelfde volgorde als hieronder.

Opsommingen enumerations

Opsommingen worden eerst gedefinieerd, vóór het hoofdelement van het schema. Hiermee kunt u waarden in een lijst weergeven om de keuzes te beperken die de gebruiker voor een bepaald veld heeft.

Voorbeeld:

<enumeration basetype="byte" name="exTransactionTypeEnum" default="store">
<value label="Website" name="web" value="0"/>
<value label="Call Center" name="phone" value="1"/>
<value label="In Store" name="store" value="2"/>
</enumeration>

Wanneer u velden definieert, kunt u deze opsomming als volgt gebruiken:

<attribute desc="Type of Transaction" label="Transaction Type" name="transactionType"
type="string" enum="exTransactionTypeEnum"/>

Toetsen keys

Elke lijst moet minstens één sleutel hebben, en vaak wordt het automatisch gevestigd in het belangrijkste element van het schema door te gebruiken automatische kenmerk ingesteld op true.

Bovendien in het kader van een Implementatie in het kader van Enterprise (FFDA), gebruikt u de @autouuid en stel deze in op true.

De primaire sleutel kan ook worden gedefinieerd met de internal kenmerk.

Voorbeeld:

<key name="householdId" internal="true">
  <keyfield xpath="@householdId"/>
</key>

In dit voorbeeld wordt in plaats van het @automatische of de @autouuid het attribuut leidt tot een standaard primaire sleutel genoemd "id"wij specificeren onze eigen "huishoudenId"primaire sleutel.

Meer informatie over toetsen in deze sectie.

Attributen (velden) attributes--fields-

Met kenmerken kunt u de velden definiëren waaruit het gegevensobject bestaat. U kunt de Insert in de werkbalk van de schemaeditie om lege kenmerksjablonen naar uw XML te verplaatsen waar de cursor zich bevindt. Lees meer in deze sectie.

De volledige lijst met kenmerken is beschikbaar in de <attribute> elementsectie in Campaign Classic v7-documentatie. Hier volgen enkele van de meer gebruikte kenmerken: @advanced, @dataPolicy, @default, @desc, @enum, @expr, @label, @length, @name, @notNull, @required, @ref, @xml, @type.

Raadpleeg voor meer informatie over elk kenmerk de beschrijving van het kenmerk in Campaign Classic v7-documentatie.

Voorbeelden examples

Voorbeeld van het definiëren van een standaardwaarde:

<attribute name="transactionDate" label="Transaction Date" type="datetime" default="GetDate()"/>

Voorbeeld van het gebruik van een gemeenschappelijk kenmerk als een sjabloon voor een veld dat ook als verplicht is gemarkeerd:

<attribute name="mobile" label="Mobile" template="nms:common:phone" required="true" />

Voorbeeld van een berekend veld dat is verborgen met het gereedschap @advanced kenmerk:

<attribute name="domain" label="Email domain" desc="Domain of recipient email address" expr="GetEmailDomain([@email])" advanced="true" />

Voorbeeld van een XML-veld dat ook is opgeslagen in een SQL-veld en dat een @dataPolicy kenmerk.

<attribute name="secondaryEmail" label="Secondary email address" length="100" xml="true" sql="true" dataPolicy="email" />

Koppelingen links

De verbindingen zijn enkele laatste elementen in het belangrijkste element van uw schema. Ze definiëren hoe alle verschillende schema's in uw instantie op elkaar betrekking hebben.

Koppelingen worden gedeclareerd in het schema dat de buitenlandse sleutel van de tabel waaraan het is gekoppeld.

Er zijn drie soorten kardinaliteit: 1-1, 1-N, en N-N. Het is het type 1-N dat door gebrek wordt gebruikt.

Voorbeelden examples-1

Een voorbeeld van een verbinding 1-N tussen de ontvankelijke lijst (out-of-the-box schema) en een lijst van douanetransacties:

<element label="Recipient" name="lnkRecipient" revLink="lnkTransactions" target="nms:recipient" type="link"/>

Een voorbeeld van een 1-1 verbinding tussen een douaneschema "Auto"(in "cus"namespace) en de ontvankelijke lijst:

<element label="Car" name="lnkCar" revCardinality="single" revLink="recipient" target="cus:car" type="link"/>

Voorbeeld van een externe verbinding tussen de ontvankelijke lijst en een lijst van adressen die op het e-mailadres en niet een primaire sleutel wordt gebaseerd:

<element name="emailInfo" label="Email Info" revLink="recipient" target="nms:address" type="link" externalJoin="true">
  <join xpath-dst="@address" xpath-src="@email"/>
</element>

Hier komt 'xpath-dst' overeen met de primaire sleutel in het doelschema en 'xpath-src' komt overeen met de externe sleutel in het bronschema.

Audit trail audit-trail

Eén handig element dat u onder aan het schema wilt opnemen, is een trackingelement (audittrail).

In het onderstaande voorbeeld kunt u velden opnemen die betrekking hebben op de aanmaakdatum, de gebruiker die de gegevens heeft gemaakt, de datum en de auteur van de laatste wijziging voor alle gegevens in de tabel:

<element aggregate="xtk:common:auditTrail" name="auditTrail"/>

De databasestructuur bijwerken updating-the-database-structure

Nadat de wijzigingen zijn voltooid en opgeslagen, moeten alle wijzigingen die van invloed kunnen zijn op de SQL-structuur worden toegepast op de database. Om dit te doen, gebruik de medewerker van de gegevensbestandupdate.

Raadpleeg deze sectie voor meer informatie.