运行IBM QueueSample代码时，如何通过Java PE API获取工作流故障错误信息？

Hey there! I’ve dealt with similar scenarios while working with IBM PE APIs and QueueSample code, so let me share some practical ways to pull workflow error details:

1. 捕获并解析WorkflowException #

当调用PE API方法（比如启动流程、完成工作项）抛出异常时，WorkflowException会包含详细的错误信息。你可以直接从异常对象中提取关键内容：

try {
    // 你的QueueSample中调用PE API的代码，比如完成工作项
    workItem.complete();
} catch (WorkflowException e) {
    // 获取错误消息列表
    List<String> errorMessages = e.getErrorMessages();
    for (String msg : errorMessages) {
        System.out.println("Error Message: " + msg);
    }
    // 获取异常详细信息（包括堆栈和内部错误）
    String exceptionDetail = e.getExceptionDetail();
    System.out.println("Exception Detail: " + exceptionDetail);
    // 获取错误代码
    int errorCode = e.getErrorCode();
    System.out.println("Error Code: " + errorCode);
}

2. 查询失败的工作项属性 #

如果工作项已经进入故障状态（比如被挂起或标记为错误），你可以直接从WorkItem对象中获取错误相关属性：

// 假设你已经获取到故障的WorkItem实例
if (workItem.getStatus() == WorkItem.STATUS_FAILED) {
    // 获取错误代码
    String errorCode = workItem.getErrorCode();
    // 获取错误描述文本
    String errorText = workItem.getErrorText();
    // 获取错误发生的时间戳
    Date errorTime = workItem.getErrorTime();

    System.out.println("Failed WorkItem Error Code: " + errorCode);
    System.out.println("Error Description: " + errorText);
    System.out.println("Error Occurred At: " + errorTime);
}

3. 从流程实例中获取错误上下文 #

如果整个流程实例出现故障，你可以通过ProcessInstance对象关联的错误信息来排查：

// 获取流程实例
ProcessInstance processInstance = pe.getProcessInstance(processInstanceId);
// 检查流程是否处于错误状态
if (processInstance.getState() == ProcessInstance.STATE_FAILED) {
    // 获取流程级别的错误信息
    String processErrorText = processInstance.getErrorText();
    System.out.println("Process Instance Error: " + processErrorText);
}

针对QueueSample的额外提示 #

QueueSample通常是轮询并处理队列中的工作项，你可以在处理逻辑前先筛选出带有错误标记的工作项，或者在处理失败后立即捕获异常并记录详细信息，这样能快速定位队列中故障任务的问题。

内容的提问来源于stack exchange，提问作者mkk