OpenDataDayBerlin2015OparlClient

This is a read only archive of pad.okfn.org. See the shutdown announcement for details.

OpenDataDayBerlin2015OparlClient
https://github.com/OParl/specs

https://github.com/OParl/reference-server
→ Wo ist denn die (neue) PHP-Referenz-Implementierung des Servers? :)

https://politik-bei-uns.de/api/
Hier ist der Quellcode dazu:
https://github.com/okfde/ris-web/blob/master/webapp/oparl.py

Simple proof of concept application (Thomas):
    https://github.com/ThomasFett/OParl-ProofOfConcept
    Trying to get all relevant data for a topic ("Bikes") in a specific city ("Köln") and a specific time range ("last 2 years").

    UPDATE: Finished the field test and wrote down a conclusion in the README of the project.

little client to show deputy data (Knut)
https://github.com/knutator2/oparlamentarier

JSON-Datensatz aus akt. Spezifikation (Kai): https://github.com/sokai/OpenData/blob/master/OParl/oparl.example.org.json
Erster Versuch (aktuell nur für System) für ein JSON Schema von OParl v1.0 (Kai): https://github.com/sokai/OpenData/blob/master/OParl/oparl-v1.0.schema.json

--- Anmerkungen - Thomas Tursics
Auf http://lichtenberg.demokratielive.org/ gibt es die Ratssitzungen von der BVV Berin-Lichtenberg im Live-Stream und ein paar Tage später in der Mediathek als Videodatei(en). Daher mein Vorschlag für die Erweiterung der OParl-Spec:

5.7 oparl:Meeting (Sitzung)
"Verschiedene Dateien (Einladung, Ergebnis- und Wortprotokoll, sonstige Anlagen) können referenziert werden." => "Verschiedene Dateien (Einladung, Ergebnis- und Wortprotokoll, Videoaufzeichnung, sonstige Anlagen) können referenziert werden."
Beispiel:
{
    "livestream": "http://link.zum/livestream",
    "videoProtocol": [
        "https://oparl.example.org/files/421",
        "https://oparl.example.org/files/422"
    ],
}
5.7.1 Eigenschaften
livestream      Livestreem der Sitzung. Typ: URL. Kardinalität: 0 bis 1. OPTIONAL.
videoProtocol     Videoaufzeichnung zur Sitzung. Diese Eigenschaft kann selbstverständlich erst nach dem Stattfinden der Sitzung vorkommen. Typ: Liste von Objekten des Typs oparl:File. Vgl. Objektlisten. Kardinalität: 0 bis *. OPTIONAL.

5.8 oparl:AgendaItem (Tagesordnungspunkt)
Beispiel:
{
    "videoLink": "https://oparl.example.org/files/422",
    "videoStart": "00:02:31",
    "videoEnd": "00:23:01",
}
5.8.1 Eigenschaften
videoLink      Videoaufzeichnung zur Sitzung. Diese Eigenschaft kann selbstverständlich erst nach dem Stattfinden der Sitzung vorkommen. Typ: Liste von Objekten des Typs oparl:File. Vgl. Objektlisten. Kardinalität: 0 bis 1. OPTIONAL.
videoStart     Zeitpunkt des Anfangs des Themas innerhalb des verlinkten Videos. Diese Eigenschaft kann selbstverständlich erst nach dem Stattfinden der Sitzung vorkommen. Typ: Datentyp xsd:dateTime. Kardinalität: 0 bis 1. OPTIONAL.
videoEnd     Zeitpunkt des Endes des Themas innerhalb des verlinkten Videos. Diese Eigenschaft kann selbstverständlich erst nach dem Stattfinden der Sitzung vorkommen. Typ: Datentyp xsd:dateTime. Kardinalität: 0 bis 1. OPTIONAL.
---

Anmerkungen - Ulf

Zu 5.4 oparl:Body (Körperschaft)

Anregung:
Körperschaft ist in diesem Fall nicht gleich die Stadt, die Gemeinde, der Landkreis oder ein kommunaler Zweckverband, sondern die legislative Ebene =
Organisatorische Ebene der Gebietskörperschaft (z.B. der Rat der Stadt XY oder der Gemeinderat XY). An dieser Stelle ist eine künftige Schnittstelle zu Informationen aus den Landesparlamenten oder dem Bundestag somit enthalten, da der Landtag die legislative Ebene des Landes XY ist.

Vorschlag:
oparl:Body (Gebietskörperschaft)

Der Objekttyp oparl:Body dient dazu, eine Gebietskörperschaft und damit die legislative Organisationseinheit auf kommunaler Ebene, wie dem Rat der Stadt, zu repräsentieren, zu dem der Server Informationen bereithält. Eine Gebietskörperschaft kann beispielsweise eine Gemeinde, ein Landkreis oder ein kommunaler Zweckverband sein. Hätte das System beispielsweise den Zweck, Informationen über das kommunale Parlament der Stadt Köln, namentlich den Rat der Stadt Köln, abzubilden, dann müsste dieses System dazu ein Objekt vom Typ oparl:Body führen, welches die Stadt Köln repräsentiert.

Zu 5.4.1 Eigenschaften

equivalentBody

Dient der Angabe beliebig vieler zusätzlicher URLs, die dieselbe Körperschaft repräsentieren. Hier können beispielsweise, sofern vorhanden, der entsprechende Eintrag der
Gemeinsamen Normdatei der Deutschen Nationalbibliothek oder der DBPedia oder der Wikipedia angegeben werden. Typ: Array mit URLs. Kardinalität:
0 bis *. EMPFOHLEN.

Anmerkung:

Was soll mit equivalentBody gemeint sein? (Siehe Anmerkungen zum Objekttyp oparl:body)

Bsp.:
Link zum Normdatensatz Geografikum ≠ Link zum Normdatensatz der Gebietskörperschaft

"equivalentBody": ["http://d-nb.info/gnd/2015732-0","http://dbpedia.org/resource/Cologne"],

Suboptimal: "http://d-nb.info/gnd/2015732-0" = Link zum Normdatensatz des Geografikums "Köln"

Korrekt: "http://d-nb.info/gnd/16247541-X" = Link zum Normdatensatz der Gebietskörperschaft „Stadtrat Köln“

keyword Schlagworte.
Typ: Array von Strings oder URLs zu skos:Concept Objekten (vgl. Vokabulare zur Klassifizierung). Kardinalität: 0 bis *. OPTIONAL.

Anmerkung:

Hier sollten die einschlägigen Beschreibungsarten eines Vorganges oder Dokumentes vorgegeben werden, welche innerhalb der RIS als Auswahl vorgegeben
werden. Es gibt formale Beschreibungen (z.B.: Antrag, Beschluss etc.) und inhaltliche Beschreibungen (z.B.: Bildung, Sport, Wirtschaft, Infrastruktur, Finanzen etc. → Orientierung an den Facetten des Statistischen Bundesamtes).

oparl:File
- 'date' sollte besser created heißen für mehr Konsistenz