# SAP 商务开发 ## 概述 SAP Commerce Cloud（以前称为 Hybris）是一个基于 Java 和 Spring 构建的企业电子商务平台。此技能为云 (CCv2) 和本地部署的扩展开发、类型系统建模、服务层实现、数据管理、API 定制和加速器模式提供指导。 ## 核心架构 ### 类型系统通过“items.xml”进行数据建模定义项目类型、属性、关系和枚举。类型在构建期间被编译成 Java 类。有关语法和模式，请参阅 [type-system.md]()。 ### 扩展模块化架构，功能存在于扩展中。每个扩展都有用于元数据的“extensioninfo.xml”、用于类型的“items.xml”和用于 bean 的“*-spring.xml”。请参阅 [extension-development.md]()。 ### 服务层四层架构：**Facade**（控制器的 API）→**Service**（业务逻辑）→**DAO**（数据访问）→**Model**（从类型生成）。请参阅 [service-layer-architecture.md]()。 ### 数据管理 **ImpEx** ：用于数据导入/导出的脚本语言。请参阅 [impex-guide.md]()。 **FlexibleSearch** ：类似于 SQL 的项目查询语言。请参阅 [flexiblesearch-reference.md]()。 ### OCC API 公开商务功能的 RESTful Web 服务。控制器使用 DataMapper 进行 DTO 转换。请参阅 [occ-api-development.md]()。 ### 加速器预建店面：B2C（零售）和 B2B（具有审批工作流程的企业）。请参阅 [accelerator-customization.md]()。 ### CronJobs 和任务引擎计划和异步作业执行。定义 `AbstractJobPerformable` 实现，通过 ImpEx 中的 `ServicelayerJob` \+ `CronJob` \+ `Trigger` 进行配置。请参阅 [cronjob-task-engine.md]()。 ### 业务流程用于订单处理、退货、审批和自定义流程的有状态工作流程。带有操作 bean（“AbstractSimpleDecisionAction”、“AbstractAction”）、等待状态和事件触发器的 XML 流程定义。请参阅 [business-process.md]()。 ### Solr 搜索由 Apache Solr 提供支持的产品搜索和分面导航。配置索引类型、属性、值提供程序和提升规则。请参阅 [solr-search-configuration.md]()。 ### 促销和规则引擎基于 Drools 的促销规则，包含条件和操作。支持订单/产品/客户促销、优惠券和自定义操作。请参阅 [promotions-rule-engine.md]()。 ### 缓存多层缓存：平台区域缓存（实体、查询、类型系统）、Spring `@Cacheable` 和集群感知失效。请参阅 [caching-guide.md]()。 ### 后台通过 cockpitng 进行管理 UI 定制：小部件配置、自定义编辑器、搜索/列表视图、向导和深层链接。请参阅 [backoffice-configuration.md]()。 ## 常见工作流程 ### 创建自定义扩展 1. 使用 `ant extgen` 生成结构或使用 `assets/extension-struct/` 中的模板 2. 配置 `extensioninfo.xml` 依赖项 3. 在`items.xml`中定义类型 4. 在`*-spring.xml`中配置bean 5. 添加到 `localextensions.xml` 6. 构建：`ant clean all` 参考：[extension-development.md]() |模板：`资产/扩展结构/` ### 定义自定义项目类型 1. 在扩展中创建或修改`*-items.xml` 2.用属性、关系定义itemtype 3.构建生成模型类 4. 在服务/DAO 中的使用参考：[type-system.md]() |模板：`资产/项目类型定义/` ### 实施服务层 1.创建DTO类用于数据传输 2. 使用FlexibleSearch创建DAO接口并实现 3. 创建Service接口并实现业务逻辑 4.创建Facade接口并实现外部API 5. 在`*-spring.xml`中配置bean 参考：[service-layer-architecture.md]() |模板：`资产/服务层/` ### 使用 ImpEx 导入数据 1. 创建包含标题行和数据行的 `.impex` 文件 2.使用INSERT_UPDATE进行创建/修改操作 3. 定义可重用值的宏 4. 通过 HAC 或 `ant importImpex` 导入参考：[impex-guide.md]() |模板：`assets/impex-scripts/` ### 使用FlexibleSearch 进行查询从 {产品} 中选择 {pk}，其中 {code} = ?code SELECT {p.pk} FROM {Product AS p JOIN Category AS c ON {p.supercategories} = {c.pk}} WHERE {c.code} = ?category 参考：[flexiblesearch-reference.md]() |示例：`assets/flexiblesearch-queries/` ### 自定义 OCC API 1.使用`@Controller`和`@RequestMapping`创建控制器 2. 为响应数据创建WsDTO 3. 创建用于模型到 DTO 转换的填充器 4. 在`*-web-spring.xml`中注册参考：[occ-api-development.md]() |模板：`assets/occ-customization/` ### 扩展加速器结账 1. 创建自定义结账步骤，实现 `CheckoutStep` 2. 在结帐流程 XML 中配置 3. 为步骤 UI 创建 JSP 4. 在`*-spring.xml`中注册bean 参考：[accelerator-customization.md]() |模板：`资产/结帐定制/` ### 创建计划作业（CronJob） 1. 使用“perform()”方法实现“AbstractJobPerformable” 2.使用`parent =“abstractJobPerformable”`注册Spring bean 3.通过ImpEx创建`ServicelayerJob`、`CronJob`和`Trigger` 4. 通过 HAC > Platform > CronJobs 进行测试参考：[cronjob-task-engine.md]() |模板：`资产/cronjob/` ### 定义业务流程 1. 在`resources/processes/`中创建流程定义XML 2. 实现扩展 `AbstractSimpleDecisionAction` 的操作 bean 3. 在Spring中使用`parent =“abstractAction”`注册action bean 4. 通过 `ProcessDefinitionResource` Spring bean 注册流程定义 5. 通过 `BusinessProcessService.createProcess()` 和 `startProcess()` 启动流程参考：[business-process.md]() |模板：`资产/业务流程/` ### 配置 Solr 产品搜索 1. 设置 `SolrFacetSearchConfig` 的服务器、语言、货币、目录版本 2. 为产品定义`SolrIndexedType` 3. 配置 `SolrIndexedProperty` 条目（可搜索、分面、可排序） 4. 设置索引器 CronJobs（每晚整夜，每 5 分钟增量） 5. 通过 HAC > Platform > Solr 测试搜索参考：[solr-search-configuration.md]() |模板：`assets/solr-configuration/` ### 设置促销 1. 为您的商店创建“PromotionGroup” 2. 使用条件和操作定义“PromotionSourceRule” 3. 如果需要，配置优惠券（`SingleCodeCoupon` / `MultiCodeCoupon`） 4. 发布规则激活 5.后台测试>营销>促销规则参考： [promotions-rule-engine.md]() |模板：`资产/促销/` ## 快速参考任务|参考|资产|脚本 ---|---|---|--- 扩展设置 | [extension-development.md]() | `资产/扩展结构/` | `脚本/生成扩展.sh` 类型定义 | [type-system.md]() | `资产/项目类型定义/` | - 服务层 | [service-layer-architecture.md]() | `资产/服务层/` | - 数据导入 | [impex-guide.md]() | `资产/impex-脚本/` | `脚本/validate-impex.sh` 查询 | [flexiblesearch-reference.md]() | `资产/灵活搜索查询/` | `脚本/query-items.sh` API定制| [occ-api-development.md]() | `资产/occ-定制/` | - 结账/店面 | [accelerator-customization.md]() | `资产/结帐定制/` | - 弹簧配置| [spring-configuration.md]() | - | - 数据模式| [data-modeling-patterns.md]() | - | - 故障排除 | [troubleshooting-guide.md]() | - | - 计划任务 | [cronjob-task-engine.md]() | `资产/cronjob/` | - 业务流程| [business-process.md]() | `资产/业务流程/` | - Solr 搜索 | [solr-search-configuration.md]() | `资产/solr-配置/` | - 促销 | [promotions-rule-engine.md]() | `资产/促销/` | - 缓存 | [caching-guide.md]() | - | - 后台| [backoffice-configuration.md]() | - | - ## 资源 ### 脚本/ 用于常见任务的实用程序脚本： * `generate-extension.sh` \- Scaffold 新的扩展结构 * `validate-impex.sh` \- 在导入之前验证 ImpEx 语法 * `query-items.sh` \- 通过HAC执行FlexibleSearch查询 ###参考资料/ 每个主题领域的详细指南。根据需要加载以获得深入信息。 ###资产/ 生产质量的代码模板可供复制和自定义。按领域（服务层、impex 脚本等）组织。

SAP 商务

包含技能