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 a 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 de 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 subelementen <element> en <attribute> .

Het eerste subelement <element> valt samen 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>

Met de tags <element> worden de namen van entiteitelementen gedefinieerd. <attribute> -tags van het schema definiëren de namen van de kenmerken in de <element> -tags waaraan ze 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, wordt focus namespace 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 namespace moet niet worden gebruikt om een nieuw schema, in om het even welke hogere/lagere casecombinatie te identificeren:

De identificatiesleutel van een schema is een koord dat wordt gebouwd gebruikend namespace en de naam die door een dubbelpunt wordt gescheiden; bijvoorbeeld: nms:recipient.

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

Om een gebied of ander element aan één van de schema's van kerngegevens in Campagne, zoals de ontvankelijke lijst (nms :recipient) toe te voegen, moet u dat schema uitbreiden.

Voor meer op dit, verwijs naar ​ 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.

Voor meer op dit, verwijs naar ​ creeer een nieuw schema ​.

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 de sectie attributen te gebruiken die aan waar worden geplaatst.

Bovendien in de context van een ​ plaatsing van de Onderneming (FFDA) ​, gebruik @autouuid en plaats het aan waar.

De primaire sleutel kan ook worden bepaald gebruikend het interne attribuut.

Voorbeeld:

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

In dit voorbeeld, in plaats van het laten @autopk of @autouuid attributen een standaard primaire sleutel tot stand brengen genoemd "id"wij specificeren onze eigen "huishoudenId"primaire sleutel.

Leer meer over sleutels in ​ deze sectie ​.

Attributen (velden) attributes--fields-

Met kenmerken kunt u de velden definiëren waaruit het gegevensobject bestaat. U kunt de Insert knoop in de toolbar van de schemageditie gebruiken om lege attributenmalplaatjes in uw XML te laten vallen waar uw curseur is. Lees meer in deze sectie.

De volledige lijst van attributen is beschikbaar in de <attribute> elementensectie in ​ Campaign Classic v7 documentatie ​. Hier volgen een aantal veelgebruikte kenmerken: @advanced, @dataPolicy, @default, @desc, @enum, @expr, @label, @length, 16}@name ,@notNull ,@required ,@ref ,@xml ,@type .

Voor meer informatie over elk attribuut, verwijs naar de beschrijving van Attributen in ​ de documentatie van Campaign Classic v7 ​.

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 verborgen is met het attribuut @advanced :

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

Voorbeeld van een gebied van XML dat ook op een SQL gebied wordt opgeslagen en @dataPolicy attributen heeft.

<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.

De verbindingen worden verklaard in het schema dat de buitenlandse sleutel van de lijst bevat waaraan het wordt verbonden.

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.