2.4. Arbeitsplatzrechner Einrichten

2.4.1. Konfiguration der Datenbank

To tell a workstation, where the database is (on the local system or on a network server) you will have to create some files initially on every device on which you will have QGIS/TWW running (client). It is not required to do that on the server itself.

Diese Anweisungen sind abhängig vom Betriebssystem.

2.4.1.1. Windows pg_service

Erstellen Sie ein neues Verzeichnis indem Sie die Konfigurationen ablegen möchten (z.B. ein neues Verzeichnis pgconfig` in ihrem Stammverzeichnis). Diese Anleitung wird jeweils mit ``PGSYSCONFDIR darauf verweisen.

Setzen Sie die Umgebungsvariable PGSYSCONFDIR auf den Dateipfad von PGSYSCONFDIR.

Bemerkung

Suchen sie Umgebungsvariablen in den Windows Systemeinstellungen, dann klicken sie auf eine der folgenden Optionen, entweder für Benutzer- oder Systemvariablen:

Klicke Neu um eine neue Variable hinzuzufügen. Klicke eine bestehende Variable und dann auf Bearbeiten um den Variablennamen oder den Wert zu ändern. Klicke eine bestehende Variable und dann auf Löschen um die Variable zu entfernen.

../_images/umgebungsvariablen_pgconfdir.jpg

Sie können die Umgebungsvariablen auch in QGIS kontrollieren: Menü Einstellungen –> Optionen... –> System Tab –> Umgebung

In diesem Verzeichnis werden zwei Dateien sein

pg_service.conf
pgpass (Um das Passwort nicht jedes Mal eingeben zu müssen)

Achtung

In Windows müssen Sie pg_service.conf im Unix Format speichern damit es funktioniert. Eine Möglichkeit dafür bietet Notepad++ im Menü Bearbeiten –> Format Zeilenende –> Konvertiere zu UNIX (LF) –> Sichern` .

2.4.1.2. Linux/macOS pg_service

Auf Unix Systemen (linux/macOS etc.) platzieren Sie die Dateien .pg_service.conf` und .pgpass in ihren home folder (üblicherweise``/home/[username]``). Beachten Sie den . am Anfang (<> Windows)!

Wenn QGIS die .pg_service.conf Datei nicht findet, muss die Umgebungsvariable PGSYSCONFDIR definiert werden:

In QGIS gehe zu Einstellungen > Optionen... > System Tab. Fast zuunterst gibt es Umgebung. Klicke Benutzerdefinierte umgebungsvariablen verwenden und klicke auf plus auf der rechten Seite. Füge PGSYSCONFDIR als Variable ein and den Wert (vermutlich /home/[username] siehe oben). Dann klicke OK unten rechts.

Nachdem Schliessen und erneuten Starten von QGIS, sollte der Eintrag PGSYSCONFDIR zuunterst im gleichen Fenster unter Aktuelle Umgebungsvariablen sichtbar sein. .. figure:: images/macEnvVarCheck.png

2.4.1.3. Auf allen Systemen

Schreiben Sie folgenden Text in die Datei pg_service.conf oder .pg_service.conf. Allenfalls müssen Sie diesen für Ihre Installation adaptieren.

[pg_tww]
host=localhost
port=5432
dbname=tww
user=twwuser

Um das Passwort auch auf dem System zu speichern können Sie die Datei pgpass benutzen.

localhost:5432:*:twwuser:password

Bemerkung

Falls die Datenbank nicht auf dem lokalen Rechner läuft muss in den Anweisungen oben jeweils localhost mit der Netzwerkadresse des Datenbankservers ersetzt werden.

Alternative: Passwort direkt in die Datei pg_service.conf (in Windows) / .pg_service.conf (in Unix) eintragen:

[pg_tww]
host=localhost
port=5432
dbname=tww
user=twwuser
password=***

2.4.2. QGIS installieren

Minimum requirement 3.34.8
We recommend using the latest master build (called qgis-dev on Windows) which often offers a better experience in combination with TWW. For Windows installation, download the OSGeo4W Installer choose advanced installation and install qgis-dev.

2.4.3. Install TWW plugin

Plugin Voraussetzungen

networkx >= 3.3

You can install them on Debian based systems with:

sudo pip install networkx
sudo apt-get install libqt4-sql-psql

Or for Windows users, directly in QGIS via the Python Console with:

import pip; pip.main(["install", "networkx"])

QGIS öffnen
Gehen sie zu Erweiterungen
- Erweiterungen verwalten und installieren...
- Einstellungen
  - Auch experimentelle Erweiterungen anzeigen aktivieren
- Plugin aktivieren (siehe untenstehendes Bild)
- Alle
  - Search TWW
  - Aktivieren Sie das Kontrollkästchen daneben

../_images/001_searchplugin.jpeg — **Add the TWW plugin**

TWW uses a data historization process. The pg history viewer plugin allows you to view the changes made and replay some of them.

2.4.4. Demodaten installieren

as described here

2.4.5. Das Demo Projekt installieren

Download from https://github.com/TWW/tww/releases the qgs project file and its translations

project-translations.zip

Die Datei entpacken
If you leave the teksi_wastewater_[language].qm files in the same directory as the teksi_wastewater.qgs file and start QGIS with one of these languages, your project will be translated to that langue when you start the project. E.g. you start teksi_wastewater.qgs with a QGIS Installation that is set to German, then the teksi_wastewater.qgs project will appear in German.

Bemerkung

You need to explicitly set the language in QGIS in settings. If QGIS is configured to take the system language, the TWW translation is not loaded.

../_images/tww_project_qm_language_files.jpg

Open project-translations/teksi_wastewater.qgs with QGIS
Wenn Sie das Projekt speichern, wird die Sprache beibehalten und kann nicht mehr auf dieselbe Weise geändert werden.

2.4.6. Wenn Sie Datenherr sind: Die eigene OID in das Projekt eintragen

If you are a data owner (Datenherr), you should add your OID data in the table tww_sys.oid_prefixes:

Edit 02_oid_generation.sql with your OID if you want it permanently in the TWW project and hand in a pull request

https://github.com/TWW/datamodel/blob/master/02_oid_generation.sql

-- sample entry for the City of Uster - you need to add an entry for your own organization
INSERT INTO tww_sys.oid_prefixes (prefix,organization,active) VALUES ('ch11h8mw','Stadt Uster',TRUE);
INSERT INTO tww_sys.oid_prefixes (prefix,organization,active) VALUES ('ch15z36d','SIGE',FALSE);
INSERT INTO tww_sys.oid_prefixes (prefix,organization,active) VALUES ('ch13p7mz','Arbon',FALSE);

und setze die gewünschte OID für das aktuelle Projekt auf TRUE.

oder füge die OID für das Projekt in der Tabelle oid_prefix in der Zeile mit der id = 1 hinzu.
Ein OID-Prefix kann bestellt werden bei https://www.interlis.ch/en/dienste/oid-bestellen

Bemerkung

Wenn sie mit verschiedenen Datenbank für verschiedene Gemeinden arbeiten, sollten sie unterschiedliche OID Prefixe für jede Datenbank benützen.

2.4.7. Mit mehreren Datenbank-Operaten arbeiten

Eine neue Database in pgAdmin erzeugen mit neuem Namen, z.B. communityA
Create a new schema tww in this database (do not choose another name, because all scripts works with the schema-name tww)
Weiter wie in 1.2 Initialisierung der Datenbank beschrieben.
Die pg_service.conf - Datei anpassen

[pg_tww]
host=localhost
port=5432
dbname=tww
user=twwuser
[pg_communityA]
host=localhost
port=5432
dbname=communityA
user=twwuser

Search and replace in the copy of tww_en.qgs all ‚pg_tww‘ with ‚pg_communityA‘