Schema-structuur begrijpen schema-structure

De basisstructuur van een schema wordt hieronder beschreven.

Gegevensschema’s data-schema

Voor een <srcschema> is de structuur als volgt:

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

Het document van XML van een gegevensschema moet het <srcschema> wortelelement met de naam en namespace attributen bevatten om de schemanaam en zijn namespace te bevolken.

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

Laten we de volgende XML-inhoud gebruiken om de structuur van een gegevensschema te illustreren:

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

Met het bijbehorende gegevensschema:

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

Beschrijving description

Het ingangspunt van het schema is zijn belangrijkste element. Het is gemakkelijk te identificeren omdat het de zelfde naam zoals het schema heeft, en het zou het kind van het wortelelement moeten zijn. De beschrijving van de inhoud begint met dit element.

In ons voorbeeld wordt het hoofdelement vertegenwoordigd door de volgende regel:

<element name="recipient">

De elementen <attribute> en <element> die volgen op het hoofdelement worden gebruikt om de locaties en namen van de gegevensitems in de XML-structuur te definiëren.

In ons voorbeeldschema zijn de volgende:

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

De volgende regels zijn van toepassing:

Datatypen data-types

Het gegevenstype is ingegaan via het type attribuut in <attribute> en <element> elementen.

Een gedetailleerde lijst is beschikbaar in de beschrijving van het <attribute> elementen het <element> element.

Wanneer dit attribuut niet bevolkt is, koord is het standaardgegevenstype tenzij het element kindelementen bevat. Als het, wordt het gebruikt slechts om de elementen hiërarchisch te structureren (<location> element in ons voorbeeld).

De volgende gegevenstypen worden ondersteund in schema's:

Hier is ons voorbeeldschema met de ingevoerde types:

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

Toewijzing van de typen Adobe Campaign/DBMS-gegevens mapping-the-types-of-adobe-campaign-dbms-data

In de onderstaande tabel staan de toewijzingen voor de typen gegevens die door Adobe Campaign worden gegenereerd voor de verschillende databasebeheersystemen.

Properties properties

De elementen <elements> en <attributes> van het gegevensschema kunnen met diverse eigenschappen worden verrijkt. U kunt een label vullen om het huidige element te beschrijven.

Labels en beschrijvingen labels-and-descriptions

Standaardwaarden default-values

Gebruik het gebrek bezit om een uitdrukking te bepalen die een standaardwaarde op inhoudsverwezenlijking terugkeert.

De waarde moet een expressie zijn die compatibel is met XPath-taal. Voor meer op dit, verwijs naar Verwijzend met XPath.

Voorbeeld:

Als u een standaardwaarde aan een veld wilt koppelen, kunt u de opdracht <default> of <sqldefault> veld.

<default> : hiermee kunt u het veld vooraf vullen met een standaardwaarde wanneer u entiteiten maakt. De waarde wordt geen standaard SQL-waarde.

<sqldefault> : hiermee kunt u een toegevoegde waarde krijgen wanneer u een veld maakt. Deze waarde wordt weergegeven als een SQL-resultaat. Tijdens een schema-update worden alleen de nieuwe records beïnvloed door deze waarde.

Opsommingen enumerations

Opsomming openen free-enumeration

Het userEnum bezit laat u een open opsomming bepalen om de waarden op te slaan en te tonen ingegaan via dit gebied.

De syntaxis is als volgt:

userEnum="name of enumeration"

Deze waarden worden weergegeven in een vervolgkeuzelijst van het invoerformulier:

Opsomming instellen set-enumeration

Het enum bezit laat u een vaste opsomming bepalen die wordt gebruikt wanneer de lijst van mogelijke waarden vooraf gekend is.

Het enum attribuut verwijst naar de definitie van een opsommingsklasse die in het schema buiten het belangrijkste element wordt bevolkt.

Met opsommingen kan de gebruiker een waarde in een vervolgkeuzelijst selecteren in plaats van de waarde in te voeren in een gewoon invoerveld:

Voorbeeld van een opsommingsdeclaratie in het gegevensschema:

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

Een opsomming wordt buiten het hoofdelement gedeclareerd via het element <enumeration> .

De opsommingseigenschappen zijn als volgt:

De opsommingswaarden worden gedeclareerd in het element <value> met de volgende kenmerken:

dbenum-opsomming dbenum-enumeration

*Het dbenum bezit laat u een opsomming bepalen de waarvan eigenschappen aan die van het gelijkaardig zijn enum bezit.

Nochtans, slaat het naam attribuut intern niet de waarde op, het slaat een code op die u de betrokken lijsten zonder hun schema uit te breiden laat uitbreiden.

Deze opsomming wordt bijvoorbeeld gebruikt om de aard van campagnes op te geven.

Voorbeeld example

Hier volgt ons voorbeeldschema met de eigenschappen die zijn ingevuld:

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

Verzamelingen collections

Een verzameling is een lijst met elementen met dezelfde naam en hetzelfde hiërarchische niveau.

Het niet verbindende attribuut met de waarde "waar"laat u een inzamelingselement bevolken.

Voorbeeld: definitie van het <group> inzamelingselement in het schema.

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

Met projectie van de XML-inhoud:

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

Verwijzen naar XPath referencing-with-xpath

De XPath-taal wordt in Adobe Campaign gebruikt om naar een element of kenmerk te verwijzen dat of dat tot een gegevensschema behoort.

XPath is een syntaxis waarmee u een knooppunt in de boomstructuur van een XML-document kunt zoeken.

Elementen worden aangeduid met hun naam en kenmerken worden aangeduid met de naam voorafgegaan door het teken "@".

Voorbeeld:

Het is ook mogelijk complexe expressies te definiëren, zoals de volgende rekenkundige bewerkingen:

Er zijn functies op hoog niveau toegevoegd aan de expressies om het potentieel van deze taal te verrijken.

U hebt toegang tot de lijst met beschikbare functies via een expressie-editor in de Adobe Campaign-clientconsole:

Voorbeeld:

Een tekenreeks samenstellen via de compute string building-a-string-via-the-compute-string

A verwerkt koord is een uitdrukking van XPath die wordt gebruikt om een koord te construeren dat een verslag in een lijst vertegenwoordigt verbonden aan het schema. verwerkt koord wordt hoofdzakelijk gebruikt in de grafische interface om het etiket van een geselecteerd verslag te tonen.

Het berekent koord wordt bepaald via het <compute-string> element onder het belangrijkste element van het gegevensschema. Een expr attribuut bevat een uitdrukking van XPath om de vertoning te berekenen.

Voorbeeld: compute koord van de ontvankelijke lijst.

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

Resultaat van het gegevens verwerkte koord voor een ontvanger: Doe John (john.doe@aol.com)

Meer informatie

Klik op de volgende koppelingen voor meer informatie: