You are here: FME Server Reference Manual > FME Server Services > Transformation Services > Data Streaming Service

Data Streaming Service

This service accepts and carries out transformation requests as specified by a workspace, returning the results as a data stream.

Note: You must install this service if you are also installing the KML Network Link service.

Data Streaming service requests are made as either URL or form requests. For example:

http://<host>/fmedatastreaming/<repository>/<workspace>.fmw?<parameters>

The resulting dataset is one file only. After the translation has finished, this dataset is streamed with the appropriate content-type (mime-type) over HTTP back to the client making the request. For example, a web browser or Google Earth are clients that could make the request.

Service Specific Request Parameters

Name	Value	Description
opt_responseformat	xml \| json Default: xml	Defines the language of the response. The text must be all lowercase.
opt_geturl	The URL to a dataset	The URL of the source dataset to be used for transformation
opt_showresult	true \| false	It indicates whether the XML/JSON responses from these three services include the FME transformation result. The default value is true if this parameter is not present.

Using Remote Data During a Request

Using data from HTTP POST body as Reader dataset

This web service can receive data and override source dataset via HTTP POST. The content of the POST request body will be saved to a temporary file which will be used as the Reader dataset of the workspace. If there is more than one reader in the workspace, then you will need to indicate which reader will use the temporary file. You indicate your choice when publishing the workspace by editing the service registration.

Using data from HTTP GET as Reader dataset

This web service can receive data and override Reader dataset via HTTP GET. The dataset should be specified as a URL and passed to service by 'opt_geturl' parameter. Both HTTP and FTP URLs are supported. If there is more than one reader in the workspace, then you will need to indicate which reader will use the temporary file. You indicate your choice when publishing the workspace by editing the service registration.

For example here is a service request that uses a remote KMZ dataset:

http://localhost/fmedatastreaming/Test/Viewer.fmw?opt_geturl=http://data.vancouver.ca/download/kml/elementary_school_boundaries.kmz

Response Elements

If the response format is specified as XML or JSON, a service failure response may contain the elements shown in the following table.

Element	Child Elements	Value	Description
statusInfo	message	message string	service failure message
statusInfo	status	success \| failure	service status
fmeTransformationResult	fmeServerResponse	FME Server response properties	FME Server response
fmeTransformationResult	fmeEngineResponse	FME Engine response properties	FME Engine response