端到端扩展场景用例集 · 场景第一部分
项目 |
内容 |
|---|---|
官方仓库 |
|
业务场景 |
以 S/4HANA 公有云为起点的多个完整并行扩展场景 |
技术栈 |
SAP BTP、CAP、Cloud Foundry / Kyma、目标(Destination)、通信安排、事件 |
对应课程 |
|
对应路径 |
第 2 条:在 SAP BTP 上构建并行扩展 |
为什么值得做:这是一本「菜谱」。每个用例都是一条可独立复现的端到端 链路,覆盖从 BTP 账户搭建、连通性配置,到部署,再到与 S/4HANA 公有云交互的完整过程。
动手要点:
每个用例都从前提条件讲起(需要哪些服务、哪些通信安排)——请严格照做。
如果连不通,先拿目标(Destination)和通信安排对照检查一遍;这是最常见的坑。
本页内容抓取自官方仓库 SAP-samples/btp-end-to-end-scenario-use-cases,共收录 11 篇官方文档(README 与 docs)。原仓库内容版权归 SAP SE,遵循其许可证。
主题 1:扩展收货流程
用例描述
SupplierHub 公司生产各类复杂的工业品和消费品。为进行生产,他们从多家供应商采购中间产品。出于法律和经济方面的原因,货物到达仓库交付时,必须检查其数量、质量和完整性。公司希望遵守这项法律要求,并按产品类型对货物做适当检查。
标准的 SAP S/4HANA 系统不提供这一功能。到目前为止需要处理大量纸质单据,流程最好能数字化。考虑到仓库环境,使用平板电脑或移动设备是执行交付检查的最佳选择。
因此,仓库管理部门希望为此用例构建一个自定义 UI。解决方案的开发与维护成本和时间应尽可能低。首选做法是采用 SAP Build Apps 这类无代码、低代码工具,并结合 SAP S/4HANA 系统的关键用户扩展(Key User Extensions)。思路是将入库交货的物料检查标准化,并记录交货中的错误和损坏。一旦发现问题,就在 SAP S/4HANA 中创建一份缺陷文档,其中包含错误描述并关联到采购订单。这样质量经理就能继续处理与供应商的投诉。
前提条件
您已收到来自 SAP Cloud Identity Services 的激活邮件,并通过邮件中提供的链接激活了个人资料。
只有这样,您才能访问所提供的 SAP S/4HANA Cloud 系统。
练习
第 1 部分:
自定义 BO 检查结果
自定义 BO 检查清单
自定义通信场景
通信系统与通信安排
第 2 部分:
设置目标(Destination)
使用示例产品创建采购订单
使用 SAP Build Apps 创建前端应用
故障排查
如果在某些练习中卡住,请查看已知问题。
已知问题
登录问题
如果您确认凭据正确却仍然无法登录(例如出现 "Your Domain is not trusted" 提示),那很可能是您的浏览器在登录触发的 SAML 流程中不允许第三方 Cookie。请尝试启用 Cookie。以下是 Chrome 的示例:
打开浏览器设置,选择 Privacy and security 部分,然后选择 Cookies and other site data。

选择 Allow all cookies。如果您不想(或不允许)这样做,也可以进行更精细的设置:在 Customized behaviors 区域选择 Add。

添加以下站点(别忘了勾选 Including third-party cookies on this site 选项):
- [*.]accounts400.ondemand.com
- [*.]accounts.ondemand.com
- [*.]lab.s4hana.cloud.sap

S/4HANA 中的按钮或链接不可用
有时您需要点击的按钮或链接处于不可用状态。例如,为自定义对象添加目录后,您可以进入生成的 UI,但该链接有时无法点击。这是浏览器缓存造成的。要解决此问题,请关闭浏览器后重新登录,之后按钮/链接应该就可以访问了。
使用 SAP Build Apps 创建前端应用
简介
前端应用需要访问此前准备好的所有数据。仓库用户应能搜索特定的采购订单行项目,并查看与该产品相关的所有检查。用户可以决定是否需要执行额外的检查,并保存检查后发现的全部信息。如果某项检查不通过,则应在 SAP 系统中创建相应的缺陷,供后台人员后续处理。
任务流程
在本练习中,您将执行以下任务:
基于模板创建新应用
安装与 SAP 系统数据的集成
创建用于搜索的数据变量
添加搜索按钮逻辑
添加搜索结果列表
添加下一页导航逻辑
添加检查清单页面初始化逻辑
添加保存检查按钮逻辑
测试应用
前提条件
您已成功完成前面所有练习
最好具备 SAP Build Apps 的基础技能。您可以先学习这个学习路径。
内容
任务 1:创建新应用
打开 SAP Build Apps 大厅
a) 转到您的 SAP BTP 子账户。
b) 选择 Instances and Subscriptions。
c) 选择 SAP Build Apps 应用旁的 Go to Application 图标,打开 SAP Build Apps 大厅。

d) 如果系统提示,请使用您的用户名和密码登录。
复制一个模板应用
a) 在列表中找到 DeliveryCheck 应用,然后选择 More Options 按钮。
b) 在弹出的菜单中选择 Save as New Project。

c) 输入 DeliveryCheck_<YOUR_ID> 作为项目名称,然后单击 Save as new 按钮继续。

d) 复制后的应用会在设计模式中打开。
任务 2:安装数据集成
设置 SAP BTP 身份验证
a) 选择 Auth 按钮切换到身份验证部分,然后在那里选择 Enable Authentication 按钮。

b) 在弹出的窗口中选择 SAP BTP authentication 磁贴。

c) 选择 OK 按钮,确认添加视图和流。

添加 SAP 系统集成
a) 在 Data 选项卡中选择 Add integration 按钮,然后选择 BTP Destinations 按钮。

b) 在目标列表中,选择 S4HC_BASIC_PO 目标(如果使用 mock 服务器,则选择 MOCK_PURCHASE_ORDER)。

c) 选择 Install Integration 按钮。

d) 选择 PurchaseOrderItem 实体,然后选择 Enable Data Entity 按钮。

e) 对以下目标和实体重复步骤 (a) 到 (d):
目标 S4HC_BASIC_PCLFN(使用 mock 服务器时为 MOCK_PRODUCT_CLASSIFICATION),实体 A_ProductCharcValue
目标 S4HC_BASIC_DEFECT(使用 mock 服务器时为 MOCK_DEFECT),实体 Defect
目标 S4HC_BASIC_GRCHECK_<YOUR_ID>(使用 mock 服务器时为 MOCK_GRCHECK),实体 YY1_GRCHECK_<YOUR_ID>
目标 S4HC_BASIC_CHECKLIST_<YOUR_ID>(使用 mock 服务器时为 MOCK_CHECKLIST),实体 YY1_CHECKLIST_<YOUR_ID>
对于 YY1_CHECKLIST_<YOUR_ID> 实体,请务必勾选 to_CHECKLIST_ITEM 复选框:

f) 最终的 SAP 系统集成列表应如下所示:

g) 稍后我们需要知道产品分类特性被分配了哪个内部 ID。这可以借助若干 API 动态获取,但为了教程简洁,此 ID 将在应用中硬编码。要获取该 ID,请打开产品分类集成,找到已启用的实体。

h) 选择 Browse Real Data 按钮。

i) 在搜索框旁的列表中选择 Search by Product。输入您在后端分类过的产品名称(mock 服务器场景请使用 MAT003),然后按键盘上的 Enter。向右滚动结果列表,直到出现 CharcInternalID 列。记下该内部 ID 的值——后续步骤会用到。

任务 3:创建数据变量
创建数据变量
a) 选择屏幕左上角的切换页面按钮。

b) 选择 Selection Screen 页面磁贴。

c) 这是应用第一个页面的布局。

d) 切换到 View/variables,进入变量部分。

e) 在左侧选择 Data Variables,然后选择 Add Data Variable 按钮。

f) 在弹出的菜单中选择 PurchaseOrderItem 实体作为新变量的引用。

g) 新建的数据变量总是带有默认逻辑,即每 5 秒从后端读取一次数据。我们不需要这种行为。要删除它,请选中新变量,然后选择屏幕底部的 Add Logic 按钮。

h) 选中全部三个逻辑块,然后按键盘上的 Delete 键。

i) 切换回布局视图。

任务 4:添加搜索按钮逻辑
添加基于搜索条件读取数据的逻辑
a) 在页面布局中选择 Search 按钮,然后选择 Show logic for SEARCHBUTTON 按钮。

b) 将 Get record collection 逻辑块拖到逻辑构建器中标记的位置。

c) 在 Properties 面板中,将资源名称设置为 PurchaseOrderItem。选择 Filter conditions 按钮,然后选择 Object with properties 绑定选项。

d) 选择 Add condition 按钮,在 Property 列表中选择 PurchaseOrder。然后选择 Compared value 字段,导航到 Data and Variables → Page Variables,再选择 PurchaseOrder 页面变量。选择 Add condition 按钮,为 Material 属性和 Material 页面变量添加另一个条件。

e) 如果保持这个筛选条件不变,用户就必须填写屏幕上的两个选择字段才能得到结果。但标准的搜索体验是:字段未填写时忽略该字段。我们来用一个小技巧实现这一点。 对于属性 PurchaseOrder,选择 ABC 按钮 → Formula,然后复制以下公式:
IF(IS_EMPTY(pageVars.PurchaseOrder),"minimum","equal")

f) 对第二个条件重复相同操作。使用以下公式:
IF(IS_EMPTY(pageVars.Material),"minimum","equal")
g) 最终的筛选条件应如下图所示。选择 Save 按钮退出。

h) 将逻辑块连接到 Component tap 事件。

将结果保存到数据变量
a) 将 Set data variable 逻辑块拖到逻辑构建器中标记的位置。

b) 将逻辑块的输入连接到上一个逻辑块的上方输出。

c) 在 Properties 面板中,将数据变量名称设置为 PurchaseOrderItem1。选择 Record collection 按钮,返回 Select Binding Type,选择 Output value of another node 绑定选项。

d) 在 Select logic node 字段中选择 Get record collection。在 Select node output 字段中选择 Collection of records。然后选择 Save 按钮。

任务 5:添加结果列表
准备结果列表
a) 选中页面布局底部的列表项,然后在 Properties 面板中单击 Repeat with 字段中的按钮。

b) 将数据变量 PurchaseOrderItem1 指定为 Repeat with 属性的绑定。
c) 选择 Primary label 字段,然后选择 Formula。使用以下公式:
repeated.current.PurchaseOrderItemText + " (" + repeated.current.Material + ")"

d) 为 Secondary label 指定公式绑定。使用以下公式:
repeated.current.PurchaseOrder + " / " + repeated.current.PurchaseOrderItem

e) Properties 选项卡现在应如下所示:

测试搜索功能
a) 现在可以测试搜索的工作效果了。选择 Launch 按钮。

b) 在下一个屏幕中选择 Open Preview Portal 按钮。

c) 选择 Open Web Preview 按钮,然后在下一个屏幕中选择您的应用(DeliveryCheck_<YOUR_ID>)。

d) 您应该会看到以下页面:

e) 您可以输入一些搜索条件,也可以让所有字段保持为空。选择 Search 按钮,结果列表将根据您的条件填充。您可以试着选择任意结果项——不会有任何反应,该功能将在下一步添加。

f) 您可以保持预览选项卡打开。设计期间的所有更新都会立即重新加载预览。
任务 6:添加导航逻辑
添加自定义业务对象检查
a) 在进入下一页之前,我们希望知道该采购订单行项目是否已完成所有检查。为此,我们将尝试读取相应的自定义业务对象实例,只有在没有找到记录时才执行导航。选中结果列表项组件,然后选择 Add logic to RESULTSLIST 按钮。

b) 将 Get record collection 逻辑块拖到逻辑构建器中标记的位置。

c) 在 Properties 面板中,将资源名称设置为 YY1_GRCHECK_<YOUR_ID>。选择 Filter collection 按钮,然后选择 Object with properties 绑定选项。

d) 选择 Add condition 按钮,在 Property 字段中选择 PurchaseOrder。为 Compared value 字段指定 Data item in repeat 绑定选项,并选择 PurchaseOrder 字段。用 Add condition 按钮再添加一个筛选项,将 Property 设为 PurchaseOrderItem,将 Compared value 设为重复字段 PurchaseOrderItem。选择 Save 按钮退出。

e) 将逻辑块连接到 Component tap 事件。

添加条件块
a) 将 If condition 逻辑块拖到逻辑构建器中标记的位置。

b) 按下图所示将它连接到其他逻辑块:

c) 在 Properties 面板中选择 Condition 按钮,然后选择公式绑定选项。

d) 使用以下公式,然后选择 Save 按钮。
IS_EMPTY(outputs["Get record collection"].records)

添加导航
a) 将 Open page 逻辑块拖到逻辑构建器中标记的位置。

b) 在 Properties 面板中填写以下数据:
将 Page 字段设置为 Checklist
为 Product 字段指定 Data item in repeat 绑定选项,并选择 Material 字段。
为 PurchaseOrder 字段指定 Data item in repeat 绑定选项,并选择 PurchaseOrder 字段。
为 PurchaseOrderItem 字段指定 Data item in repeat 绑定选项,并选择 PurchaseOrderItem 字段。
为 PurchaseOrderItemDescription 字段指定 Data item in repeat 绑定选项,并选择 PurchaseOrderItemText 字段。

c) 按下图所示,将逻辑块连接到 If condition 块:

测试导航
现在可以测试导航了。单击任意结果列表项,应该会导航到下一页。但页面容器会是空的,我们将在下一步修复。

任务 7:添加检查清单页面逻辑
获取所有检查清单
a) 选择屏幕左上角的切换页面按钮。

b) 选择 Checklist 页面磁贴。

c) 确保屏幕上没有选中任何组件。只有这时,您才能通过选择 Show logic for CHECKLIST 按钮访问页面逻辑。

d) 将 Get record collection 逻辑块拖到逻辑构建器中标记的位置。

e) 在 Properties 面板中,将资源名称设置为 YY1_CHECKLIST_<YOUR_ID>。在 Properties 选项卡的 Advanced 区域中,将逻辑块名称设置为 Get all checklists。

f) 将逻辑块连接到 Page mounted 事件。

获取产品分类数据
a) 将 Get record collection 逻辑块拖到逻辑构建器中标记的位置。

b) 在 Properties 面板中,将资源名称设置为 A_ProductCharcValue。为 Filter condition 字段指定 Object with properties 绑定选项。

c) 设置以下条件,然后选择 Save 按钮退出。
在 Property 字段中选择 ClassType。在 Compared value 字段中输入 001。
在 Property 字段中选择 Product。将页面参数 Product 指定给 Compared value 字段。
在 Property 字段中选择 CharcInternalID。在 Compared value 字段中输入任务 2 步骤 3(i) 中记下的值(mock 服务器场景请使用 777)。

d) 在 Properties 选项卡的 Advanced 区域中,将逻辑块名称设置为 Get product classification。

e) 将逻辑块的输入连接到 Get all checklists 节点的上方输出。

将产品分类与检查清单匹配
a) 将 Set page variable 逻辑块拖到逻辑构建器中标记的位置。

b) 按下图所示,将该逻辑块连接到其他节点。

c) 在 Properties 面板中,将变量名称设置为 Checklists。为 Assigned value 字段指定 Formula 绑定选项。

d) 使用以下公式,然后选择 Save 按钮退出。
对于 S4HANA Cloud 后端:
MAP(outputs["Get all checklists"].records, { name: item.Name, default: item.IsDefault, description: item.Description, instructions: item.Instructions, checks: MAP(item.to_CHECKLIST_ITEM.results, item.CheckText), checked: item.IsDefault || IS_IN_ARRAY_BY_KEY(outputs["Get product classification"].records, "CharcValue", item.Name) })
对于 Mock 服务器后端:
MAP(outputs["Get all checklists"].records, { name: item.Name, default: item.IsDefault, description: item.Description, instructions: item.Instructions, checks: MAP(item.to_CHECKLIST_ITEM, item.CheckText), checked: item.IsDefault || IS_IN_ARRAY_BY_KEY(outputs["Get product classification"].records, "CharcValue", item.Name) })

测试检查清单页面布局
a) 您可以再次预览结果。在第一屏选择搜索按钮,然后在结果列表中选择任意一项。您将进入下一个屏幕,其中所有字段都已根据您的分类和检查清单详情设置好。

b) 不要点击 Save checks 按钮——其中的逻辑尚未完成,将在下一步添加。
任务 8:添加保存按钮逻辑
保存缺陷数据
a) 返回页面布局设计器。选择 Save checks 按钮,然后选择 Show logic for SAVEBUTTON 按钮。

b) 将 Create record 逻辑块拖到逻辑构建器中标记的位置。

c) 在 Properties 面板中,将资源名称设置为 Defect。为 Record 字段指定 Formula 绑定选项。

d) 使用以下公式,然后选择 Save 按钮退出。
{DefectText: "Checks for PO Item " + params.PurchaseOrder + "/" + params.PurchaseOrderItem, DefectCodeGroup: "DEF-PACK", DefectCode: "0001", "_DefectDetailedDescription": [{ LongTextInternalNumber: 1, Language: "EN", DefectLongText: "Failed checks:" + REDUCE_INIT(pageVars.Checks,"",IF(NOT(item.status),accumulator+"\n- "+item.name+" ("+item.result+")",accumulator)) }] }

e) 按下图所示,将该逻辑块连接到其他节点。

保存自定义对象数据
a) 将 Create record 逻辑块拖到逻辑构建器中标记的位置。

b) 在 Properties 面板中,将资源名称设置为 YY1_GRCHECK_<YOUR_ID>。为 Record 字段指定 Formula 绑定选项。

c) 使用以下公式,然后选择 Save 按钮退出。
{ "PurchaseOrder": params.PurchaseOrder, "PurchaseOrderItem": params.PurchaseOrderItem, "to_GRCHECKITEM": MAP(pageVars.Checks, {"CheckName": item.name, "CheckResult": item.result, "CheckStatus": IF(item.status,"X","")}) }

d) 按下图所示,将该逻辑块连接到其他节点。

任务 9:测试应用
测试应用
a) 应用现在已就绪。您可以用自己的条件搜索,然后选择结果项,根据检查清单数据执行检查。您甚至可以在应用中指定其他检查清单。试着操作第二屏的各个组件,了解其工作方式。为了进行后续正式测试,请至少将一项检查标记为失败,如下方截图所示。选择 Save checks 按钮后,相应数据将保存到后端(mock 服务器场景下只会模拟保存)。

b) 如果在成功保存后再次选择同一个采购订单行项目,您应该会看到以下弹窗:

检查缺陷的保存结果
a) 如果您连接的是真实的 SAP 系统(而不是 mock 服务器),可以检查应用的保存结果。您需要为任意采购订单行项目保存检查。请确保有部分检查失败,如步骤 1(a) 的截图所示。
b) 转到 Process Defects 应用。

c) 在 Created on 筛选字段中设置与创建时间对应的时间范围。选择 Go 按钮进行搜索。

d) 在结果列表中根据描述找到您的缺陷。选中相应的行。

e) 检查 Defect Detailed Description 字段中是否只填写了未通过的检查。

检查自定义对象的保存结果
a) 转到 Custom Business Objects 应用。

b) 选择 YY1_GRCHECK_<YOUR_ID> 对象。

c) 选择 Go To Generated UI 按钮。

d) 在搜索中选择 Go 按钮,根据 Purchase Order 和 Purchase Order Item 字段找到您的对象。

e) 确认所有检查结果都出现在 GRCHECKITEMs 区域中。

结果
您已经使用 SAP Build Apps 创建并测试了前端应用。建议您检查并研究模板中使用的所有组件和逻辑块,因为本教程并未覆盖全部内容。
延伸阅读 / 参考链接(推荐)
示例:
在 SAP S/4HANA Cloud 中为检查清单数据构建自定义业务对象
使用场景 / 简介
为了存储物料分类中使用的检查清单数据,我们可以再创建一个自定义对象。它将为关键用户提供一个简单的 UI,用于填写检查清单的名称、描述、检查项信息、操作说明和注意事项等数据。
任务流程
在本练习中,您将执行以下任务:
使用 Custom Business Object 应用创建自定义业务对象。
为自定义业务对象分配业务目录。
填写测试数据。
内容
任务 1:创建自定义业务对象
创建新的自定义业务对象
a) 打开 Custom Business Objects 应用。

b) 选择 New

c) 输入名称 CHECKLIST_<YOUR_ID>
d) 选择 Standard 场景
e) 按 Create

创建业务对象节点和字段
a) 选择 General Information 选项卡,并确认以下特性:
确定与校验(Determination and Validation)
用户界面(User Interface)
后端服务(Back End Service)
系统管理数据(System Administrative Data)

b) 选择 Nodes 选项卡,选中 CHECKLIST_<YOUR_ID> 行,然后选择 New 按钮添加新的子节点 CHECKLIST_ITEM。

c) 在 Fields 选项卡中选择 CHECKLIST_<YOUR_ID> 节点。除自动生成的字段外,选择 New 并添加以下字段:
标签
标识符
类型
长度
键
Name
Name
Text
10
x
Is Default
IsDefault
Checkbox
Description
Description
Text
500
Instructions
Instructions
Text
500

d) 选择 CHECKLIST_ITEM 节点。选择 New 并添加以下字段:
标签
标识符
类型
长度
Check Text
CheckText
Text
500

发布自定义业务对象
a) 保存配置并选择 Publish。此过程需要一些时间。

b) 发布成功后,您会在业务对象上看到绿色的 Published 标记。
任务 2:为业务对象分配业务目录
要以用户传播的方式安全访问 Checklist API,我们需要为其分配一个业务目录。 在我们的场景中,使用 Materials Management - Purchase Orders 目录,因为后续练习中访问采购订单 API 也需要它。
维护目录
a) 返回 Custom Business Objects 应用,选择 CHECKLIST_<YOUR_ID> 业务对象。

b) 在 General Information 选项卡中选择 Maintain Catalogs

c) Custom Catalog Extension 应用随即启动。
为 YY1_CHECKLIST_<YOUR_ID>_SCBO 分配业务目录
a) 在 Custom Catalog Extension 表的 Search 筛选字段中搜索 YY1_CHECKLIST_<YOUR_ID>_SCBO

b) 在 Used in Business Catalog 窗口中选择 Add。

c) 在 Add Business Catalog 弹出窗口中搜索 Materials Management - Purchase Orders 目录并选中它。按 OK。

d) 在 Used in Business Catalog 窗口中选择 Materials Management - Purchase Orders 目录,然后按 Publish。

为 YY1_CHECKLIST_<YOUR_ID>_CDS_IBS 分配业务目录
a) 在 Custom Catalog Extension 表中选中 YY1_CHECKLIST_<YOUR_ID>_CDS_IBS

b) 重复第 2 节中的步骤 b) 到 d)。
任务 3:填写初始数据
打开生成的 UI
a) 返回 Custom Business Objects 应用,选择 CHECKLIST_<YOUR_ID> 业务对象。

b) 在 General Information 选项卡中选择 Go To Generated UI

注意
如果 Go To Generated UI 按钮不可用,请尝试注销后重新登录。
创建抬头数据
a) 在新屏幕中选择 Create 按钮。

b) 填写以下数据,然后选择 Create 按钮:
Name(名称):DEFAULT
Is Default(是否默认):Checked
Description(描述):Default checklist
Instructions(操作说明):Follow the general rules of your organization

创建行项目数据
a) 在 CHECKLIST_ITEMs 区域中选择 Create 按钮。

b) 在 Check Text 字段中输入 Have the goods been ordered?,然后选择 Create 按钮。

c) 单击顶部的检查清单名称返回该清单,然后新建一个检查项,文本为 Is the packaging undamaged?。

对以下检查清单重复前面的步骤两次:
检查清单 2:
Name(名称):DANGER
Default(是否默认):False
Description(描述):Dangerous goods
Instructions(操作说明):Use safety gloves
Checklist item(检查项):
Is the UN number recognizable?
检查清单 3:
Name(名称):CHEMICAL
Default(是否默认):False
Description(描述):Chemical product
Instructions(操作说明):Follow respiratory hygiene principles
Checklist item(检查项):
Is a MSDS enclosed with the goods?
结果
您已创建自定义业务对象来存储检查清单数据,添加了用于安全访问的业务目录,并向该对象预填了数据。
在下一个练习中,您将为必要 API 的外部访问定义通信系统和通信安排。
延伸阅读 / 参考链接
在 SAP S/4HANA Cloud 中设置通信系统与通信安排
使用场景 / 简介
要允许与 SAP S/4HANA 租户进行入站通信,您需要显式允许 API 能被 SAP BTP 等外部系统访问。
任务流程
在本练习中,您将执行以下任务:
为基本身份验证创建通信系统与通信安排
内容
任务 1:为基本身份验证创建通信系统与通信安排
在 SAP S/4HANA Cloud 中创建通信系统
a) 登录您的 SAP S/4HANA Cloud 系统。
b) 搜索并打开 Communication Systems 应用
c) 选择 New

d) 使用上一练习中的 ID(例如 AB123),将 GRCHECK_BASIC_<YOUR_ID> 设置为 System ID
e) 选择 Create

定义通信系统并创建通信用户
a) 在 Technical Data 部分勾选 Inbound Only 复选框。
a) 设置逻辑系统(例如 S4H)和唯一的业务系统 ID(使用您的 ID,例如 AB123)。

c) 为 Inbound Communication 添加用户

d) 在 New Inbound Communication User 弹窗中选择 New User

e) 在 Create Communication User 窗格中,将 GRCHECK_<YOUR_ID> 设置为 User Name,将 User for API communication 设置为 Description
f) 生成一个密码,并将其复制到密钥存储中。下一个练习会用到它。

g) 选择 Create 保存通信用户。在弹窗中选择 OK,将其添加到通信系统。

h) 保存通信系统
为自定义业务对象创建通信安排:
a) 打开 Communication Arrangements 应用,然后选择 New
b) 选择 YY1_GRCHECK_<YOUR_ID> 场景,添加一个 Arrangement Name。按 Create

c) 在 Communication Arrangement 面板中,选择您在上一节中创建的通信系统。通信用户会自动添加。
d) 复制两个 Service URL。下一个练习会用到它们。选择 Save。

结果
您已创建通信系统与通信安排,为我们的场景公开相关数据。在下一个练习中,我们将在 SAP BTP 一侧设置通信部分。
延伸阅读 / 参考链接
在 SAP S/4HANA Cloud 中设置自定义通信场景
使用场景 / 简介
由于 S/4HANA Cloud 中的所有通信设置都基于通信场景,您需要创建一个自定义通信场景,其中包含自定义业务对象提供的服务。
任务流程
在本练习中,您将执行以下任务:
创建并发布自定义通信场景
内容
任务 1:创建自定义通信场景
要公开自定义业务对象,我们必须创建自定义通信场景。
a) 打开 Custom Communication Scenarios 应用

b) 选择 New

c) 添加场景名称 GRCHECK_<YOUR_ID> 和描述,例如 GR Checklist APIs。选择 New

选择自定义业务对象
a) 选择 Inbound Services 选项卡,然后按 Add

b) 选择 YY1_GRCHECK_<YOUR_ID>_CDS(可以使用筛选字段),然后按 Select

c) 对 YY1_CHECKLIST_<YOUR_ID>_CDS 自定义业务对象重复此操作

任务 2:发布自定义通信场景
发布通信场景
a) Save 您的更改,然后按 Publish

b) 稍后,通信场景的状态会切换为 Published

注意
发布过程可能因不同用户同时执行发布操作而失败。遇到这种情况,稍后重新发布即可。
延伸阅读 / 参考链接
配置从 SAP BTP 到 SAP S/4HANA Cloud 的端到端通信
简介
本节中,您将配置 SAP S/4HANA Cloud 系统与 SAP BTP 子账户之间的端到端通信,使运行在 SAP BTP 子账户中的应用能够使用 SAP S/4HANA 系统上运行的 OData 服务。
任务流程
在本练习中,您将执行以下任务:
为 API GRCHECK_<YOUR_ID> 定义目标(Destination)
为 API CHECKLIST_<YOUR_ID> 定义目标(Destination)
内容
为 SAP S/4HANA Cloud 创建目标(Destination)
在 SAP BTP Cockpit 中,导航到您的子账户。
在左侧子账户菜单中,导航到 Connectivity → Destinations。

要添加新目标,您需要 SAP S/4HANA 系统 URL。取上一练习中复制的 API URL 的第一部分。例如,目标配置使用 https://myXXXXX-api.s4hana.ondemand.com/。
为 YY1_GRCHECK_<YOUR_ID> 添加目标
a) 为 SAP S/4HANA Cloud 系统配置目标。用户为上一练习中创建的通信用户
名称
值
Name
S4HC_BASIC_GRCHECK_<YOUR_ID>
Type
HTTP
URL for SAP S/4HANA
https://myXXXXX-api.s4hana.ondemand.com/sap/opu/odata/sap/YY1_GRCHECK_<YOUR_ID>_CDS
<change to your URL>Proxy Type
Internet
Authentication (only needed for SAP S/4HANA)
BasicAuthentication
User
你的通信用户名
Password
你的通信用户密码
b) 添加属性
属性
值
HTML5.DynamicDestination
true
HTML5.Timeout
60000
WebIDEEnabled
true
WebIDEUsage
odata_gen
Use default JDK truststore
勾选复选标记
c) 选择 Save

为 YY1_CHECKLIST_<YOUR_ID> 添加目标
a) 为 SAP S/4HANA Cloud 系统配置目标。用户为上一练习中创建的通信用户
名称
值
Name
S4HC_BASIC_CHECKLIST_<YOUR_ID>
Type
HTTP
URL for SAP S/4HANA
https://myXXXXX-api.s4hana.ondemand.com/sap/opu/odata/sap/YY1_CHECKLIST_<YOUR_ID>_CDS
<change to your URL>Proxy Type
Internet
Authentication (only needed for SAP S/4HANA)
BasicAuthentication
User
你的通信用户名
Password
你的通信用户密码
b) 添加属性
属性
值
HTML5.DynamicDestination
true
HTML5.Timeout
60000
WebIDEEnabled
true
WebIDEUsage
odata_gen
Use default JDK truststore
勾选复选标记
c) 选择 Save

结果
现在您已创建了在 BTP 与 SAP S/4HANA Cloud 之间传输数据所需的全部目标。
在 SAP S/4HANA Cloud 中为收货检查构建自定义业务对象
使用场景 / 简介
为了进一步校验并留存收货检查结果的历史记录,您可以将其存储在 SAP S/4HANA 系统中。无需编写任何代码即可做到这一点的方法是创建自定义业务对象。
任务流程
在本练习中,您将执行以下任务:
使用 Custom Business Object 应用创建自定义业务对象。
为自定义业务对象分配业务目录。
内容
任务 1:创建自定义业务对象
创建新的自定义业务对象
a) 打开 Custom Business Objects 应用。

b) 选择 New

c) 设置自定义业务对象的名称。
业务对象的名称必须唯一,并且为了区分工作坊中所有参与者的对象,请使用以下命名约定:在自定义业务对象 GRCHECK_<YOUR_ID> 后加上您的姓名首字母和一个 3 位数字,例如 GRCHECK_AB123。
d) 选择 Standard 场景
e) 按 Create

创建业务对象节点和字段
a) 选择 General Information 选项卡,并确认以下特性:
确定与校验(Determination and Validation)
用户界面(User Interface)
后端服务(Back End Service)
系统管理数据(System Administrative Data)

b) 选择 Nodes 选项卡,选中 GRCHECK_<YOUR_ID> 行,然后选择 New 按钮添加新的子节点 GRCHECKITEM。

c) 在 Fields 选项卡中选择 GRCHECK_<YOUR_ID> 节点。除自动生成的字段外,选择 New 并添加以下字段:
标签
标识符
类型
长度
键
Purchase Order
PurchaseOrder
Text
10
x
Purchase Order Item
PurchaseOrderItem
Numeric Identifier
4
x

d) 选择 GRCHECKITEM 节点。选择 New 并添加以下字段:
标签
标识符
类型
长度
Check Name
CheckName
Text
100
Check Status
CheckStatus
Text
1
Check Result
CheckResult
Text
500

发布自定义业务对象
a) 保存配置并选择 Publish。此过程需要一些时间。

b) 发布成功后,您会在业务对象上看到绿色的 Published 标记。
任务 2:为业务对象分配业务目录
要以用户传播的方式安全访问 GRCHECK API,我们需要为其分配一个业务目录。 在我们的场景中,使用 Materials Management - Purchase Order 目录,因为后续练习中访问采购订单 API 也需要它。
维护目录
a) 返回 Custom Business Objects 应用,选择 GRCHECK_<YOUR_ID> 业务对象。

b) 在 General Information 选项卡中选择 Maintain Catalogs

c) Custom Catalog Extension 应用随即启动。
为 YY1_GRCHECK_<YOUR_ID>_SCBO 分配业务目录
a) 在 Custom Catalog Extension 表的 Search 筛选字段中搜索 YY1_GRCHECK_<YOUR_ID>_SCBO

b) 在 Used in Business Catalog 窗口中选择 Add。

c) 在 Add Business Catalog 弹出窗口中搜索 Materials Management - Purchase Orders 目录并选中它。按 OK。

d) 在 Used in Business Catalog 窗口中选择 Materials Management - Purchase Orders 目录,然后按 Publish。

为 YY1_GRCHECK_<YOUR_ID>_CDS_IBS 分配业务目录
a) 在 Custom Catalog Extension 表中选中 YY1_GRCHECK_<YOUR_ID>_CDS_IBS

b) 重复第 2 节中的步骤 b) 到 d)。
结果
您已创建自定义业务对象来存储收货检查的结果,并添加了用于安全访问的业务目录。
在下一个练习中,您将再创建一个自定义业务对象来存储检查清单数据。
延伸阅读 / 参考链接
创建采购订单
使用场景 / 简介
采购员创建采购订单。之后订购的货物到达仓库,仓库工作人员可以扫描货物并在系统中找到该采购订单。请注意,本练习使用 WORKSHOP 物料。该物料已使用自定义物料分类进行分类。您可以在 Manage Product Master Data 应用的 Classification 选项卡中查看。
任务流程
在本练习中,您将执行以下任务:
创建采购订单
内容
任务 1:创建采购订单
打开 Manage Purchase Orders 应用,然后选择 Create。

在 General Information 部分输入相关数据。
a) Purchasing Doc. Type:Standard PO (NB)
b) Supplier:10300001
c) Currency:EUR
d) Purchasing Group:001
e) Purchasing Organisation:1010
d) Company Code:1010

创建新的采购订单行项目
a) 转到 Items 部分
b) 选择 Create

Purchase Order Item 应用打开。在该应用中填写以下内容:
a) Material:WORKSHOP
b) Plant:1010
c) Order Quantity:1 PC
d) Net Order Price:0.50
e) Price Unit:1 PC
f) 在 Delivery Address 部分,各字段应已预填。您可以根据需要修改。
g) 选择 Apply 按钮。

返回 Purchase Order 应用,选择 Order

如果设置了自动审批,采购订单将被创建。请记下订单号,以便稍后在 Build Apps 中使用

结果
您已使用 WORKSHOP 物料创建了新的采购订单。采购订单创建完成后,您就可以创建 Goods Delivery Check 应用了。