2.4. Arbeitsplatzrechner Einrichten

2.4.1. Konfiguration der Datenbank

Um einer Arbeitsstation zu sagen, wo sich die Datenbank befindet (im lokalen System oder auf einem Netzwerkserver) müssen Sie zu Beginn auf jedem System auf dem QGIS/QGEP läuft (Client), einige Dateien erzeugen. Die muss nicht auf dem Server selber gemacht werden.

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_qgep]
host=localhost
port=5432
dbname=qgep
user=qgepuser

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

localhost:5432:*:qgepuser: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_qgep]
host=localhost
port=5432
dbname=qgep
user=qgepuser
password=***

2.4.2. QGIS installieren

minimale Voraussetzung 3.4
Wir empfehlen die Verwendung der aktuellsten master builds (unter Windows sind diese als qgis-dev verfügbar). Diese offerieren oft die beste Integration in Kombination mit QGEP. Für die Windows Installation, laden sie den OSGeo4W Installer runter und wählen SIe advanced Installation und installieren Sie qgep-dev.

2.4.3. Installation des QGEP Plugins

Plugin Voraussetzungen

networkx >= 2.1

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
  - QGEP suchen
  - Aktivieren Sie das Kontrollkästchen daneben

../_images/001_searchplugin.jpeg — **QGEP Zusatzprogramm hinzufügen**

QGEP verwendet einen Datenhistorisierungsprozess. Das pg history viewer plugin ermöglicht es Ihnen, die vorgenommenen Änderungen zu sehen und einige von ihnen wiederzugeben.

2.4.4. Demodaten installieren

as described here

2.4.5. Das Demo Projekt installieren

qgep.zip von https://github.com/QGEP/qgep/releases/latest herunterladen
Die Datei entpacken
Wenn Sie die qgep_[language].qm Dateien im gleichen Verzeichnis wie die qgep.qgs Datei belassen und QGIS mit einer dieser Sprachen starten, wird Ihr qgep-Projekt in diese Sprache übersetzt, wenn Sie das Projekt starten. Wenn Sie z.B. qgep.qgs mit einer QGIS Installation starten, die auf Deutsch eingestellt ist, dann wird das qgep.qgs Projekt in Deutsch erscheinen.

Bemerkung

Sie müssen die Sprache in QGIS explizit in den Einstellungen festlegen. Wenn QGIS so konfiguriert ist, dass es die Systemsprache übernimmt, wird die QGEP-Übersetzung nicht geladen.

../_images/qgep_project_qm_language_files.jpg

Öffnen Sie project/qgep.qgs mit 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

Wenn Sie Datenherr (data owner) sind, sollten Sie Ihre OID Daten in der Tabelle qgep_sys.oid_prefixes hinzufügen:

Fügen Sie Ihre OID zu 02_oid_generation.sql hinzu und machen Sie einen pull request, wenn Sie sie permanent im QGEP Projekt haben wollen.

https://github.com/QGEP/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 qgep_sys.oid_prefixes (prefix,organization,active) VALUES ('ch11h8mw','Stadt Uster',TRUE);
INSERT INTO qgep_sys.oid_prefixes (prefix,organization,active) VALUES ('ch15z36d','SIGE',FALSE);
INSERT INTO qgep_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
Ein neues Schema qgep in der Database erstellen (den Namen qgep nicht ändern, da in vielen Scripten der Schemanamen qgep verwendet wird)
Weiter wie in 1.2 Initialisierung der Datenbank beschrieben.
Die pg_service.conf - Datei anpassen

[pg_qgep]
host=localhost
port=5432
dbname=qgep
user=qgepuser
[pg_communityA]
host=localhost
port=5432
dbname=communityA
user=qgepuser

In einer Kopie des Projektdatei qgep_en.qgs alle Vorkommnisse von ‚pg_qgep‘ suchen und mit ‚pg_communityA‘ ersetzen