Leitfaden für Behördenredakteure Teil 2: Einbindung durch parametrisierten Hyperlink

Transkript

1 Leitfaden für Behördenredakteure Teil 2: Einbindung durch parametrisierten Hyperlink Sächsisches Staatsministerium des Innern Sächsische Staatskanzlei

2 Impressum Herausgeber: Sächsisches Staatsministerium des Innern, Wilhelm Buck Str. 2, Dresden Telefon/Fax: Internetadresse: Kontakt: Redaktion: Anwendungsbetreuung und Redaktion Amt24 Redaktionsschluss: 12/2009 Auflage: Verteilerhinweis: Diese Broschüre wird im Rahmen der Öffentlichkeitsarbeit der Sächsischen Staatsregierung herausgegeben. Sie darf weder von Parteien noch von Wahlhelfern im Wahlkampf zum Zwecke der Wahlwerbung verwendet werden. Auch ohne einen zeitlichen Bezug zu einer bevorstehenden Wahl darf die Druckschrift nicht in einer Weise verwendet werden, die als Parteinahme des SMI zugunsten einzelner Gruppen verstanden werden könnte. Den Parteien ist es gestattet, diese Druckschrift zur Unterrichtung ihrer eigenen Mitglieder zu verwenden. Lutz Engler LSeGov T-Systems Seite 2 von 7 Externe / interne Links

3 1 Parametrisierter Hyperlink (von extern) Mit einem parametrisierten Hyperlink können Sie das Service-Portal Amt24 ohne großen Aufwand an Ihren kommunalen Internetauftritt anbinden. Durch die Verknüpfung mit einem Cascading Style Sheet (CSS) läßt sich zudem die Oberfläche von Amt24 an das Design Ihres eigenen Internetauftritts anpassen &mandantenid=20255&plz=01662&css=false modul=be modul=fo modul=ll&id=8 modul=su&begriff=xyz modul=sw&id=1233 modul=vb modul=we &ags= Startseite Behördenwegweiser Startseite Formulare / Onlinedienste Startseite Lebenslagen; ID des beliebigen Informationsobjektes Suche nach einem Begriff xyz (dieser muß angegeben werden) Aufruf eines bestimmten Stichworts Startseite Verfahren / Dienstleistungen Startseite Amt24 AGS des Mandanten 1 mit Ortsteilerweiterung; zu finden im Regionalregister &mandantenid=20255 Mandanten-ID (Anwendungsbetreuer kontaktieren) 2 &plz=01662 Regionalisierung mit PLZ, welche der o.g. AGS zugeordnet ist 1 &css=false Oberfläche (Stylesheet) des kommunalen Mandanten deaktivieren (seit April 2009 wird ausschließlich die Angabe der Mandanten-ID zur Aktivierung des Mandanten-CSS verwendet, so daß der Wert true obsolet ist) 1 siehe Datenbanktabelle AGS 2 siehe Datenbanktabelle MANDANTEN Lutz Engler LSeGov T-Systems Seite 3 von 7 Externe / interne Links

4 Die Schnittstelle zu den Kommunen Die Darstellung der HTML-Seiten der Kommunen ermöglicht die dynamische Einbindung von entsprechenden Style-Definitionen. Die Style-Definitionen der Kommunen werden in CSS-Dateien festgelegt. Der parametrisierte Hyperlink des Standardprodukts, zum Anzeigen kommunaler HTML-Seiten, enthält einen Parameter, der das Laden einer neuen Style-Definition für die Kommune anfordert. Der parametrisierte Hyperlink sieht wie folgt aus: <protokoll>://<server>/zfinder/zflink.do?modul=<modulname>&id=<id> &ags=<ags>&mandantenid=<mandantenid>&plz=<plz>&ort=<ort>&css=false Dabei haben die Parameter folgende Bedeutung: <protokoll>: Verbindungsprotokoll. Werte: http oder https. <server>: Vollständiger Name oder IP-Adresse des Servers, der den Request verarbeiten kann (Anwendungsserver). <modul>: Bezeichnung des Zuständigkeitsfinder-Moduls mit den Daten des referenzierten Informationsobjektes. Mögliche Werte: <modul> be fo ll su sw vb we Zuständigkeitsfinder-Modul Behörden/Organisationseinheiten Formulare Lebenslagen Suchbegriff (Empfohlene Links) Stichwörter Verfahrensbeschreibungen Startseite <id>: ID des referenzierten Informationsobjektes. Bei den Modulen su und sw muss die id angegeben werden. Beim Modul we ist die Angabe einer id nicht sinnvoll. Bei den Modulen be, fo, ll und. vb ist die Angabe einer id optional. Wird eine id angegeben, führt der Deeplink direkt zum referenzierten Informationsobjekt. Wird keine id angegeben, dann führt der Deeplink auf die Startseite des entsprechenden Moduls. Die id kann vom Anwendungsbetreuer per Datenbankabfrage sowie vom Content-Redakteur durch Einsicht der Metadaten des Informationsobjektes oder durch Auswahl im Portalfrontend (Browser-Adresszeile) ermittelt werden: Lutz Engler LSeGov T-Systems Seite 4 von 7 Externe / interne Links

5 <ags>: Allgemeiner Gemeindeschlüssel. <mandantenid> :Mandanten-ID in der Datenbank. <plz>: Postleitzahl. <ort>: Ort <css>: Laden einer Style-Definition; der Wert false lädt die Landesversion bei Angabe eines kommunalen Mandanten. PLZ und AGS erlauben eine Regionalisierung der Daten des referenzierten Informationsobjektes. Dabei gilt: plz = 0 und ags = 0 => Regionalisierung auf ganzes Bundesland. plz = -1 => Regionalisierung auf ganzer Ort, der durch ags bezeichnet wird. plz > 0 und ags > 0 => Regionalisierung auf einen bestimmten Ort mit einer bestimmten Postleitzahl. Ausnahme: Landesmandant läßt keine Regionalisierung zu (&ags= &man dantenid=0&plz=01127 funktioniert nicht) Sonst: Fehler. Beispiel für einen Hyperlink: &mandantenid=26277&plz=-1 => Lebenslage mit der ID 1128 wird referenziert, mit der Regionalisierung auf die ganze Stadt Radebeul und dem Laden einer speziellen Style-Definition. Enthält der Hyperlink keine Angaben über PLZ und AGS, wird dies als keine Regionalisierung interpretiert: id=20255 Lutz Engler LSeGov T-Systems Seite 5 von 7 Externe / interne Links

6 1.1 Externer Link auf einen Behördendatensatz im Amt24 =BHW&id=16856 id=16856 Amts-ID der Behörde (evtl. Anwendungsbetreuer kontaktieren) 3 2 Link in Behördendatensatz als Verweis auf eine andere Behörde des Amt24 Sachsen (Interner Link) <strong>außerhalb der Sprechzeiten steht Ihnen die <a href= amt24.sachsen.de/zfinder/behoerden.do;?action=showdetail&modul=bh&id =14647>Stadtverwaltung Kirchberg</a> gern zur Verfügung.</strong> id=14647 Amts-ID der Behörde (evtl. Anwendungsbetreuer kontaktieren) 4 3 siehe Datenbanktabelle VERWALTUNGSEINHEITEN 4 siehe Datenbanktabelle VERWALTUNGSEINHEITEN Lutz Engler LSeGov T-Systems Seite 6 von 7 Externe / interne Links

7 Anhang Beispiele externe Links auf ein Informationsobjekt des Amt24 Sachsen Link auf die Suche in Verfahren mit Übergabe Suchbegriff: chtextdone=&searchtext=abfallgebühr (Regionalisierung und Mandant nicht möglich) Allgemeiner Suchbegriff: Suchbegriff mit Regionalisierung: s= &plz=01814 Suchbegriff ohne Regionalisierung und mit kommunalem Mandant: ndantenid=20255 Suchbegriff mit Regionalisierung und mit kommunalem Mandant: s= &plz=01814&mandantenid=26279 Suchbegriff mit Regionalisierung per Ortsangabe: t=meißen&plz=01662 Ohne den Parameter &plz ist bei Gemeinden mit mehreren Ortsteilen vom Anwender eine manuelle Auswahl des Ortsteiles zu treffen. Mandant und Regionalisierung: andantenid=27436&plz=-1 Regionalisierung auf ganzen Ort andantenid=26196&plz=09648 Regionalisierung auf Ortsteil Mandant ohne Regionalisierung: Auswahl Startseite Auswahl Lebenslagen Auswahl Verfahren Lutz Engler LSeGov T-Systems Seite 7 von 7 Externe / interne Links