v7
Gilt nur für Campaign Classic v7

Grundlegendes zur Schemastruktur schema-structure

Die grundlegende Struktur eines Schemas wird nachfolgend beschrieben.

Datenschemata data-schema

Für <srcschema>, lautet die Struktur wie folgt:

<srcSchema>
    <enumeration>
        ...          //definition of enumerations
    </enumeration>

    <element>         //definition of the root <element>    (mandatory)

        <compute-string/>  //definition of a compute-string
        <dbindex>
            ...        //definition of indexes
        </dbindex>
        <key>
            ...        //definition of keys
        </key>
        <sysFilter>
            ...           //definition of filters
        </sysFilter>
        <attribute>
            ...             //definition of fields
        </attribute>

            <element>           //definition of sub-<element>
                  <attribute>           //(collection, links or XML)
                  ...                         //and additional fields
                  </attribute>
                ...
            </element>

    </element>

        <methods>                 //definition of SOAP methods
            <method>
                ...
            </method>
            ...
    </methods>

</srcSchema>

Das XML-Dokument eines Datenschemas muss die Wurzel <srcschema> mit den Attributen name und namespace zur Angabe des Schemanamens und des Namespace enthalten.

<srcSchema name="schema_name" namespace="namespace">
...
</srcSchema>

Verwenden wir den folgenden XML-Inhalt, um die Struktur eines Schemas zu illustrieren:

<recipient email="John.doe@aol.com" created="2009/03/12" gender="1">
  <location city="London"/>
</recipient>

Mit dem zugehörigen Datenschema:

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

Beschreibung description

Der Einstiegspunkt des Schemas ist sein Hauptelement. Es ist einfach zu identifizieren, da es denselben Namen wie das Schema hat und das Stammelement untergeordnet sein sollte. Die Beschreibung des Inhalts beginnt mit diesem Element.

In unserem Beispiel wird das Hauptelement durch die folgende Zeile dargestellt:

<element name="recipient">

Die <attribute> und <element> -Elemente, die dem Hauptelement folgen, werden verwendet, um die Speicherorte und Namen der Datenelemente in der XML-Struktur zu definieren.

In unserem Beispielschema sind dies:

<attribute name="email"/>
<attribute name="created"/>
<attribute name="gender"/>
<element name="location">
  <attribute name="city"/>
</element>

Es gelten die folgenden Regeln:

  • Jedes <element> und <attribute> müssen mit dem Namen über das Attribut name identifiziert werden.

    note important
    IMPORTANT
    Der Name des Elements sollte kurz sein, vorzugsweise auf Englisch, und nur Zeichen einschließen, die in XML-Benennungsregeln zulässig sind.
  • In der XML-Struktur dürfen nur <element>-Elemente <attribute>-Elemente und <element>-Elemente enthalten.

  • Ein <attribute>-Element muss einen eindeutigen Namen innerhalb eines <element> haben.

  • Die Verwendung von <elements> in mehrzeiligen Datenzeichenfolgen wird empfohlen.

Datentypen data-types

Der Datentyp wird über das Attribut type in den Elementen <attribute> und <element> eingegeben.

Eine detaillierte Liste finden Sie in der Beschreibung der <attribute> element und <element> element.

Wenn dieses Attribut nicht gefüllt wird, ist string der Standarddatentyp, es sei denn, das Element enthält untergeordnete Elemente. Wenn es gefüllt ist, wird es nur zur hierarchischen Strukturierung der Elemente verwendet (Element <location> in unserem Beispiel).

Die folgenden Datentypen werden in Schemata unterstützt:

  • string: Zeichenfolge. Beispiele: ein Vorname, eine Stadt usw.

    Die Größe kann über das Attribut length (optional, Standardwert "255") angegeben werden.

  • boolean: Boolesches Feld. Beispiel für mögliche Werte: wahr/falsch, 0/1, ja/nein usw.

  • byte, short, long: ganze Zahlen (1 Byte, 2 Byte, 4 Byte). Beispiele: Alter, Kontonummer, Anzahl der Punkte usw.

  • double: Gleitkommazahl doppelter Genauigkeit. Beispiele: Preis, Quote usw.

  • date, datetime: Datum und Datum + Uhrzeit. Beispiele: Geburtsdatum, Kaufdatum usw.

  • datetimenotz: Datum + Uhrzeit ohne Zeitzonendaten.

  • timespan: Dauer. Beispiel: Betriebszugehörigkeit.

  • memo: Langtextfelder (mehrere Zeilen). Beispiele: eine Beschreibung, ein Kommentar usw.

  • uuid: Felder "uniqueidentifier", um eine GUID zu unterstützen (nur in Microsoft SQL Server unterstützt).

    note note
    NOTE
    So enthalten Sie eine uuid -Feld in RDBMS außer Microsoft SQL Server, the newuuid() -Funktion hinzugefügt und mit dem Standardwert ausgefüllt werden.

Im Folgenden finden Sie unser Schema mit den eingegebenen Typen:

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <attribute name="email" type="string" length="80"/>
    <attribute name="created" type="datetime"/>
    <attribute name="gender" type="byte"/>
    <element name="location">
      <attribute name="city" type="string" length="50"/>
   </element>
  </element>
</srcSchema>

Mapping der Typen von Adobe Campaign/DBMS-Daten mapping-the-types-of-adobe-campaign-dbms-data

In der folgenden Tabelle sind die Zuordnungen für die Datentypen aufgeführt, die von Adobe Campaign für die verschiedenen Datenbankverwaltungssysteme generiert wurden.

Adobe Campaign
PosgreSQL
Oracle
String
VARCHAR(255)
VARCHAR2 (NVARCHAR2, falls Unicode vorhanden)
Boolesch
SMALLINT
NUMBER(3)
Byte
SMALLINT
NUMBER(3)
Short
SMALLINT
NUMBER(5)
Double
DOPPELPRÄZISE
FLUSS
Lang
INTEGER
NUMBER(10)
Int64
BIGINT
NUMBER(20)
Datum
DATUM
DATUM
Zeit
ZEIT
FLUSS
DatumUhrzeit
TIMESTAMPZ
DATUM
Datetimenotz
TIMESTAMPZ
DATUM
Zeitbereich
DOPPELPRÄZISE
FLUSS
Memo
TEXT
CLOB (NCLOB, wenn Unicode)
Blob
BLOB
BLOB

Eigenschaften properties

Die <elements> und <attributes> -Elemente des Datenschemas können mit verschiedenen Eigenschaften angereichert werden. Sie können ein Label ausfüllen, um das aktuelle Element zu beschreiben.

Labels und Beschreibungen labels-and-descriptions

  • Mit der Eigenschaft label können Sie eine kurze Beschreibung eingeben.

    note note
    NOTE
    Das Label ist mit der aktuellen Sprache der Instanz verknüpft.

    Beispiel:

    code language-sql
    <attribute name="email" type="string" length="80" label="Email"/>
    

    Der Titel wird im Eingabeformular der Adobe Campaign-Clientkonsole angezeigt:

  • Mit der Eigenschaft desc können Sie eine lange Beschreibung eingeben.

    Die Beschreibung wird im Formular in der Statusleiste des Hauptfensters der Adobe Campaign-Clientkonsole angezeigt.

    note note
    NOTE
    Die Beschreibung ist mit der aktuellen Sprache der Instanz verknüpft.

    Beispiel:

    code language-sql
    <attribute name="email" type="string" length="80" label="Email" desc="Email of recipient"/>
    

Standardwerte default-values

Verwenden Sie die default -Eigenschaft zum Definieren eines Ausdrucks, der bei der Inhaltserstellung einen Standardwert zurückgibt.

Der Wert muss ein mit der XPath-Sprache kompatibler Ausdruck sein. Weitere Informationen hierzu finden Sie unter Verweisen mit XPath.

Beispiel:

  • Aktuelles Datum: default="GetDate()"

  • Zähler: default="'FRM'+CounterValue('myCounter')"

    In diesem Beispiel wird der Standardwert mithilfe der Verkettung einer Zeichenfolge und des Aufrufs der Funktion CounterValue mit einem freien Zählernamen erstellt. Die zurückgegebene Zahl wird bei jedem Einfügen um 1 erhöht.

    note note
    NOTE
    Navigieren Sie in der Adobe Campaign-Clientkonsole zu Administration > Zähler Ordner des Explorers, in dem Zähler verwaltet werden sollen.

Um einen Standardwert mit einem Feld zu verknüpfen, können Sie die <default> oder <sqldefault> -Feld.

<default> : ermöglicht es Ihnen, das Feld beim Erstellen von Entitäten mit einem Standardwert vorauszufüllen. Der Wert wird kein SQL-Standardwert sein.

<sqldefault> : ermöglicht es Ihnen, beim Erstellen eines Felds einen zusätzlichen Wert zu erhalten. Dieser Wert wird als SQL-Ergebnis angezeigt. Während einer Aktualisierung des Schemas wirkt sich dieser Wert nur auf die neuen Einträge aus.

Auflistungen enumerations

Aufzählung öffnen free-enumeration

Die userEnum -Eigenschaft können Sie eine geöffnete Auflistung definieren, in der die in diesem Feld eingegebenen Werte gespeichert und angezeigt werden.

Die Syntax sieht folgendermaßen aus:

userEnum="name of enumeration"

Diese Werte werden in einer Dropdown-Liste im Formular angezeigt:

NOTE
Navigieren Sie in der Adobe Campaign-Clientkonsole zu Administration > Auflistungen Ordner des Explorers, in dem Auflistungen verwaltet werden sollen.

Auflistung festlegen set-enumeration

Mit der Eigenschaft enum können Sie eine feste Auflistung definieren, die verwendet wird, wenn die Liste der möglichen Werte im Voraus bekannt ist.

Das Attribut enum bezieht sich auf die Definition einer Auflistungsklasse, die im Schema außerhalb des Hauptelements gefüllt wird.

Auflistungen ermöglichen es dem Benutzer, einen Wert aus einer Dropdown-Liste auszuwählen, anstatt ihn in ein reguläres Eingabefeld einzugeben:

Beispiel für eine Deklaration einer Auflistung im Datenschema:

<enumeration name="gender" basetype="byte" default="0">
  <value name="unknown" label="Not specified" value="0"/>
  <value name="male" label="male" value="1"/>
  <value name="female" label="female" value="2"/>
</enumeration>

Eine Auflistung wird über das Element <enumeration> außerhalb des Hauptelements deklariert.

Die Eigenschaften der Auflistung lauten wie folgt:

  • baseType: Datentyp, der den Werten zugeordnet ist
  • label: Beschreibung der Auflistung
  • name: Name der Auflistung
  • default: Standardwert der Auflistung

Die Werte für die Auflistung werden im Element <value> mit den folgenden Attributen deklariert:

  • name: Name des intern gespeicherten Werts
  • label: in der grafischen Benutzeroberfläche angezeigter Titel

dbenum-Auflistung dbenum-enumeration

*Die dbenum -Eigenschaft können Sie eine Auflistung definieren, deren Eigenschaften denen der enum -Eigenschaft.

Das Attribut name speichert den Wert jedoch nicht intern, sondern speichert einen Code, mit dem Sie die betreffenden Tabellen erweitern können, ohne ihr Schema zu ändern.

Diese Auflistung dient beispielsweise zur Angabe der Art von Kampagnen.

Beispiel example

Beispiel des um diese Eigenschaften ergänzten Schemas:

<srcSchema name="recipient" namespace="cus">
  <enumeration name="gender" basetype="byte">
    <value name="unknown" label="Not specified" value="0"/>
    <value name="male" label="male" value="1"/>
    <value name="female" label="female" value="2"/>
  </enumeration>

  <element name="recipient">
    <attribute name="email" type="string" length="80" label="Email" desc="Email of recipient"/>
    <attribute name="created" type="datetime" label="Date of creation" default="GetDate()"/>
    <attribute name="gender" type="byte" label="gender" enum="gender"/>
    <element name="location" label="Location">
      <attribute name="city" type="string" length="50" label="City" userEnum="city"/>
   </element>
  </element>
</srcSchema>

Sammlungen collections

Eine Sammlung ist eine Liste von Elementen mit gleichem Namen und auf gleicher Hierarchieebene.

Mithilfe des Attributs unbound mit dem Wert "true" können Sie ein Sammlungselement füllen.

Beispiel: Definition des Sammlungselements <group> im Schema.

<element name="group" unbound="true" label="List of groups">
  <attribute name="label" type="string" label="Label"/>
</element>

Mit Projektion des XML-Inhalts:

<group label="Group1"/>
<group label="Group2"/>

Verweisen mit XPath referencing-with-xpath

Die XPath-Sprache wird in Adobe Campaign verwendet, um ein zu einem Datenschema gehörendes Element oder Attribut zu adressieren.

XPath ist eine Syntax, die es ermöglicht, einen Knoten in der Baumstruktur eines XML-Dokuments zu lokalisieren.

Elemente werden mit ihren Namen bezeichnet, während den Namen von Attributen ein "@"-Zeichen vorangestellt wird.

Beispiel:

  • @email: wählt die E-Mail-Adresse aus,
  • location/@city: wählt das Attribut "city" unter dem Element <location> aus,
  • …/@email: wählt die E-Mail-Adresse aus dem übergeordneten Element des aktuellen Elements aus
  • group[1]/@label: wählt das Attribut "label" aus, das dem ersten <group>-Sammlungselement untergeordnet ist,
  • group[@label='test1']: wählt das Attribut "label" aus, das dem Element <group> untergeordnet ist und den Wert "test1" enthält.
NOTE
Eine zusätzliche Einschränkung wird hinzugefügt, wenn der Pfad ein Unterelement kreuzt. In diesem Fall muss der folgende Ausdruck zwischen Klammern stehen:
  • location/@city ist nicht gültig; verwenden Sie [location/@city]
  • [@email] und @email entsprechen einander

Es ist auch möglich, komplexe Ausdrücke wie die folgenden arithmetischen Operationen zu definieren:

  • @gender+1: fügt 1 zum Inhalt des Attributs gender hinzu,
  • @email + '('+@created+')': erstellt einen String, indem der Wert der E-Mail-Adresse, die zum Erstellungsdatum hinzugefügt wurde, in Klammern gesetzt wird (für den String-Typ muss die Konstante in Anführungszeichen gesetzt werden).

Die Ausdrücke wurden um Funktionen auf hoher Ebene erweitert, um das Potenzial dieser Sprache zu erweitern.

In der Adobe Campaign-Client-Konsole können Sie über einen beliebigen Ausdruckseditor auf die Liste der verfügbaren Funktionen zugreifen:

Beispiel:

  • GetDate(): gibt das aktuelle Datum zurück,
  • Year(@created): gibt das Jahr des im Attribut "created"enthaltenen Datums zurück.
  • GetEmailDomain(@email): gibt die Domain der E-Mail-Adresse zurück.

Erstellen einer Zeichenfolge über den Compute string building-a-string-via-the-compute-string

Ein Compute string ist ein XPath-Ausdruck, mit dem eine Zeichenfolge erstellt wird, die einen Eintrag in einer mit dem Schema verknüpften Tabelle darstellt. Compute string wird hauptsächlich in der grafischen Oberfläche verwendet, um die Beschriftung eines ausgewählten Eintrags anzuzeigen.

Der Compute string wird über das Element <compute-string> unter dem Hauptelement des Datenschemas definiert. Ein expr-Attribut enthält einen XPath-Ausdruck zur Berechnung der Anzeige.

Beispiel: Compute string der Empfänger-Tabelle.

<srcSchema name="recipient" namespace="nms">
  <element name="recipient">
    <compute-string expr="@lastName + ' ' + @firstName +' (' + @email + ')' "/>
    ...
  </element>
</srcSchema>

Ergebnis der berechneten Zeichenfolge für einen Empfänger: Doe John (john.doe@aol.com)

NOTE
Wenn das Schema keinen Compute string enthält, wird standardmäßig ein Compute string mit den Werten des Primärschlüssels des Schemas gefüllt.

Weitere Informationen

Weitere Informationen finden Sie unter den folgenden Links:

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1