Inside Activate
Jobs and Tasks
Synchronous Jobs
7 min
synchronous jobs allow certain operations to complete immediately within the activate web client, providing a responsive user experience for tasks that must return results straight away unlike asynchronous jobs, which are queued and executed by the orchestrator in the background, synchronous jobs are submitted and processed in real time why use synchronous jobs? synchronous execution is used when the user must receive an immediate response the task is lightweight and predictable delayed processing would negatively impact usability (e g , form validation, quick entitlement lookups, “test connection” type actions) asynchronous jobs are preferred when the task may take longer to complete external systems may introduce delays the workflow includes multiple steps or approval processes fault tolerance and retry logic is required synchronous jobs should be used sparingly and only when necessary to avoid unnecessary load on the orchestrator orchestrator ports configuration the orchestrator must expose http and https endpoints for synchronous jobs to work correctly location in activate studio resources → configuration → orchestratorports example configuration 6030;6031 01c5fffd5e07ce2e3329ddd01179d5bb518a6718 where 6030 – http port the orchestrator listens on 6031 – https port 01c5fffd…a6718 – certificate thumbprint used for https the orchestrator binds the https port to the server certificate matching the specified thumbprint why this matters if these ports are not configured correctly the activate web client cannot communicate with the orchestrator synchronous jobs will not run synchronously and be orphaned users will experience delays on their jobs activate will fall back to asynchronous behaviour where possible whenever a server certificate is renewed, the new thumbprint must be updated in the orchestratorports configuration orchestrator ports configuration resources/configuration/orchestratorports 6030;6031 01c5fffd5e07ce2e3329ddd01179d5bb518a6718 the http and https ports are ports that the orchestrator listens on the https listn uses the server certificate specified by the thumbprint if these aren't configured then the activate web client app will be able to communicate with the orchestrator and the synchronous job won't submit and complete immediately orphan jobs orphan jobs occur when a synchronous job begins execution but does not transition into a valid workflow state in these cases the job remains stuck in running with no workflow events attached how orphan detection works the orchestrator checks for orphans every 60 minutes any job in running with no workflow events is flagged flagged jobs are queued for reprocessing on the next orchestrator worker loop the next worker loop occurs within roughly 10 seconds , depending on system load this ensures that jobs that fail during the synchronous submission phase do not remain stuck indefinitely summary of key behaviour synchronous jobs provide instant feedback to the user correct orchestratorports configuration is mandatory misconfigured ports = synchronous jobs cannot run orphan jobs are automatically detected and recovered certificate updates require updating the configured thumbprint