端到端扩展场景用例集 · 场景第一部分

项目

内容

官方仓库

SAP-samples/btp-end-to-end-scenario-use-cases

业务场景

以 S/4HANA 公有云为起点的多个完整并行扩展场景

技术栈

SAP BTP、CAP、Cloud Foundry / Kyma、目标(Destination)、通信安排、事件

对应课程

CLD200、BAS400、CF400、KYM400

对应路径

第 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 部分:

  1. 自定义 BO 检查结果

  2. 自定义 BO 检查清单

  3. 自定义通信场景

  4. 通信系统与通信安排

第 2 部分:

  1. 设置目标(Destination)

  2. 使用示例产品创建采购订单

  3. 使用 SAP Build Apps 创建前端应用

故障排查

如果在某些练习中卡住,请查看已知问题。

已知问题

登录问题

如果您确认凭据正确却仍然无法登录(例如出现 "Your Domain is not trusted" 提示),那很可能是您的浏览器在登录触发的 SAML 流程中不允许第三方 Cookie。请尝试启用 Cookie。以下是 Chrome 的示例:

  1. 打开浏览器设置,选择 Privacy and security 部分,然后选择 Cookies and other site data。

Browser settings

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

Allowed cookies

  1. 添加以下站点(别忘了勾选 Including third-party cookies on this site 选项):

- [*.]accounts400.ondemand.com
- [*.]accounts.ondemand.com
- [*.]lab.s4hana.cloud.sap

New site

S/4HANA 中的按钮或链接不可用

有时您需要点击的按钮或链接处于不可用状态。例如,为自定义对象添加目录后,您可以进入生成的 UI,但该链接有时无法点击。这是浏览器缓存造成的。要解决此问题,请关闭浏览器后重新登录,之后按钮/链接应该就可以访问了。

使用 SAP Build Apps 创建前端应用

简介

前端应用需要访问此前准备好的所有数据。仓库用户应能搜索特定的采购订单行项目,并查看与该产品相关的所有检查。用户可以决定是否需要执行额外的检查,并保存检查后发现的全部信息。如果某项检查不通过,则应在 SAP 系统中创建相应的缺陷,供后台人员后续处理。

任务流程

在本练习中,您将执行以下任务:

  1. 基于模板创建新应用

  2. 安装与 SAP 系统数据的集成

  3. 创建用于搜索的数据变量

  4. 添加搜索按钮逻辑

  5. 添加搜索结果列表

  6. 添加下一页导航逻辑

  7. 添加检查清单页面初始化逻辑

  8. 添加保存检查按钮逻辑

  9. 测试应用

前提条件

  • 您已成功完成前面所有练习

  • 最好具备 SAP Build Apps 的基础技能。您可以先学习这个学习路径。

内容

任务 1:创建新应用

  1. 打开 SAP Build Apps 大厅

    a) 转到您的 SAP BTP 子账户。

    b) 选择 Instances and Subscriptions。

    c) 选择 SAP Build Apps 应用旁的 Go to Application 图标,打开 SAP Build Apps 大厅。

    Build Apps Subscription

    d) 如果系统提示,请使用您的用户名和密码登录。

  2. 复制一个模板应用

    a) 在列表中找到 DeliveryCheck 应用,然后选择 More Options 按钮。

    b) 在弹出的菜单中选择 Save as New Project。

    Save as a new project

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

    New project name

    d) 复制后的应用会在设计模式中打开。

任务 2:安装数据集成

  1. 设置 SAP BTP 身份验证

    a) 选择 Auth 按钮切换到身份验证部分,然后在那里选择 Enable Authentication 按钮。

    Auth tab

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

    SAP BTP Authentication

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

    Authorization popup

  2. 添加 SAP 系统集成

    a) 在 Data 选项卡中选择 Add integration 按钮,然后选择 BTP Destinations 按钮。

    Add SAP systems integration

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

    Select destination

    c) 选择 Install Integration 按钮。

    Install integration button

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

    Enable data entity for PO

    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 复选框:

      Enable data entity for PO

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

    SAP integration list

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

    Get ID - select integration

    h) 选择 Browse Real Data 按钮。

    Get ID - browse real data

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

    Get ID - right column

任务 3:创建数据变量

  1. 创建数据变量

    a) 选择屏幕左上角的切换页面按钮。

    Page switch button

    b) 选择 Selection Screen 页面磁贴。

    Select first page

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

    Page 1 - initial view

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

    Switch to variables

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

    Page 1 Data Variable add button

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

    Data variable - popup menu

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

    Data variable - add logic

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

    Data variable - delete default logic

    i) 切换回布局视图。

    Switch to variables

任务 4:添加搜索按钮逻辑

  1. 添加基于搜索条件读取数据的逻辑

    a) 在页面布局中选择 Search 按钮,然后选择 Show logic for SEARCHBUTTON 按钮。

    Search - show logic

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

    Search - adding get block

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

    Search - get block details

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

    Search - get block filter

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

    IF(IS_EMPTY(pageVars.PurchaseOrder),"minimum","equal")
    

    Search - get block filter formula

    f) 对第二个条件重复相同操作。使用以下公式:

    IF(IS_EMPTY(pageVars.Material),"minimum","equal")
    

    g) 最终的筛选条件应如下图所示。选择 Save 按钮退出。

    Search - get block filter ready

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

    Search - add get block

  2. 将结果保存到数据变量

    a) 将 Set data variable 逻辑块拖到逻辑构建器中标记的位置。

    Search - adding set block

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

    Search - add set block

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

    Search - set block details

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

    Search - set block binding

任务 5:添加结果列表

  1. 准备结果列表

    a) 选中页面布局底部的列表项,然后在 Properties 面板中单击 Repeat with 字段中的按钮。

    Results repeat

    b) 将数据变量 PurchaseOrderItem1 指定为 Repeat with 属性的绑定。

    c) 选择 Primary label 字段,然后选择 Formula。使用以下公式:

    repeated.current.PurchaseOrderItemText + " (" + repeated.current.Material + ")"
    

    Results primary formula

    d) 为 Secondary label 指定公式绑定。使用以下公式:

    repeated.current.PurchaseOrder + " / " + repeated.current.PurchaseOrderItem
    

    Results secondary formula

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

    Results binding

  2. 测试搜索功能

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

    Preview button

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

    Preview or build

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

    Web preview

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

    Page 1 demo

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

    Search demo

    f) 您可以保持预览选项卡打开。设计期间的所有更新都会立即重新加载预览。

任务 6:添加导航逻辑

  1. 添加自定义业务对象检查

    a) 在进入下一页之前,我们希望知道该采购订单行项目是否已完成所有检查。为此,我们将尝试读取相应的自定义业务对象实例,只有在没有找到记录时才执行导航。选中结果列表项组件,然后选择 Add logic to RESULTSLIST 按钮。

    Show logic button

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

    Custom BO block adding

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

    Custom BO block details

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

    Custom BO block filter

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

    Custom BO block add

  2. 添加条件块

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

    If block adding

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

    If block add

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

    If block details

    d) 使用以下公式,然后选择 Save 按钮。

    IS_EMPTY(outputs["Get record collection"].records)
    

    If block formula

  3. 添加导航

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

    Open page block adding

    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 字段。

    Open page details

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

    Open page block add

  4. 测试导航

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

Page 2 - no logic yet

任务 7:添加检查清单页面逻辑

  1. 获取所有检查清单

    a) 选择屏幕左上角的切换页面按钮。

    Page switch button

    b) 选择 Checklist 页面磁贴。

    Page 2 selection

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

    Show logic

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

    Adding read lists block

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

    Read lists block details

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

    Add read lists block

  2. 获取产品分类数据

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

    Adding classification block

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

    Classification block details

    c) 设置以下条件,然后选择 Save 按钮退出。

    • 在 Property 字段中选择 ClassType。在 Compared value 字段中输入 001。

    • 在 Property 字段中选择 Product。将页面参数 Product 指定给 Compared value 字段。

    • 在 Property 字段中选择 CharcInternalID。在 Compared value 字段中输入任务 2 步骤 3(i) 中记下的值(mock 服务器场景请使用 777)。

    Classification block filter

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

    Classification block name

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

    Add classification block

  3. 将产品分类与检查清单匹配

    a) 将 Set page variable 逻辑块拖到逻辑构建器中标记的位置。

    Adding checklists block

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

    Add checklists block

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

    Checklists block details

    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) })

Checklists block formula

  1. 测试检查清单页面布局

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

    Page 2 demo

    b) 不要点击 Save checks 按钮——其中的逻辑尚未完成,将在下一步添加。

任务 8:添加保存按钮逻辑

  1. 保存缺陷数据

    a) 返回页面布局设计器。选择 Save checks 按钮,然后选择 Show logic for SAVEBUTTON 按钮。

    On save - show logic

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

    Adding defect block

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

    Defect block details

    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)) }] }
    

    Defect block formula

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

    Add defect block

  2. 保存自定义对象数据

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

    Adding custom object block

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

    Custom object block details

    c) 使用以下公式,然后选择 Save 按钮退出。

    { "PurchaseOrder": params.PurchaseOrder, "PurchaseOrderItem": params.PurchaseOrderItem, "to_GRCHECKITEM": MAP(pageVars.Checks, {"CheckName": item.name, "CheckResult": item.result, "CheckStatus": IF(item.status,"X","")}) }
    

    Custom object block formula

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

    Add custom object block

任务 9:测试应用

  1. 测试应用

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

    Page 2 - checks demo

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

    Checks were done

  2. 检查缺陷的保存结果

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

    b) 转到 Process Defects 应用。

    Process defect app

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

    Process defect filter

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

    Process defect list

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

    Process defect data

  3. 检查自定义对象的保存结果

    a) 转到 Custom Business Objects 应用。

    Custom business objects app

    b) 选择 YY1_GRCHECK_<YOUR_ID> 对象。

    Custom business objects list

    c) 选择 Go To Generated UI 按钮。

    Custom business objects ui

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

    Custom business objects list

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

    Custom business objects list

结果

您已经使用 SAP Build Apps 创建并测试了前端应用。建议您检查并研究模板中使用的所有组件和逻辑块,因为本教程并未覆盖全部内容。

延伸阅读 / 参考链接(推荐)

示例:

在 SAP S/4HANA Cloud 中为检查清单数据构建自定义业务对象

使用场景 / 简介

为了存储物料分类中使用的检查清单数据,我们可以再创建一个自定义对象。它将为关键用户提供一个简单的 UI,用于填写检查清单的名称、描述、检查项信息、操作说明和注意事项等数据。

任务流程

在本练习中,您将执行以下任务:

  1. 使用 Custom Business Object 应用创建自定义业务对象。

  2. 为自定义业务对象分配业务目录。

  3. 填写测试数据。

内容

任务 1:创建自定义业务对象

  1. 创建新的自定义业务对象

    a) 打开 Custom Business Objects 应用。

    new bo

    b) 选择 New

    new bo

    c) 输入名称 CHECKLIST_<YOUR_ID>

    d) 选择 Standard 场景

    e) 按 Create

    create bo

  2. 创建业务对象节点和字段

    a) 选择 General Information 选项卡,并确认以下特性:

    • 确定与校验(Determination and Validation)

    • 用户界面(User Interface)

    • 后端服务(Back End Service)

    • 系统管理数据(System Administrative Data)

    BO general information

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

    c) 在 Fields 选项卡中选择 CHECKLIST_<YOUR_ID> 节点。除自动生成的字段外,选择 New 并添加以下字段:

    标签

    标识符

    类型

    长度

    键

    Name

    Name

    Text

    10

    x

    Is Default

    IsDefault

    Checkbox

    Description

    Description

    Text

    500

    Instructions

    Instructions

    Text

    500

    BO CHECKLIST fields

    d) 选择 CHECKLIST_ITEM 节点。选择 New 并添加以下字段:

    标签

    标识符

    类型

    长度

    Check Text

    CheckText

    Text

    500

    BO CHECKLIST_ITEM fields

  3. 发布自定义业务对象

    a) 保存配置并选择 Publish。此过程需要一些时间。

    publish bo

    b) 发布成功后,您会在业务对象上看到绿色的 Published 标记。

任务 2:为业务对象分配业务目录

要以用户传播的方式安全访问 Checklist API,我们需要为其分配一个业务目录。 在我们的场景中,使用 Materials Management - Purchase Orders 目录,因为后续练习中访问采购订单 API 也需要它。

  1. 维护目录

    a) 返回 Custom Business Objects 应用,选择 CHECKLIST_<YOUR_ID> 业务对象。

    open bo

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

    maintain catalogs

    c) Custom Catalog Extension 应用随即启动。

  2. 为 YY1_CHECKLIST_<YOUR_ID>_SCBO 分配业务目录

    a) 在 Custom Catalog Extension 表的 Search 筛选字段中搜索 YY1_CHECKLIST_<YOUR_ID>_SCBO

    yy1_grcheck_scbo

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

    add catalog

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

    select catalog

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

    publish

  3. 为 YY1_CHECKLIST_<YOUR_ID>_CDS_IBS 分配业务目录

    a) 在 Custom Catalog Extension 表中选中 YY1_CHECKLIST_<YOUR_ID>_CDS_IBS

    yy1_grcheck_cds_ibs

    b) 重复第 2 节中的步骤 b) 到 d)。

任务 3:填写初始数据

  1. 打开生成的 UI

    a) 返回 Custom Business Objects 应用,选择 CHECKLIST_<YOUR_ID> 业务对象。

    open bo

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

    Entities button

注意

如果 Go To Generated UI 按钮不可用,请尝试注销后重新登录。

  1. 创建抬头数据

    a) 在新屏幕中选择 Create 按钮。

    Entities button

    b) 填写以下数据,然后选择 Create 按钮:

    • Name(名称):DEFAULT

    • Is Default(是否默认):Checked

    • Description(描述):Default checklist

    • Instructions(操作说明):Follow the general rules of your organization

      Entities button

  2. 创建行项目数据

    a) 在 CHECKLIST_ITEMs 区域中选择 Create 按钮。

    Entities button

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

    Entities button

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

    Entities button

  3. 对以下检查清单重复前面的步骤两次:

    检查清单 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:为基本身份验证创建通信系统与通信安排

  1. 在 SAP S/4HANA Cloud 中创建通信系统

    a) 登录您的 SAP S/4HANA Cloud 系统。

    b) 搜索并打开 Communication Systems 应用

    c) 选择 New

    Communication System

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

    e) 选择 Create

    Communication System

  2. 定义通信系统并创建通信用户

    a) 在 Technical Data 部分勾选 Inbound Only 复选框。

    a) 设置逻辑系统(例如 S4H)和唯一的业务系统 ID(使用您的 ID,例如 AB123)。

    Communication System

    c) 为 Inbound Communication 添加用户

    Communication System

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

    Communication System

    e) 在 Create Communication User 窗格中,将 GRCHECK_<YOUR_ID> 设置为 User Name,将 User for API communication 设置为 Description

    f) 生成一个密码,并将其复制到密钥存储中。下一个练习会用到它。

    Communication System

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

    Communication System

    h) 保存通信系统

  3. 为自定义业务对象创建通信安排:

    a) 打开 Communication Arrangements 应用,然后选择 New

    b) 选择 YY1_GRCHECK_<YOUR_ID> 场景,添加一个 Arrangement Name。按 Create

    Communication Arrangement

    c) 在 Communication Arrangement 面板中,选择您在上一节中创建的通信系统。通信用户会自动添加。

    d) 复制两个 Service URL。下一个练习会用到它们。选择 Save。

    Communication Arrangement

结果

您已创建通信系统与通信安排,为我们的场景公开相关数据。在下一个练习中,我们将在 SAP BTP 一侧设置通信部分。

延伸阅读 / 参考链接

在 SAP S/4HANA Cloud 中设置自定义通信场景

使用场景 / 简介

由于 S/4HANA Cloud 中的所有通信设置都基于通信场景,您需要创建一个自定义通信场景,其中包含自定义业务对象提供的服务。

任务流程

在本练习中,您将执行以下任务:

  • 创建并发布自定义通信场景

内容

任务 1:创建自定义通信场景

  1. 要公开自定义业务对象,我们必须创建自定义通信场景。

    a) 打开 Custom Communication Scenarios 应用

    custom cs

    b) 选择 New

    add cs

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

    add cs

  2. 选择自定义业务对象

    a) 选择 Inbound Services 选项卡,然后按 Add

    add inbound service

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

    select bo

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

    select bo

任务 2:发布自定义通信场景

  1. 发布通信场景

    a) Save 您的更改,然后按 Publish

    save and publish cs

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

    save and publish cs

注意

发布过程可能因不同用户同时执行发布操作而失败。遇到这种情况,稍后重新发布即可。

延伸阅读 / 参考链接

配置从 SAP BTP 到 SAP S/4HANA Cloud 的端到端通信

简介

本节中,您将配置 SAP S/4HANA Cloud 系统与 SAP BTP 子账户之间的端到端通信,使运行在 SAP BTP 子账户中的应用能够使用 SAP S/4HANA 系统上运行的 OData 服务。

任务流程

在本练习中,您将执行以下任务:

  1. 为 API GRCHECK_<YOUR_ID> 定义目标(Destination)

  2. 为 API CHECKLIST_<YOUR_ID> 定义目标(Destination)

内容

为 SAP S/4HANA Cloud 创建目标(Destination)

  1. 在 SAP BTP Cockpit 中,导航到您的子账户。

  2. 在左侧子账户菜单中,导航到 Connectivity → Destinations。

    new Destination

  3. 要添加新目标,您需要 SAP S/4HANA 系统 URL。取上一练习中复制的 API URL 的第一部分。例如,目标配置使用 https://myXXXXX-api.s4hana.ondemand.com/。

  4. 为 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

      new Destination

  5. 为 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

      new Destination

结果

现在您已创建了在 BTP 与 SAP S/4HANA Cloud 之间传输数据所需的全部目标。

在 SAP S/4HANA Cloud 中为收货检查构建自定义业务对象

使用场景 / 简介

为了进一步校验并留存收货检查结果的历史记录,您可以将其存储在 SAP S/4HANA 系统中。无需编写任何代码即可做到这一点的方法是创建自定义业务对象。

任务流程

在本练习中,您将执行以下任务:

  1. 使用 Custom Business Object 应用创建自定义业务对象。

  2. 为自定义业务对象分配业务目录。

内容

任务 1:创建自定义业务对象

  1. 创建新的自定义业务对象

    a) 打开 Custom Business Objects 应用。

    new bo

    b) 选择 New

    new bo

    c) 设置自定义业务对象的名称。

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

    d) 选择 Standard 场景

    e) 按 Create

    create bo

  2. 创建业务对象节点和字段

    a) 选择 General Information 选项卡,并确认以下特性:

    • 确定与校验(Determination and Validation)

    • 用户界面(User Interface)

    • 后端服务(Back End Service)

    • 系统管理数据(System Administrative Data)

    BO general information

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

    c) 在 Fields 选项卡中选择 GRCHECK_<YOUR_ID> 节点。除自动生成的字段外,选择 New 并添加以下字段:

    标签

    标识符

    类型

    长度

    键

    Purchase Order

    PurchaseOrder

    Text

    10

    x

    Purchase Order Item

    PurchaseOrderItem

    Numeric Identifier

    4

    x

    BO GRCHECK fields

    d) 选择 GRCHECKITEM 节点。选择 New 并添加以下字段:

    标签

    标识符

    类型

    长度

    Check Name

    CheckName

    Text

    100

    Check Status

    CheckStatus

    Text

    1

    Check Result

    CheckResult

    Text

    500

    BO GRCHECKITEM fields

  3. 发布自定义业务对象

    a) 保存配置并选择 Publish。此过程需要一些时间。

    publish bo

    b) 发布成功后,您会在业务对象上看到绿色的 Published 标记。

任务 2:为业务对象分配业务目录

要以用户传播的方式安全访问 GRCHECK API,我们需要为其分配一个业务目录。 在我们的场景中,使用 Materials Management - Purchase Order 目录,因为后续练习中访问采购订单 API 也需要它。

  1. 维护目录

    a) 返回 Custom Business Objects 应用,选择 GRCHECK_<YOUR_ID> 业务对象。

    open bo

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

    maintain catalogs

    c) Custom Catalog Extension 应用随即启动。

  2. 为 YY1_GRCHECK_<YOUR_ID>_SCBO 分配业务目录

    a) 在 Custom Catalog Extension 表的 Search 筛选字段中搜索 YY1_GRCHECK_<YOUR_ID>_SCBO

    yy1_grcheck_scbo

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

    add catalog

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

    select catalog

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

    publish

  3. 为 YY1_GRCHECK_<YOUR_ID>_CDS_IBS 分配业务目录

    a) 在 Custom Catalog Extension 表中选中 YY1_GRCHECK_<YOUR_ID>_CDS_IBS

    yy1_grcheck_cds_ibs

    b) 重复第 2 节中的步骤 b) 到 d)。

结果

您已创建自定义业务对象来存储收货检查的结果,并添加了用于安全访问的业务目录。

在下一个练习中,您将再创建一个自定义业务对象来存储检查清单数据。

延伸阅读 / 参考链接

创建采购订单

使用场景 / 简介

采购员创建采购订单。之后订购的货物到达仓库,仓库工作人员可以扫描货物并在系统中找到该采购订单。请注意,本练习使用 WORKSHOP 物料。该物料已使用自定义物料分类进行分类。您可以在 Manage Product Master Data 应用的 Classification 选项卡中查看。

任务流程

在本练习中,您将执行以下任务:

  1. 创建采购订单

内容

任务 1:创建采购订单

  1. 打开 Manage Purchase Orders 应用,然后选择 Create。

Create purchase order

  1. 在 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

    PO general

  2. 创建新的采购订单行项目

    a) 转到 Items 部分

    b) 选择 Create

    Create po item

  3. 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 按钮。

    order item details

  4. 返回 Purchase Order 应用,选择 Order

    order

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

    order

结果

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

延伸阅读 / 参考链接