Iwan7 - Konfiguration

Die Konfiguration ist minimal. Der Port und das Basis-Verzeichnis wird beim Starten übergeben (entweder interaktiv oder als Dienst-Argument).

Folgende Parameter müssen angegeben werden:

-port: Die Portnummer, an der der Http Listener läuft (empfohlener Wert: 8287)

-baseDir: Das Basis-Verzeichnis für die (Projekt) Konfigurationsdateien

Globale Standard-Parameter

Zur Laufzeit können diese Parameter durch Aufruf an /config modifiziert werden.

Wenn die Werte null sind (empfohlen), werden die "besten" Standardeinstellungen gesetzt. Diese können sich von Version zu Version unterscheiden.

{
    /*
    Trace-Level (TraceError)
    einer der Werte: 
       TraceNone
	   TraceWarning,
	   TraceError,
	   TraceInfo,
	   TraceDebug,
	   TraceDetail,
	   TraceDetailEx
    */
    
    "traceLevel": null,

    /*
    Zeichen-Modi (UseVectorQueue,RenderLayersParallel)
    eine Kombination der Wert:
        NoParallel
        RenderLayersParallel,
        UseVectorQueue,
        DebugRenderSkipVRendering
    */

    "renderMode":null,

    /*
    Optimierung für komplexe Polygone (true) (siehe ShapeFile)
    */
    
    "enableComplexPolyRenderCache":null,

    /*
    Internes Connection-Pooling für PostgreSQL (true)
    */
   "enablePostgresConnectionPool":null,

    /*
    Maximale Byte-Größe der für den Abruf eines Legendenbildes.
    Der Standardwert sind 5 MByte (= 5242880)
    */
    
    "maxLegendImageByteSize":null,

    /*
    Grafik-Engine (Agge)
    einer der Werte:
        GdiPlus,
        Direct2d,
        Agge    
    */

    "renderEngine":null

    /*
    Objekt, mit Proxy-Einstellungen (*1)

     {
        proxyUri:"http://localhost:8888",
        useDefaultProxy:false,
        proxyBypassList:null,
        proxyCredentials:{
            "userName":"usr",
            "passWord":"\encrypted..."
           }
     }
    */

    "defaultProxy": null

    /*
    Liste mit Bounding-Boxes, die für das Schätzen von EPSG Codes verwendet wird.
    Wenn nicht angegeben, dann sind dies die Standardwerte: (siehe unten unter CRSEstimates):
    */
    "CRSEstimates":null

    /*
    Anzahl der Worker-Threads, der Standardwert sind 64
    Bei 0 entsprechend der CPU Zahl des Servers
    */
     "ThreadPoolSize":null
}

(*1) Die Proxy-Einstellungen werden derzeit noch nicht verwendet und sind für zukünftige Anwendungszwecke gedacht.

Projektspezifische Konfigurationen

Projekte dienen der Isolation von Ebenen untereinander. Meist ist solch ein Projekt mit einer cardo Instanz assoziiert. Der Projektname kann/muss in jedem Request mit übergeben werden.

Die Projektdateien sind ebenfalls im baseDir zu finden. Der Name der Datei ist immer in der Form .config anzugeben.

Ein Sonderfall ist dabei die Datei $default.config.

Beim Starten des Servers werden alle *.config Dateien in baseDir eingelesen. Die so ermittelten Dateien definieren gleichzeitig die verfügbaren Projektnamen.

{
     "workingDir":null,
     "tempDir":null,
     "projectBBox":null
}

• workingDir: Das Arbeitsverzeichnis, relative Pfadangaben werden zu diesem ausgewertet, wenn nicht angegeben, dann identisch mit baseDir

• tempDir: Verzeichnis für temporäre Dateien, wenn nicht angegeben, dann wird workingDir/tempFiles angenommen.

• projectBBox: Die Standard-Boundingbox für das jeweilige Projekt als Objekt in der Form {minx, "miny":number,"maxx":number,"maxy":number,"epsgCode":number} Geplant ist, beim Rendern den Pinsel-Ursprung auf die linke untere Ecke dieser Boundingbox auszurichten.

• logonUserName,logonUserPassword: Ein Windows Benutzer-Account, der für die impersonisierung des Arbeits-Threads bei Aufrufen an dieses Project verwendet werden soll. Das Kennwort für den logonUserName, kann auch als EncryptedString angegeben werden.

nur in der $default.config:

• allowAccessToUndefinedProjects: Wenn false (der Standardwert), dann wird bei Aufrufen an an nicht vorhandenes Projekt der Fehler "Es ist keine Definition für ein Projekt XY vorhanden" ausgelöst.

• CRSEstimates: Hiermit kann die Liste für die auto-Ermittlung der EPSG Codes explizit angegeben werden. Zum Testen kann /json/estimateCrs/ verwendet werden (Bsp.: http://localhost:8287/iwan/json/estimateCrs?x=12&y=51).

  Die Einstellungen werden nur bei json/WriteConfig oder beim Serverstart ausgelesen. Alternativ kann mit Aufruf von json/reloadConfig das Neuladen ausgelöst werden.

  Die Standardwerte sind:

  {
       "useFallbackIfNotFound":false,
        "bbox":[
    	    {"epsgCode":31468,"minx":4300000,"maxx":4999999    ,"miny":0,"maxy":0},
    	    {"epsgCode":31469,"minx":5000000,"maxx":5999999    ,"miny":0,"maxy":0},
    	    {"epsgCode":25833,"minx":200000 ,"maxx":599999     ,"miny":0,"maxy":0},
    	    {"epsgCode":25832,"minx":600000 ,"maxx":801486     ,"miny":0,"maxy":0},
    	    {"epsgCode":31467,"minx":3200000,"maxx":3700000    ,"miny":0,"maxy":0},
    	    {"epsgCode":4326 ,"minx":-180,"maxx":180           ,"miny":0,"maxy":0},
    	    {"epsgCode":4647 ,"minx":32354333,"maxx":32683279  ,"miny":0,"maxy":0},
    	    {"epsgCode":5650 ,"minx":33000000,"maxx":33900000  ,"miny":0,"maxy":0},
    	    {"epsgCode":3068 ,"minx":2816.9273,"maxx":49855.0971,"miny":300.1350,"maxy":39377.9521},
        ]
    }
  

  Bei der Auswertung gilt: Wenn die Werte der Achse 0 sind, gilt der vergleich aus "Wahr" (minx=0, maxx=0 => keine Auswertung in x-Richtung, gleiches für y).

  Wenn useFallbackIfNotFound:true angegeben wird und in den eigenen Einstellungen kein Treffer ermittelt wird, wird mit dem hier gezeigtem Standardwerten weiter gesucht.

  Wenn der epsgCode 0 definiert wird, dann gilt die Projektion als nicht-erkannt. Damit kann für Konfliktsituationen die Schätzung deaktiviert werden.

  Das Gleiche gilt, wenn das Array der BBox-Liste leer ist und useFallbackIfNotFound:true angegeben wird. Damit kann die automatische Schätzung faktisch deaktiviert werden.

  Als Zusammenfassung hier die Interface-Deklaration der Datenstrukturen:

  
   export interface IIwanProjectConfig
   {
        workingDir: string;
        tempDir: string;
        projectBBox: IBBox | null;
        CRSEstimates: ICRSEstimationHint | null;
        logonUserName: string | null;
        logonUserPassword: string | null;
   }
  
   export interface IIwanDefaultProjectConfig extends IIwanProjectConfig
   {
        allowAccessToUndefinedProjects: boolean;
   }
  
   export interface IBBox
   {
        minx: number;
        miny: number;
        maxx: number;
        maxy: number;
        epsgCode: number;
   }
  
   export interface ICRSEstimationHint
   {
        bbox: IBBox[];
        useFallbackIfNotFound: boolean;
   }
  
  

Ein möglicher Einsatzzweck ist das Bereitstellen von Ebenentypen, die z.Z. in der cardo-Oberfläche nicht definiert werden können. Bspw. für die Definition eines Virtuellen Layer

Die Datei sollte UTF8 kodiert gespeichert sein und enthält ein Array der Ebenenbeschreibungen. Bsp.-Inhalt:

[
    {
    "STR": {
        "type": "Shapefile",
        "filename": "..\\strasse.shp"
       }
    },
    {
    "WEG": {
        "type": "Shapefile",
        "filename": "..\\wege.shp"
       }
    }
]

Siehe auch die Liste der Datenquellen mit den Beschreibungen. Für das Testen der Einstellungen verwende die UI.