Syndication: vGOV-Daten extern einbinden

vGOV erlaubt das Einbinden von Daten (Mitglieder-, Gesellschafter-, Bürgerlisten etc.) in externe Homepages. Dafür stellt vGOV Daten im XML-Format bereit. Diese können mit XML-Parsern (z.B. den XML-Funktionen von PHP) ausgelesen und weiterverarbeitet werden oder man lässt die Daten mit einem XSL-Stylesheet anzeigen.

Diese Funktionen sind etwas für (ein wenig fortgeschrittene) Webmaster. Wer vGOV einfach nur als Benutzer besucht, braucht sich darum nicht weiter zu kümmern.

Datenquelle

Die Datenquelle ist die Datei: http://www.vgov.de/xml.php
An die Datei muss zunächst der Parameter ?wo=123 übergeben werden. Dabei ist »123« die Objekt-ID desjenigen Objekts, für das die Liste ausgegeben werden soll. Gültige Objekte sind Staaten, Gebiete, Vereine, Parteien und Firmen. Für Firmen werden dann die Gesellschafter, für Vereine und Parteien die Mitglieder und für Staaten und Gebiete die Bürger ausgegeben.

Die Sortierung kann eingestellt werden, und zwar mit dem Parameter &orderby=1, wobei 1 für Name aufsteigend, 2 für Name absteigend, 3 für Beitrittszeitpunkt aufsteigend (also älteste zuerst) und 4 für Beitrittszeitpunkt absteigend (also neueste zuerst) steht.

Wenn ein Staat oder ein Gebiet angegeben wird, können aber auch die in dem jeweiligen Staat oder Gebiet ansässigen Firmen, Vereine oder Parteien ausgegeben werden, und zwar mit dem Parameter &was=1, wobei 1 für Bürger (Voreinstellung), 2 für Firmen, 3 für Vereine und 4 für Parteien steht.

Wird der Parameter »wo« nicht oder ungültig angegeben, wird er auf 3 gesetzt, was bedeutet, dass die Liste für den Staat SPQM erstellt wird.
Wird bei Staaten oder Gebieten der Parameter »was« nicht oder ungültig angegeben, wird er ebenfalls auf 1 gesetzt, sodass Bürger angezeigt werden. Bei anderen Objekttypen (Firmen, Vereine, Parteien) wird er ignoriert.
Wird der Parameter »orderby« nicht oder ungültig angegeben, wird er ebenfalls auf 1 gesetzt, also nach Namen aufsteigend sortiert.

Zusätzlich kann der Parameter &style=http://link.zu/datei.xsl angegeben werden. Damit kann man - auch ohne PHP - ein XSL-Template einbinden und so eine XSLT-Datei für die Ausgabe erzeugen. Bitte darauf achten, dass im Parameter die URL der XSL-Datei urlencoded ist! Standadmäßig wird die vGOV-eigene XSL-Datei verwendet; das betrifft aber eben nur den Fall, dass die XML-Quelldatei direkt angezeigt wird. Die XML-Daten selbst sind davon nicht betroffen.

Datenformat

Die Daten werden im XML-Format ausgegeben. Die Datei wird mit dem MIME-Type text/xml gesendet und entspricht dem Charset utf-8.
Die Daten sind nicht HTML-formatiert. Lediglich die in XML reservierten Zeichen & " > < und ' werden umgewandelt.

Die XML-Datei hat folgende Struktur (am Beispiel einer Bürgerliste aus SPQM, hier auf 2 Bürger gekürzt):

Beschreibung der einzelnen Tags:

<ergebnis>
Das ist das alles umgebende Tag (sog. Seiten-Tag).

<miccro>, <miccrohome>, <copyright>, <nutzungsbedingungen>
Hier steht immer, von wem die Daten sind, ein Verweis auf das Copyright sowie die vGOV-Homepage und -Nutzungsbedingungen.

<wo>
Enthält den Namen des Objekts (Staat, Gebiet, Firma, Verein oder Partei), für das die Liste ausgegeben wird .

<wodetails>
Enthält den Link zur vGOV-Detailseite dieses Objekts .

<was>
Enthält die Bezeichnung dessen, was ausgegeben wird. Bei Staaten und Gebieten also Bürger, Firmen, Vereine oder Parteien, bei Firmen Gesellschafter und bei Vereinen und Parteien Mitglieder.

<objekt>
Dieses Tag umgibt jedes gefundene Ergebnis, also sozusagen jede Tabellenzeile. Innerhalb jedes Objekt-Tags gibt es die unten genannten Tags.

<titel>
Das ist der Name des gefundenen Objekts.

<beschreibung>
Enthält die bei MICCRO hinterlegte Beschreibung; kann auch leer sein.

<idtyp>
Enthält den ID-Typ, wenn die Bürger eines Staates oder Gebietes angezeigt werden; ist sonst immer leer.

<beitritt>
Enthält den Zeitpunkt, seit wann das gefundene Objekt Mitglied (bzw. Bürger, Gesellschafter...) bei dem Wo-Objekt ist. Das Format bitte dem Beispiel entnehmen.

<homepage>
Enthält den bei vGOV hinterlegten Link zur Homepage des gefundenen Objekts; kann auch leer sein.

<lexikon>
Enthält den bei vGOV hinterlegten Link zu einem Lexikon-Eintrag zu dem gefundenen Objekt; kann auch leer sein.

<details>
Enthält den Link zur vGOV-Detailseite des gefundenen Objekts.