RegisterRasterWithGeoServer Task

This task registers a raster with a GeoServer so that it can be rendered on a web client. It does not upload rasters to the server, nor does it allow any editing or data manipulation. GeoServer must be able to access the same file system as this task.

Instead of setting properties, you can use the GeoServer Configuration Template to define connection details. This file is in JSON format. Specify the connection details in this file, then save it as geoserver_conf.json and place it in the resource/server folder of your ENVI installation path. If you choose to set properties to define the connection details, those settings will override any values defined in the configuration file.

Syntax

Result = ENVITask('RegisterRasterWithGeoServer')

Input properties (Set, Get): HOST, INPUT_RASTER, PASSWORD, PORT, PROTOCOL, PROXY_HOST, PROXY_PORT, PROXY_PROTOCOL, USERNAME, WORKSPACE

Output properties (Get only): OUTPUT_COVERAGE, OUTPUT_URI

Properties marked as "Set" are those that you can set to specific values. You can also retrieve their current values any time. Properties marked as "Get" are those whose values you can retrieve but not set.

Methods

This task inherits the following methods from ENVITask:

Properties

This task inherits the following properties from ENVITask:

COMMUTE_ON_DOWNSAMPLE

HOST (optional)

Specify a string with the hostname for GeoServer communications. The host can be a machine name or IP address.

INPUT_RASTER (required)

Specify a raster to register with GeoServer. Supported file types are ENVI, GeoTIFF, and NITF.

OUTPUT_COVERAGE

The name of the raster coverage that will be created. The returned asset is assigned a unique layer name.

OUTPUT_URI

An OGC WCS URI to the new resource within GeoServer.

PASSWORD (optional)

Specify a string with the password if GeoServer requires credentials.

PORT (optional)

Specify an integer port number for GeoServer communications.

PROTOCOL (optional)

Specify a string with the protocol for GeoServer communications. Examples include 'http' and 'https'.

PROXY_HOST (optional)

Specify a string with the host name returned to the client. The client uses this name when forming OGC requests. The proxy host can be a machine name or IP address. A proxy is an upstream server that acts as a router for all requests coming into or out of a server.

PROXY_PORT (optional)

Specify an integer port number returned to the client. The client uses this port when forming OGC requests.

PROXY_PROTOCOL (optional)

Specify a string with the protocol returned to the client. The client uses this protocol when forming OGC requests. Examples include 'http' and 'https'.

USERNAME (optional)

Specify a string with the username if GeoServer requires credentials.

WORKSPACE (optional)

Specify a string with the workspace used for GeoServer registration. If you do not define a workspace, this task will create one called ENVI. The workspace name cannot contain spaces.

Version History

ENVI 5.3. 1

Introduced

API Version

4.2