FME Form: 2024.1

FME Options: Web Connections

Select Tools > FME Options > Web Connections.

Tip  Use the Filter search to find a setting located anywhere in FME Options.

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 BigQuery. The Web Connections page allows you to manage web connections and their associated web services.

Managing Web Services

FME Form 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 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 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.

Viewing, Adding, and Removing Web Services

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 Service: The web service uses the OAuth 2.0 standard to exchange authorization code for an access token.
  • Token Service: The web service uses the OAuth 2.0 standard to exchange application credentials for an access token.
  • HTTP Authentication Service: The web service uses an HTTP authentication method to grant access.

Alternatively, to use an existing service as a template, select Create From.

Tip  To add a web service for connecting to an FME Flow that authorizes as a user imported from Microsoft Azure Active Directory, select Create From > Microsoft Azure Active Directory (Template).

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 Form.

Uploading Web Services to FME Flow and Updating Existing Web Services

When you upload a workspace to FME Flow, and the workspace contains a web connection, you can choose to upload the connection with the workspace. Doing so also uploads the associated web service. However, you can also upload web services directly from Web Connections, or update a web service that was previously uploaded.

  1. Click Manage Services.
  2. On the Manage Web Services dialog, select the service you want to upload, and click Upload. (You may need to scroll to the bottom of the web service form to see the Upload button.)
  3. On the Upload to FME Flow dialog, specify a connection to FME Flow, or, to create one and use it right away, select Add Web Connection. (For information about adding a web connection, see Using Web Connections.)
  4. Depending on the protocol of the web service (for example, OAuth 2.0), specify the credentials that you generated when you added the web service, or specify alternative credentials.
  5. Click OK.
  6. (Update only) If the web service is already uploaded to FME Flow, the Web Service Exists dialog opens. Click Yes to confirm the update, or No to cancel.

For information about working with web services and web connections in FME Flow, see Web Connections in the FME Flow Web User Interface help.

Managing Web Connections

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.

  1. Click the Add button .
  2. On the Add Web Connection dialog, specify a Web Service.
  3. Warning  For production purposes, we recommend specifying user-defined web services, rather than the pre-registered services already provided. For more information, see Managing Web Services, above.
  4. Specify a Connection Name.
  5. Visibility: This field applies only if Database Accessibility, as specified in Tools > FME Options > Default Paths, is Shared. Specify whether the connection is available only to yourself, or to any user of the database (Shared). For more information, click Help from the Default Paths window under Tools > FME Options.

  6. Specify the Connection Parameters
  7. Click OK.
Note  The following characters are not allowed in connection names: ^ \ / : * ? " < > | & = ' + % #

To upload a web connection to FME Flow

You can upload a web connection to FME Flow directly from the Web Connections page. Doing so also uploads a reference to the associated web service, and populates it with the credentials from the web connection. Right-click on the connection you want to upload and select Upload. The FME Flow Connection widget opens. For more information, see Connecting to FME Flow.

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.

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.