Konfigurace

Stejně jako MapServer se TinyOWS konfiguruje pomocí textového konfiguračního souboru. Na výběr je buď přidání parametrů do už existujícího souboru mapfile a nebo vytvoření nového konfiguračního souboru ve formátu XML.

Konfigurace pomocí souboru XML

Konfigura prostřednictvím zvláštního souboru je preferovaný způsob práce s TinyOWS. Výchozí konfigurační soubor je očekávaný v /etc/tinyows.xml. Tuto hodnotu lze přepsat proměnnou prostředí TINYOWS_CONFIG_FILE:

<tinyows online_resource="http://127.0.0.1/cgi-bin/tinyows"
         schema_dir="/usr/local/tinyows/schema/">

 <pg host="127.0.0.1" user="postgres" password="postgres" dbname="tinyows_demo" port="5432"/>

 <metadata name="TinyOWS Server"
           title="TinyOWS Server - Demo Service" />

 <layer retrievable="1"
        writable="1"
        ns_prefix="tows"
        ns_uri="http://www.tinyows.org/"
        name="world"
        title="World Administrative Boundaries" />

 <layer retrievable="1"
        writable="1"
        ns_prefix="tows"
        ns_uri="http://www.tinyows.org/"
        name="france"
        title="French Administrative Sub Boundaries (IGN - GeoFLA Departements)" />

</tinyows>

Element tinyows

online_resource
URL vedoucí na webovou službu, povinný parametr
schema_dir
Adresář s uloženými XML schematy - výchozí je /usr/local/tinyows/schema/, ale např. při instalaci z balíku je to /usr/share/tinyows/schema/. Povinný parametr.

Další parametry jsou nepovinné

log
cesta k souboru pro logování
log_level
Binární součin: 1:ERROR, 2: EVENT, 4: HTTP QUERY, 8: SQL, 15: vše
degree_precision, meter_precision
Počet desetinných míst souřadnic
display_bbox
Bounding box není ve standardu WFS povinný a jeho výpočet je relativně náročný - touto volbou ho lze deaktivovat a snížit tak zátěž na serveru.
estimated_extent
Použít méně přesný, ale rychlejší odhadovaný extent
check_schema
Testovat vstupní data pro schématu XML
encoding
Výchozí hodnota je utf-8
wfs_default_version
TinyOWS podporuje WFS 1.0.0 nebo 1.1.0

Element limits

Tímto elementem lze omezit počet zpracovávaných prvků:

features
maximální počet vektorových objektů, které jsou odeslány zpět klientovi
geobbox
maximální prostorový rozsah pro prvky ve formě vychod,zapad,sever,jih

Element pg

Tímto elementem se definuje napojení na databázi PostgreSQL. Parametry jsou nepovinné a odpovídají standardním parametrům pro připojení k databázi.

  • host
  • user
  • password
  • dbname
  • port
  • encoding

Element metadata

Tento element obsahuje informace o službě.

name
Povinný parametr - identifikátor služby
title
Povinný parametr - lidsky čitelný identifikátor služby
keywords
klíčová slova oddělená čárkou
fees
access_constraints

Element abstract

Obsahuje delší popis služby

Element contact

Detailní popis kontaktu

Povinné údaje

name
Název kontaktu
site
URL kontaktu
email
elektronická pošta

Nepovinné údaje

  • ndividual_name
  • position
  • phone
  • fax
  • online_resource
  • address
  • postcode
  • city
  • administrative_area
  • country
  • hours_of_service
  • contact_instructions

Element layer

Vlastní definice vrstev.

Povinné parametry

ns_prefix
Zkratka jmenného prostoru pro vrstvu
ns_uri
URI pro zadaný jmenný prostor
name
Identifikátor vrstvy

Nepovinné parametry

  • title
  • retrievable
  • writable
  • schema
  • table
  • abstract
  • keywords
  • srid
  • geobbox
  • include_items
  • exclude_items
  • pkey

Konfigurace pomocí souboru mapfile

Pro použití mapfile je potřeba nastavit proměnnou prostředí TINYOWS_MAPFILE.

Konfigurační hodnoty pro TinyOWS se ukládají do sekce METADATA a používají prefix tinyows_.

Podporovány jsou pouze vrstvy s připojením do PostgreSQL/PostGIS. Většina konfiguračních hodnot pro jednoduché WFS publikované prostřednictvím MapServeru jsou ignorovány.

MAP
    NAME "TinyOWS"

    WEB
         METADATA
                    "tinyows_schema_dir" "/usr/local/share/tinyows/schema/"
                    "tinyows_onlineresource" "127.0.0.1/cgi-bin/tinyows.fcgi"
                    "wfs_title" "TinyOWS service provided by a MapFile"
                    "wfs_contact" "foo@bar.net"
         END
    END

    LAYER
            NAME 'France'
            CONNECTIONTYPE postgis
            CONNECTION "host=127.0.0.1 user=postgres password=postgres dbname=tinyows_demo port=5432"
            METADATA
                    'wfs_title' 'France'
                    'wfs_namespace_prefix' 'tows'
                    'wfs_namespace_uri' 'http://www.tinyows.org/'
                    'wfs_srs' 'EPSG:27582'
                    'tinyows_table'  'france'
                    'tinyows_writable' '1'
                    'tinyows_retrievable' '1'
            END
            DUMP TRUE
    END
END

Jednotlivé konfigurační hodnoty a jejich převod z XML do mapfile je popsán v tabulce.