Infodienste. Integration und Schnittstellen. Stand: Version: 2.1 Status: Freigegeben. Sitz des Unternehmens Breiteweg Barleben

Transkript

1 Infodienste Integration und Schnittstellen Sitz des Unternehmens Breiteweg Barleben Standort Halle (Saale) Herrenstraße Halle Tel Standort Potsdam Behlertstr. 3a / Haus B Potsdam Tel Breiteweg Barleben Tel Fax kontakt@teleport.de Stand: Version: 2.1 Status: Freigegeben Geschäftsführer: Marco Langhof Thomas Patzelt Prokurist: Christoph Zeun Amtsgericht Stendal HRB 6388 Umsatzsteuer-ID DE Sparkasse Magdeburg IBAN: DE BIC: NOLADE21MDG TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 1 / 14

2 Inhalt 1 Einleitung Datenmodell der Infodienste Übersicht der Schnittstellen Allgemein Include-Wizard Mein Include Wizard Style einer Abfrage festlegen Statistiken Suchschnittstellen Integrationsbeispiele Include-Wizard Webservices Eigene Lösungen TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 2 / 14

3 1 Einleitung Das System der Infodienste bietet verschiedene Schnittstellen zum Austausch von Daten oder zur Integration in Drittsysteme. Dieses Dokument gibt einen Überblick über die Möglichkeiten der Nutzung dieser Schnittstellen. 2 Datenmodell der Infodienste Die nachfolgende Grafik verdeutlicht das Datenmodell der Infodienste. Die Grafik zeigt die wichtigsten Datenobjekte innerhalb der Infodienste Bürgerservice und Veranstaltungsdatenbank mit deren Verknüpfungen. Im Zentrum steht die Zuständigkeit. Diese definiert sich aus der Verknüpfung von Leistung (Was möchte der Bürger tun?), Gebietsdaten (Wo ist mein Wohnort?) und Organisationseinheit (Welche Behörde ist für mich zuständig?). Anliegen sind untergliedert in Leistungskategorien, welche normalerweise Lebenslagen abbilden (Reise, Wohnen). Weiterhin ist es möglich, eine Leistung für ein bestimmtes Gebiet (z.b. Gemeinden oder Landkreis) zu spezialisieren. Es können regionale Ergänzungen zu Leistungen angegeben werden. Zu Organisationseinheiten können auch Formulare zugeordnet werden. Diese sind entweder im System hinterlegt oder es wird ein externer Formularserver eingebunden. Im Infodienst Veranstaltungsdatenbank können Veranstaltungen untergliedert nach Kategorien verwaltet werden. TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 3 / 14

4 3 Übersicht der Schnittstellen 3.1 Allgemein Das nachfolgende Diagramm gibt einen Überblick über die Integration der Infodienste in die Systemlandschaft eines Bundeslandes. Es sind die wichtigsten Akteure, Systeme und Schnittstellen verdeutlicht. 3.2 Include-Wizard Der Include-Wizard ermöglicht es Ihnen durch gezielte Abfragen auf Inhalte der zentralen Datenbank des Zuständigkeitsfinders/Bürgerservice sowie der Veranstaltungsdatenbank zuzugreifen und die Inhalte auf eigenen Internetauftritten kostenlos einzubinden. Es können interaktive Abfragen, wie zum Beispiel Suchformulare, oder auch eine fest definierte Auswahl von Daten konfiguriert werden. Damit besteht die Möglichkeit, die selbst gepflegten Daten sowie die Daten der anderen Teilnehmer in den eigenen Webauftritt zu integrieren. Anwendungsbeispiele wären: Suchformular nach zuständigen Stellen und Mitarbeitern Darstellung von Lebenslagen mit zugehörigen Leistungen Suche und Download von Formularen Organigrammdarstellung der eigenen Behörden Und viele weitere TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 4 / 14

5 3.2.1 Mein Include Wizard Die Abfragen sind der wichtigste Teil der Anwendung. Eine Abfrage definiert, welche Daten und welche Funktionen in die fremde Webseite eingebunden werden sollen. Sie hat immer eine Eigentümer- Nutzergruppe, die auch das Recht zum Bearbeiten der Abfrage besitzt. Die Startseite Mein IW des Include-Wizard bietet Ihnen einen Direkteinstieg für die Bearbeitung von Abfragen im Include-Wizard. Sie erhalten eine Übersicht Ihrer eigenen Abfragen, Sie können nach Abfragen suchen und Sie können direkt Abfragen aus Vorlagen erstellen. Abbildung 1 Beispiel Mein IW TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 5 / 14

6 Im Einfachen Modus können Sie schnell neue Abfragen auf Basis von vordefinierten Abfragevorlagen erstellen. Ihnen stehen im System mehrere Anwendungsbeispiele (Vorlagen) aus denen Sie wählen können zur Verfügung. Abbildung 2 Beispiel Vorlagenauswahl TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 6 / 14

7 Aufbau einer Abfrage Eine Abfrage enthält drei Kategorien von Konfigurationsdaten, welche in nachfolgender Grafik dargestellt werden: ABFRAGE ALLGEMEINE ANGABEN - Bezeichnung - Beschreibung - Zuordnung des Styles... SEITE 2 SEITE 1 Abfrageelement 1 Suchparameter Abfrageelement 3 ERWEITERTE ANGABEN - Aktivierung/Deaktivierung - Eigentümer (Nutzergruppe) - Globale Einschränkungen / Filter - Leistung - Gebiet - Vordefinierter Suchkontext - Leistung - Gebiet - Organisationseinheit Abfrageelement 2 Suchparameter Abfrageelement 4 In den Allgemeinen Angaben werden die (interne) Bezeichnung und Beschreibung vergeben. Diese dienen zur Identifizierung und Suche im Redaktionsbereich der Infodienste. Weiterhin wird hier der gewünschte Style zugeordnet. Unter Erweiterte Angaben kann eine Abfrage aktiviert bzw. deaktiviert sowie die Nutzergruppe bestimmt werden, welche Eigentümer der Abfrage sein soll. Weiterhin können hier globale (d.h. Abfrage-weite) Einschränkungen definiert werden, z.b. um Ortssuchen nur in einem bestimmten Gebiet zuzulassen. Zudem kann ein Suchkontext vordefiniert werden, wenn dieser nicht über ein Abfrageelement selbst bestimmt oder in einem Abfrageelement vordefiniert werden soll. Ein Anwendungsbeispiel wäre hier zum Beispiel die Darstellung von Leistungen. Als Suchkontext kann ein bestimmter Ort ausgewählt werden, auf welchen die Leistungen dann regionalisiert dargestellt werden. Kern der Abfrage ist die Gestaltung der Seiten. Diese spiegeln die öffentliche Darstellung einer Abfrage wieder. Eine Seite ist ein Container für Elemente, welcher immer gleichzeitig im Webbrowser angezeigt werden. Eine Seite wiederum enthält Abfrageelemente. TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 7 / 14

8 Abfrageelement Konfiguration Anzeige Konfiguration Sonstige Konfiguration Suchparameter Verknüpfungen Setzen oder Benutzen von Suchparametern Setzen oder Benutzen des Kontext Abfrageelement Globaler Suchkontext Abfrageelemente sind Benutzeroberflächenelemente mit einer bestimmten Funktion. Beispiele für Abfrageelemente sind Suchfeld Ort, Listenansicht Leistungen, Einzelansicht Organisationseinheit, Navigation A-Z Leiste Leistungen oder Elemente für die Darstellung von fest definierten Texten. Abfrageelemente besitzen bestimmte Konfigurationsdaten. Eine zentrale Rolle spielen hier auch die Suchparameter: Über diese werden Informationen zwischen den Abfrageelementen transportiert bzw. dienen zum Setzen oder Benutzen des globalen Suchkontext. Der Designer Zur Erstellung der Abfrage steht Ihnen der Designer zur Verfügung. Hier werden die Seiten mit den gewünschten Elementen angelegt und miteinander verknüpft. TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 8 / 14

9 Abbildung 3 Designer - Drag and Drop zum Erstellen von Elementen Auf der Arbeitsfläche können die Elemente auch über Drag n Drop gemäß des gewählten Layouts in Ihrer Position verändert werden. Abbildung 4 Designer - Drag and Drop zum Verschieben vom Elemente Style einer Abfrage festlegen Jede Abfrage kann in einem bestimmten Style dargestellt werden. Der Style definiert Daten wie Farbe, Schriftgröße, Abstände etc. Die Styles werden in einem separaten Bereich der Anwendung erstellt. Es können entweder eigene CSS-Style-Definitionen verwendet oder aus einer Liste verfügbarer, im System gespeicherte Styles ausgewählt werden. TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 9 / 14

10 3.2.3 Statistiken Der Include-Wizard verfügt über eine Statistik, die eine Übersicht über gewählte Abfragen in bestimmten Zeiträumen erstellt. Die zeitliche Einschränkung erfolgt über die Angabe von Monat und Jahr. Abbildung 5 Include-Wizard Statistik TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 10 / 14

11 4 Suchschnittstellen Aktuell existieren zwei Möglichkeiten, die Daten der Infodienste in externe Suchen einzubinden: Webservice Hier können entsprechende Methoden aufgerufen werden, welche Datenobjekte zurückliefern. Beispielsweise Leistungen mit einem Suchbegriff oder zuständige Behörden anhand von Leistung und Wohnort. Die Daten werden als XML-Objekte zurückgeliefert. Include-Wizard Hier können die Daten über Request Parameter abgerufen werden. Die Response wird als HTML ausgegeben. Anbei ein Beispiel: Abfrage mit Parameter Suchtext nach reisepass und im Volltext suchen reisepass&listeleistung_04_publicservicetypefull_fulltextsearch=true Die möglichen Parameter sind im Include Wizard beschrieben. Abbildung 6 Übersicht der Request Parameter 5 Integrationsbeispiele Anhand der verfügbaren Schnittstellen ergeben sich mehrere Möglichkeiten, die Infodienste in eigene Portale zu integrieren. Die nachfolgenden Beispiele sollen dies verdeutlichen. 5.1 Include-Wizard Im Portal der Stadt Lüneburg wird die Zuständigkeitssuche über den Include-Wizard realisiert. Die nachfolgenden Grafiken zeigen das Portal von Lüneburg. Der Inhalt des mit einem blauen Rahmen markierten Bereiches wird per Include direkt vom Infodienste-Server geladen (HTML). Alles außerhalb des blauen Rahmens stammt aus dem CMS der Stadt. TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 11 / 14

12 Mittels eigener CSS hat Lüneburg das Design der Include-Wizard-Abfragen auf ihr Design angepasst. 5.2 Webservices Die Gemeinde Stuhr hat die Einbindung per Webservices gewählt. Hier hat der technische Dienstleister die Webservices angebunden. Es werden die Daten der Infodienste per XML übertragen. Die Ausgabe wird TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 12 / 14

13 komplett im CMS der Gemeinde Stuhr realisiert. Auf der Grafik stammen die im Inhaltsbereich sichtbaren Daten (Dienstleistungsbeschreibung, Behörde und Ansprechpartner) aus den Infodiensten. 5.3 Eigene Lösungen Möglich ist auch die Erstellung eines speziell angepassten Portals. Ein Beispiel hierfür ist das Serviceportal Thüringen. Alle Inhalte des Bereichs Zuständigkeitsfinder stammen von den Infodiensten. Das Rahmenwerk ist ein Oracle Portal. TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 13 / 14

14 Im Portal von Sachsen-Anhalt erfolgt die Einbindung per TYPO3-Erweiterung: TELEPORT_Infodienste_Integration und Schnittstellen_v2.1.docx 14 / 14