Förstå schemastrukturen schema-structure

Grundstrukturen för ett schema beskrivs nedan.

Datascheman data-schema

För en <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 rotelementet <srcschema> med attributen name och namespace för att schemanamnet och dess namnområde ska kunna fyllas i.

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

Elementen <attribute> och <element> som följer huvudelementet används för att definiera platser och namn för 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 attributet type i elementen <attribute> och <element>.

Det finns en detaljerad lista i beskrivningen av elementet <attribute>och elementet <element>.

När det här attributet inte är ifyllt är string standarddatatypen om 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

Elementen <elements> och <attributes> 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 egenskapen default 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 till XPath.

Exempel:

Om du vill länka ett standardvärde till ett fält kan du använda <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

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

Med egenskapen enum 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.

Attributet enum 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 elementet <enumeration>.

Uppräkningsegenskaperna är följande:

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

dbenum-uppräkning dbenum-enumeration

*Med egenskapen dbenum kan du definiera en uppräkning vars egenskaper liknar egenskaperna för egenskapen enum.

Attributet name lagrar dock 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å.

Med attributet unbound med värdet "true" kan du fylla i ett samlingselement.

Exempel: definition av samlingselementet <group> 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

En 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ängen används främst i det grafiska gränssnittet för att visa etiketten för en markerad post.

Beräkningssträngen definieras via elementet <compute-string> under huvudelementet i dataschemat. Ett expr-attribut 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: