Förstå schemastruktur 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 för ett dataschema måste innehålla rotelementet <srcschema> med attributen name och namespace för att schemanamnet och dess namnutrymme 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 för 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> .

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

När det här attributet inte är ifyllt är sträng standarddatatypen om inte elementet innehåller underordnade element. Om det gör det används det 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

I tabellen nedan visas 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 du skapar innehåll.

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 kan du använda <default> eller <sqldefault> fält.

<default> : Gör att du kan fylla i fältet i förväg med ett standardvärde när du skapar enheter. Värdet kommer inte att vara ett standardvärde för SQL.

<sqldefault> : gör att du kan ha ett mervärde när du skapar ett fält. Det här värdet visas som ett SQL-resultat. Under en schemauppdatering påverkas endast 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 över möjliga värden är känd i förväg.

Attributet enum refererar till definitionen av en uppräkningsklass som fylls i 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

Språket XPath 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:

Högnivåfunktioner har lagts till i uttrycken för att berika potentialen i detta språk.

Du kan komma åt listan över tillgängliga funktioner via valfri 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 uttr-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>

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