16. Konfiguration GeoShop Products

16. Konfiguration GeoShop Products
Zurück		Weiter

16.1. Definition

Mit einem Product wird der Download von Daten definiert. Products werden Benutzern zugeordnet.

Product Definition

Die Products werden im GeoShop mit dem GeoShop Administrator unter Config > Products definiert.

Abbildung 36. GeoShop Administrator Products

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

GEOSHOP_DIR\user\products\<name>.pro

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

PRODUCT
   name STRING dxf_dm01
   display_name STRING 'AV DXF/DWG'
   models LIST
      MODEL
         name STRING DM01AVCH24D
         display_name STRING 'amtl. Vermessung'
         topics LIST
            STRING FixpunkteKategorie1
            STRING FixpunkteKategorie2
            STRING FixpunkteKategorie3
            STRING Liegenschaften
         }
      }
   }
   params MAP
      selection_type STRING POLYGON
      order_ra_option STRING ON
      order_la_options LIST
         STRING 'textfield,Verwendung *'
      }
      selection_options MAP
         format STRING 'choice,Fileformat,DXF,DWG'
      }
   }
   services MAP
      DM01AVCH24D MAP
         script STRING \script\il2dxf\DM01AVCH24D.cfg
         service STRING download
      }
   }
   price_function STRING \script\price\price.cfg,Tarifzonen
}

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

16.2. Eigenschaften

Products werden in Textfiles definiert und wie folgt abgelegt.

GEOSHOP_DIR\user\products\<name>.pro

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

Beschreibung Definition Product

Parameter	req/opt	Typ	Beschreibung
`PRODUCT`	`r`	`MAP`	Map mit Definition Product.

Beschreibung ParameterMAP PRODUCT

Parameter	req/opt	Typ	Beschreibung
`name`	`r`	`STRING`	Name der Products.
`display_name`	`o`	`STRING`	Displayname der Products.
`models`	`o`	`LIST`	Liste von Modellen mit Topics für Product.
`params`	`o`	`MAP`	Map von Parametern für Product.
`services`	`r`	`MAP`	Map von Services für Product zur Aufbereitung der Daten.
`price_function`	`o`	`STRING`	Preisfunktion für Product.

Beschreibung ParameterLIST PRODUCT.models

Parameter	req/opt	Typ	Beschreibung
`MODEL`	`r`	`MAP`	Definition eines Modelles.

Beschreibung ParameterMAP PRODUCT.models.MODEL

Parameter	req/opt	Typ	Beschreibung
`name`	`r`	`STRING`	Name des Modelles.
`display_name`	`o`	`STRING`	Displayame des Modelles.
`topics`	`o`	`LIST`	Liste der Topics des Modelles. Alle Einträge der Liste sind vom Typ `STRING` und führen die Topics des Modelles auf, die in diesem Product enthalten sein können.

Beschreibung ParameterMAP PRODUCT.params

Parameter	req/opt	Typ	Beschreibung
Selektionsbereich			Parameter für Selektionsbereich.
`selection_title`	`o`	`STRING`	Titel für Auswahl Selektionsbereich. Default: 'Selektionsbereich'
`selection_position`	`o`	`STRING`	`TOP\|BOTTOM\|OFF`. Position der Selektionbereich-Elemente. Mit `BOTTOM` wird die Selektion am Schluss der Produkt-Parameter aufgeführt.
`selection_type`	`o`	`STRING`	`OFF\|POLYGON\|BOX\|FORMATBOX`. Type des geometrischen Selektionbereiches. Default=`BOX`.
`selection_rotate`	`o`	`STRING`	`ON\|OFF`. Kann der Selektionsbereich rotiert werden. Default=`ON`.
`selection_formats`	`o`	`LIST`	Für `selection_type=FORMATBOX`. Liste von Maps mit Formaten. Siehe weiter unten.
`selection_formats_position`	`o`	`STRING`	`TOP\|BOTTOM\|OFF`. Für `selection_type=FORMATBOX`. Position der Format-Elemente. Mit `BOTTOM` werden die Format-Elemente am Schluss der Selektions-Elemente aufgeführt.
Topics			Parameter für Selektion Topics.
`topics_title`	`o`	`STRING`	Titel für Auswahl Topics. Default: 'Ebenen auswählen'.
`topics_visible`	`o`	`STRING`	`ON\|OFF`. Ist die Topicsauswahl sichtbar. Default=`ON`.
`topics_display`	`o`	`LIST`	Definiert zu einem Produkt die Displaynamen von Modellen und Topics. Mehere Modelle und/oder Topics können unter Displaynamen zusammengefasst werden. Zusätzliche Texte können definiert werden. Alle Einträge der Liste sind vom Typ `STRING`. Syntax `STRING '<label>:<definition>'` `<label> := topic\|text` `topic:<display-model>:<display-topic>;<model>:<topic>[,<topic>]` `text:<text>` `<display-model>` := Freier Text `<display-topic>` := Freier Text `<model>` := Ein extistierender Modelnamen für das Product. `<topic>` := Ein extistierender Topicnamen für das Product. `<text>` := Freier Text. Beispiel STRING 'topic:Amtl. Vermessung,Basisbezug;Grunddatensatz_ZH:Fixpunkte,... STRING 'topic:Amtl. Vermessung,weiteres;Grunddatensatz_ZH:Bodenbedeckung,... STRING 'text: Dies ist der Basisbezug'
`topics_preselected_choice`	`o`	`LIST`	Definiert zu einem Product vorselektierte Topics. Werden mit `topics_display` Displaynamen verwendet, so sind auch in diesen Definitionen die Displaynamen zu verwenden. Alle Einträge der Liste sind vom Typ `STRING`. Syntax `STRING '<model>:<topic>[,<topic>]'` `<model>` := Ein extistierender Modelnamen für das Product. `<topic>` := Ein extistierender Topicnamen für das Product. Beispiel STRING 'Grunddatensatz:Fixpunkte,Bodenbedeckung' oder mit Displaynamen aus `topics_display` STRING 'Amtl. Vermessung:Basisbezug,weiteres'
`topics_precelected_fixed`	`o`	`LIST`	Definiert zu einem Product fix selektierte Topics. Die Topics können nicht deselektiert werden. Syntax wie Parameter `topics_precelected_choice`
`topics_choice_dependence`	`o`	`LIST`	Definiert voneinander abhängige Topics für die Selektion. Wird ein Topic selektiert/deselektiert, so werden auch die abhängigen Topics selektiert/deselektiert. Werden mit `topics_display` Displaynamen verwendet, so sind auch in diesen Definitionen die Displaynamen zu verwenden. Alle Einträge der Liste sind vom Typ `STRING`. Syntax `STRING '<model>:<topic>[,<topic>][;<model>:<topic>[,<topic>]]'` `<model>` := Ein extistierender Modelnamen für das Product. `<topic>` := Ein extistierender Topicnamen für das Product. Beispiel STRING 'Grunddatensatz:Fixpunkte,Bodenbedeckung' oder mit Displaynamen aus `topics_display` STRING 'Amtl. Vermessung:Basisbezug,weiteres'
Options			Parameter für weitere Optionen.
`selection_options_title`	`o`	`STRING`	Titel für Optionen. Default: 'Optionen'.
`selection_options`	`o`	`MAP`	Definiert weitere Optionen in einer MAP. Alle Einträge der Map sind vom Typ `STRING`. Syntax `<option> STRING '<type>,<label>[,<value>[,<value>]]'` `<option> := Freier Name.` `<type> := choice\|choice2\|textfield\|checkbox` `<label>` := Freier Text. `<value>` := Freier Text für eventuelle Werte für die Option. `choice`,<label>,<value>[,<value>]\|<select statement> Auswahl von fixen Werten oder aus einer Datenbanktabelle. Das select statement beinhaltet 1 Rückgabewerte. `choice2`,<label>,<value>[,<value>]\|<select statement> Auswahl von fixen Werten oder aus einer Datenbanktabelle. Das select statement beinhaltet 2 Rückgabewerte. Der erste Wert wird displayed, der zweite Wert wird der Option zugewiesen. `textfield`,<label> Freies Textfeld. `checkbox`,<label> Checkbox. Beispiel auswahl1 STRING 'choice,Auswahl1,Wert1,Wert2' auswahl2 STRING 'choice,Auswahl2,select Nummer from GS_Parzelle' auswahl3 STRING 'choice2,Auswahl3,select Gemeinde,Prefix from GS_Gmd' auswahl4 STRING 'textfield,Auswahl4' auswahl5 STRING 'checkbox,Auswahl5' Option Der selektierte Wert einer Option steht in der weiteren Verarbeitung des Produktes für die Konfigurationen wie folgt zur Verfügung. `OPT.selection_<option>` Beispiel: `OPT.selection_auswahl1 = 'Wert1'`
Information			Parameter für weitere Informationen.
`info_product`	`o`	`STRING`	Relative oder absoulte URL zu einer HTML-Seite mit Produktinformationen. Falls definiert erscheint bei der Produkteauswahl ein Infobutton mit einem Link. Beispiel: `/info/infoproducts.html` Bei relativer URL muss die Seite muss wie folgt abgelegt sein. `GEOSHOP_DIR\user\www\info\infoproducts.html`
`info_nutzungsbestimmungen`	`o`	`STRING`	Relative oder absoulte URL zur HTML-Seite mit Nutzungsbestimmungen. Falls definiert erscheint nach der Produkteauswahl und nach einer eventuellen Preisberechnung eine Seite mit den Nutzungbestimmungen. Falls die URL auf ein Textfile (.txt) zeigt, wird direkt der Text angezeigt. Falls die URL auf eine HTML-Seite (.html) zeigt, erscheint ein Infobutton mit einem Link auf die HTML-Seite. Beispiel: `/info/nutzungsbestimmungen.html` Bei relativer URL muss die Seite muss wie folgt abgelegt sein. `GEOSHOP_DIR\user\www\info\nutzungsbestimmungen.html`
`info_policy`	`o`	`STRING`	Relative oder absoulte URL zur HTML-Seite mit der Policy. Falls definiert erscheint bei der Eingabe der Bestellinformationen ein Infobutton. Beispiel: `/info/policy.html` Bei relativer URL muss die Seite muss wie folgt abgelegt sein. `GEOSHOP_DIR\user\www\info\policy.html`
Order			Parameter für weitere Informationen für Bestellung.
`order_la_options`	`o`	`LIST`	Liste von weiteren Eingabefelderen für Bestellinformation. Alle Einträge der List sind vom Typ `STRING` . Syntax `STRING '<type>,<label[]>[,<value>[,<value>]]'` `<type> := choice\|textfield` `<label[]>` := Freier Text. Ein * markiert ein Mussfeld. `<value>` := Freier Text für eventuelle Werte für die Option. `choice`,<label>,<value>[,<value>] `textfield`,<label> Beispiel STRING 'textfield,Verwendung *' Option Der selektierte Wert einer Option steht in der weiteren Verarbeitung des Produktes für die Konfigurationen wie folgt zur Verfügung. `OPT.delivery_la<label>` Beispiel: `OPT.delivery_laverwendung = 'Baueingabe'` Alle Optionen der Lieferadresse stehen in folgender Form zur Verfügung. `OPT.deliverey_la<option>`
`order_ra_option`	`o`	`STRING`	`ON\|OFF`. Soll bei der Eingabe der Lieferadresse eine Checkbox erscheinen, über die eine Rechnungsadresse eingegeben werden kann. Default = `OFF` . Option Alle Optionen der Rechnungsadresse stehen in folgender Form zur Verfügung. `OPT.deliverey_ra<option>`
`product_la_trailer`	`o`	`LIST`	Weitere Informationen, die am Ende des Menüs für die Lieferadresse angezeigt werden. Alle Einträge der Liste sind vom Type `STRING`. Syntax `STRING '<value>]'` `<value>` := Freier Text. Beispiel STRING 'Bei Fragen melden Sie sich bitte bei uns'
Weiteres			Parameter Weitere
`product_trailer`	`o`	`LIST`	Weitere Informationen, die am Ende des Menüs des Produktes angezeigt werden. Alle Einträge der Liste sind vom Type `STRING`. Syntax `STRING '<value>]'` `<value>` := Freier Text. Beispiel STRING 'Dies ist ein tolles Produkt'
`view`	`o`	`STRING`	View der Datensicht, die bei der Selektion des Produktes eingestellt werden soll.

Beschreibung ParameterMAP PRODUCT.params.selection_formats (Format)

Parameter	req/opt	Typ	Beschreibung
`format`	`r`	`STRING`	`A0\|A1\|A2\|A3\|A4`. Name des Formats. Die Option steht als `OPT.selection_format` zur Weiterverarbeitung zur Verfügung.
`orientations`	`o`	`STRING`	`[quer][,][hoch].` Möglich Orientierungen des Formats. Die Option steht als `OPT.selection_formatorientation` zur Weiterverarbeitung zur Verfügung.
`scales`	`r`	`STRING`	`[1:250[,1:500].` Möglich Massstäbe des Formats. Die Option steht als `OPT.selection_scale` zur Weiterverarbeitung zur Verfügung.
`format_default`	`o`	`STRING`	`ON\|OFF.` Dies ist das Default-Format.
`orientation_default`	`o`	`STRING`	`quer\|hoch.` Dies ist das Default-Orientierung.
`scale_default`	`o`	`STRING`	Dies ist der Default-Massstab. Ein Wert aus `scales` .
`layout_itf,` `<format>,` `<orientation>,` `<scale>`	`o`	`STRING`	INTERLIS-itf-File mit Layoutdefinition für die Darstellung des Formates im GeoShop Client. Das INTERLIS-itf-File beinhaltet den Layout im Modell PlotLayout vor. Die Layoutdefinition kann in Abhängigkeit der Kombination `<format>,<orientation>,<scale>` definiert. Anstelle der Werte kann auch `` verwendet werden. Das INTERLIS-itf-File wrd relativ definiert. Beispiel `layout_itf,A4,quer,1:250 STRING '\plot\a4q250.itf'` `layout_itf,A4,quer, STRING '\plot\a4q.itf'` `layout_itf,A4,* STRING '\plot\a4.itf'` Die INTERLIS-itf-Files müssen entsprechend der Definition abgelegt sein. `GEOSHOP_DIR\user\plot\*.itf`
`layout_def,` `<format>,` `<orientation>,` `<scale>`	`o`	`MAP`	Alternative zu `layout_itf,...` . Die Layout Definition erfolgt anstelle des INTERLIS-itf-File mittels einer Map. Die Definition `<format>,<orientation>,<scale>` ist analog zu zu `layout_itf,...` . Die Map beinhaltet folgende Definitionen. MAP `scale STRING <scale>` `layout_scale STRING <layout_scale>` `clip_area STRING <clip_area>` <scale> Für welchen Scale die Definitionen gilt. `<layout_scale>` In welchem Scale die `clip_area` definiert ist. `<clip_area>` Geschlossenes Polygon für den Clip-Bereich, repektive Datenbereich in der Form `x1,y1,.....xi,yi,.....xn,yn` Beispiel `layout_itf,A4,hoch,* MAP` `scale STRING 1:500` `layout_scale STRING 1:500` `clip_area STRING '0.01,0.01,0.20,0.01,0.20,0.28, ....` `... 0.01,0.28,0.01,0.01)` `}` Die `clip_area` im Beispiel ist für den Massstab `scale=1:500` definiert. Die `clip_area` im Beispiel oben ist in Zentimeter definiert. Deshalb muss auch der `layout_scale=1:500` mit definiert werden.

16.3. Preisberechnung

Die Preisberechnung für ein Produkt erfolgt über eine Konfiguration, die durch den Parameter price_function definiert wird. Die Preisberechnung ist im Dokument Verrechnungsmodul beschrieben.

16.4. Bestelldaten

Betsellungen werden Defaultmässig an zwei Stellen abgelegt.

Pro Bestellung erfolgt eine Ablage des Bestellung in einem Textfile mit dem Namen der Bestellnummer <orderno> . Das File beinhaltet Infomationen für den GeoShop zur Abwicklung des Jobs für die Bestellung.

GEOSHOP_DIR\data\orders\<orderno>

Dazu wird in der Datenbank in der Tabelle GS_Order pro Bestellung ein Record eingetragen.

GEOSHOP_DIR\data\dba\geoshop.mdb!GS_Order

Falls zusätzliche Informationen, zum Beispiel aus einer speziellen Preisberechnung in der Datenbank abgelegt werden sollen, kann eine separate Tabelle mit den Erweiterungen für die Bestellungen in der Datenbank angelegt werden. Dies ist in der Dokumentation des Verechnungmouls beschrieben.

Zurück		Weiter
15. Konfiguration GeoShop Queries	Zum Anfang	17. Konfiguration GeoShop Plot