EXT: CIVSERV¶

((generated))¶

((generated))¶

Den Verzeichnisbaum erstellen¶

Die vorgefertigten .t3d Dateien für den Aufbau des Verzeichnisbaums befinden sich im Pfad civserv/doc/.

Speichern Sie die Datei 2006-11-16_virtuelle_verwaltung_inkl_mandant.t3d (und ggfs andere dort vorhandene .t3d-Dateien) auf einem lokalen Laufwerk.

Für alle folgenden Schritte wählen Sie das Modul „Liste“.

((generated))¶

((generated))¶

Virtuelle Verwaltung¶

O.S.I.R.I.S. - choose community¶

Webseiten (Mandant Musterstadt)¶

Ggfs gibt es noch weitere Templates, etwa für eine Seite in einer zweiten Sprache oder weitere Mandanten-Templates.

Für die Konfiguration von Menüs und Layout sind vor allem die Mandanten-Templates von Bedeutung.

Step 1:

*Master* *Template* *–* befindet sich aufdemOrdner 'virtuelle Verwaltung' (dem root-Ordner des gesamten virtuellen Rathaus).

• Das Master Template braucht nicht editiert werden, es trägt die drei Häkchen für das Root-Template und für Clear Constants und Clear Setup.
• Beim Master Template müssen unter Include static (from extensions) 'css styled content' und 'Civil Services' ausgewählt sein.
• Alle anderen Felder können leer bleiben. Ggfs kann im Setup Spam Protection eingerichtet werden.

Step 2:

*Portal Template* – befindet sich auf der Seite O.S.I.R.I.S. portal entry,

kann i.d.Regelvernachlässigtwerden, wird nur gebraucht wenn man eine Portal-Einstiegsseite für O.S.I.R.I.S. im Mehrmandantenbetrieb darstelllen möchte.Für die Werte die in dem Code-Beispiel in eckigen Klammern dargestellt sind, setzen sie die entsprechenden UID-Werte aus Ihrem Seitenbaum.

In jedem Fall sollten hier nur die Felder Constants und Setup bearbeitet werden.

:underline:`**Constants**`

pageid = [123]
cache_services = 1
community_choice = 1

pageid = die ID der Seite 'O.S.I.R.I.S. - choose community' - die Konstante 'pageid' kann beim Portal Template auch weggelassen werden!

:underline:`**Setup**`

plugin.tx_civserv_pi1._DEFAULT_PI_VARS.community_id= choose

Step 3:

*Template Verwaltung 1* – befindet sichauf dem Sysordner ' Webseiten'

Hier nur „Constants“ editieren, die Werte müssen mit denen aus der Mandantenkonfiguration übereinstimmen.Für die Werte die in dem Code- Beispiel in eckigen Klammern dargestellt sind, setzen sie die entsprechenden UID-Werte aus Ihrem Seitenbaum.

Minimal müssen eingetragen werden:

:underline:`**Constants**`

pageid = [129]
fulltext_search_id = [130]
cache_services = 1
community_choice = 0
community_id =  [11000000]

pageid = die ID der Seite ' Virtuelle Verwaltung' (nicht der Sysordner sondern die Seite - befindet sich im Sysordner Webseiten )

f ulltext_search_id = die ID der Seite 'Volltextsuche'

community_id = Nummer zu eindeutigen Identifizierung des Mandanten (kann zb. aus www.orte.de entommen werden, Berlin hat zum Beispiel die deutschlandweit eindeutige Gemeindekennziffer 11000000)

CIVSERV standalone¶

O.S.I.R.I.S ist so aufgebaut, dass es eigenständig mit seinem eigen Menü, welches automatisch generiert wird, und mit einem eigenen Layout laufen kann. Die einzige Frontend-Seite ist dann die Seite „virtuelle Verwaltung“ (im Ordner 'Webseiten' eines jeden Mandanten).Die Menü- Einträge sind über das Mandanten-TS-Template (auf dem Ordner Webseiten) konfigurierbar (Constants-Feld), zur Verfügung stehen die Optionen:

menuServiceList = 1
menuCircumstanceTree = 1
menuUsergroupTree = 1
menuOrganisationList = 0
menuOrganisationTree = 1
menuFormList = 1
menuTop15 = 1
menuEmployeeList = 0

Das Beispiel zeigt die Standardkonfigurartion für das Hauptmenü, wenn im Mandanten-TS-Template keine menu-Konfiguration eingetragen wird, dann werden die Menüpunkte entsprechend der obigen Auswahl angezeigt.

Weitere Konfigurationsmöglichkeiten auch für die Stichwortsuche und die ServiceNavagation sind der Datei civserv/ext_typoscript_constants.txt zu entnehmen.

CIVSERV in bestehendes Template einbinden (BeispielSzenario von Thomas Gottschlich)¶

Für gewöhnlich existiert bereits eine Seitenstruktur inkl. Template, zum Beispiel eine kommunale Homepage und man möchte das virtuelle Rathaus in die bestehende Struktur und das Corporate Design der Homepage einbinden.

Step 1:

Wenn man CIVSERV in dieses Template einbinden möchte, muss man zunächst das Plugin Virtuelle Verwaltung auf der entsprechenden Seite einfügen (hier Bürgerservice ).

CIVSERV einbinden - Optionen¶

Es sind auch andere Möglichkeiten denkbar, O.S.I.R.I.S. in eine bestehende Website zu integrieren:

• es können auch interne Seitenlinks statt der Shortcuts verwendet werden.
• Die Startseite der Extension CIVSERV kann auch so angepasst werden, dass sie die Startseite der Homepage imitiert – a la Mimikri. Das bietet sich vor allem an, wenn sich die Homepage und das virtuelle Rathaus auf verschiedenen Servern befinden.

Das Layout von O.S.I.R.I.S. anpassen:¶

Das gesamte Layout von O.S.I.R.I.S. wird gesteuert über:

• eine zentrale css-Datei: civserv/templates/css/screen.css
• ein zentrales html-Template: civserv/templates/index.html
• verschiedene smarty-Templates, die die unteschiedlichen Ansichten wied ergeben:civserv/templates/service.tpl.htmlcivserv/templates/service_l ist.tpl.htmlcivserv/templates/organisation.tpl.htmlusw.

Das Layout kann für jeden Mandanten im System überschrieben werden. Dazu muss eine Kopie von screen.css im Pfad des Mandanten abgelegt werden, z.B.

filedmin/civserv/1100000/templates/css/musterstadt.css (1100000 sei die GKZ von Musterstadt, musterstadt.css sei eine Kopie von screen.css)

Weiterhin sollte eine Kopie des zentralen html-design-Templates in den Pfad

filedmin/civserv/1100000/templates/musterstadt.html (musterstadt.html sei eine Kopie von index.html)

gelegt werden.

Diese Dateien können dann nach Belieben angepasst werden .

Gleichzeitig müssen im Setup des Mandaten-TS-Templates die Pfade zu den neuen Layout-Dateien gesetzt werden:

page.includeCSS >
page.includeCSS{
file100 = fileadmin/civserv/1100000/templates/css/musterstadt.css
file100.title= individual style
file100.media=screen

und:

page.10.template.file = fileadmin/civserv/1100000/templates/musterstadt.html

Es können dort auch mehrere verschiedene css-Dateien angegeben werden. Die müssen dann entsprechend eingebunden werden.

Updates of CIVSERV (english):¶

• After each update via the TER you should check if a new field has been added to the configuration of the clients (Mandanten) in tx_civserv_conf_mandant.
• After each update via the TER you should go to the install tool and run the database analyser -> compare to ensure that new fields are added to the database

Weblinks¶

• Weitere Dokumentationen und Anleitungen http://www4.citeq.de/O.S.I.R.I.S./doc/
• Beispiel-Site (1 Mandant, standalone) http://www4.citeq.de/osiris_demo/
• CIVSERV Mailinglist http://lists.netfielders.de/cgi- bin/mailman/listinfo/typo3-project-civserv

CIVSERV Datenmodell¶

Die Zusammenhänge der einzelnen Objekte im CIVSERV lassen sich am besten anhand des Datenmodells verstehen.

Versioning and Workspaces¶

CIVSERV >= 4.1.3 (in combination with Typo3 >= 4.x) supports workspace and versioning – in an experimental status though.

Further documentation of civserv and workspaces will follow when there is reliable experience from a mandant using this feature.

New navigations: „Organisations A-Z“ and „Employees A-Z“¶

to activate any of them put the following line(s) in client-TS- template (constants field):

menuEmployeeList = 1
menuOrganisationList = 1

Fixed 'Region bug':¶

First of all: this feature will only work in sites with several mandants/clients/communities belonging to several different regions!

At the very bottom of the service-form you may select another region to which you want to offer this service. The idea is that a county administration offers some of its services, i.e. car registration procedures, to the smaller regions/clients configured in the same site (because obviously small villages do not offer these services themselves). If you do chose to offer your service to another region via the above-mentioned select-field, the communities / clients belonging to that region will find the service in the folder 'external services' in their pagetree and then they can chose to make it visible for their own virtual town hall.

The bug: It was possible to chose your own region in the select field, which led to to an accumulation of redundant services in your folder 'external services' – this is no longer possible now.

New wizard for service-organisation-relations¶

This wizard makes it much more comfortable to choose a responsible organisational unit for a given service.

New feature for bilingual O.S.I.R.I.S. sites¶

First of all this is only a limited realisation of a bilingual site!

To make it work you need a second page (doktype 1) for the display of the english content, next to the main display-pagethe second or alternative web-page has to carry the plugin civserv and its own TS- extension-template.

Alternative page / extension TS template – constants:

language = default                         //defaut = english!
pageid = 1417                           //uid of second-language-content
alternative_page_id = 280   //uid of main page
fulltext_search_id =                    //leave empty!!!
# Enable/disable menu-items     //you must disable all menu entries exept service-list!!
menuServiceList = 1
menuCircumstanceTree = 0
menuUsergroupTree = 0
menuOrganisationList = 0
menuOrganisationTree = 0
menuFormList = 0
menuTop15 = 0
menuEmployeeList = 0

Alternative page / extension TS template – setup:

page.config.language >
page.config.language = {$language}
page.10.template.file = fileadmin/civserv/{$community_id}/templates/index_english.html
leftmenu.1.NO.allWrap =|*||*| <li> | </li> || <li class="german"> | </li>
leftmenu.1.ACT.allWrap =|*||*| <li> | </li> || <li class="german"> | </li>
page.10.marks.MENU < leftmenu

Main page / TS template – constants:

pageid = 280                               //uid of main page
alternative_page_id = 1417       //uid of second-language-content

Further you need

a service folder for the services in the second language (one only!). It has to be included in the Mandant's Configuration, same as the alternative_page_id

an alternative HTML-start-page (copy of index.html, with all the static content translated into alternative language of your choice) which has to be referred in the setup field of the extension TS template

New wizard for employee-position-room-relations:¶

Choose which room will be displayed for your employee by selecting a building first, then then floor and then one of the rooms on that floor

3 new wizards for the selection of positions in the service form¶

select a position via its name (name of the employee occupying that position is also displayed in choice field)

select a position via the name of the employee (name of the position is also displayed)

select from a limited number of positions: only those which are related to the responsible organisational unit. (the service- organisation relation(s) have to be saved first)

You can further limit the number of positions availble to the editor of a service, depending on his or her view of the pagetree. It is kind of a „dirty trick“ but it might come handy for administrations with a very big staff, say over 1000 postions. There are two conditions you have to fulfill for this limitation to work (will have an effect on the first two wizards, and only if the actual be_user is an editor with a limited webmount. Administrators will still get to see all of the postions):

• Write the uid of the related organisation into the subtitle field of the service folders.
• Tick the checkbox in the client configuration at „page_subtitles of service folders carry organisation_uids“

What happens?:

If there is a service folder (i.e. 'services/police administration') with theuid 10 which contains services related to the organisational unit with the uid 55 ('police') you write '10' into the subtitle-field of the page with the uid 55 (you have ticked the above mentioned checkbox of course)

An editor who has access to the folder with the uid 10 in his page tree will see all postions belonging to the organisational unit with the uid 55 when he edits a service and wants to chose a contact person.

The whole mechanism works additively: The more service folders (with an accordingly manipulated subtitle field) the editor has in his page tree, the more positions he gets to see.

New checkbox for display of organisation supervisor¶

You can chose wether you want to display the names of the organisation-supervisors in the organisation detail view – or not. Just tick the checkbox on the organisation-form.

New fields in serveral forms:¶

Further new features¶

Services form:

• wizard for forms-by-categories (in a community with say over 1000 form-records this may be helpful)
• all select-fields are only available in the form, after it has been saved at least once. Instead of the select fields for other records (i.e. Positions) an info-text is displayed while a service record has not yet been published

employees form:

the select field for positions is only available, after the employee- record has been saved at least once. Instead of the select field an info-text is displayed

service-positions form:

this is only relevant for civserv running with typo3_src >= 4.0: you can only edit a service-position-record when the according service has the status 'published'. This feature is important when you are working within custom workspaces.

Folder rooms:

The rooms are now displayed in BE with information about building and floor where they are located. This helps the editors to identfy rooms in the BE list view!