CityGML Writer Parameters
CityGML Target
Specifies the version of CityGML to be written. The output documents will be quite different as CityGML changed significantly (especially with regards to the namespaces in which objects are located) between these two versions.
This parameter is new for FME 2012. If set to Yes, it writes out features that match the elements defined in the core CityGML schema files, depending on the version selected in CityGML Version, as well as any additional ADE schema files that are specified in either the Application Domain Extension or ADE Schema File(s) parameters.
It is recommended to set this to Yes for new workspaces and mapping files that wish to write CityGML 1.0, 1.1 and various ADE datasets. Users have the option to get the writer's behavior prior to FME 2012 by setting this directive to No.
This parameter has no effect if the CityGML Version parameter is set to 0.4.
The writer can write out elements defined in NoiseADE by setting this parameter to NoiseADE. Alternatively, it can also write out to any other ADE by setting this parameter to Other and specifying schema files for ADE Schema File(s) parameter.
This parameter specifies additional schema files that can be used to write out elements defined in them.
Output File Contents
By default, the CityGML writer produces UTF-8 encoded documents. If this parameter is set to another encoding, the writer will transcode the data to the specified encoding.
This parameter can be used to enter valid XML comments and will be placed in the output file after the xml declaration tag.
This parameter specifies the content of the xsi:schemaLocation attribute on CityModel root element in the output file.
CityGML restricts a curve to be a polyline. Curves should therefore be written as <gml:LineString> elements and rings as <gml:LinearRing> elements. The parameter should be set to Yes. (No is used only for backwards compatibility.)
When this parameter is set to Yes, the CityGML writer will attempt to remove the auto-generated gml:id(s) (that is, gml:id(s) starting with the "fme-gen-" prefix).
When set to Yes (which is the default), the prefix for the CityGML namespace for http://www.opengis.net/citygml/2.0 or http://www.opengis.net/citygml/1.0 to "core".
Previously, the default namespace declaration (that is, no prefix) was always used in the CityGML output document.
Validation
If Yes, the CityGML XSD used for validating the output file is determined by the version specified in CityGML Version. If No, validation is not performed.
SRS Parameters
The CityGML writer will attempt to write srsName attributes on the geometry based on EPSG numbers that match the coordinate system of the features that it is writing.In some cases, no such well-know name exists. In which case, no srsName will be written. However if the user wishes to provide an srsName attribute, they can set the keyword SRS_NAME, and its value will be inserted into the srsName attribute of the geometry written.
Note: This is not the same as setting the coordinate system keyword/parameter for the writer. No reprojection will be done on the basis of the SRS_NAME keyword. This keyword is strictly for those cases where the user can provide a name (and possibly an axis order) for an srsName that FME is not aware of.
This parameter is only used when the user is providing an srsName via the srsName parameter. It determines the coordinate order when writing geometries.
Pretty Printing
Setting this parameter to Yes ensures the output is neatly formatted. This promotes easier reading on screen and in print output.
- Indent Size: Select a value from 0 to 9.
- Replace Tabs with Spaces: By default the Tab character is used to for indentations. Select Yes to substitute the Tab character with a Space.
Note: Enabling this option produces a considerably larger output file due to added whitespace.
Use Network Authentication
This parameter is always visible in some formats, and visible in other formats only when the dataset is a URL.
Specify the authentication method to use when accessing a password-protected server.
- Basic: (default) Basic access authentication is designed to allow a client to provide credentials to a server on the assumption that the connection between them is trusted and secure. Note that any credentials passed from client to server can be easily intercepted through an insecure connection.
- Digest: Digest authentication is one of the agreed-upon methods a web server can use to negotiate credentials, such as username or password, with a user's web browser.
- NTLM: A challenge-response protocol that is used to provide compatibility with versions of Windows earlier than the Windows 2000 operating systems.
- Web Connection: Web connections provide a convenient and secure way to store and reuse previously established connection parameters. See Web Connection below.
- Single Sign-on: FME will use the credentials of the current user to authenticate the HTTP request. This authentication method currently works only on the Windows operating system.
Note: To access datasets using a proxy server, use the Network tools in FME Options. From the Workbench menu, select Tools > FME Options > Network. For more information, see "Network Proxy" in the FME Workbench Help.