XML Schnittstelle

anthrazit bietet die Möglichkeit einer Schnittstelle, wo mittels entsprechend formatierter
XML Dokumente, Daten (Text, Bilder, Dokumente) in das System eingspiesen werden können.

Konzept Datenschnittstelle

Sicherheit

Die Import Schnittstelle auf dem moPage-Server ist einerseits per htaccess (User/Passwort) geschützt. Anderseits werden die Zugangsdaten separat geliefert. Zusätzlich muss im XML Feed im <import> Element ein vorgängig definiertes Passwort mitgeliefert werden. Auch der XML Daten-Feed auf Partnerseite sollte optimalerweise auch in einem htaccess geschützten Bereich liegen.

Ansprechen der Datenschnittstelle

Abholung durch moPage Server

xml_fetch.png

Die Abholung kann in definierten Intervallen erfolgen.

Anlieferung via GET

xml_get.png

Anlieferung via POST

xml_post.png

Definition für Abholung der Daten

Zu Beginn muss definiert werden, welche Variante vom Client/Datenlieferant implementiert/angestrebet ist.

Beschaffenheit der XML Daten

Variante #1

Bei der ersten Übertragung wird der komplette Datenstamm eingelesen. Zukünftig sollten nur noch die geänderten Datensätze im XML Feed angeliefert werden.
Löschungen müssen vermerkt werden. Siehe Punkt 2.2 "löschen".

Variante #2

Es wird immer der komplette aktive Datenstamm im Feed hinterlegt. Datensätze, die nicht mehr im Feed vorhanden sind, werden automatisch gelöscht.
Hierbei ist es elementar, dass die einzelnen Datensätze mit dem Attribut mutationsdatum versehen sind und ein wahrheitsgetreues Mutationsdatum enthalten. Anhand dieses Datums entscheidet das API dann, welche Daten neu eingelesen werden müssen.

WICHTIG:
Auch hier muss vorgängig definiert werden, welche Variante vom Client/Datenlieferant angestrebt wird. Vorzugsweise Variante 1.

Request mit API Key

Base URL / Authentifizierung / Request Headers

Die Base URL für alle Requests lautet

https://api.mopage.ch

Die Authentifizierung erfolgt mit einem vorgängig kommunizierten API Key, der im Request Header wie folgt mitzuliefern ist:

X-Api-Key: {client_api_key_here}

Daten anliefern

Mit referenziertem XML File:

PUT /api/v1/xmldata?urldata=ENCODED_URL_TO_XML_FILE

Daten direkt liefern:

POST /api/v1/xmldata/{importid}

Hierbei werden die XML Daten im Body des POST Requests mitgeliefert.

Als Response erhält man in der Folge eine Liste mit den eingefügtn/geupdateten/gelöscten Datensätzen:

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<import importid="86" date="2023-06-23T15:57:08+02:00">
    <item id="1358360" objektkey="2126862070" parent="7682391" usid="111" action="updated" titel="Atelieraufenthalt in Kairo für Carina Kirsch" mutationsdatum=""/>
    <item id="7895" objektkey="456488029" parent="7682391" usid="111" action="inserted" titel="Weiterer Titel" mutationsdatum=""/>
    <item id="13583601" objektkey="1889323642" parent="7682391" usid="111" action="inactivated" titel="" mutationsdatum=""/>
</import>

Liste aller Datensätze anfordern

GET /api/v1/xmldata/getlist/{importid}

{importid} ist hierbei mit der effektiven Resource zu ersetzen

Als Resultat erhalten Sie ein XML in folgender Form:

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<list>
    <item status="1" suchbar="1" datumvon="" datumbis="" geloescht="0">
        <id>01</id>
        <objektkey>123456789</objektkey>
        <titel>Datensatztitel</titel>
    </item>
    <item status="1" suchbar="1" datumvon="" datumbis="" geloescht="0">
        <id>03</id>
        <objektkey>112233</objektkey>
        <titel>Anderer Titel</titel>
    </item>
</list>

Einzelner Datensatz löschen

DELETE /api/v1/xmldata/delete/{importid}/{id}

{importid} und {id} (ID des Datensatzen auf Source System) sind hierbei mit den effektiven Resourcen zu ersetzen.

Als Response erhält man dann folgende Erfolgmeldung:

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<import importid="111" date="2023-06-23T16:07:34+02:00">
    <item id="123456" objektkey="2126862070" usid="123" action="inactivated" titel="Atelieraufenthalt in Kairo für Carina Kirsch" />
</import>

Aufbau der Daten

Der XML Aufbau ist detailliert dokumentiert. Da die Authentifizierung per API Key erfolgt, können im Root Element <import> sämtliche Attribute weggelassen werden.

Seitentypen

Wie die verschiedenen Seitentypen aufgebaut sein sollten, welche Elemente eingesetzt werden, entnehmen Sie der jeweiligen Doku:

XML Aufbau

XML Grundstruktur

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

Das Rootelement <import>

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

 Name Bemerkung Pflichtfeld
partnerid Vorgegebene, numerische ID für den Partner, ist bei uns vorgängig in DB erfasst und muss übereinstimmen ja
passwort Vorgängig definierter Schlüssel/Passwort, ist bei uns hinterlegt (einmalig pro Partner) ja
importid  Vorgegebene, numerische ID für den jeweiligen Import, ist bei uns vorgängig in DB erfasst und muss übereinstimmen ja
vaterobjekt Key (von anthrazit kommunizierter alternativer Key, übergeordnetes Strukturelement) optional
partner  Name des Partners, ist bei uns vorgängig in DB erfasst und muss übereinstimmen. optional

Beispiel:

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

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:

 Name Bemerkung Defaultwert
status  status: 0 für inaktiv (unsichtbar), 1 für aktiv 1
suchbar 0 oder 1, Erscheint bei 1 in moPage Suche. 1
datumvon Datum, ab wann das Objekt dargestellt wird. Importdatum
datumbis Datum, ab wann das Objekt ausgeblendet wird. 2038-01-01-00:00:00
loeschen bei 1 wird entspr. Datensatz gelöscht (einziges zwingendes Subelement von <item> ist das <id> Element.) nicht gesetzt
position numerischer Wert für die Position (in Liste; danach wird aufsteigend sortiert)  nicht gesetzt
vaterobjekt Key (von anthrazit kommunizierter alternativer Key, übergeordnetes Strukturelement)  nicht gesetzt
mutationsdatum Datum letzter Änderung des Datensatzes 2011-12-13 00:0:00
WICHTIG: wird bei erneutem Import einer gleichen Item ID kein neueres mutationsdatum geliefert, wird auch nichts geupdated.		  nicht gesetzt
ansichtbild mögliche Werte (wenn nicht gesetzt, wir Default rechts angewendet):
0 = Standard (oben links, quadratisch)
1 = Bild unter Titel, volle Breite
2 = Bild oben links klein
3 = Bild ganz oben, volle Breite
10 = halbe Breite im Text
11 = Bild Top/Float (Standard)
12 = Bild halb (Desktop) / voll (mobile)		 0
ansichtliste mögliche Werte (wenn nicht gesetzt, wir Default rechts angewendet):
3 = normaler Listeneintrag, ganzzeilig klickbar
4 = Objekt mit allen Details direkt in Liste ausgeben		 3

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

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

XML Beispiel für Standardseite

Priorität Name Typ  Bemerkung
muss id  varchar 50  unique numerische/alphanumerische id aus Partner System
muss titel varchar 100  Titel der Seite
kann textlead varchar 1000  Leadtext der Seite (Wird fett oberhalb von textmobile dargestellt)
muss textmobile varchar 10000  (Für Längere Texte wird empfohlen, die ersten 2-3 Sätze in diesem Feld zu speichern und zusätzlichen den ganzen Text im Feld Text)
Kann text varchar 30000 Falls zusätzlich eine ausführlichere Version des Textes vorhanden ist kann diese im Feld abgelegt werden. In der mobile Ansicht wird dann unter dem textmobile ein Textlink mit "mehr" angezeigt.
kann url_bild varchar 255  Verweis (URL) auf Bild (jpg, min. grösse 1000 px Breite optimalerweise)

HINWEIS: Element kann mehrmals vorkommen (Slideshow)
Kann optional folgende Attribute enthalten:
legende: optionale Bildunterschrift
vorschau: bei Wert 1 wird das entspr. Bild nur in einer Vorschausituation ausgegeben (zB Übersichtsliste)
kann  keyword varchar  es sind mehrere Elemente möglich. Die Gesamtlänge aller Keywords muss < 1000 Zeichen sein (Rest wird abgeschnitten). Keywords dienen zur Auffindbarkeit in der Suche und werden nicht sichtbar dargestellt.

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>

Elemente für alle Seitentypen

Priorität Name  Typ  Bemerkung
kann bcode varchar 16 unique Zeichenfolge [a-z0-9] für den QR Code. Wenn dieses Element nicht geliefert wird, wir es auf Basis des <titel> Elements generiert.
kann icon varchar 64 Referenzname des Seiten Icons (wird in Listen ausgegeben)
Liste aller Icons mit Referenznamen: https://xml.mopage.ch/icons
kann url_dokument varchar 255 Verweis (URL) auf Dokument (pdf, doc, xls, ppt...). Datei wird dabei auf mopage Server abgelegt, deshalb ist die Dateigrösse je nach mopage Version limitiert.

HINWEIS: Element kann mehrmals vorkommen und Kann optional folgendes Attribut enthalten:
legende: Alternativer Dokumententitel

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>

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.

Priorität Name Typ Bemerkung
kann attribut alphanuum Enthält folgende Elementattribute:
id: pflichtfeld - wiederspiegelt die Attribut ID auf https://xml.mopage.ch/attribute
skalawert: optional, ist ein numerischer Wert einer Skala von 1 – 5, im Sinne von 1 = schlecht, 5 = sehr gut.

Das Element selbst kann einen Beschreibungstext enthalten.
Es sind mehrere Elemente <attribut> innerhalb 1 <item> Elements erlaubt.

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>

Verschiedene Seitentypen

Verschiedene Seitentypen

News

Priorität Name Typ Bemerkung
muss  id varchar 50 unique numerische/alphanumerische id aus Partner System
muss titel varchar 100 Titel der Newsmeldung
kann textlead varchar 1000 Falls die Nachricht über einen Lead verfügt kann diese hier angegeben werden. (Wird fett oberhalb von textmobile dargestellt)
muss textmobile varchar 10000 Nachrichtentext. (Für Längere Texte wird empfohlen, die ersten 2-3 Sätze in diesem Feld zu speichern und zusätzlichen den ganzen Text im Feld Text)
kann text varchar 30000 Falls zusätzlich eine ausführlichere Version des Textes vorhanden ist kann diese im Feld abgelegt werden. In der mobile Ansicht wird dann unter dem textmobile ein Textlink mit "mehr" angezeigt.
kann url_bild varchar 255 Verweis (URL) auf Bild (jpg, min. grösse 1000 px Breite optimalerweise)

HINWEIS: Element kann mehrmals vorkommen (Slideshow)
Kann optional folgendes Attribut enthalten:
legende: optionale Bildunterschrift
kann url_dokument varchar 255 Verweis (URL) auf Dokument (pdf, doc, xls, ppt...). Datei wird dabei auf mopage Server abgelegt, deshalb ist die Dateigrösse je nach mopage Version limitiert.

HINWEIS: Element kann mehrmals vorkommen und Kann optional folgendes Attribut enthalten:
legende: Alternativer Dokumententitel
soll rubrik varchar 100 Es sind mehrere Elemente <rubrik> möglich pro <item>.
kann url_web varchar 1000 Referenzweblink zur Nachricht für Computer Bildschirme.
Inkl. http://
kann url_mobile varchar 1000 Referenzweblink zur Nachricht für mobile Endgeräte.
Inkl. http://
kann keyword varchar 1000 Es sind mehrere Elemente möglich. Die Gesamtlänge aller Keywords muss < 1000 Zeichen sein (Rest wird abgeschnitten). Keywords dienen zur Auffindbarkeit in der Suche und werden nicht sichtbar dargestellt.
kann datumprio datetime Datum für Darstellung auf Newsbeitrag und Sortierkrietrium in Form 2021-11-23 14:15:00
Das Element kann optional das Attribut verstecken="1" beinhalten, falls das Datum nicht ausgegeben werden soll

Wichtig:

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" datumvon="2010-09-03 12:30:00" datumbis="2011-02-13 18:45:00" mutationsdatum="2011-12-13 00:0:00">
        <id>01</id>
        <titel>Titel der Nachricht</titel>
        <textmobile>Nachrichtentext</textmobile>
        <textlead>Leadtext</textlead>
        <text>Das ist der längere Text für online</text>
        <url_bild legende="Kirche beim Dorfzentrum">http://path.to/image.jpg</url_bild>
        <url_dokument legende="Preisliste PDF">http://www.server.com/thefile.pdf</url_dokument> 
        <url_web>http://www.derlink.ch</url_web>
        <url_mobile>http://m.derlink.ch</url_web>
        <rubrik>Informatik</rubrik>
        <rubrik>Aktuelles</rubrik>
        <keyword>informatik</keyword>
        <keyword>computer</keyword>
        <datumprio verstecken="1">2021-11-23 14:15:00</datumprio>
    </item>
</import>
Verschiedene Seitentypen

Standort

Priorität Name Typ Bemerkung
muss  id varchar 50 unique numerische/alphanumerische id aus Partner System
muss titel varchar 100 Titel der Seite
kann textlead varchar 1000 Falls die Nachricht über einen Lead verfügt kann diese hier angegeben werden. (Wird fett oberhalb von textmobile dargestellt)
muss textmobile varchar 10000 Nachrichtentext. (Für Längere Texte wird empfohlen, die ersten 2-3 Sätze in diesem Feld zu speichern und zusätzlichen den ganzen Text im Feld Text)
kann text varchar 30000 Falls zusätzlich eine ausführlichere Version des Textes vorhanden ist kann diese im <text> Feld abgelegt werden. In der mobile Ansicht wird dann unter dem textmobile ein Textlink mit "mehr" angezeigt.
kann url_bild varchar 255 Verweis (URL) auf Bild (jpg, min. grösse 1000 px Breite optimalerweise)

HINWEIS: Element kann mehrmals vorkommen (Slideshow)
Kann optional folgendes Attribut enthalten:
legende: optionale Bildunterschrift
kann url_web varchar 1000 Referenzweblink zur Nachricht für Computer Bildschirme.
Inkl. http://
kann url_mobile varchar 1000 Referenzweblink zur Nachricht für mobile Endgeräte.
Inkl. http://
kann keyword varchar 1000 Es sind mehrere Elemente <keyword> möglich. Die Gesamtlänge aller Keywords muss < 1000 Zeichen sein (Rest wird abgeschnitten). Keywords dienen zur Auffindbarkeit in der Suche und werden nicht sichtbar dargestellt.
muss adresse varchar 255 Strasse und Hausnummer
kann adresse_zusatz varchar 255  
muss plz varchar 50  
muss ort varchar 255  
muss land_iso varchar 2 2stellig. Beispiel: ch
kann land varchar 255 Land ausgeschrieben
kann hauptrubrik varchar 100 Übergeordnete Rubrik für <rubrik>. Hauptrubrikname steht dabei im Attribut name: <hauptrubrik name="blabla">. Mehrere möglich.
kann rubrik varchar 100 Es sind mehrere Elemente <rubrik> möglich pro <item>. Entweder direkt als Subelement von <item> oder gegliedert als Subelement von oben beschriebener <hauptrubrik>
soll telefon1 varchar 255 Internationales Format +41522030283 empfohlen
kann telefon2 varchar 255  Internationales Format +41522030283 empfohlen
kann telefon3 varchar 255  Internationales Format +41522030283 empfohlen
kann mobile varchar 255  Mobiltelefon-Nummer, internationales Format +41522030283 empfohlen
soll email varchar 500 E-Mail Adresse der Location zur Kontaktaufnahme
soll  oeffnungszeiten varchar 255  
kann firma varchar 255 Wenn Leer wird der Objekt-Titel verwendet. Alternativ kann anstelle einer Firma auch eine Person spezifiziert werden.
kann vorname varchar 255  Ansprechperson Vorname
kann name varchar 255 Ansprechperson Nachname
kann sex varchar 1 M oder F
kann abteilung varchar 255 Abteilung z.B. Verkauf
kann fax varchar 255 Internationales Format +41522030283 empfohlen
kann oev varchar 255 ÖV Beschreibung
kann longitude float geogr. Länge (WGS84-Koordinaten, wird wenn leer von mopage Server gesucht)
kann latitude float geogr. Breite (WGS84-Koordinaten, wird wenn leer von mopage Server gesucht)
kann facebook varchar 255 Facebook URL
kann twitter varchar 255 Twitter Account/Url
kann skype varchar 255 Skype Name
kann linkedin varchar 255 LinkedIn Account/Url
kann googleplus varchar 255 Google+ URL
kann xing varchar 255 XING Account/Url

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>Steueramt</titel>
        <adresse>Sonnenstr. 12</adresse>
        <plz>5004</plz>
        <ort>Sonnenberg</ort>
        <land_iso>ch</land_iso>
        <hauptrubrik name="Ämter">
             <rubrik>Geld</rubrik>
             <rubrik>Steuern</rubrik> 
            <rubrik>allgemein</rubrik>
         </hauptrubrik> 
        <hauptrubrik name="Stadt">
             <rubrik>Gemeindehaus</rubrik>
             <rubrik>Stock 2</rubrik> 
         </hauptrubrik> 
        <rubrik>Finanzen</rubrik>
        <telefon1>+41522000001</telefon1>
        <email>email@domain.com</email>
        <oeffnungszeiten>Mo-DO, 8.00 - 17.30h, FR, 7:00 - 19:00 </oeffnungszeiten>
        <textmobile>Haben Sie Steuerfragen? Wir helfen Ihnen gerne.</textmobile>
        <url_web>http://www.gemeinde-sonnenberg.ch</url_web>
        <url_mobile>http://m.gemeinde-sonnenberg.ch</url_web>
        <firma>Gemeindeverwaltung Sonnenberg</firma>
        <vorname>Simon</vorname>
        <name>Wetter</name>
        <sex>M</sex>
        <abteilung>Steueramt</abteilung>
        <mobile>+41791112233</mobile>
        <fax>+41522000003</fax>
        <adresse_zusatz>Geb. 15a</adresse_zusatz>
        <land>Schweiz</land>
        <textlead>Leadtext der Seite</textlead>
        <url_bild legende="Kirche beim Dorfzentrum">http://path.to/image.jpg</url_bild>
        <url_bild>http://path.to/image2.jpg</url_bild>
        <url_bild>http://path.to/image3.jpg</url_bild>
        <oev>Busslinlie 5b Hatestelle Bergli</oev>
        <longitude>8.56235684</longitude>
        <latitude>47.5985655</latitude>
        <keyword>Steuern</keyword>
        <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>
Verschiedene Seitentypen

Veranstaltung

Priorität Name Typ Bemerkung
muss  id varchar 50 unique numerische/alphanumerische id aus Partner System
muss titel varchar 100 Titel der Seite
kann textlead varchar 1000 Falls die Nachricht über einen Lead verfügt kann diese hier angegeben werden. (Wird fett oberhalb von textmobile dargestellt)
muss textmobile varchar 10000 Nachrichtentext. (Für Längere Texte wird empfohlen, die ersten 2-3 Sätze in diesem Feld zu speichern und zusätzlichen den ganzen Text im Feld Text)
muss termin   Kann mehrmals vorkommen. Wenn es sich um einen ganztägigen Termin handelt, muss im Element <termin> das Attribut allday="1" gesetzt sein.
Dieses Element enthält jeweils folgende 2 Subelemente von und bis:
  von datetime 255 Startdatum Event, zB 2010-11-11 12:15:00 
  bis datetime 255 Enddatum Event, zB 2011-11-11 15:30:00
Ist das Ende nicht bekannt, soll das Enddatum gleich wie das Startdatum gesetzt werden. Somit wir der Termin nur punktuell angezeigt.
kann text varchar 30000 Falls zusätzlich eine ausführlichere Version des Textes vorhanden ist kann diese im <text> Feld abgelegt werden. In der mobile Ansicht wird dann unter dem textmobile ein Textlink mit "mehr" angezeigt.
kann url_bild varchar 255 Verweis (URL) auf Bild (jpg, min. grösse 1000 px Breite optimalerweise)

HINWEIS: Element kann mehrmals vorkommen (Slideshow)
Kann optional folgendes Attribut enthalten:
legende: optionale Bildunterschrift
kann url_web varchar 1000 Weblink mit zusätzlichen Informationen, inkl. http://
kann url_mobile varchar 1000 Weblink mobile optimiert für zusätzliche Informationen, inkl. http://
kann keyword varchar 1000 Es sind mehrere Elemente möglich. Die Gesamtlänge aller Keywords muss < 1000 Zeichen sein (Rest wird abgeschnitten). Keywords dienen zur Auffindbarkeit in der Suche und werden nicht sichtbar dargestellt.
kann hauptrubrik varchar 100 Übergeordnete Rubrik für <rubrik>. Hauptrubrikname steht dabei im Attribut name: <hauptrubrik name="blabla">. Mehrere möglich.
kann rubrik varchar 100 Es sind mehrere Elemente <rubrik> möglich pro <item>. Entweder direkt als Subelement von <item> oder gegliedert als Subelement von oben beschriebener <hauptrubrik>
kann referenzort varchar 50 Referenz ID auf Event Location. (Siehe 3.2 Standort)
kann abo   Falls Event abonniert werden sollen kann, können hier die Vorlaufzeit und die Benachrichtigungstexte definiert werden.
Das Element <abo> kann das Attribut vorlaufzeit beinhalten, Vorlaufzeit in Minute für die Benachrichtigung (wenn nicht gesetzt, gilt der Fallback 1440 Minuten, also 1 Tag).
enthält folgende Subelemente textlang und textkurz:
  textkurz  varchar 130 Text für Push Benachrichtigung. Kann folgende Platzhalter enthaten:
{datum} = Veranstaltungdatum
{titel} = Titel dieses Events
  textlang  varchar 5000 Text für Email Benachrichtigung. Kann folgende Platzhalter enthaten:
{datum} = Veranstaltungdatum
{titel} = Titel dieses Events
{link} = Link auf diese Seite
kann veranstaltungsort   Ort/Lokalität, an dem der Event stattfindet (erzeugt eigenen Datensatz). Beinhaltet folgende Subelemente:
muss titel varchar 100 Titel der Seite
muss adresse varchar 255 Strasse und Hausnummer
muss plz varchar 50   
muss ort varchar 255    
kann  Alle weiteren Elemente von Standort     

Anmerkungen:
Abgelaufene Events werden automatisch entfernt

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>Jahresparty</titel>
        <termin allday="1">
            <von>2011-08-06 00:00:00</von>
            <bis>2011-08-06 23:59:00</bis>
        </termin>
        <termin>
            <von>2011-04-06 11:00:00</von>
            <bis>2011-04-08 12:15:00</bis>
        </termin>
        <referenzort>1234</referenzort>
        <textmobile>Das Event findet bei jeder Witterung statt. Natürlich wie immer 2x im Jahr.</textmobile>
        <rubrik>Museum</rubrik>
        <rubrik>Kultur</rubrik>
        <rubrik>Musik</rubrik>
        <textlead>Wir laden euch herzlich ein!</textlead>    
        <url_bild legende="Kirche beim Dorfzentrum">http://path.to/image.jpg</url_bild>
        <url_web>http://www.derlink.ch</url_web>
        <url_mobile>http://m.derlink.ch</url_mobile>
        <keyword>Event</keyword>
        <abo vorlaufzeit="1440">
            <textkurz>Der Event '{titel}' findet am {datum} statt</textkurz>
            <textlang>Guten Tag\n\nDer Event '{titel}' findet am {datum} statt. Es wäre schön, Sie am Anlass begrüssen zu dürfen!\n\n {link}</textlang>
        </abo>
        <veranstaltungsort>
            <titel>Steueramt</titel>
            <adresse>Sonnenstr. 12</adresse>
            <plz>5004</plz>
            <ort>Sonnenberg</ort>
            <telefon1>+41522000001</telefon1>
            <email>email@domain.com</email>
            <oeffnungszeiten>Mo-DO, 8.00 - 17.30h, FR, 7:00 - 19:00 </oeffnungszeiten>
            <url_web>http://www.gemeinde-sonnenberg.ch</url_web>
            <mobile>+41791112233</mobile>
            <fax>+41522000003</fax>
            <adresse_zusatz>Geb. 15a</adresse_zusatz>
            <land>Schweiz</land>
            <textlead>Leadtext der Seite</textlead>
            <url_bild>http://path.to/image.jpg</url_bild>
            <oev>Busslinlie 5b Hatestelle Bergli</oev>
            <longitude>8.56235684</longitude>
            <latitude>47.5985655</latitude>
        </veranstaltungsort>
    </item>
</import>