Skip to content

Dead-Letter Jobs

The "Processes Workspace" perspective in the platform provides a dedicated environment for managing and monitoring BPMN (Business Process Model and Notation) based runtime processes. This section focuses on the "Dead-Letter Jobs" view, a tool designed for handling and managing jobs that have encountered errors and are in a "dead-letter" state.

Accessing the Processes Workspace Perspective

  1. Navigate to the Processes Workspace Perspective:

  2. Access the Processes Workspace Perspective in the platform.

  3. Open the Dead-Letter Jobs View:

  4. Within the Processes Workspace perspective, open the "Dead-Letter Jobs" view. This view displays jobs that have encountered errors and are currently in a "dead-letter" state.

Dead-Letter Jobs View

1. Job Listing:

  • The Dead-Letter Jobs view provides a list of jobs that have encountered errors during execution. Each entry includes details such as job ID, process instance ID, error message, and relevant metadata.

2. Error Details:

  • Access detailed information about the errors encountered by each job. This includes error messages, stack traces, and other information to aid in diagnosing and resolving the issues.

3. Job Resubmission:

  • The Dead-Letter Jobs view allows users to resubmit dead-letter jobs for re-execution. This functionality is useful for addressing errors and allowing the affected jobs to proceed through the BPMN process.

4. Job Status Tracking:

  • Track the status of each dead-letter job within the view. Visual indicators help users quickly identify pending, completed, or failed job resubmissions.

Advanced Functionality

  1. Integration with BPMN Editor:

  2. Seamlessly transition from the Dead-Letter Jobs view to an integrated BPMN editor for direct editing and modification of BPMN process definitions related to the encountered errors.

  3. Real-time Updates:

  4. Experience real-time updates to the Dead-Letter Jobs view as dead-letter jobs are resubmitted and progress through different steps of the associated BPMN processes. This feature provides a dynamic and interactive view of job recovery.

  5. Error Analysis and Resolution:

  6. Utilize the information provided in the Dead-Letter Jobs view for detailed analysis and resolution of encountered errors. Access logs, stack traces, and related data to diagnose and fix issues.

Conclusion

The "Processes Workspace" perspective in the codbex platform, with the "Dead-Letter Jobs" view, offers a specialized tool for handling and managing jobs that have encountered errors during execution. Whether resubmitting jobs, tracking status, or analyzing errors, this view streamlines the process of recovering from dead-letter states.