XML Schnittstelle
anthrazit bietet die Möglichkeit einer Schnittstelle, wo mittels entsprechend formatierterXML 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 

 

 Die Abholung kann in definierten Intervallen erfolgen. 

 Anlieferung via GET 

 

 Anlieferung via POST 

 

 Definition für Abholung der Daten 

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

 

 Soll der moPage Server intervallmässig die Daten abholen? 

 Oder wird dies von der Client-Anwendung her getriggert (GET oder POST Variant, s. oben). 

 

 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: 

 

 News 

 Standort 

 Veranstaltung

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

 

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

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: 

 

 Damit die Newsseiten zeitgesteuert aufgeschaltet werden können, muss im <import> Element das Attribut datumvon und datumbis gesetzt werden. Siehe XML Aufbau . 

 Soll die Nachricht nicht nach einer bestimmten Zeit ausgeblendet werden muss „datumbis“ nicht geliefert werden 

 

 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>

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>

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>