Förstå schemastrukturen schema-structure

Grundstrukturen för ett schema beskrivs nedan.

Datascheman data-schema

För <srcschema>är strukturen följande:

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

XML-dokumentet i ett dataschema måste innehålla <srcschema> rotelementet med name och namespace attribut för att fylla i schemanamnet och dess namnutrymme.

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

Låt oss använda följande XML-innehåll för att illustrera strukturen i ett dataschema:

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

Med motsvarande dataschema:

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

Beskrivning description

Startpunkten för schemat är dess huvudelement. Det är enkelt att identifiera eftersom det har samma namn som schemat och bör vara underordnat rotelementet. Beskrivningen av innehållet börjar med det här elementet.

I det här exemplet representeras huvudelementet av följande rad:

<element name="recipient">

The <attribute> och <element> -element som följer efter huvudelementet används för att definiera placeringen och namnen på dataobjekten i XML-strukturen.

I vårt exempelschema är följande:

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

Följande regler gäller:

Datatyper data-types

Datatypen anges via type i <attribute> och <element> -element.

En detaljerad lista finns i beskrivningen av <attribute> element och <element> element.

När attributet inte är ifyllt, string är standarddatatypen såvida inte elementet innehåller underordnade element. Om den gör det används den bara för att strukturera elementen hierarkiskt (<location> -element i vårt exempel).

Följande datatyper stöds i scheman:

Här är vårt exempelschema med de angivna typerna:

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

Mappa typer av Adobe Campaign-/DBMS-data mapping-the-types-of-adobe-campaign-dbms-data

Tabellen nedan visar mappningarna för de typer av data som genereras av Adobe Campaign för de olika databashanteringssystemen.

Egenskaper properties

The <elements> och <attributes> element i dataschemat kan berikas med olika egenskaper. Du kan fylla i en etikett för att beskriva det aktuella elementet.

Etiketter och beskrivningar labels-and-descriptions

Standardvärden default-values

Använd standard för att definiera ett uttryck som returnerar ett standardvärde när innehåll skapas.

Värdet måste vara ett uttryck som är kompatibelt med XPath-språket. Mer information finns i Referera med XPath.

Exempel:

Om du vill länka ett standardvärde till ett fält använder du <default> eller <sqldefault> fält.

<default> : låter dig fylla i fältet i förväg med ett standardvärde när entiteter skapas. Värdet kommer inte att vara ett standard-SQL-värde.

<sqldefault> : ger dig ett mervärde när du skapar ett fält. Värdet visas som ett SQL-resultat. Under en schemauppdatering påverkas bara de nya posterna av det här värdet.

Uppräkningar enumerations

Öppna uppräkning free-enumeration

The userEnum kan du definiera en öppen uppräkning för att lagra och visa de värden som anges i det här fältet.

Syntaxen är följande:

userEnum="name of enumeration"

Dessa värden visas i en nedrullningsbar lista från indataformuläret:

Ange uppräkning set-enumeration

The enum Med -egenskapen kan du definiera en fast uppräkning som används när listan med möjliga värden är känd i förväg.

The enum -attribut refererar till definitionen för en uppräkningsklass som är ifylld i schemat utanför huvudelementet.

Uppräkningar gör att användaren kan välja ett värde i en nedrullningsbar lista i stället för att ange värdet i ett vanligt inmatningsfält:

Exempel på en uppräkningsdeklaration i dataschemat:

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

En uppräkning deklareras utanför huvudelementet via <enumeration> -element.

Uppräkningsegenskaperna är följande:

Uppräkningsvärdena deklareras i <value> element med följande attribut:

dbenum-uppräkning dbenum-enumeration

*De dbenum kan du definiera en uppräkning vars egenskaper liknar de i enum -egenskap.

Men name -attributet lagrar inte värdet internt, utan lagrar en kod som gör att du kan utöka de berörda tabellerna utan att ändra deras schema.

Den här uppräkningen används till exempel för att ange kampanjens karaktär.

Exempel example

Här är vårt exempelschema med egenskaperna ifyllda:

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

Samlingar collections

En samling är en lista med element med samma namn och samma hierarkiska nivå.

The obunden -attribut med värdet "true" kan du fylla i ett samlingselement.

Exempel: definition av <group> samlingselement i schemat.

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

Med projektion av XML-innehållet:

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

Referera med XPath referencing-with-xpath

XPath-språket används i Adobe Campaign för att referera till ett element eller attribut som tillhör ett dataschema.

XPath är en syntax som gör att du kan hitta en nod i trädet i ett XML-dokument.

Elementen anges med sitt namn och attributen anges med namnet före tecknet"@".

Exempel:

Det går också att definiera komplexa uttryck, till exempel följande aritmetiska operationer:

Funktioner på hög nivå har lagts till i uttrycken för att berika detta språks potential.

Du kommer åt listan över tillgängliga funktioner via en uttrycksredigerare i Adobe Campaign klientkonsol:

Exempel:

Skapa en sträng via beräkningssträngen building-a-string-via-the-compute-string

A Beräkningssträng är ett XPath-uttryck som används för att konstruera en sträng som representerar en post i en tabell som är associerad med schemat. Beräkningssträng används främst i det grafiska gränssnittet för att visa etiketten för en markerad post.

The Beräkningssträng definieras via <compute-string> -elementet under dataschemats huvudelement. An expr -attributet innehåller ett XPath-uttryck för att beräkna visningen.

Exempel: beräkningssträng för mottagartabellen.

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

Resultat av den beräknade strängen för en mottagare: Doe John (john.doe@aol.com)

Läs mer

Klicka på följande länkar om du vill veta mer: