XML Schnittstelle : 2 XML Aufbau

2.1 XML Grundstruktur

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<import>
    <item>
        ...
    </item>
    <item>
        ...
    </item>
</import>

2.2 Das Rootelement <import>

Das Rootelement <import> enthält 1 oder mehrere Subelemente <item>. Das Rootelement <import> hat folgende Attribute:

Beispiel:

<import partner="Partner AG" partnerid="99" passwort="xyz012" importid="1">

2.3 Das <item> Element und seine Attribute

Das Element <item> enthält die eigentlichen Daten Elemente eines Datensatzes. Die darin enthaltenen Elemente sind in den Tabellen unter (Pt. 2.3 – 3.4) erklärt. Das <item> Element selbst kann immer folgende Attribute enthalten:

Anmerkung:
Werden die obigen Werte nicht gesetzt, gelten die Defaultwerte.

Beispiel:

<item status="1" suchbar="1" datumvon="2010-09-03 12:30:00" datumbis="2011-02-13 18:45:00" position="1" mutationsdatum="2011-12-13 00:0:00">

Anmerkungen zu einigen Subelementen von <item>:

• <id> enthält einen numerischen Wert, eindeutige ID des Partner Datensatzes die auch über mehre Feeds hinaus unique sein muss, wird bei uns ebenfalls für die Identifizierung des Datensatzes (in Kombination mit der partnerid) verwendet.
• Von Element <rubrik> dürfen mehrere vorhanden sein pro <item>. Rubriken werden den Datensätzen "angehängt" sodass, man auch Listen von Datensätzen ausgeben kann, die einer gewissen Rubrik angegliedert sind.
• Werden in den Elementen Sonderzeichen wie & und/oder ganze HTML Tags mitgeliefert, MUSS das in einem CDATA Abschnitt geschehen, also z.B. so:

<textmobile><![CDATA[<h1>Lorem ipsum</h1> dolor sit amet, <br />Nullam uscipit iaculis. Maecenas tempor molestie eros id interdum. Donec sed velit sem, vel luctus urna.]]></textmobile>

2.4 XML Beispiel für Standardseite

Beispiel:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<import partner="Partner AG" partnerid="99" passwort="xyz012" importid="1">
    <item status="1" suchbar="1" mutationsdatum="2011-12-13 00:0:00">
        <id>01</id>
        <titel>Titel der Seite</titel>
        <textmobile>Text der Seite </textmobile>
        <textlead>Leadtext der Seite</textlead>
        <url_bild vorschau="1">http://path.to/previewimage.png</url_bild>
        <url_bild legende="Kirche beim Dorfzentrum">http://path.to/image.jpg</url_bild>
        <keyword>essen</keyword>
        <keyword>gastro</keyword>
        <keyword>vegi</keyword>
    </item>
</import>

2.5 Elemente für alle Seitentypen

Beispiel:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<import partner="Partner AG" partnerid="99" passwort="xyz012" importid="1">
    <item status="1" suchbar="1" mutationsdatum="2011-12-13 00:0:00">
        <id>01</id>
        <titel>Das Restaurant</titel>
        <bcode>dasrestaurant</bcode> 
        <icon>People</icon> 
        <url_dokument legende="Preisliste PDF">http://www.server.com/thefile.pdf</url_dokument> 
    </item>
</import>

2.6 Attribute

Attribute sind eine Art von anthrazit vorgegebenen Tags/Keywords, die mit einem beliebigen Datensatz (Standardseite, News, Veranstaltung, Standort...) verlinkt werden können.

Eine Liste aller möglichen Attribute ist online auf https://xml.mopage.ch/attribute einsehbar. Fehlt Ihrer Meinung nach ein Attribut, dann nehmen Sie mit anthrazit Kontakt auf.

Attribute können zusätzlich einen Beschreibungstext und einen Skalawert (numerisch) haben.

Beispiel:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<import partner="Partner AG" partnerid="99" passwort="xyz012" importid="1">
    <item status="1" suchbar="1" mutationsdatum="2011-12-13 00:0:00">
        <id>01</id>
        <titel>Titel der Seite</titel>
        ...
        <attribut id="1" skalawert="3">weiterführende Info zu diesem Attribut</attribut> 
        <attribut id="3" skalawert="5">weiterführende Info zu jenem Attribut</attribut> 
        <attribut id="8" skalawert="2">weiterführende Info und hierzu</attribut>     
    </item>
</import>