FME Options: Web Connections
Select Tools > FME Options> Web Connections.
Many web services require you to connect and authenticate in order to make REST calls to them. For example, when you use an HTTPCaller transformer, you may need to authenticate to a web service, such as Google Fusion Tables. The Web Connections page allows you to manage these web services in the following ways:
- Viewing, Adding, and Removing Web Services
- Managing Web Connections
FME Desktop must be registered to use the web services to which you want to connect. For testing purposes, many of the most common services that authenticate using the OAuth 2.0 standard are already registered in FME. For production applications, we recommend that you add your own web services.
WARNING: Authorization credentials, such as Client Id and Client Secret, that are included with the pre-registered OAuth 2.0 services, are subject to service outages outside the control of Safe Software. In a production environment, we recommend using web services that you register using your own credentials. This way, the credentials are restricted to your organization, and you can deal directly with web service providers in the event of outages.
To view the web services that are available in FME, click Manage Services. The Manage Web Services dialog opens, listing the available services.
To add a service, on the Manage Web Services dialog, click the Add Web Service button . In the dropbox, specify the authorization protocol the service uses (OAuth 2.0, Token, or HTTP Authentication). Alternatively, to use an existing service as a template, select Create From. The newly added web service opens. In the list of services, enter a name for the service. Add the service parameters, and click Save.
Tip: Where possible, create new services from existing templates using Create From. In the template, click the links under External Help Links to learn how to obtain authorization credentials, such as Client Id and Client Secret. For example, to create your own Google Drive web service, click the Add Web Service button and select Create From > Google Drive. After specifying a Web Service Name and Description, expand External Help Links, and click Google Drive Help for information on obtaining Google Drive web service credentials.
To remove a service, on the Manage Web Services dialog, select the service you want to remove and click the Remove button .
Note: You cannot edit or remove services that are pre-registered in FME Desktop.
Use the Web Services Connections window to manage web connections.
To add a web connection
It is usually more convenient to add a web connection at the time you want to use one in a workspace. However, you can also add a web connection directly in FME Options, and use it later in a workspace.
- Click the Add button .
- On the Add Web Connection dialog, specify a Web Service.
- Specify a Connection Name.
Visibility: This field applies only if Connection Storage, as specified in Tools > FME Options > Default Paths, is a shared location visible to multiple users. Specify whether the connection is available only to yourself, or to any user of the database (Public). For more information, click Help from the Default Paths window under Tools > FME Options.
- Specify the Connection Parameters
- Click OK.
WARNING: For production purposes, we recommend specifying user-defined web services, rather than the pre-registered services already provided. For more information, see Viewing, Adding, and Removing Web Services, above.
Note: The following characters are not allowed in connection names: ^ \ / : * ? " < > | & = ' + % #
To edit a web connection
You can edit the connection parameters of an existing web connection. After you edit, all workspaces that use the web connection will use the new parameters to connect.
- Double-click the connection you want to edit.
You can specify whether a connection is available only to yourself, or to any user of the web service that it references. You do not have to be the creator of a connection to make this change.
- Ensure that Data Path and Public Key File in Tools > FME Options > Default Paths > Connection Storage reference a common, shared location visible to multiple users.
- Ensure that you have manually moved the fme_connections.data and fme_publicKey.jceks files referenced by Data Path and Public Key File to the location specified in step 1.
- On the Web Connections dialog (Tools > FME Options> Web Connections), check the box under Public that corresponds to the connection you want to make available. Or, to restrict the connection to yourself, clear the box.
To remove a web connection
- Select the connection and click the Remove button .
To change the storage location of the connections file
You can change the location where the connection configuration file is stored. This change is made in the Tools > FME Options > Default Paths tool.