Skip to main content

Troubleshoot Leave Workflow Integration

Summary​

Safe triage for Workflow start, callback, duplicate, and state-reconciliation issues.

Audience​

Employees or administrators affected by the scenario, first-line support, QA, service owners, and architects.

Symptoms​

A Workflow-enabled request remains Pending, start fails, callback fails, or states diverge.

Scope​

Optional Workflow orchestration and Leave callback/state correlation.

Cause​

The cause must be confirmed from current state and source-backed evidence.

Likely causes​

  • Workflow unavailable or rejected start
  • Correlation missing/mismatched
  • Callback failed or arrived after state changed
  • Duplicate callback
  • Leave/Workflow state divergence

Safe diagnostic steps​

  1. Confirm Workflow mode and current Leave state.
  2. Use safe correlation evidence to locate the corresponding Workflow instance/status.
  3. Review source-safe start/callback logs without inspecting trust material.

Resolution​

Restore the dependency or reconcile states through Leave and Workflow owners. Do not invoke or replay callbacks manually.

Safe resolution​

Use only the resolution above and approved operational processes. Do not modify databases, replay messages, bypass authorization, or repeat ambiguous state-changing actions.

Validation​

Confirm both systems agree on the expected terminal/non-terminal state and only one decision effect exists.

Evidence to collect​

Collect the safe UTC window, route/operation category, response/status category, deployed version, affected scope count, and a correlation identifier. Exclude credentials, tokens, personal Leave details, employee identifiers, payloads, configuration values, and private topology.

Escalation​

Workflow and Leave service owners; Identity/security or gateway owner for protected-call failures.

Source References​

  • microservices/src/leave-service/Application/WorkflowIntegration.cs
  • microservices/src/leave-service/Infrastructure/WorkflowServiceClient.cs
  • microservices/src/leave-service/Api/LeaveEndpoints.cs

See Also​

Keywords​

  • Leave troubleshooting
  • Troubleshoot Leave Workflow Integration
  • Safe diagnostics

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly