13. Konfiguration GeoShop Users

13.1. Definition

Mit einer Userdatei wird ein Benutzer definiert, der Zugriff auf die Daten im GeoShop hat. Die Definition eines Benutzers umfasst neben dem Benutzernamen mit einem Passwort diverses Eigenschaften und Berechtigungen.

Übersicht Eigenschaften und Berechtigungen

User können diverse Eigenschaften zugeordnet werden. Diese Eigenschaften lassen sich wie folgt gruppieren.

general

Authentifizierung und generelle Eigenschaften.

privileges

Privilegien, respektive Rechte eines Users wie zum Beispiel das Recht auf Objektabfragen

views

Zugeteilte Sichten auf die Daten für den User.

queries

Zugeteilte Suchabfragen auf die Daten für den User.

products

Zugeteilte Produkte der Daten für den User.

preferences

Präferenzen eines Users wie zum Beispiel der Auschnitt der Daten beim Starten des GeoShop Clients.

file_filter

Filter für Zugriff des Users auf die Daten.

Mit diesen Eigenschaften und Berechtigungen können User individuell konfiguriert werden. Dabei können folgende typische GeoShop User unterschieden werden.

Übersicht typische GeoShop User
User Typ Administrator

Dieses User administriert den GeoShop. Auch der Administrator ist ein GeoShop User.

User Typ Ordermanager

Diese User managed die eingegangenen Bestellungen. Auch der Ordermanager ist ein GeoShop User.

User Typ Viewer

Dies sind User, die mit dem GeoShop Client die Daten viewen können, aber keine Datendownloads durchführen können.

User Typ Download

Dies sind User, die mit dem GeoShop Client die Daten viewen können und Datendownloads über Produkte durchführen können.

User Typ Upload

Dies sind User, die Datenuploads in den GeoShop durchführen.

Ein User Definition wird wie folgt durchgeführt.

User Definition

User werden im GeoShop mit dem GeoShop Administrator unter Users kreiert und administriert

Abbildung 32. GeoShop Administrator Users

GeoShop Administrator Users

User Definitionen werden im GeoShop in Textfiles an folgender Stelle abgelegt.

GEOSHOP_DIR\user\users\<name>.pro

Der Inhalt einer User Definitionen sieht als Beispiel wie folgt aus.

USER
   name STRING myuser
   password STRING abc123
   privileges LIST
      STRING client
      STRING print
      :
   }
   views LIST
      STRING av
      :
   }
   queries LIST
      STRING gebaeude
      :
   }
   products LIST
      STRING dxf_dm01
      :
   }
   preferences MAP
      order.adr1 STRING ''
      :
   }
   file_filter MAP
   }
}

Die Definition eines Users ist vollständig im GeoShop Administrator Benutzerhandbuch definiert.

Views, Queries und Products sind wiederum GeoShop Definitionen, die in nachfolgenden Kapiteln beschrieben werden. Diese Anteile werden über die Namen den Users zugeordnet.

13.2. Eigenschaften

Users werden in Textfiles definiert und wie folgt abgelegt.

GEOSHOP_DIR\user\users\<name>.usr

Folgende Eigenschaften können für User konfiguriert werden.

Beschreibung Definition User
Parameterreq/optTypBeschreibung
USERrMAPMap mit Definition User.
Beschreibung Parameter MAP USER
Parameterreq/optTypBeschreibung
namerSTRINGName des Users.
passwordrSTRINGPassword des Users.
based_onoSTRING

Name des Basisusers. User übernimmt alle Definitionen dieses Users.

prefixoSTRING
Bedeutung für Benutzer Viewen/Download:

Benutzer hat nur Zugriff auf Datenfiles mit diesem Prefix. Mehrere Prefixes können kommasepariert angegeben werden.

Bedeutung Benutzer Upload:

Jedes Datenfile, dass der Benutzer uploaded erhält diesen Prefix.

download_diroSTRING

Lokales Directory für Downloads.

privilegesoLIST

Liste von Privilegien.

viewsoLIST

Liste von Views.

queriesoLIST

Liste von Queries.

productsoLIST

Liste von Products.

preferencesoMAP

Map von Preferenzen.

file_filteroMAPMap von Filefiltern pro Modell. Verfeinerung des Parameter prefix .
Beschreibung Parameter LIST USER.privileges
Parameterreq/optTypBeschreibung
adminoSTRINGBerechtigung als Administrator.
orderoSTRINGBerechtigung als Ordermanager.
clientoSTRING

Berechtigung als User für GeoShop Client.

multioSTRING

Der Benutzer kan sich mehrmals einloggen.

change_passwordoSTRING

Der Benutzer kann das Passwort ändern.

install_modelloSTRING

Berechtigung zum Upload eines INTERLIS Modelles.

install_productoSTRING

Berechtigung zum Upload eines Produktes.

install_scriptoSTRING

Berechtigung zum Upload eines Scripts.

infooSTRING

Berechtigung für Objektabfragen.

magnifieroSTRING

Berechtigung für Lupe.

measureoSTRINGBerechtigung für Messfunktionen.
plotoSTRINGBerechtigung für Plots.
printoSTRINGBerechtigung für Prints.
uploadoSTRINGBerechtigung zum Upload von Daten aller Modelle.
upload_<Model>oSTRINGBerechtigung zum Upload von Daten im INTERLIS Modell <Model>.
Beschreibung Parameter LIST USER.views
Parameterreq/optTypBeschreibung
<Viewname A>oSTRINGView steht Benutzer zur Verfügung.
<Viewname N>oSTRINGView steht Benutzer zur Verfügung.
<Viewname Z>oSTRING

View steht Benutzer zur Verfügung.

Beschreibung Parameter LIST USER.queries
Parameterreq/optTypBeschreibung
<Queryname A>oSTRINGQuery steht Benutzer zur Verfügung.
<Queryname N>oSTRINGQuery steht Benutzer zur Verfügung.
<Queryname Z>oSTRING

Query steht Benutzer zur Verfügung.

Beschreibung Parameter LIST USER.products
Parameterreq/optTypBeschreibung
<Productname A>oSTRINGProduct steht Benutzer zur Verfügung.
<Productname N>oSTRINGProduct steht Benutzer zur Verfügung.
<Productname Z>oSTRING

Product steht Benutzer zur Verfügung.

Beschreibung Parameter MAP USER.preferences
Parameterreq/optTypBeschreibung
order.name1oSTRINGName 1 für Bestellungen.
order.name2oSTRINGName 2 für Bestellungen.
order.adr1oSTRING

Adresse 1 für Bestellungen.

order.adr2oSTRING

Adresse 2 für Bestellungen.

order.zipoSTRING

Postleitzahl für Bestellungen.

order.cityoSTRING

Ort für Bestellungen.

order.countryoSTRING

Land für Bestellung.

order.teloSTRING

Telefon für Bestellungen.

order.faxoSTRING

Fax für Bestellungen.

order.emailoSTRINGEMail für Bestellungen.
order.remarkoSTRINGBemerkung für Bestellungen.
range.minXoREALMinimum X für Datensicht beim Einstieg in GeoShop Client.
range.minYoREALMinimum Y für Datensicht beim Einstieg in GeoShop Client.
range.maxXoREALMaximum X für Datensicht beim Einstieg in GeoShop Client.
range.maxYoREALMaximum Y für Datensicht beim Einstieg in GeoShop Client.
overview.minXoREALMinimum X für Übersicht in GeoShop Client.
overview.minYoREALMinimum Y für Übersicht in GeoShop Client.
overview.maxXoREALMaximum X für Übersicht in GeoShop Client.
overview.maxYoREALMaximum Y für Übersicht in GeoShop Client.
overview.viewoSTRINGView für Übersicht in GeoShop Client.
measure.accuracyoREALGenauigkeit für Messfunktionen.
search.queryoSTRINGDefault Queryname für Suchabfragen.
upload.<model>_extensiono<STRING>Die Files des Models haben diese Extension. Nur von Bedeutung falls Benutzer Daten uploaden kann.
upload.incrementalo<STRING>ON|OFF. Die Daten werden nur geladen, wenn Sie unterschiedlich zur letzten Lieferung sind. Nur von Bedeutung falls Benutzer Daten uploaden kann.
upload.emailo<STRING>Diese Email erhält Mails über erfolgte Uploads. Nur von Bedeutung falls Benutzer Daten uploaden kann.
<name>o<TYPE>Beliebige weitere Parameter zur späteren Verwendung in Scripts.
Beschreibung Parameter MAP USER.file_filter
Parameterreq/optTypBeschreibung
<Modell A>oSTRINGUser hat nur auf Daten (Files) des Modelles mit diesem Prefix Zugriff.
<Modell N>oSTRINGUser hat nur auf Daten (Files) des Modelles mit diesem Prefix Zugriff.
<Modell Z>oSTRING

User hat nur auf Daten (Files) des Modelles mit diesem Prefix Zugriff.

13.3. Parameter based_on

Der Parameter based_on bietet die Möglichkeit, für typische Benutzer oder Benutzergruppen einen Basisuser zu definieren, und diesen bei konkreten Benutzern einzubinden.

Beispiel eines Basisusers.

USER
   name STRING basedownload
   password STRING abc123
   privileges LIST
      STRING client
      STRING print
      STRING measure
      STRING info
      STRING multi
      STRING plot
      STRING magnifier
   }
   views LIST
      STRING av
      :
   }
   queries LIST
      STRING strasse
      :
   }
   products LIST
      STRING dxf_dm01
      :
   }
   preferences MAP
      overview.maxX REAL 678600.0
      overview.maxY REAL 247600.0
      overview.minX REAL 672900.0
      overview.minY REAL 242600.0
      overview.view STRING overview
      range.maxX REAL 675859.7615546219
      range.maxY REAL 245435.00000000003
      range.minX REAL 675766.2384453781
      range.minY REAL 245364.0
      search.query STRING strasse
   }
}

Der Basisuser definiert alle Privilegien, Views, Queries, Products und Preferences für eine Gruppe von konkreten Users.

Ein konkreter User beinhalten mit based_on den Basisusers und definiert nur noch veränderte und zusätzliche Parameter.

USER
   name STRING myuser
   password STRING abc123
   based_on STRING basedownload
   preferences MAP
      order.name1 STRING 'Firma AG'
      order.name2 STRING 'Peter Muster'
      order.adr1 STRING 'Bahnhofstrasse 1'
      order.adr2 STRING 'Postfach'
      order.zip STRING '8001'
      order.city STRING 'Zürich'
      order.country STRING 'Schweiz'
      order.email STRING 'peter.musert@firma.ch'
      order.tel STRING '044 123 56 78'
      order.fax STRING '044 123 56 79'
   }
}

13.4. User Typ Administrator

Ein GeoShop User vom Typ Administrator kann über den GeoShop Administrator den GeoShop administrieren und konfigurieren.

Die Definition des GeoShop Administrators bedingt folgender Konfiguration des Users.

USER
   name STRING Administrator
   password STRING abc123
   privileges LIST
      STRING admin
      STRING upload
   }
}

13.5. User Typ Ordermanager

Ein GeoShop User vom Typ Odermanager kann über den GeoShop Ordermanager Bestellungen administrieren.

Die Definition des GeoShop Ordermanagers bedingt folgender Konfiguration des Users.

USER
   name STRING Order
   password STRING abc123
   privileges LIST
      STRING order
   }
}

13.6. User Typ Viewer

Ein GeoShop User vom Typ Viewer wird in der Regel für einen öffentlichen Zugang zum Viewen der Daten mit dem GeoShop Client definiert. Dieser Type hat meist reduzierte Berechtigungen und kann insbesondere keine Daten downloaden (ausser eventuell speziellen Produkten).

Die Definition eines GeoShop Viewers kann wie folgt aussehen.

USER
   name STRING public
   password STRING public
   privileges LIST
      STRING client
      STRING print
      STRING measure
      STRING multi
      STRING plot
      STRING magnifier
   }
   views LIST
      STRING av
      STRING overview
   }
   queries LIST
      STRING strasse
      STRING gebaeude
      STRING xy
   }
   preferences MAP
      order.adr1 STRING ''
      order.adr2 STRING ''
      order.city STRING ''
      order.country STRING ''
      order.email STRING ''
      order.fax STRING ''
      order.name1 STRING ''
      order.name2 STRING ''
      order.remark STRING ''
      order.tel STRING ''
      order.zip STRING ''
      range.maxX REAL 675859.7615546219
      range.maxY REAL 245435.00000000003
      range.minX REAL 675766.2384453781
      range.minY REAL 245364.0
      overview.maxX REAL 678600.0
      overview.maxY REAL 247600.0
      overview.minX REAL 672900.0
      overview.minY REAL 242600.0
      overview.view STRING overview
      search.query STRING strasse
   }
}

Das Beispiel oben definiert einen User der reduzierte Privilegien, eingeschränkte Datensichten, eingeschränkte Suchabfragen und keine Produkte zum Download von Daten aufweist.

Damit man sich unter einem öffentlichen Viewer nicht einzuloggen braucht, kann man in einem Link für den GeoShop Client den User und das Password als Argumente mitgegeben:

http://localhost:3501/geoshop/client.html?user=public&password=public

13.7. User Typ Download

Ein GeoShop User vom Typ Download kann über Produkte Daten vom GeoShop downloaden. Dieser Typ beinhaltet in der Liste der Produkte, die Produkte die er downloaden kann. In der Regel sind dies dem Betreiber des GeoShop bekannte Benutzer.

Die Definition eines GeoShop Download Users kann wie folgt aussehen.

USER
   name STRING myuser
   password STRING abc123
   privileges LIST
      STRING client
      STRING print
      STRING measure
      STRING info
      STRING multi
      STRING plot
      STRING magnifier
   }
   views LIST
      STRING av
      STRING lk
      STRING overview
      STRING wms
   }
   queries LIST
      STRING gebaeude
      STRING gps
      STRING parzelle
      STRING strasse
      STRING xy
   }
   products LIST
      STRING dxf_dm01
      STRING dxf_plot
      STRING dxf_sia405
   }
   preferences MAP
      order.name1 STRING 'Firma AG'
      order.name2 STRING 'Peter Muster'
      order.adr1 STRING 'Bahnhofstrasse 1'
      order.adr2 STRING 'Postfach'
      order.zip STRING '8001'
      order.city STRING 'Zürich'
      order.country STRING 'Schweiz'
      order.email STRING 'peter.musert@firma.ch'
      order.tel STRING '044 123 56 78'
      order.fax STRING '044 123 56 79'
      order.remark STRING ''
      overview.maxX REAL 678600.0
      overview.maxY REAL 247600.0
      overview.minX REAL 672900.0
      overview.minY REAL 242600.0
      overview.view STRING overview
      range.maxX REAL 675859.7615546219
      range.maxY REAL 245435.00000000003
      range.minX REAL 675766.2384453781
      range.minY REAL 245364.0
      search.query STRING strasse
   }
}

Wenn der Benutzer bekannt ist, können auch die Adressangaben bereits definiert werden. Dadurch braucht der Benutzer nicht nach jedem Einloggen seine Daten einzugeben.

13.8. User Typ Upload

Ein GeoShop User vom Typ Upload kann über ftp oder dem GeoShop Uploadmanager Daten in den GeoShop laden. Upload User sind Datenlieferanten des GeoShop.

Die Definition eines GeoShop Upload Users kann wie folgt aussehen.

USER
   name STRING upload
   password STRING abc123
   perfix STRING firma_
   privileges LIST
      STRING upload_DM01AVCH24D
   }
   preferences MAP
      upload.DM01AVCH24D_extensions STRING itf
      upload.incremental STRING on
      upload.email STRING 'peter.musert@firma.ch'
   }
}

Das Beispiel definiert einen Upload User der Daten des Modelles DM01AVCH24D in den GeoShop laden kann. Alle Files, die dieser User in den GeoShop lädt, erhalten den definierten Prefix. Der Zugriff auf die Daten kann über diesen Prefix für andere Benutzer gesteuert werden.