Transformation Services

Transformation Services include the following:

Authentication

See Web Services Authentication.

Common Request Elements

Workspace Published Parameters

An FME published parameter defined in a workspace can be directly passed to a web service as a request parameter. When the web service submits a transformation job to FME Flow, the FME Flow uses the value of the published parameter to run the workspace.

Syntax

The published parameters can be provided to the workspace using the HTTP POST or GET method. Assuming the GET method is used, then the syntax for the published parameter URL parameters is as follows:

http://hostname/<service>/<repository>/<workspace>?{ParameterName[=ParameterValue]&}

Example

Here is a URL to invoke the austinDownload.fmw workspace through the data download service (note the URL parameters, such as COORDSYS and its value LL84):

http://hostname/fmedatadownload/Samples/austinDownload.fmw?COORDSYS=LL84&BBOX_COORDSYS=LL84
&FORMAT_GENERIC=SHAPE&MINX=-100&MINY=25&MAXX=-90&MAXY=35&THEMES=airports

The published parameters from the example above are discussed in the following table. You may also download the austinDownload.fmw workspace from the Samples repository in order to see how the published parameters are configured in the workspace.

Parameter name

Parameter value

Description

COORDSYS

LL84

This is the Writer's Coordinate System parameter (i.e. the output coordinate).

BBOX_COORDSYS LL84 This is the Reader's Search Envelope Coordinate System parameter for the search envelope provided by the MIN*/MAX* published parameters, which collectively restrict the amount of data that is actually read by FME. Also, this published parameter is used to reproject the search envelope to match the source data's coordinate system in order to perform a hard clip within the workspace using a Clipper transformer.
FORMAT_GENERIC SHAPE This is the Generic Writer's Output Format parameter.
MINX -100 This is the Reader's Search Envelope Min X parameter that will be used to select and clip data. This published parameter is used by both the Reader and a Clipper transformer in order to restrict the amount of data that is read and then to hard clip the data respectively.
MINY 25 This is the Reader's Search Envelope Min Y parameter. See MINX for further details.
MAXX -90 This is the Reader's Search Envelope Max X parameter. See MINX for further details.
MAXY 35 This is the Reader's Search Envelope Max Y parameter. See MINX for further details.
THEMES airport This is the Reader's Feature Types to Read parameter.

Web Services-Specific Job Directives

See Job Directives for details.

Supported FME Engine Directives

The following table provides information about the FME Engine directives.

Directive name

Directive value

Description

fme_LOG_FILENAME

FME translation log file name.

Specify the FME translation log file name instead of using the default file name.