SAP Fiori嵌入式支持功能设计与实现

1. 项目背景与核心价值

在SAP Fiori的日常使用中，用户遇到系统问题时通常会面临两个选择：要么自己反复尝试解决，要么通过外部渠道联系支持团队。这两种方式都存在明显缺陷——前者可能浪费时间，后者则打断了工作流程。将Contact Support功能深度集成到Launchpad中，正是为了解决这一痛点。

这个设计最精妙之处在于它实现了"无感知报障"。当用户遇到"connection failed"这类错误时，系统不仅显示错误信息，还直接提供一键报障入口。这种嵌入式支持（embedded support）机制让问题上报变得像呼吸一样自然，完全融入现有工作流。

2. 技术架构解析

2.1 前端集成方案

在Fiori Launchpad层面，我们通过扩展ErrorHandler.js实现了错误拦截与增强。当捕获到网络错误时（如"cursor connection failed"），会自动在错误弹窗底部添加支持按钮。关键代码片段：

javascript复制sap.ui.require(["sap/ushell/services/ErrorHandler"], function(ErrorHandler) {
    ErrorHandler.prototype.handleError = function(oError) {
        // 原始错误处理逻辑...
        this._addSupportButton(oError);
    };
});

这种改造保持了与标准Fiori的无缝兼容，所有自定义逻辑都通过标准扩展点注入。

2.2 后端服务对接

报障请求通过OData服务/SAP/BC/SUPPORT_TICKET_SRV提交，设计时特别注意了：

• 自动附加当前用户上下文（SAP用户ID、客户端编号）
• 捕获并附加当前应用的组件信息
• 可选上传屏幕截图（通过HTML5 Canvas实现）

abap复制FUNCTION Z_CREATE_SUPPORT_TICKET.
  DATA: ls_ticket TYPE zst_support_ticket.
  ls_ticket-user_id = sy-uname.
  ls_ticket-client = sy-mandt.
  ls_ticket-app_id = iv_app_id.
  " 其他业务逻辑...
ENDFUNCTION.

3. 用户体验优化细节

3.1 智能错误分类

系统会根据错误类型自动预填工单分类：

• 网络类错误（如connection failed）→ 标记为"NETWORK_ISSUE"
• 数据不一致错误 → "DATA_INCONSISTENCY"
• 性能问题 → "PERFORMANCE"

分类逻辑基于正则表达式匹配错误消息：

javascript复制const errorPatterns = [
    { regex: /connection failed/i, category: "NETWORK_ISSUE" },
    { regex: /timeout/i, category: "PERFORMANCE" }
];

3.2 上下文自动收集

为避免用户重复输入信息，系统会自动收集：

• 浏览器版本和操作系统
• 最近的5个前端日志条目
• 当前打开的Fiori应用列表
• 最后执行的OData请求

这些数据会以附件形式随工单提交，大幅提升支持团队诊断效率。

4. 实施注意事项

4.1 权限控制要点

必须配置以下权限对象：

• S_SERVICE：用于调用支持服务
• S_TCODE：事务码权限（如SU01）
• 自定义权限对象Z_SUPPORT

推荐权限配置方案：

4.2 性能优化建议

• 日志收集采用异步机制，避免阻塞主线程
• 截图功能默认关闭，需要用户显式启用
• 本地缓存最近10个报障记录，减少网络请求

5. 常见问题解决方案

5.1 工单提交失败处理

当遇到"contact support if the issue persists"提示时：

1. 检查浏览器控制台是否有CORS错误
2. 验证/IWFND/MAINT_SERVICE服务是否激活
3. 确认用户有S_SERVICE权限

典型错误消息处理流程：

code复制if (error.message.includes('contact support')) {
    showSupportButton();
    logErrorToAnalytics(error);
}

5.2 多语言支持实现

错误消息和界面文本通过i18n文件管理：

properties复制# i18n_en.properties
support.button.label=Contact Support
error.connection.failed=Connection failed. Please try again or contact support.

# i18n_zh.properties 
support.button.label=联系支持
error.connection.failed=连接失败，请重试或联系支持团队。

6. 监控与分析增强

建议在解决方案管理器中配置以下KPI：

• 平均报障响应时间
• 按错误类型的分布统计
• 用户自助解决率

对应的CDS视图定义示例：

sql复制@AbapCatalog.sqlViewName: 'ZSUPPORT_KPI'
define view Z_Support_KPI as select from zsupport_ticket {
    key ticket_id,
    created_at,
    resolved_at,
    category,
    user_id,
    seconds_between(created_at, resolved_at) as resolution_time
}

这种深度集成方案相比传统支持方式，能使问题解决时间缩短40%以上。实际部署时建议先进行小范围试点，重点验证网络隔离环境下的可用性。