Create your own WPS block

Presentation

The OGC Web Processing Service (WPS) Standard provides rules for standardizing inputs and outputs (requests and responses) for invoking geospatial processing services as a web service.

WPS scripts for NoiseModelling are written in Groovy language. They are located in the NoiseModelling/scripts/ directory.

Note

Don’t be shy, if you think your script can be useful to the community, you can redistribute it using github or by sending it directly to us.

Tip

The best way to make your own WPS is to be inspired by those that are already made. See how the tutorial is built or contact us for many more examples.

General Structure

1. Import used libraries

import groovy.sql.Sql
import java.sql.Connection
import org.h2gis.api.ProgressVisitor

2. WPS Script meta data

title = 'My script title'
description = 'My script description, I support <b>html</b> !'
inputs = [
    my_optional_parameter: [name: 'option1', title: 'option1', description : 'Description, you can use html here. This parameter is optional because you have provided a default value', type: String.class, default: 'MY_RESULT_TABLE'],
    my_integer_parameter: [name: 'my_integer_parameter', title: 'my_integer_parameter', description : 'Restrict to an int, you can use html here', type: Integer.class],
    my_double_parameter: [name: 'my_double_parameter', title: 'my_double_parameter', description : 'Restrict to an floating point value, you can use html here', type: Double.class],
    my_boolean_parameter: [name: 'my_boolean_parameter', title: 'my_boolean_parameter', description : 'A checkbox parameter', type: Boolean.class],
    my_choice_parameter: [name: 'my_choice_parameter', title: 'my_choice_parameter', description : 'A list box with limited choices', type: String.class, allowedValues : ["Choice 1", "Choice 2", "Choice 3"], default : "Choice 2"],
]

// Optional (default 60 seconds)
// For synchronous WPS, it will wait this time (in seconds) before returning a message, but it will still run the execution in the background
executionTimeout = 120


outputs = [
    result: [name: 'result', title: 'result', description : 'Result output, generally the result output table name. You can use this output as an input for another processing', type: String.class]
]

Note

You may want to add an optional parameter but without a default value (the input will not be in the input map) to do so instead of defining a default value default: 'MY_RESULT_TABLE' use the entry min : 0

4. Set main method to execute

/**
 * Main method
 * @param connection SQL Connection
 * @param input Map of inputs, should provide the same keys as described in the input metadata
 * @param progress Can be used to display the progression of the computation, and to check if the user canceled the execution
 * @return A map as described in the result metadata
 * @throws SQLException if something went wrong
 */
def exec(Connection connection, Map inputs, ProgressVisitor progress) {
    Sql sql = new Sql(connection)
    // Get the parameter value. For optional parameters, do not forget to provide a default value in the metadata.
    def myTableName = inputs.my_optional_parameter
    sql.execute("CREATE TABLE IF NOT EXISTS $myTableName(PK SERIAL PRIMARY KEY, DATA INTEGER)".toString())
    return [result : '$myTableName']
}

5. Make your method available

You have to save the script into the folder NoiseModelling/scripts/. You have to refresh the web page WPS Builder in order to see your new script.