Arbeiten mit Schemata gs-ac-schemas

Die physische und logische Struktur der im Programm übertragenen Daten wird in XML beschrieben. Sie folgt einer Adobe Campaign-spezifischen Grammatik namens Schema.

Ein Schema ist ein mit einer Datenbanktabelle verknüpftes XML-Dokument. Es definiert die Datenstruktur und beschreibt die SQL-Definition der Tabelle:

Außerdem wird die XML-Struktur zum Speichern von Daten beschrieben:

Mit Schemata können Sie eine Entität in der Datenbank definieren. Es gibt ein Schema für jede Entität.

Adobe Campaign verwendet Datenschemata zum:

Nähere Erläuterungen zu den in Campaign integrierten Tabellen und ihrer Interaktion finden Sie in diesem Abschnitt.

Syntax von Schemata syntax-of-schemas

Das Stammelement des Schemas ist <srcschema>. Es enthält die Unterelemente <element> und <attribute>.

Das erste <element>-Unterelement fällt mit dem Stammelement der Entität zusammen.

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

Die <element>-Tags definieren die Namen von Entitätselementen. <attribute>-Tags des Schemas definieren die Namen der Attribute in den <element>-Tags, mit denen sie verknüpft wurden.

Identifizierung eines Schemas identification-of-a-schema

Ein Schema wird anhand seines Namens und seines Namespace identifiziert.

Mit einem Namespace können Sie eine Reihe von Schemata nach Interessensgebieten gruppieren. Beispielsweise wird der Namespace cus für die kundenspezifische Konfiguration (customers) verwendet.

Reservierte Namespaces reserved-namespaces

Bestimmte Namespaces sind für Beschreibungen der Systementitäten reserviert, die für den Betrieb von Adobe Campaign erforderlich sind. Der folgende Namespace darf keinesfalls zur Identifizierung eines neuen Schemas verwendet werden, unabhängig von der Kombination von Groß-/Kleinbuchstaben:

Der Identifizierungsschlüssel eines Stylesheets ist eine Zeichenfolge, die den Namespace und den Namen enthält, getrennt durch einen Doppelpunkt (z. B. nms:recipient).

Campaign-Schemata erstellen und erweitern create-or-extend-schemas

Um einem der Standard-Datenschemata in Campaign ein Feld oder ein anderes Element hinzuzufügen, z. B. die Empfängertabelle (nms:recipient), müssen Sie dieses Schema erweitern.

Weiterführende Informationen hierzu finden Sie unter Erweitern eines Schemas.

Um einen völlig neuen Datentyp hinzuzufügen, der in Adobe Campaign nicht vorhanden ist (z. B. eine Tabelle zu Verträgen), können Sie direkt ein benutzerdefiniertes Schema erstellen.

Weiterführende Informationen hierzu finden Sie unter Erstellen eines neuen Schemas.

Im Anschluss an die Erstellung oder Erweiterung eines Schemas für Ihre Arbeit sollten Sie dessen XML-Inhaltselemente in der im Folgenden aufgeführten Reihenfolge definieren.

Auflistungen enumerations

Auflistungen werden als Erstes definiert, noch vor dem Hauptelement des Schemas. Über sie können Sie Werte in einer Liste anzeigen, um die Auswahl einzuschränken, die der Benutzer für ein bestimmtes Feld hat.

Beispiel:

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

Beim Definieren von Feldern können Sie diese Auflistung wie folgt verwenden:

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

Schlüssel keys

Jede Tabelle muss über mindestens einen Schlüssel verfügen. Dessen Erstellung erfolgt häufig automatisch im Hauptelement des Schemas. Hierzu muss das Attribut autopk auf true gesetzt sein.

Verwenden Sie im Kontext einer Enterprise (FFDA)-Bereitstellungaußerdem die @autouuid und setzen Sie sie auf true.

Der Primärschlüssel kann auch mit dem Attribut internal definiert werden.

Beispiel:

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

In diesem Beispiel erstellen wir nicht anhand der Attribute @autopk oder @autouuid einen standardmäßigen Primärschlüssel namens „id“, sondern einen eigenen Primärschlüssel mit dem Namen „householdId“.

Weiterführende Informationen zu Schlüsseln finden Sie in diesem Abschnitt.

Attribute (Felder) attributes--fields-

Mit Attributen können Sie die Felder definieren, aus denen Ihr Datenobjekt besteht. Klicken Sie in der Symbolleiste zur Schemabearbeitung auf Einfügen, um leere Attributvorlagen an der Stelle in Ihrer XML abzulegen, an der sich Ihr Cursor befindet. Weiterführende Informationen finden Sie in diesem Abschnitt.

Eine vollständige Liste der Attribute finden Sie im Abschnitt <attribute>-Element in der Dokumentation zu Campaign Classic v7. Im Folgenden finden Sie einige der gebräuchlichsten Attribute: @advanced, @dataPolicy, @default, @desc, @enum, @expr, @label, @length, @name, @notNull, @required, @ref, @xml, @type.

Weitere Informationen zu den einzelnen Attributen finden Sie in der Attributbeschreibung in der Dokumentation zu Campaign Classic v7.

Beispiele examples

Beispiel für die Definition eines Standardwerts:

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

Beispiel für die Verwendung eines allgemeinen Attributs als Vorlage für ein Feld, das ebenfalls als obligatorisch gekennzeichnet ist:

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

Beispiel eines berechneten Felds, das mit dem Attribut @advanced ausgeblendet wird:

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

Beispiel für ein XML-Feld, das ebenfalls in einem SQL-Feld gespeichert ist und ein @dataPolicy-Attribut aufweist.

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

Relationen links

Relationen gehören zu den letzten Elementen im Hauptelement Ihres Schemas. Sie definieren, wie die verschiedenen Schemata in Ihrer Instanz miteinander in Beziehung stehen.

Relationen werden in dem Schema deklariert, das den Fremdschlüssel der Tabelle enthält, mit der sie verknüpft sind.

Es gibt drei Arten von Kardinalität: 1-1, 1-N und N-N. Standardmäßig wird der Typ 1-N verwendet.

Beispiele examples-1

Beispiel für eine 1-N-Relation zwischen der Empfängertabelle (vordefiniertes Schema) und einer Tabelle mit benutzerdefinierten Transaktionen:

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

Beispiel für eine 1-1-Relation zwischen einem benutzerspezifischen Schema "Car" (im Namespace "cus") und der Empfängertabelle:

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

Beispiel für eine externe Relation zwischen der Empfängertabelle und einer Tabelle mit Adressen, die auf der E-Mail-Adresse anstatt auf dem Primärschlüssel basiert:

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

Hier entspricht "xpath-dst" dem Primärschlüssel im Zielgruppenschema und "xpath-src" dem Fremdschlüssel im Quellschema.

Audit-Protokoll audit-trail

Es kann sich als nützlich erweisen, am Ende Ihres Schemas ein Tracking-Element hinzuzufügen (für das Audit-Protokoll).

Gehen Sie wie im nachfolgenden Beispiel vor, um Felder mit Bezug auf das Erstellungsdatum, den Benutzer, der die Daten erstellt hat, das Datum und den Autor der letzten Änderung für alle Daten in Ihrer Tabelle einzubeziehen:

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

Datenbankstruktur aktualisieren updating-the-database-structure

Sobald Ihre Änderungen abgeschlossen und gespeichert sind, müssen alle Änderungen, die sich auf die SQL-Struktur auswirken können, auf die Datenbank angewendet werden. Verwenden Sie dazu den Assistenten für das Datenbank-Update.

Weiterführende Informationen hierzu finden Sie in diesem Abschnitt.