Run Workspace

You can perform the following from the Run Workspace page:

  • Run a workspace directly from this page.
  • Share a workspace as an "app" that is run from a browser, or as a webhook that is integrated with third-party software.

Note: Workspace templates cannot be run from FME Server.

To Run a Workspace

  1. Specify:
    • The repository to which the workspace belongs.
    • The workspace you want to run.
    • An FME Server service that the workspace is registered to run.
    • Optionally, an e-mail address to deliver results. This option allows you to receive e-mail notification when the translation is complete, rather than wait for a completion message on this page.
    • Note: To receive e-mail, the following FME Server email subscribers must be properly configured: DataDownload_Email_JobFailure, DataDownload_Email_JobSucess, JobSubmitter_Email_JobFailure, JobSubmitter_Email_JobSuccess. For more information, see Monitoring FME Server Events from Topics.

  2. Under Published parameters, provide any published parameters or other settings specific to the FME Server service.
  3. If any published parameters represent data files, this page allows you to upload files to FME Server, making use of the Data Upload Service behind the scenes. This service works in conjunction with the Data Download, Data Streaming, and Job Submitter services to upload files.

    Note: Any "Feature Types to Read" published parameters that contain spaces must be enclosed in double quotes. For example, "Bus Routes".

    Note: Resources connections to Amazon Web Services (AWS) S3 buckets cannot be accessed.

  4. (Optional) Expand Advanced. This section shows:
  5. Job Queue (optional): The job queue in which to run the job. The specified queue overrides the queue of the repository to which the workspace belongs. If not specified, the job is placed in the job queue of the repository.

    Queued Job Expiry Time (optional): The length of time after which a job that is waiting in queue does not execute. If the job does not execute before this time is reached, it remains in the queue until it is ready to execute, but execution is not attempted. This directive is useful for time-sensitive jobs that you do not want to run after the specified time is exceeded.

    Running Job Expiry Time (optional): The time a job will remain in the running state. This directive is used to ensure that a job does not hang and block an FME Engine indefinitely. The minimum allowable value is 1.

    Run Until Cancelled (optional): If checked, the job runs continuously, even after a server shutdown or crash, until it is explicitly canceled.

    Workspace Sharing: You can generate a token, along with URLs that use the token, which allow unauthenticated access to run the workspace in the following ways:

    • As an "app" that is run from a browser, and allows users to configure any published parameters.
    • Through a webhook that can be integrated with third-party software to programmatically run the workspace according to the published parameters configured on the Run Workspace page.

    Once created, you can access the token on the API Tokens tab of the Token Management page.

    Published Parameters: Details of any published parameters.

  6. Click Run. You may see an intermediate page indicating that processing has begun.

The resulting web page indicates whether the job submission was successful.

To Unregister a Service from a Workspace

To unregister a service from a workspace, use FME Workbench to "republish" the workspace to FME Server. On the "Register Workspace Services" page of the "Publish to FME Server Wizard," unselect the service you want to unregister. For more information, see the FME Workbench help.

To Unregister a Workspace from a Repository

To unregister a workspace from a repository, use FME Workbench to "republish" the workspace to FME Server. On the "Register Workspace Services" page of the "Publish to FME Server Wizard," unselect all the FME Server Web Services. Although the workspace is still considered "published," it is no longer visible in FME Server. For more information, see the FME Desktop Help.