管理应用¶
管理员与 SAP Mobile Services (移动服务) 交互以确保生产环境高效运作。
管理员任务主要分为两类:
- 应用程序管理,配置部署到用户的应用程序并在用户社区中监控应用程序。
- 安全管理,确定用于移动应用程序的 SAP Business Technology Platform 安全功能。
用户界面¶
SAP 移动服务主控室 中的常用图标。实际图标样式可能略有不同。
| 图标 | 目的 | 描述 |
|---|---|---|
| 切换菜单 | 在左侧窗格中切换导航菜单的显示和隐藏。显示菜单以实现快速导航;隐藏菜单以便最大化窗口区域。 | |
| 主页 | SAP 移动服务主控室 主页屏幕显示最近访问的五个应用、过去 24 小时的警报汇总以及新注册和推送消息的相关 KPI。
|
|
| 移动应用程序 | 创建新的应用程序定义,以使用 SAP 移动服务主控室 管理应用程序。 | |
| 分析 | 查看 SAP 移动应用程序的分析图表。 | |
| 关于 | 查看有关 SAP 移动服务主控室 的信息。单击右上角的登录名称来查看选项。
|
|
| 设置 | 选择您的登录名,然后选择用户设置以更改您的设置,然后保存。
|
|
| 法律信息 | 您可以找到法律披露、隐私、使用条款、版权和商标的重要链接。 | |
| 通知 | 选择以查看通知。例如,如果已达到服务计划限制或者您应该检查日志文件以获取信息,则可能会收到警报。配置和使用 移动服务 时,通知可能会提供有用的信息。 | |
| 提供反馈 | 响应简短调查并提供自由形式文本。您的反馈为匿名,用于改进 SAP Mobile Services。不会收集任何个人数据。调查会定期更改,当前仅提供英语版本。 完成调查后,您可以加入我们的 SAP User Research Panel,发挥更大的影响力。如果您有兴趣,欢迎加入。您将享有以下体验:
|
|
| 支持 | 选择无需离开 SAP Mobile Services 主控室即可访问内置支持。您可以访问博客、文章、视频和教程。如果您获得授权并使用 SAP 通用标识登录,您还可以创建支持工单并使用“专家聊天”。 | |
| 帮助 | 打开和关闭嵌入式帮助。您可以在工作时展开和折叠帮助主题窗格以查看和隐藏主题。请注意,对于一些语言,例如简体中文和日语,已翻译嵌入式帮助。未翻译的嵌入式帮助以英文显示。 如果出现“导览”图标,请选择该图标,然后选择导览名称。 | |
| 导览 | 导览将引导您在 SAP Mobile Services 主控室中完成某过程的基本步骤,例如配置移动网络跟踪功能。有关详细信息,请参阅导览。 | |
| 注销 | 注销应用程序。单击右上角的登录名称来查看选项。 | |
| SAP BTP 主控室 | 单击此处会将您转到您的 BTP 子账户。 | |
| SAP BTP 空间 | 单击此处会将您转到您的 BTP 空间。 | |
| 参数文件 | 您的登录名在右上角显示。选择名称以查看下拉菜单。 | |
| 用户信息 | 您可以查看登录用户的用户名、标识和电子邮件。 | |
| 隐私声明 | SAP 的隐私声明阐述了其在数据保护与隐私方面的承诺,并详细说明了处理个人数据的方式。此文档用于了解 SAP 如何处理个人信息,并用于管理其站点上的 cookie 首选项。要访问隐私声明,请转到参数文件,然后选择隐私声明。或者,您可以通过导航到切换菜单下的法律信息找到隐私声明并进行选择。 | |
| 创建 | 为功能配置新资源,例如新目标。 | |
| 操作设置 | 查看可用操作,例如定制表列。 | |
| 刷新 | 用于检索数据的新副本。 | |
| 新建 | 添加新项目,例如目标、提供者或功能限制策略。 | |
| OData 目标质量测试 | OData 目标质量测试确保数据的准确性和可靠性。这对于确保 OData 目标正常运行并提供高质量数据以供各种应用程序和系统使用至关重要。 | |
| Ping | Ping | Ping 目标。 |
| OData 应用程序目标测试或启动 Web 应用 | 取决于上下文。设置目标时,用于测试 OData 应用程序目标。使用 SAP 移动服务主控室中的 ESPM 示例数据时,用于启动 Web 用户界面以测试您的应用。 | |
| 在浏览器中启动 | 为无法从 SAP 移动服务主控室 运行的场景测试目标,例如 Cloud Connector SSO、Forward 和 OAuth2 User Token exchange,因为这些场景需要业务用户(最终用户)登录。 |
|
| 排序 | 根据所选条件排序列表,如按升序或降序或按列名。 | |
| 上传 | 上传对象。 | |
| 重置筛选器 | 用于重置应用的筛选器。 | |
| 下载 | 下载对象。 | |
| 已锁定 | 应用程序已锁定,因此您无法进行任何编辑。 | |
| 已解锁 | 应用程序已解锁,可以进行编辑。 | |
| 详细信息 | 查看有关所选资源的详细信息。 | |
| 复制 URL | 将 URL 字符串复制到剪贴板,使您可以在其他位置粘贴完整的 URL。 |
导览¶
导游可引导您在 SAP Mobile Services 主控室中完成某过程的基本步骤。
-
选择帮助图标 ( )。仅当导览可用时才会显示导览图标。
-
选择“导览”图标。可能会列出一个或多个导览。
-
选择导览(即使只有一个导览可用,也需要选择)。
-
随后显示第一个“导览”对话框。按照说明进行操作。
注释
行为可能因屏幕类型和尺寸有所不同。如有必要,您可以将对话框拖到新位置,以查看文本或用户界面元素。
从主控室获取支持¶
无需离开主控室即可获得 SAP Mobile Services 的内置支持。您可以访问博客、文章、视频和教程,并且可以使用“专家聊天”并在获得授权的情况下创建支持工单。
如果您计划创建支持工单并使用“专家聊天”,则必须使用 SAP 通用标识登录。如果您无权进行这些活动,则这些选项不可用。
-
在 SAP Mobile Services 主控室中,选择耳机图标 以访问嵌入式支持。
第一次访问嵌入式支持时,会显示欢迎使用内置支持屏幕以及登录屏幕,以帮助您入门。选择下一步以查看屏幕,然后入门以访问内置支持屏幕。
或者,您可以选择跳过以绕过登录屏幕并直接转到内置支持页面。您可以通过从内置支持屏幕中选择 随时重新访问登录屏幕。
-
通过内置支持屏幕,您可以执行以下操作:
-
输入主题并选择搜索图标 。例如,输入
logs或XSUAA以搜索有关此主题的信息。 -
在我们对此页面的建议下,访问有用的链接,例如 SAP 业务技术平台的新增功能、有关从 SAP Mobile Services 主控室管理应用的信息、SAP 社区和 SAP Mobile Services 产品页面。
-
通过此横幅:
-
选择 可访问登录屏幕、观看视频教程以及访问内置支持的帮助、设置 cookie 首选项等。
-
选择 以使用您的 SAP 通用标识登录并访问您的系统上下文信息。
-
选择 以关闭内置支持屏幕。
-
-
-
选择登录以使用您的 SAP 通用标识登录,以访问案例创建和专家聊天等内置支持功能。
如果没有 S 用户获得授权,您会收到通知,并提示您链接现有账户(例如 S/P 用户标识)以访问所有内置支持选项。如果您符合条件,则可以按照提示操作。要了解详细信息,请参阅 SAP 注释 2617792 - 数字支持体验故障排除指南(需要登录)。
访问 BTP 主控室和开发空间管理器¶
在 SAP 移动服务主控室 中,您可以导航到关联 BTP 账户和开发空间管理器。
-
转到 SAP 移动服务主控室。
-
在主页屏幕上,选择右上角的 。
-
选择 SAP BTP 主控室以访问关联 SAP BTP 主控室子账户。
-
选择 开发空间管理器以访问关联开发空间。
-
SAP BTP 主控室向导将在新浏览器窗口中打开。选择您的全局账户并选择继续。
创建应用程序¶
创建新的应用程序定义,以使用 SAP 移动服务主控室管理应用程序。
-
选择 SAP 应用程序、本机、混合或 移动开发工具包 模板时,系统将根据应用程序类型自动选择最典型的功能。此时,您可以添加或移除功能,或稍后进行处理。
-
有些功能(如客户端设置和连接性)是必需的,因此您无法将其移除。
-
其他功能具有相关性,因此您需要按特定顺序将其移除,或者根本无法删除它们。例如,离线访问需要连接性,云构建需要应用目录。
定义应用程序后,配置已分配功能或添加更多功能。有关详细信息,请参阅管理应用程序功能和配置已分配功能。
-
在 SAP 移动服务主控室 中,选择移动应用程序 > 本机/
MDK,然后选择新建。注释
lite和free服务计划对您可以实施的应用程序数量施加限制。如果达到限制,您将看到一条消息,并且必须删除一个应用程序才能继续。有关详细信息,请参阅服务计划。 -
在应用程序类型屏幕上,选择应用程序类型。 我们支持以下应用程序类型:
- SAP 应用程序:SAP 交付的可定制应用程序,例如 SAP Service and Asset Manager。
- 移动开发工具包 (MDK):基于元数据的单一来源应用程序,可部署于 Web 或移动客户端环境中。
- 本机:使用 SDK 构建的应用程序,在 iOS 或 Android 中本机运行。
- 混合:使用混合应用程序工具包构建的应用程序。
-
在基本信息屏幕上,输入应用程序属性,然后选择下一步。
应用程序属性
字段 值 应用程序类型 显示上一步中选择的应用程序类型。您可以返回到上一步来更改应用程序类型。 SAP 应用程序 选择您想要定制的 SAP 交付应用程序,例如 SAP Service and Asset Manager。 服务计划 为您的账户选择服务计划: - 资源:将此用于自定义应用程序开发。开票基于活动资源,活动资源是用户标识符(或匿名用户的设备标识符)。
- build-code:将此用于自定义应用程序开发。开票基于容量单位,基于活动资源进行计算。
- build-default:此计划专用于 {{ no such element: dict object['bc'] }},允许基于 AI 的开发和自动化。有关详细信息,请参阅 SAP Mobile Services 的服务计划
- basic-plus-app:该计划提供全面的功能集。这对于 SAP 移动应用程序来说非常理想。
- 免费:您可以免费开始使用此服务,没有任何功能限制。当达到配额限制时,您可以切换到付费版本。
- 精简:此计划仅适用于试用账户。它没有功能限制,但受到配额限制,并且无法升级到生产版本。
- b2c(使用者版本)(已弃用):使用者版本的开票基于活动用户,没有功能限制。您可以具有不受限制的用户和应用。
- 标准(已弃用):标准计划的开票基于注册用户数量。没有任何功能限制。
- kernel-service:此计划用于在单一应用主控室中管理的应用程序(软件即服务,或者 SaaS)。
标识 应用程序的唯一标识符,用反转域名表示法。这是由应用程序开发人员分配或生成的应用程序或捆绑标识符。管理员使用应用程序标识将应用程序注册到移动服务,然后客户端应用程序在将请求发送到服务器时使用应用程序标识。应用程序标识: - 必须唯一
- 必须以字母字符开头
- 只能包含字母数字字符、下划线、连字符和句点。
- 最多可以包含 64 个字符
- 不能包含空格
- 不能以句号开头,并且不能包含两个连续的句号
- 无法以
com.sap或sap开头 - 不能是关键字
com.sap.mobile.platform.cards和com.sap.mobile.mtb
- 标识必须至少有两段(一个或多个句号)。
- 每段开头必须为字母。
- 所有字符必须为字母数字或下划线
[a-zA-Z0-9_]。
sample.com.sap.mobile.app1。名称 应用程序名称只能包含字母数字字符、空格、下划线和句号,长度最长为 80 个字符。 描述 (可选)描述最多可以包含 255 个字母数字字符和特殊字符。 供应商 (可选)开发应用程序的供应商。供应商名称只能包含字母数字字符、空格、下划线和句号,长度最长为 255 个字符。 应用程序路由的域 在支持多个域的区域中,选择最终用户可通过其访问应用程序的应用程序路由。路由与空间相关联并在 SAP Business Technology Platform 主控室中配置。下拉列表显示所有可用于客户组织的共享域和自定义域。如果要使用自定义域,可以根据什么是自定义域中的信息创建一个。 -
在安全设置屏幕上,输入配置值,然后选择下一步。
对于已配置 Identity Authentication 服务 (IAS) 的环境,您可以在创建新移动应用程序时选择 IAS 或 XSUAA(已扩展 UAA)安全配置。有关配置 Identity Authentication 服务的信息,请参阅配置 IAS 安全性。
-
XSUAA 设置 - 选择此选项以使用 SAP 权限和信任管理服务方法进行验证。
-
IAS 设置 - 选择此选项以使用 Identity Authentication 服务方法进行验证(也称为验证)。
根据您的选择,请参阅下表获取配置值。您可以稍后按配置应用安全中的描述在安全标签上修改这些值。
XSUAA 设置
字段 值 XSUAA 服务 选择要使用的 XSUAA 验证和验证服务。您可以选择缺省实例以创建新实例,或者您可以从列表中选择现有服务。如果您已部署 Cloud Foundry 应用程序并希望从移动服务连接到此应用程序,则使用现有 XSUAA 实例非常有用。在此情况中,重用现有 XSUAA 实例非常方便。为其他场景选择缺省实例。 xs-security.json 定义用于访问应用程序的验证方法和权限类型的 JSON文件。有关详细信息,请参阅应用程序安全描述符配置语法。令牌生命周期 输入令牌生命周期,并选择单位(小时或分钟)。默认令牌生命周期为 15 分钟,允许的范围是 10 分钟到 24 小时。有关详细信息,请参阅应用程序安全描述符配置语法。 刷新令牌生命周期 输入刷新令牌生命周期,并选择单位(天、小时或分钟)。值必须大于令牌生命周期值。有关详细信息,请参阅应用程序安全描述符配置语法。 已审批提供者 指示应用应支持所有已审批提供者还是仅支持所选提供者。 令牌中的系统属性 指示组、角色集合或两者。 IAS 设置
字段 值 IAS 设置 选择要使用的 Identify Authentication 服务。 您可以选择缺省实例以创建新实例,或者您可以从列表中选择现有服务。 Security-config.json 定义用于访问应用程序的验证方法和权限类型的 JSON文件。有关详细信息,请参阅 SAP BTP 身份服务的参考信息。令牌生命周期 输入令牌生命周期,并选择单位(小时或分钟)。默认令牌生命周期为 15 分钟,允许范围为 10 分钟到 1 小时。有关详细信息,请参阅 SAP BTP 身份服务的参考信息。 刷新令牌生命周期 输入刷新令牌生命周期,并选择单位(天、小时或分钟)。默认刷新令牌生命周期为 30 天,允许范围为 1 小时到 180 天。有关详细信息,请参阅 SAP BTP 身份服务的参考信息。 -
-
在角色设置屏幕上,输入角色,然后选择下一步。
缺省情况下,已选中启用角色设置。选中后,您必须将一个或多个角色添加到列表。只有分配了这些角色的用户才能访问该应用,这有助于确保更好的安全性。SAP 建议启用角色。
输入一个或多个角色名称,以逗号或返回/回车键分隔,例如开发人员、销售人员、经理。要了解有关缺省 Cloud Foundry 角色的详细信息,请参阅组织、空间、角色和权限。
输入角色后,您可以通过应用的安全标签维护它们,如配置应用安全中所述。
-
在分配功能屏幕上,默认选择一组功能。您可以在此处根据您的要求定制这些功能。 下表显示了不同类型的应用程序默认启用的功能。您可以禁用不需要的功能。您可以按管理应用程序功能中所述做进一步更改。
默认选择的功能 SAP 应用程序 移动开发工具包 本机 混合 应用目录 是* 是* 否 否 应用更新 是 是 否 是 客户端日志上传 是 是 是 是 客户端设置 是* 是* 是* 是* 客户端使用情况和用户反馈 否 否 是 否 云构建 是 是 否 否 连接性 是* 是* 是* 是* 离线访问 是 是 是 是 推送通知 是 是 是 是 注释
*指示此功能为必需,不能取消选择以下是基本功能的列表。
功能 描述 应用目录 上传移动应用程序部件进行 beta 测试,以及部署到外部服务。 应用更新 上传新版本的混合或移动开发工具包应用程序。 增强现实 管理可通过移动应用程序访问的客户端增强现实资源。 设置交换 处理设备注册,提供移动客户端和服务器之间的常规设置交换(例如客户端策略)。 客户端资源 向应用程序添加客户端资源。 连接性 允许您定义应用程序可以使用的后端系统连接性。 离线访问 启用对设备上数据的安全离线访问。 推送通知 注册设备以接收本机推送通知。 客户端日志上传 允许应用程序上传应用程序日志文件并在服务器中进行分析。 网络跟踪 允许应用程序可基于用户名或内容类型来跟踪网络活动。 示例 OData ESPM 在开发和测试过程中使用 OData 示例服务。 客户端使用情况和用户反馈 允许应用程序上传客户端使用情况和反馈信息并在服务器中进行分析。 云构建 为 Fiori 快速启动板或单个 SAP Fiori 业务应用构建边界并启用它们以使用 SAP Mobile Platform SDK。 -
在审核屏幕上,您可以验证正在创建的应用程序定义的详细信息。确保所有详细信息均正确。选择编辑对该部分进行必要的修改。
-
选择完成以创建应用程序定义。随即信息标签使用当前设置显示。
注释
如果在定义应用程序时未在角色设置屏幕上选择启用角色设置,则会显示一条警告消息。您可以选择确定继续创建应用程序定义。
应用程序管理¶
使用 SAP 移动服务主控室和其他工具管理并监控本机、混合和 移动开发工具包 移动应用程序。管理包括定义和配置应用程序、监控应用程序和应用程序使用情况、查看统计数据和日志、检查系统健康状况以及排除故障和问题。
本机(在线和离线)、混合(Kapsel - 离线)和 移动开发工具包 应用程序是使用各种工具和方法开发的。SAP 工具方便了移动应用的开发,拥有模块化的方式用于下载、登录、推送通知和错误报告。开发过程中会为每个应用程序生成一个唯一的应用程序标识符,并将该应用程序部署到应用程序下载站点或 SAP Mobile Services。Web 应用程序以企业预置方式运行,但同时通过 SAP Mobile Platform 或移动服务安全提供。
管理员在 SAP 移动服务主控室 中创建应用程序定义,其中包含唯一的应用程序标识符、指向其在生产系统中的后端数据源的连接,以及安全配置和应用程序特定条目。
管理员通过本机应用程序商店或通过企业网站下载将应用程序提供给设备。用户登录到应用程序时(或以匿名用户身份访问应用程序时),应用程序+用户+设备这一组合将注册到 SAP 移动服务主控室 中。可以使用此注册信息,在字段中使用 SAP 移动服务主控室 管理并监控设备应用程序,并利用单独和汇总的使用情况统计数据。
您可以执行以下操作:
- 可以添加、编辑或删除应用程序,以及导出和导入应用程序。
- 可以查看所有应用程序,或者检索筛选出的一部分应用程序。
- 您可以按列排序,并刷新列表。在应用程序列表中,可通过下钻来查看某一特定应用程序的摘要和详细信息。
- 可以锁定应用程序以防止意外更改。如果应用已锁定,必须解锁才能进行修改。
对于已迁移到单个服务应用的应用,在应用程序级别启用详细事件日志记录。您可以选择要包含的单个服务和移动应用路由器,如下一部分的日志设置中所述。
对于多服务应用(尚未迁移到任何服务的应用),您必须在服务级别启用详细的事件日志记录。选择启用详细事件日志来收集详细消息。选择禁用详细事件日志以停止收集详细消息(仍收集错误消息)。
按查看事件日志中所述,访问分析 > 日志以查看事件日志。
-
在 SAP 移动服务主控室 中,选择移动应用程序 > 本机/
MDK。您可以查看包含摘要信息的应用程序列表,包含应用程序标识、名称、供应商、应用程序类型、服务计划、状态和创建日期。使用搜索和排序选项,找到想要查看的应用程序。
注释
App Lab 管理的应用不会显示在应用程序列表中。要管理 App Lab 更新,请参阅移动应用目录部件。
本机/
MDK应用程序汇总列 描述 应用程序标识 唯一应用程序标识符。已锁定应用程序标记为已锁定。 名称 应用程序名称。 供应商 提供应用程序的供应商。 应用程序类型 显示应用程序类型。 服务计划 显示应用程序定义所使用的服务计划: - 资源:将此用于自定义应用程序开发。开票基于活动资源,活动资源是用户标识符(或匿名用户的设备标识符)。
- build-code:将此用于自定义应用程序开发。开票基于容量单位,基于活动资源进行计算。
- build-default:此计划专用于 {{ no such element: dict object['bc'] }},允许基于 AI 的开发和自动化。有关详细信息,请参阅 SAP Mobile Services 的服务计划
- basic-plus-app:该计划提供全面的功能集。这对于 SAP 移动应用程序来说非常理想。
- 免费:您可以免费开始使用此服务,没有任何功能限制。当达到配额限制时,您可以切换到付费版本。
- 精简:此计划仅适用于试用账户。它没有功能限制,但受到配额限制,并且无法升级到生产版本。
- b2c(使用者版本)(已弃用):使用者版本的开票基于活动用户,没有功能限制。您可以具有不受限制的用户和应用。
- 标准(已弃用):标准计划的开票基于注册用户数量。没有任何功能限制。
- kernel-service:此计划用于在单一应用主控室中管理的应用程序(软件即服务,或者 SaaS)。
状态 应用程序的当前状态: - 已开始 - 应用程序运行正常。
- 不一致 - 如果从 SAP Business Technology Platform 主控室删除或更改应用程序,则应用程序可能变得不一致。您可以从 SAP 移动服务主控室 主控室中删除或恢复应用程序
- 已从 SAP Business Technology Platform 主控室删除 - 已删除应用程序。您可以在 SAP 移动服务主控室 中进行恢复或删除。
- 正在恢复 - 正在从不一致的状态恢复应用程序。
已过期 此应用程序是否已过期。如果已确定,将提示您将应用程序更新为包含修复和改进的较新版本。通常,您应该更新应用程序。 创建日期 (UTC/local) 应用程序创建日期(UTC 或本地格式),具体取决于您为用户设置选择的内容。 -
选择一个应用程序查看其详细信息。要防止意外更改,您可以在完成其配置后锁定应用程序。要进行更改,您需要手动解锁应用程序。
当应用程序锁定时,会在应用程序名称旁显示已锁定标签。这将阻止您对其配置进行任何编辑。
注释
取消锁定的应用程序将标记为已解锁。
-
设置:此标签提供所选应用程序的常规设置。 常规设置包括连接性、客户端设置、安全性、日志设置、警报、应用程序链接和认证。要在此标签上设置信息,请参阅创建应用程序。 在 Cloud Foundry 环境中,您还可以配置自定义域。有关详细信息,请参阅编辑应用程序和管理自定义域。
- 连接性:SAP Mobile Services 的连接性功能允许您定义应用程序可以使用的后端系统连接性。您可以为不同的后端系统定义任意数量的目标。这些目标将专门由为其配置的应用程序。您可以限制访问允许的路径。有关详细信息,请参阅定义连接性。
- 客户端设置:为所选的移动应用程序设置客户端策略并管理其用户注册。有关详细信息,请参阅定义客户端策略和功能限制和管理 JSON 存储。
- 安全性:此标签使您可以管理所选应用程序的安全性。有关详细信息,请参阅配置应用安全性。
- 日志设置面向的是已迁移到单个服务模型的应用,用于启用应用程序级别的事件日志。您可以指定任何已分配到应用的单个服务,以及移动应用路由器。借此您可以进一步控制要在应用程序级别查看的事件日志信息。有关详细信息,请参阅在应用级别启用事件日志。您可以根据查看事件日志中的描述继续查看事件日志。
- 警报:此标签允许您为不同类别的服务器故障配置设置。配置完成后,实施 SAP Business Technology Platform Alert Notification 服务即可接收通知。有关详细信息,请参阅配置警报设置和订阅移动服务警报。
- 应用程序链接:此标签启用 Apple 的通用链接以及 Android 应用的应用程序链接。Apple 通用链接和 Android 应用程序链接允许用户在本地打开应用程序,而无需下载应用或使用浏览器容器。有关详细信息,请参阅创建应用程序链接。
- 认证:此标签可为所选应用启用认证功能,并允许您配置 iOS 或 Android 认证设置。设备认证使开发人员和管理员能够了解尝试连接到企业应用和工作空间的设备的软件和硬件环境。有关详细信息,请参阅配置 iOS 认证和配置 Android 认证。
要配置附加功能,请导航至设置 > 扩展组件功能。选择添加功能,选择所需的应用程序并选择确定。
该扩展组件功能将在扩展组件功能列表下显示。有关详细信息,请参阅配置已分配功能。
要移除扩展组件功能,请选择该功能以打开功能配置屏幕,然后选择从应用程序移除。在 Cloud Foundry 环境中,您还可以配置自定义域。有关详细信息,请参阅编辑应用程序和管理自定义域。
-
API:此标签提供登录和 API 功能。
在登录部分下,您可以找到一个或两个二维码,可用于配置移动应用程序以连接到此 移动服务 实例。
对于应用内扫描代码,设备用户必须先手动启动应用,之后在应用内扫描二维码以启动登录流程。
对于缺省配置,本机应用开发人员可以下载包含发现服务缺省配置的本机特定文件。 选择 iOS 以
plist格式下载配置文件,或选择 Android 以JSON格式下载文件。将文件添加到您的 iOS 或 Android 应用项目,无需进一步格式化。对于配置,您可以查看与应用程序关联的任何应用程序路由。选择编辑以进行更改。有关 XSUAA 属性应用程序路由的域的信息,请参阅创建应用程序 。
对于 Apple 和 Android 启动应用代码,设备用户可以选择 URL(或使用允许读取二维码的 Apple 照相机应用或 Android 应用程序扫描二维码),以查找并启动本地安装的应用程序。如果用户启用 Android 应用链接,它还支持 Android 的相机应用。如果您在应用程序链接部分中启用 Apple 通用链接或 Android 应用链接或两者同时启用,则会生成应用启动二维码;二维码的标签文本取决于启用的应用程序链接(Apple 启动应用代码、Android 启动应用代码或 Apple 和 Android 启动应用代码)。
对于含 URI 模式的 Apple 和 Android 启动应用代码,设备用户可以扫描二维码或选择 URL,以使用
appLinkURL 查找并启动应用程序。仅当在应用程序链接标签中启用设备应用程序 URI 模式后,才会显示此选项。您必须选择一种设备类型,并为 iOS 或 Android 输入相应的设备应用程序 URI 模式。注释
(仅限 移动开发工具包)如果在应用程序链接标签中设置 Apple 和 Android 设备应用程序 URI 模式,您将看到两个单独的二维码,分别标记为 含 URI 模式的 Apple 启动应用代码 和含 URI 模式的 Android 启动应用代码。
如果应用安全配置更改,则必须生成新的二维码。另请注意,URL 可能会很长,可能比屏幕上显示的值长。 使用复制到剪贴板按钮复制其完整值。
在 API 下,可以查看常用 API URL 列表。使用复制 URL ( ),以将只读 URL 复制到剪切板并粘贴到其他位置,避免输入错误,确保准确性。
注释
服务器 URL 值也是
<mobile_services_host>名称。 -
用户和设备管理:此标签允许管理员执行一个或多个与用户和设备相关的操作,例如冻结、撤销、锁定、导出用户数据、发送推送通知、擦除和删除。
-
发现:此标签使您能够在应用程序级别添加应用程序配置。您可以将域或登录代码与配置数据共同添加到每个应用中。您可以将相同的应用程序配置添加到多个域。
-
编辑应用程序¶
编辑应用程序列表中现有的应用程序。
-
在 SAP 移动服务主控室 中,选择移动应用程序 > 本机/
MDK。 -
选择应用程序,然后选择编辑进行修改。您可以编辑服务计划、名称、描述和供应商详细信息。有关应用程序属性,请参阅创建应用程序。
注释
当应用程序已锁定时,您无法对其进行编辑。
-
保存更改。
删除应用程序¶
从应用程序列表删除应用程序。对于使用云构建服务重新生成的任何 SAP Fiori 或混合应用, 删除应用程序也会永久删除与应用程序相关的所有二进制。
- 在 SAP 移动服务主控室中,选择移动应用程序 > 本机/
MDK。 - 选择应用程序,然后选择 。
-
单击确定进行确认。
注释
删除应用程序后,用户将无法使用它。所有现有日志和跟踪均会删除,且
无法恢复。
管理应用用户和设备注册¶
通过用户和设备管理,用户可以在应用程序级别执行各种操作。这包括冻结和解除冻结用户、发送推送通知、撤销用户对应用程序的访问权限、锁定和解锁用户以及导出用户数据。
此外,您还可以管理与设备相关的操作,例如擦除设备注册数据和删除设备注册。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 本机/
MDK。 -
选择应用程序,导航到用户和设备管理标签。 此屏幕包含 2 个部分:
- 已注册设备:此部分显示括号中的数字,代表当前的应用程序注册数量。
- 已冻结用户:此部分显示括号中的数字,代表应用程序的当前已冻结用户数量。
-
在已注册设备部分中,您可以执行各种操作,例如冻结、删除、擦除、锁定和撤销单个用户和设备的访问权限。
-
输入搜索条件以将焦点缩小到特定用户或用户组,然后选择执行。您可以根据用户名、注册时间范围(预定义时间范围或使用日历日期选取器定义范围的自定义时间范围)、设备类型、电子邮件地址、合规性状态(合规、泄露或未知)、擦除状态(未擦除或已擦除)、锁定状态(未锁定或已锁定)或冻结状态(未冻结的用户或冻结的用户)进行搜索。
-
查看搜索结果以查看注册用户。
已注册设备
列 描述 用户名 (已冻结) 列出了已注册此应用程序的用户的姓名。已冻结的用户将被标记为已冻结。 注册标识 客户端应用程序提供的唯一标识符,或者系统生成的应用程序注册标识。每个注册用户左侧将会出现一个选择框。 设备标识 设备标识。 设备类型 设备的类型,如 Android 或 iPhone(注册/登录过程中由设备发送)。 Unknown表示无法检测到设备类型。上次连接 (UTC+0000) 应用程序上次活动且 SAP Mobile Services 收到请求的日期、时间和时区,格式为 YYYY-MM-DD HH:mm:ss。擦除 是否将应用程序连接设置为擦除。 锁定 是否将应用程序连接设置为已锁定。 操作 操作包括向注册用户发送推送消息和导出用户数据。 -
在已注册设备部分中,您可以执行各种操作,例如冻结、删除、擦除、锁定、撤销单个用户和设备的访问权限。
-
锁定用户并擦除设备注册
锁定(用户)和擦除(设备注册)增强了注册用户及其设备的安全性和管理。启用擦除切换按钮将从指定设备上的应用中注销所选用户并锁定此用户。它还会擦除这些设备上所有应用管理的数据。此操作不可逆。此应用不会恢复之前管理的已被擦除的任何数据。
解锁按钮可让管理员在解锁后恢复特定设备上用户的访问权限。此按钮关闭所选注册的擦除功能并解锁用户。它允许用户在同一设备上重新登录此应用。但是,请记住,应用之前擦除的任何数据都无法恢复。
请参阅定义锁定和擦除策略以获取相关信息。
注释
在用户注册详细信息屏幕中,您可以单击 启用锁定按钮来锁定用户,此操作将关闭启用擦除按钮。类似地,当您单击 禁用锁定按钮时,它会打开启用擦除,反之亦然。
-
删除用户注册
要删除一个或多个用户注册,请选中用户名列左侧的复选框。然后,单击 删除用户注册。
对于为 OAuth 安全配置的应用,当您删除用户注册时,所有相关的 OAuth 令牌将自动撤销。无论应用使用的是管理 API 还是客户端运行时 API,这都适用。
当用户在列表中有单个注册并且用户将其删除时,他们的注册将被撤销。结果,他们的注册信息不再显示在列表中。另一方面,如果用户在列表中有多个注册并且他们删除了一个,则其所有其他的注册也会被撤销。因此,其注册不再显示在列表中。
任何一种情况下,删除用户注册后,用户注册都不会在主控室中显示,并且不会包含在计量数据中。当用户重新登录应用时,会自动生成新的 OAuth 令牌,并物理删除旧令牌。用户注册再次在列表中显示,并在发送计量数据时进行计数。此功能 确保仅使用最新的 OAuth 令牌并删除旧令牌。
-
撤销用户的 OAuth 令牌
选择撤销以撤销注册用户使用的所有 OAuth 令牌。下次用户登录时,将会发出一个新的 OAuth 令牌,确保只使用最新令牌。此功能仅适用于使用 OAuth 安全配置的应用程序,包括使用 Identity Authentication 服务 (IAS) 和软件即服务 (SaaS) 的应用程序。有关详细信息,请参阅撤销 OAuth 令牌。如果没有出现撤销按钮,则配置不支持该功能。
-
启用自动移除 您可以选择此选项来确定是否应在特定天数后自动移除应用程序注册。要调整天数,只需单击 编辑图标。 不活动期间从该注册经验证的会话中的最后一个请求开始计算。也就是该注册的最后访问时间。
-
发送推送通知 通过单击操作列中的 3 个点,选择 发送推送通知给用户。 在发送推送通知中,键入消息,然后单击发送。消息
The native push notification was sent successfully确认已发送此消息。 -
导出用户数据 通过单击操作列中的 3 个点,选择导出用户数据。
-
触发初始下载和取消初始下载 - 注册级别 触发初始下载:这会触发所选注册设备从离线服务完整下载应用数据。重新下载期间会保留所有本地更改。 要开始下载,请在“操作”列中选择 ,然后选择 触发初始下载。在警告弹出窗口中,选择触发初始下载。
Cancel Initial Download:此操作将停止所选注册设备从离线服务完整下载应用数据。 要取消下载,请在“操作”列中选择 ,然后选择 取消初始下载。在警告弹出窗口中,选择取消初始下载。
注释
在“用户注册”详细信息屏幕中,您可以选择 并选择 触发初始下载触发完整下载,也可以选择 取消初始下载停止完整下载。
要在应用程序级别触发初始下载,请参阅定义应用程序的离线设置。
-
冻结和取消冻结用户 要冻结用户,首先选择此用户。此操作将为所选用户打开用户注册详细信息屏幕。在此,单击 冻结用户 按钮。
冻结用户将阻止用户注册本机/MDK 应用程序或接收流量。随即弹出
Block User Access消息,通知您冻结用户访问会导致用户退出应用程序。除非用户从冻结用户列表中移除,否则用户无法重新登录应用程序。单击确定进行确认。随即显示User Blocked消息,Blocked写入该用户的用户名列下。要取消冻结用户,请单击 取消冻结按钮。随即弹出
Unblock User Access消息,通知您取消冻结用户访问允许用户重新获得应用程序的访问权限。然后用户可以通过任何设备登录。单击确定进行确认。随即显示User Unblocked消息。您还可以从另一个屏幕取消冻结用户。选择用户和设备管理 > 已冻结用户。随即显示锁定用户的列表。从此视图中,您可以通过单击操作列中的 取消冻结按钮来取消冻结用户。
此外,您可以根据需要过滤用户名。单击 以将现有的唯一用户添加到锁定的用户列表。
-
在应用级别更改服务计划¶
如果您更改 SAP Business Technology Platform 级别的服务计划,您可能还需要更改 移动服务 应用级别的服务计划设置。术语许可证类型和服务计划可互换使用。许可确定功能和费用。
在开始之前,建议您充分了解可用的服务计划以及您当前的服务计划。您可以检查 SAP Business Technology Platform 主控室以查看您当前的活动 移动服务 服务计划。请注意 移动服务 应用和 Cloud Foundry 运行时是否在相同的服务计划下。要正确开票,所有现有服务都必须在正确的服务上。例如,如果应用属于 free 计划,则 Cloud Foundry 运行时也必须属于 free 计划,否则会产生费用。
有关详细信息,请参阅:
另请记住以下准则:
-
standard (Users)和b2c (Consumer Edition)服务计划已弃用,不是一个好的长期选择。 -
basic-plus-app提供全面的功能集。它非常适合于 SAP 移动应用程序,例如 SAP Service and Asset Manager。 -
您可以将服务计划从
free更改为resources或build-code或build-default,以便您可以在不丢失工作的情况下迁移您的应用。 -
迁移不可撤销。您无法从
resources、build-code、build-default、standard (Users)或b2c (Consumer Edition)切换到free。 -
kernel-service许可证类型用于由 SAP 构建并在单一应用主控室(软件即服务,SaaS)中管理的应用程序。该许可证类型由 SAP 定义,因此为只读,无法在主控室中选择或编辑。 -
如果选择
basic-app许可证类型,则移动离线访问功能将禁用。
要更改计划:
-
在 SAP 移动服务主控室 中,选择移动应用程序 > 本机/
MDK。 -
选择应用程序,然后选择编辑进行修改。
-
在编辑应用程序详细信息中,查找服务计划字段。其值表示在 移动服务主控室 中创建或部署应用时使用的服务计划。例如,您可能从
free计划(非试用架构)或lite计划(试用子账户)开始。 -
从服务计划下拉列表中选择目标服务计划,同时牢记准则和限制。例如,如果您当前具有
free计划,则可以选择resources以在应用级别更改计划。 -
保存更改。监控您的帐单以确保其反映您打算进行的更改是个好主意。
注意
- 监控您的账单以确保其反映您所做更改是个好主意。
- 建议从 Mobile Services 主控室更改服务计划。仅购买的服务计划可供选择。
- 此外,您还可以从 SAP Business Technology Platform (SAP BTP) 更新服务计划。有关详细信息,请参阅更改服务计划。
管理单个 (SaaS) 或 SAP Mobile Start 应用程序¶
单个应用版本的 SAP 移动服务主控室 适用于 Cloud Foundry。此版本支持业务用户管理单个 Cloud Foundry 应用程序,例如,在软件即服务 (SaaS) 上下文中。单个应用支持范围包括本机、混合、微应用。此功能仅适用于 Cloud Foundry,并要求应用程序已迁移到单个服务。
以下角色与 SAP Business Technology Platform 主控室相关。要了解有关设置角色和角色集合的详细信息,请参阅构建应用程序的角色和角色集合。
-
管理员 - 读写角色。必须为业务用户分配“管理员”角色。
-
帮助台 - 只读角色。
通过特定的主控室 URL 访问单个应用 SAP 移动服务主控室。URL 的格式为:
https://<mobile_application_url>/mobileservices/Admin
例如,如果 com.sap.myApp 应用程序的 URL 为 http://mobile-tenant1-groupX-tenant-com-sap-myapp.cfapps.sap.hana.ondemand.com,则可通过以下路径访问应用程序:
https://mobile-tenant1-groupX-tenant-com-sap-myapp.cfapps.sap.hana.ondemand.com/mobileservices/Admin。
提示
您可以通过导航到 API 标签,然后复制服务器 URL 来查找 <mobile_application_URL>。
常规 SAP 移动服务主控室访问仅可以平台用户身份进行。平台用户还可以登录到 SAP Business Technology Platform 主控室,并是子账户、组织和空间的成员。
另一方面,根据 SAP Business Technology Platform 子账户中配置的信任提供者验证业务用户。业务用户不需要 SAP Business Technology Platform 账户的常规访问权限。
业务用户功能会受到限制。由于不允许已登录用户对 SAP Business Technology Platform 账户执行操作,因此移动服务不能运行需要与 SAP Business Technology Platform 基础架构和其他服务进行交互的操作。例如,业务用户不能创建新应用程序,这会在空间中安装新应用程序路由;或者更改安全设置,这会重新创建 XSUAA(安全)服务实例。
您将在以业务用户身份使用 SAP 移动服务主控室时注意到这些差异:
-
由于只有一个要管理的应用,不再显示左侧导航窗格且会省略导航痕迹。
-
不再显示删除、导出和锁定操作。
-
不再显示几个已分配的功能,其中包括移动应用目录和移动云构建。
-
不再显示发现标签。
-
在应用程序详细信息下的信息标签上,自定义域是只读的;并且许可证类型不出现或显示为
kernel-service,具体取决于应用。 -
在安全标签上,OAuth 设置和角色设置为只读。
-
在日志标签上,您只能查看单个应用程序的事件日志。
除了这些基本差异外,单个应用版本的大部分 SAP 移动服务主控室操作相同。
-
如上述上下文中所述,使用主控室 URL 通过浏览器访问单个应用 SAP 移动服务主控室,格式为:
https://<mobile_application_url>/mobileservices/Admin。例如,
https://mobile-tenant1-groupX-tenant-com-sap-myapp.cfapps.sap.hana.ondemand.com/mobileservices/Admin。系统提示您登录,然后显示 SAP 移动服务主控室 和单个应用程序。 -
使用 SAP 移动服务主控室 管理应用程序及其分配的功能,请记住上述上下文中提及的差异和限制。
更改单个 (SaaS) 应用程序的服务计划¶
如果您更改 SAP Business Technology Platform 级别的服务计划,您可能还需要更改 移动服务 单个应用级别的服务计划设置。术语许可证类型和服务计划可互换使用。许可确定功能和费用。
在开始之前,建议您充分了解可用的服务计划以及您当前的服务计划。您可以检查 SAP Business Technology Platform 主控室以查看您当前的活动 移动服务 服务计划。请注意 移动服务 应用和 Cloud Foundry 运行时是否在相同的服务计划下。要正确开票,所有现有服务都必须在正确的服务上。例如,如果应用属于 free 计划,则 Cloud Foundry 运行时也必须属于 free 计划,否则会产生费用。有关详细信息,请参阅服务计划。
要更改计划:
-
通过特定的主控室 URL 访问单个应用 SAP 移动服务主控室。URL 的格式为:
https://<mobile_application_url>/mobileservices/Admin例如,如果
com.sap.myApp应用程序的 URL 为http://mobile-tenant1-groupX-tenant-com-sap-myapp.cfapps.sap.hana.ondemand.com,则可通过以下路径访问应用程序:https://mobile-tenant1-groupX-tenant-com-sap-myapp.cfapps.sap.hana.ondemand.com/mobileservices/ Admin。提示
您可以通过导航到 API 标签,然后复制服务器 URL 来查找
<mobile_application_URL>。 -
在应用程序详细信息屏幕上,选择更改服务计划以更改服务计划。
-
升级服务计划 从下拉菜单中选择服务计划。
-
升级到
build-default:选择build-default服务计划将解锁应用程序的高级功能。这些功能包括应用程序管理策略(包括设置限制打印数据和限制打开 URL),并且将添加 Cloud Build 功能。 -
升级到
resources:选择resources不会更改任何功能集。它保持不变。
-
-
降级服务计划 您也可以将服务计划从
build-default降级到kernel-service或resources。 降级到kernel-service或resources:降级服务计划将清除所有高级功能数据,包括应用程序管理策略和 Cloud Build。 1.应用程序管理策略:设置限制打印数据和限制打开 URL 将被移除。 2.Cloud Build:Cloud Build 服务将从应用程序中移除,所有 Cloud Build 相关数据都将被清除。 -
选择更改计划。
注释
要在升级到
build-default服务计划后为 SaaS 应用程序启用 Cloud Build 服务,提供者必须提前分配 Cloud Build 服务。如果提供者应用未分配有 Cloud Build 服务,则即使是升级到build-default服务计划后 SaaS 应用程序也无法进行访问。
为单个 (SaaS) 应用程序创建构建作业¶
作为管理员,您可以为 iOS 和 Android 应用程序创建和管理云构建作业。
为单个 (SaaS) 应用程序创建构建作业。构建作业合并了项目设置和构建设置(如签名参数文件)。选择创建构建作业按钮为 移动开发工具包客户端 或 SAP Asset Manager创建构建作业。
要创建构建作业,请执行以下步骤:
-
访问单个应用 移动服务 主控室。有关详细信息,请参阅管理单个 (SaaS) 或 SAP Mobile Start 应用程序。
-
在应用程序详细信息屏幕上,导航到设置标签,然后从扩展组件功能部分选择云构建。
-
导航到构建作业标签以创建新的构建作业或查看现有构建作业。您还可以从此屏幕编辑或删除构建作业。
(可选)要修改现有构建作业,请从相应构建作业的操作列中选择 。
(可选)要删除现有构建作业,请从相应构建作业的操作列中选择 。
-
选择创建构建作业创建新的构建作业。
-
在构建作业向导的基本信息屏幕中,填写信息。
基本信息屏幕详细信息
字段 描述 构建作业名称 用于替换缺省名称的唯一构建作业名称。 应用短名称 应用程序短名称。 应用长名称 应用程序长名称。 构建平台 要构建的平台,例如 Android 和 iOS。 -
在构建选项屏幕上,填写平台相关信息。
- 对于 iOS 构建
- 签名参数文件:从下拉列表中选择签名参数文件。
- 包标识:App Store 提供的唯一应用标识符。系统自动从所选签名参数文件中提取包标识。
- 对于 Android 构建:填写下方信息:
- 签名参数文件:从下拉列表中选择签名参数文件。
- Google 服务 JSON 文件:输入 Google 服务 JSON 文件,或浏览进行查找。选择显示以查看 JSON 文件的内容。如果该文件不是正确的文件,请单击删除并重试。保存后,将上传 JSON 文件。
- 包名称:系统自动从上传的 Google 服务 JSON 文件中提取包名称。
- 二进制格式:选择要使用的二进制格式,APK(Android 包套件,缺省格式)或 AAB(Android 应用包)或 APK(Android 包套件)和 APK(Android 包套件,缺省格式)。
- 目标部署:选择目标部署设备 (ARM) 和/或模拟器 (X86)。
注意
- 以下是选择和使用构建平台时需要牢记的一些要点:
- 如果上传的 Google 服务 JSON 文件具有多个包名称,请从下拉列表中相应地选择包名称。
- 如果上传的 Google 服务 JSON 文件具有一个包名称,该文件将仅显示此包名称。
- 如果用户同时选择构建平台、iOS 和 Android,则提取的包标识和包名称应一致。如果不一致,则会显示一条明确的错误消息,阻止后续操作。您可能需要相应地调整配置文件。
- 每当构建平台选择发生更改时,系统都会重新验证包标识和包名称的一致性。
- 如果系统无法从 Google 服务 JSON 文件中提取包名称,您可能还会收到错误消息。可能存在的问题在于文件格式。
-
在应用图标屏幕上,选择 以添加以下信息的图标或图像:
对于 iOS 应用图标
图标类型 描述 主应用徽标 (必需)表示应用程序的主图像。 欢迎屏幕徽标 启动应用程序时在初始屏幕上显示的图像或图形。 色调模式下的图像 色调模式下的图像为应用了颜色重叠的图片。这将叠加图像的整体色度或色调。 深色模式下的图像 深色模式下的图像是设计为在深色背景下显示的视觉资料,旨在减少眼疲劳,并提高弱光环境下的可见性。 注意
对于 iOS 应用图标,使用最大大小为 1MB 的
PNG文件。建议的尺寸为1024×1024像素。如果上传具有不同尺寸的图像,系统会在构建流程中将其调整为1024x1024像素。成功上传图标或图像后,将在图像预览列下显示预览。对于 Android 应用图标
图标类型 描述 主应用启动器徽标图像 (必需)用于在设备上打开主应用程序的图标。 主应用启动器背景图像 设备主屏幕上的应用图标后显示的图像。 主应用启动器的单色图像 单色图像是仅使用一种颜色或该颜色的深浅色调的图片。 欢迎屏幕上的徽标图像 表示在应用程序初始屏幕上显示的品牌或公司的图像。 通知图标 设备或应用程序上用来指示新信息或未读信息的小符号。 注意
对于 iOS 应用图标,使用最大大小为 1MB 的
Vector XML文件。建议的尺寸为 1024×1024 像素。如果上传具有不同尺寸的图像,系统会在构建流程中将其调整为1024x1024 pixels。成功上传图标或图像后,将在图像预览列下显示预览。选择 以移除任何添加的图标或图像。
-
选择创建构建作业。
- 对于 iOS 构建
结果 已成功为所选构建平台及带有应用图标的构建选项创建构建作业。
下一步 创建构建作业后,您可以针对所创建构建作业运行构建,编辑以及删除构建作业。
查看单个 (SaaS) 应用程序的构建作业详细信息¶
作为管理员,您可以查看已为单个 (SaaS) 应用程序创建的构建作业。
此任务说明了如何使用云构建查看和管理单个 (SaaS) 应用程序的构建作业详细信息。它指导用户访问构建作业列表、检查其状态和属性、创建或修改构建作业以及查看构建历史记录、日志和二进制文件。这些步骤有助于有效监控进度并解决问题。
要查看构建作业,请执行以下步骤:
-
访问单个应用 移动服务 主控室。有关详细信息,请参阅管理单个 (SaaS) 或 SAP Mobile Start 应用程序。
-
在应用程序详细信息屏幕上,导航到设置标签,然后从扩展组件功能部分选择云构建。
-
在构建作业标签上,查看所选应用程序的可用构建作业列表。
构建作业属性
字段 描述 构建作业名称 分配给构建作业的名称,例如“测试应用”。 状态 构建作业的当前状态,例如构建已完成、正在构建或构建失败。 签名参数文件 用于构建作业中包含的平台的签名参数文件,格式为 <Platform>:<signing_profile_name>。例如:Android:AndroidProfileKey0或iOS:CBSComSapFioriWildcard。构建编号 分配给构建的编号,例如 1。 创建日期 构建作业创建的日期,格式为 YYYY-MM-DD(本地或 UTC)。 上次构建日期 上次构建的日期,格式为 YYYY-MM-DD(本地或 UTC)。 操作 您可以执行的操作,例如构建、编辑和删除。 - 创建构建作业按钮 ‒ 创建新的构建作业。有关详细信息,请参阅为单个 (SaaS) 应用程序创建构建作业。
- 选择 对云构建作业进行排序。您可以按构建作业名称(默认)、创建日期或上次构建日期对构建作业进行排序。
- (可选)要构建现有构建作业,请从相应构建作业的操作列中选择构建。检查状态列以查看进度。
- (可选)要修改现有构建作业,请从相应构建作业的“操作”列中选择 。
- (可选)要删除现有构建作业,请从相应构建作业的“操作”列中选择 。
-
您可以选择每个构建作业以查看其当前状态。如果二进制格式同时为
APK和AAB,则页面上将针对每种格式显示单独的部分。云构建历史记录
字段 描述 构建状态 构建作业的当前状态,例如构建已完成、正在构建或构建失败。 操作系统 构建的操作系统,例如 iOS 或 Android。 二进制格式 用于打包的二进制格式,平台为 Android 时为 AAB(Android 应用包)或 APK(Android 打包套件);平台为 iOS 时为 IPA(iOS App Store 包)。 构建编号 分配给构建的版本,例如 1。 构建/版本代码 构建版本。 应用版本 应用程序版本。 构建日期 (UTC+0000) 构建的日期,格式为 YYYY-MM-DD HH:MM(本地或 UTC)。 操作 您可以执行的操作(如果有),例如下载 APK(面向 android)、下载 AAB(面向 android)或下载二进制文件(面向 iOS)。 选择下载 APK、下载 AAB 或下载二进制文件以将二进制文件下载到本地目录。准备好之后,可以将二进制文件发布到下载站点。
-
(可选)选择构建作业历史记录行进一步下钻,以查看更多构建详细信息。
- 在构建详细信息下,可以查看以下信息:包名称、构建开始日期 (UTC+0000)、目标部署(设备 (ARM) 或模拟器 (X86))、二进制格式、构建编号和应用版本。
- 在安装下,您可以通过扫描二维码或复制 URL 来安装二进制文件(APK 和 IPA)。
- 在构建日志下,您可以随着构建进度查看实时构建日志。日志包括适用于平台的构建属性汇总,例如应用类型、工具集版本、插件和版本:
- iOS - 应用类型、评论、平台、编号、类型、sdk_version、mobilestart_version、tuist_version、默认值、体系结构、xcode、Id 和选项。
- Android - 应用类型、评论、平台、编号、类型、sdk_version、mobilestart_version、默认值、java、sdk_tools、sdk、sdk_build_tools、Id 和选项。
如果需要,您可以选择 并将日志下载到本地目录。使用日志解决问题。
- 选择下载二进制文件按钮下载二进制文件。
- 选择删除按钮删除二进制文件。任何添加到 App Lab 中的二进制文件也将会自动删除。
-
选择信息标签以查看功能详细信息。
编辑单个 (SaaS) 应用程序的构建作业¶
作为管理员,您可以编辑单个 (SaaS) 应用程序的构建作业。
要编辑构建作业,请执行以下步骤:
-
访问单个应用 移动服务 主控室。有关详细信息,请参阅管理单个 (SaaS) 或 SAP Mobile Start 应用程序。
-
在应用程序详细信息屏幕上,导航到设置标签,然后从扩展组件功能部分选择云构建。
-
在构建作业标签的“操作”下选择 以编辑构建作业。
-
使用构建作业向导对构建作业进行更改。有关详细信息,请参阅为单个 (SaaS) 应用程序创建构建作业。
-
选择完成。构建作业状态将更改为待构建,并在下次运行构建时使用新值。
为单个 (SaaS) 应用程序创建签名参数文件¶
作为管理员,您可以为 iOS 和 Android 应用程序创建和管理签名参数文件。
为了在 Android 和 iOS 上构建和运行二进制文件,必须对二进制文件进行签名。作为管理员,您可以管理企业签名参数文件,云构建服务使用这些参数文件构建 IPA 和 APK 文件。您可以生成新的 Android 签名参数文件,并且可以上传现有 Android 或 iOS 签名参数文件。
要创建签名参数文件,请按以下步骤操作:
-
访问单个应用 移动服务 主控室。有关详细信息,请参阅管理单个 (SaaS) 或 SAP Mobile Start 应用程序。
-
在应用程序详细信息屏幕上,导航到设置标签,然后从扩展组件功能部分选择云构建。
-
导航到签名参数文件标签以查看已为云构建服务上传的现有签名参数文件[签名参数文件的总数显示在**签名参数文件**之后 (#)]。您可以搜索特定的参数文件,或对现有参数文件进行排序以查看总签名参数文件的子集。参数文件通过平台显示,包括 Android 和 iOS。
签名参数文件
列 描述 参数文件名称 分配给签名参数文件的名称。 参数文件状态 显示签名参数文件的状态。 以下是可能状态的列表: - 有效:无需进行任何操作。
- 无效(未选择文件):请上载有效的
.mobileprovisioning文件。 - 有效(即将过期):在配置参数文件过期之前进行续订或替换。
- 无效(已过期):上传已续订的参数文件或选择其他有效的签名参数文件。 如果参数文件状态为无效(未选择文件)或无效(已过期),则参数文件处于错误状态。此条件阻止构建。
创建人 签名参数文件创建人员的标识符。 过期日期 (UTC+0000) 签名参数文件过期的日期(以本地或 UTC 时区计)。 操作 您可以执行的操作,例如删除或编辑。 -
选择上传以上传现有 iOS 或 Android 签名参数文件,提供以下信息:
- 对于 iOS 平台
- 参数文件名称
- 签名参数文件(.p12 格式)
- 私钥密语
- MainApp 配置参数文件
- WatchKit 应用配置参数文件
- WatchKit 应用小部件配置参数文件
- 小部件配置参数文件
- 通知服务配置参数文件
- 对于 Android 平台
- 参数文件名称
- 密钥库文件(格式为 .keystore 或 .jks)
- 密钥库密码
- 密钥别名
- 密钥密码
注释
所有配置参数文件必须采用
.mobileprovisioning格式。 -
您可以编辑 Android 或 iOS 平台的现有已上传签名参数文件。
从相应签名参数文件的操作列中选择 以编辑现有签名参数文件。
-
您可以删除 Android 或 iOS 平台的现有已上传签名参数文件。
从相应签名参数文件的操作列中选择 以删除现有签名参数文件。
-
选择确定以保存对签名参数文件的更改。
为单个 (SaaS) 应用程序启用清除设置¶
作为管理员,您可以为云构建日志的清除设置设置计划并为应用程序构建输出。
清除在单个应用级别进行。云构建日志将保留指定的天数,并在计划器任务运行时清除。输出和部件将保留指定的天数,并在计划器任务运行时清除。
要启用或修改清除设置,请按以下步骤操作:
-
访问单个应用 移动服务 主控室。有关详细信息,请参阅管理单个 (SaaS) 或 SAP Mobile Start 应用程序。
-
在应用程序详细信息屏幕上,导航到设置标签,然后从扩展组件功能部分选择云构建。
-
导航到清除设置标签以查看当前清除设置。
-
如果启用清除设置已禁用,请选择 以启用清除设置并编辑清除设置。
设置 描述 在此时间后清除成功构建的日志 确定何时清除成功构建的日志 - 立即,或在 1、3、7 或 30 天之后。缺省值为 7 天。 在此时间后清除未成功构建的日志 确定何时清除未成功构建的日志 - 立即,或在 1、3、7 或 30 天之后。缺省值为 7 天。 保留每个应用过去 n 个成功构建的输出 确定过去 1-5 个成功的应用构建中部件的保留时间。缺省值为 3 个成功的构建。 保留每个应用过去 n 个未成功构建的输出 确定过去 1-5 个未成功的应用构建中部件的保留时间。缺省值为 3 个未成功的构建。 上次清除 以 YYYY-MM-DD HH:MM 格式(本地或 UTC 时区)显示上次成功的清除。 -
选择保存。
下一步 系统会保留数据,直到调度器任务执行。缺省情况下,每 12 小时发生一次。您可以通过服务器端配置修改此间隔。具有待定状态的构建从清除操作中排除,并且不受这些设置影响。
管理 SAP Build Apps¶
在 SAP 移动服务主控室 中配置和管理 SAP 构建应用。
目前您无法从 SAP 移动服务主控室 创建 SAP Build Apps。buildApps 应用程序类型只能由构建应用团队从其服务创建。
SAP Build Apps 提供用于部署缩小版移动应用并使用主控室对其进行管理的选项。目前,buildApps 应用程序类型只能由构建应用团队从其服务创建。创建后,该应用程序将在 SAP 移动服务主控室 SAP Build Apps 应用程序列表中显示。请注意,适用于 buildApps 应用程序的特性和功能有限。仅适用于 SAP 构建的功能才会在主控室中显示。
-
在 SAP 移动服务主控室 中,选择移动应用程序 > SAP Build Apps。
您可以查看包含摘要信息的应用程序列表,包含应用程序标识、名称、供应商、应用程序类型、服务计划、状态和创建日期。使用搜索和排序选项,找到想要查看的应用程序。
SAP Build Apps 应用程序摘要
列 描述 应用程序标识 唯一应用程序标识符。 名称 应用程序名称。 应用程序类型 SAP Build Apps 供应商 提供应用程序的供应商。 状态 应用程序的当前状态,例如:(1) 已启动 - 应用程序运行正常。(2) 不一致 - 如果从 SAP Business Technology Platform 主控室删除或更改应用程序,它们可能会变得不一致。从 SAP 移动服务主控室 中,您可以删除或恢复应用程序。(3) 已从 SAP `BTP`` 主控室删除 - 应用程序已删除。您可以在 SAP 移动服务主控室 中将其恢复或删除。(4) 正在恢复 - 正在从不一致的状态恢复应用程序。 已过期 此应用程序是否已过期。如果已确定,将提示您将应用程序更新为包含修复和改进的较新版本。通常,您应该更新应用程序。 创建日期 (UTC+0000) 应用程序创建日期(UTC 或本地格式),具体取决于您为用户设置选择的内容。 -
根据配置 SAP Build Apps 中的描述,选择一个应用程序以查看或修改其详细信息。
-
选择导入以导入新应用。
-
在导入应用程序中,输入文件名或选择浏览来找到该文件。
-
单击保存。该应用已导入并已添加到应用程序列表。
-
根据配置 SAP Build Apps 中的描述配置应用。
-
配置 SAP Build Apps¶
配置和编辑 SAP Build Apps 并从 移动服务主控室 管理应用。仅适用于 SAP 构建的功能才会在主控室中显示。
-
在 SAP 移动服务主控室 中,选择移动应用程序 > SAP Build Apps。
-
选择一个应用程序查看其详细信息。
-
配置或修改 SAP Build Apps 应用程序。要防止意外更改,您可以在完成其配置后锁定应用程序。要进行更改,您需要手动解锁应用程序。
-
设置:此标签提供所选应用程序的常规设置。 常规设置包括连接性、客户端设置、安全性、日志设置、警报、应用程序链接和认证。要在此标签上设置信息,请参阅创建应用程序。 在 Cloud Foundry 环境中,您还可以配置自定义域。有关详细信息,请参阅编辑应用程序和管理自定义域。
- 连接性:SAP Mobile Services 的连接性功能允许您定义应用程序可以使用的后端系统连接性。您可以为不同的后端系统定义任意数量的目标。这些目标将专门由为其配置的应用程序。您可以限制访问允许的路径。有关详细信息,请参阅定义连接性。
- 客户端设置:为所选的移动应用程序设置客户端策略并管理其用户注册。有关详细信息,请参阅定义客户端策略和编辑 JSON 存储。
- 安全性:此标签使您可以管理所选应用程序的安全性。有关详细信息,请参阅配置应用安全性。
- 日志设置面向的是已迁移到单个服务模型的应用,用于启用应用程序级别的事件日志。您可以指定任何已分配到应用的单个服务,以及移动应用路由器。借此您可以进一步控制要在应用程序级别查看的事件日志信息。有关详细信息,请参阅在应用级别启用事件日志。您可以根据查看事件日志中的描述继续查看事件日志。
- 警报:此标签允许您为不同类别的服务器故障配置设置。配置完成后,实施 SAP Business Technology Platform Alert Notification 服务即可接收通知。有关详细信息,请参阅配置警报设置和订阅移动服务警报。
- 应用程序链接:此标签启用 Apple 的通用链接以及 Android 应用的应用程序链接。Apple 通用链接和 Android 应用程序链接允许用户在本地打开应用程序,而无需下载应用或使用浏览器容器。有关详细信息,请参阅创建应用程序链接。
要配置附加功能,请导航至设置 > 扩展组件功能。选择添加功能,选择所需的应用程序并选择确定。
该扩展组件功能将在扩展组件功能列表下显示。有关详细信息,请参阅配置已分配功能。
要移除扩展组件功能,请选择该功能以打开功能配置屏幕,然后选择从应用程序移除。在 Cloud Foundry 环境中,您还可以配置自定义域。有关详细信息,请参阅编辑应用程序和管理自定义域。
-
API 提供登录和 API 功能。
-
在登录下,您可以找到一个或更多二维码,可用于配置移动应用程序以连接到此 移动服务 实例。
对于应用内扫描代码,设备用户必须先手动启动应用,之后在应用内扫描二维码以启动登录流程。
对于缺省配置,本机应用开发人员可以下载包含发现服务缺省配置的本机特定文件。选择 iOS 以
plist格式下载配置文件,或选择 Android 以 JSON 格式下载文件。您可以将文件添加到您的 iOS 或 Android 应用项目,无需附加格式化。对于配置,您可以查看与应用程序关联的任何应用程序路由。选择编辑以进行更改。有关 XSUAA 属性应用程序路由的域的信息,请参阅创建应用程序 。
对于 Apple 和 Android 启动应用代码,设备用户可以选择 URL(或使用允许读取二维码的 Apple 照相机应用或 Android 应用程序扫描二维码),以查找并启动本地安装的应用程序。如果用户启用 Android 应用链接,它还支持 Android 的相机应用。如果您在应用程序链接部分中启用 Apple 通用链接或 Android 应用链接或两者同时启用,则会生成应用启动二维码;二维码的标签文本取决于启用的应用程序链接(
Apple launch app code、Android launch app code或Apple and Android launch app code)。对于含 URI 模式的 Apple 和 Android 启动应用代码,设备用户可以扫描二维码或选择 URL,以使用
appLinkURL 查找并启动应用程序。仅当在应用程序链接标签中启用设备应用程序 URI 模式后,才会显示此选项。您必须选择一种设备类型,并为 iOS 或 Android 输入相应的设备应用程序 URI 模式。注意
(仅 移动开发工具包)如果在应用程序链接标签中设置 Apple 和 Android 设备应用程序 URI 模式,您将看到两个单独的二维码,分别标记为含 URI 模式的 Apple 启动应用代码和含 URI 模式的 Android 启动应用代码。
如果应用安全配置更改,则必须生成新的二维码。另请注意,URL 可能会很长,可能比屏幕上显示的值长。使用复制到剪贴板 ( ),复制整个值。
-
在 API 下,可以查看常用 API URL 列表。使用复制到剪贴板 ( ),以将只读 URL 复制到剪切板并粘贴到其他位置,避免输入错误,确保准确性。
注意
服务器 URL 也是
名称。 -
-
用户和设备管理:此标签允许管理员执行一个或多个与用户和设备相关的操作,例如冻结、撤销、锁定、导出用户数据、发送推送通知、擦除和删除。
-
管理 微应用¶
使用 SAP 移动服务主控室 配置和管理 微应用,如 WeCom(企业)、微信(社交)和钉钉。注意,仅在选定的国家/地区提供 微应用 支持。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用。
可以查看应用列表以及摘要信息,例如应用程序标识、名称、应用程序类型和供应商等。使用搜索和排序选项,找到想要查看的应用。
您可以查看包含摘要信息的应用程序列表,包含应用程序标识、名称、供应商、应用程序类型、服务计划、状态和创建日期。使用搜索和排序选项,找到想要查看的应用程序。
微应用 摘要
列 描述 应用程序标识 微应用 的唯一标识符。 名称 微应用 名称。 应用程序类型 微应用 类型,例如 WeCom、微信或钉钉。 供应商 供应商在 微应用 中提供。 服务计划 创建 微应用 时已存在的应用程序计划。 状态 微应用 的当前状态,例如已开始、不一致、已删除或正在恢复。 已过期 微应用 是否已过期。如果已确定,将提示您将 微应用 更新为包含修复和改进的较新版本。通常,您应该更新 微应用。 创建日期 (UTC/local) 微应用 创建日期(UTC 或本地格式),具体取决于您为用户设置选择的内容。 -
选择 微应用 以查看其详细信息,并进行更改。
-
设置:此标签提供所选应用程序的常规设置。 常规设置包括连接性、客户端设置、安全性、日志设置、警报、应用程序链接和认证。要在此标签上设置信息,请参阅创建应用程序。 在 Cloud Foundry 环境中,您还可以配置自定义域。有关详细信息,请参阅编辑应用程序和管理自定义域。
- 连接性:SAP Mobile Services 的连接性功能允许您定义应用程序可以使用的后端系统连接性。您可以为不同的后端系统定义任意数量的目标。这些目标将专门由为其配置的应用程序。您可以限制访问允许的路径。有关详细信息,请参阅定义连接性。
- 客户端设置:为所选的移动应用程序设置客户端策略并管理其用户注册。有关详细信息,请参阅定义客户端策略和编辑 JSON 存储。
- 安全性:使您可以管理所选 微应用 的安全性。有关附加安全性详细信息,请参阅配置应用安全性。
- 日志设置用于启用 微应用 的事件日志。您可以指定任何已分配到 微应用 的单个服务,以及移动应用程序。借此您可以进一步控制要在应用级别查看的事件日志信息,如在应用级别启用事件日志中所述。您可以根据查看事件日志中的描述继续查看事件日志。
- 警报:允许您为微信应用启用警报,并为警报建立消息阈值和计划。要接收通知,请通过 Alert Notification 服务配置订阅和警报(不能通过 移动服务主控室管理订阅和警报)。有关详细信息,请参阅配置警报设置和订阅移动服务警报。
要配置附加功能,请导航至设置 > 扩展组件功能。选择添加功能,选择所需的应用程序并选择确定。
该扩展组件功能将在扩展组件功能列表下显示。有关详细信息,请参阅配置已分配功能。
要移除扩展组件功能,请选择该功能以打开功能配置屏幕,然后选择从应用程序移除。在 Cloud Foundry 环境中,您还可以配置自定义域。有关详细信息,请参阅编辑应用程序和管理自定义域。
-
API 提供了一些配置选项的摘要(选择编辑进行更改),以及常用 API URL 的列表[使用**复制到剪切板** ( ) 以将只读 URL 复制到剪贴板]。请注意,服务器 URL 也是
<mobile_services_host>名称。 - 您可以通过用户(仅微信)来导出或删除用户数据,并阻止一名或多名用户使用 微应用。
-
创建 微应用¶
创建新的应用程序定义,以使用 SAP 移动服务主控室 管理 微应用。使用模板定义 微应用,然后配置其已分配功能或添加更多功能。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用,然后选择新建。
-
在新应用程序中,输入: 微应用 属性
字段 值 Config模板选择配置模板类型:WeCom(企业)、微信(社交)或钉钉。 标识 (必填)应用程序的唯一标识符,用反转域名表示法。这是由应用程序开发人员分配或生成的应用程序或捆绑标识符。管理员使用应用程序标识将应用程序注册到SAP Mobile Services,然后客户端应用程序在将请求发送到服务器时使用应用程序标识。请参阅下方的应用程序标识建议。 名称 (必填)应用程序名称只能包含字母数字字符、空格、下划线和句号,长度最长为 80 个字符。 CorpID(必填 - 仅 WeCom、钉钉)WeCom 或钉钉企业的唯一标识。 AgentID(必填 - 仅 WeCom、钉钉)每个企业应用程序的唯一标识。 WeChat AppID(仅限微信 - 必填)微信应用程序的唯一标识。 描述 (可选)描述最多可以包含 255 个字母数字字符和特殊字符。 供应商 (可选)开发应用程序的供应商。供应商名称只能包含字母数字字符、空格、下划线和句号,长度最长为 255 个字符。 服务计划 您要用于账户的服务计划: resources(默认)、build-code、free、standard (Users)或b2c (Consumer Edition)。“精简”计划仅适用于试用子账户。许可确定功能和费用。有关附加信息,请参阅服务计划。请记住standard (Users)和b2c (Consumer Edition)服务计划已弃用,因此resources是最佳选择。您可以将服务计划从free更改为resources,以便您可以在不丢失工作的情况下迁移您的应用。更改服务计划不可撤销。您无法从resources、standard或b2c切换到free。应用程序路由的域 在支持多个域的区域中,选择最终用户可通过其访问应用程序的应用程序路由。路由与空间相关联并在 SAP Business Technology Platform 主控室中配置。下拉列表显示所有可用于客户组织的共享域和自定义域。如果要使用自定义域,可以根据什么是自定义域中的信息创建一个。 应用程序标识建议:
- 必须唯一。
- 必须以字母字符开头。
- 只能包含字母数字字符、下划线和句号。
- 最多可以包含 64 个字符。
- 不能包含空格。
- 不能以句号开头,并且不能包含两个连续的句号。
- 不能是以下区分大小写的关键字:
Admin、AdminData、Pushsmp_cloud、resource、test-resources、resources、Scheduler、odata、applications、Connections、public、lcm。
还建议分配至少包含两个段的标识,例如
com.sap.mobile.app1。如果您正在构建 Android 应用程序,则其标识必须遵循 Google 定义的规则,否则 Android 构建将会失败:
-
标识必须至少有两段(一个或多个句号)。
-
每段开头必须为字母。
-
所有字符必须为字母数字或下划线 [
a-zA-Z0-9_]。
为从 SAP Web IDE 创建的打包应用保留前缀
com.sap.webide。 -
选择下一步继续。
字段 值 XSUAA 服务 选择要使用的 XSUAA 验证和验证服务。您可以选择缺省实例以创建新实例,或者您可以从列表中选择现有服务。如果您已部署 Cloud Foundry 应用程序并希望从移动服务连接到此应用程序,则使用现有 XSUAA 实例非常有用。在此情况中,重用现有 XSUAA 实例非常方便。为其他场景选择缺省实例。 xs-security.json 定义用于访问应用程序的验证方法和权限类型的 JSON文件。有关附加信息,请参阅应用程序安全描述符配置语法。令牌生命周期 输入令牌生命周期,并选择单位(天、小时或分钟)。 刷新令牌生命周期 输入刷新令牌生命周期,并选择单位(天、小时或分钟)。 已审批提供者 指示应用应支持所有已审批提供者还是仅支持所选提供者。 令牌中的系统属性 指示组、角色集合或两者。 -
单击完成和确定以确认。随即信息页面使用当前设置显示。
为 微应用 配置已分配功能¶
配置与 微应用 定义相关联的功能。可以添加附加功能以及删除不需要的功能。某些功能需要在应用程序中进行编码。通常功能之间没有相关性。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用。
-
选择应用程序并访问设置标签。
-
选择应用程序,在设置标签下,您可以查看分配给所选应用程序的功能列表。缺省情况下,这些功能包括:
-
连接性 - SAP Mobile Services 的连接性功能允许您定义应用程序可以使用的后端系统连接性。您可以为不同的后端系统定义任意数量的目标。这些目标将专门由为其配置的应用程序。您可以限制访问允许的路径。有关详细信息,请参阅定义连接性。
-
客户端设置 - 为所选的移动应用程序设置客户端策略并管理其用户注册。有关详细信息,请参阅定义客户端策略和编辑 JSON 存储。
-
安全性 - 此标签使您可以管理所选应用程序的安全性。有关详细信息,请参阅配置应用安全性。
-
日志设置 - 此标签面向的是已迁移到单个服务模型的应用,用于启用应用程序级别的事件日志。您可以指定任何已分配到应用的单个服务,以及移动应用路由器。借此您可以进一步控制要在应用程序级别查看的事件日志信息。有关详细信息,请参阅在应用级别启用事件日志。您可以根据查看事件日志中的描述继续查看事件日志。
-
警报 - 此标签允许您为不同类别的服务器故障配置设置。配置完成后,实施 SAP Alert Notification 服务即可接收通知。有关详细信息,请参阅配置警报设置和订阅移动服务警报。
-
-
(可选)在已分配功能下,选择添加图标 来添加以下功能,然后选择确定:
-
示例 OData ESPM - 在开发和测试的过程中使用示例服务。
-
网络跟踪 - 查看从移动应用程序收集的网络跟踪信息以进行调试。
-
移动 微应用 - 定义 WeCom、微信或钉钉设置和服务密钥,并查看功能详细信息。
-
-
选择已分配功能(例如移动 微应用)以配置其设置,然后选择保存。
-
(可选)选择重置将设置重置为缺省值。
-
(可选)选择从应用程序中移除将功能从应用程序中移除。
配置 WeCom 设置¶
配置 WeCom 微应用 的设置。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用,然后选择现有 WeCom 应用或创建一个。
-
导航到设置标签,然后从扩展组件功能部分中选择移动 微应用(或先进行添加)。
-
在配置标签中,定义以下设置:
名称 描述 CorpID(必填)WeCom 企业账户的唯一标识。在 WeCom 管理员面板 > 我的企业 > 企业信息下查找此信息。 AgentID(必填)企业应用程序的唯一标识。在 WeCom 管理员面板 > 企业应用程序 > 进入应用程序下查找此信息。 应用密钥 (必填)企业应用程序密钥。在 WeCom 管理员面板 > 企业应用程序 > 进入应用程序下查找此信息。 消息处理器端点 从连接列表中选择消息处理器端点。复制值(消息处理器 URL)以编辑 WeCom 管理员面板中的 API 接收设置 URL。 消息处理器 URL 根据您选择的消息处理器端点,将出现消息处理器 URL。使用复制图标将 URL 复制到剪贴板,然后粘贴到其他位置。 令牌 (必填)WeCom 企业应用程序消息接收令牌。在 WeCom 管理员面板 > 特定应用 > 消息接收 > API 接收设置中查找此信息。 EncodingAESKey(必填)WeCom 企业应用程序消息接收的消息正文编码密钥。在 WeCom 管理员面板 > 特定应用 > 消息接收 > API 接收设置中查找此信息。 -
在服务密钥标签中,对于某些功能,您可以实施服务密钥,这使应用程序可以使用服务密钥作为其凭据来访问服务实例。请参阅服务密钥。
-
在信息标签上,您可以找到其他信息,包括功能描述和文档以及支持 URL。
配置微信设置¶
配置微信 微应用 的设置。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用,然后选择现有微信应用或创建一个。
-
导航到设置标签,然后从扩展组件功能部分中选择移动 微应用(或先进行添加)。
-
在配置标签中,定义以下设置:
名称 描述 WeChat AppID(必填)微信应用程序的唯一标识。 在微信公众平台中,申请公众号后,可以在基本配置中找到微信 AppId。 应用密钥 (必填)微信应用程序的应用程序密钥。 在微信公众平台中,申请公众号后,可以在基本配置中找到应用密钥。 消息处理器端点 从连接列表中选择消息处理器端点。 消息处理器 URL 根据您选择的消息处理器端点,将出现消息处理器 URL。使用复制图标将 URL 复制到剪贴板,然后粘贴到其他位置。 令牌 (必填)微信应用程序消息接收令牌。Token 和 EncodingAESKey 用于微信公众平台中消息和自主设置的开发人员服务器验证。在微信公众平台中,您可以在基本配置中找到 Token 信息。 EncodingAESKey微信应用程序消息接收的消息正文编码密钥。Token 和 EncodingAESKey 用于微信公众平台中消息和自主设置的开发人员服务器验证。在微信公众平台中,您可以在基本配置中找到 EncodingAESKey 信息。 -
在服务密钥标签中,对于某些功能,您可以实施服务密钥,这使应用程序可以使用服务密钥作为其凭据来访问服务实例。请参阅服务密钥。
-
在信息标签上,您可以找到其他信息,包括功能描述和文档以及支持 URL。
配置钉钉设置¶
配置钉钉 微应用 的设置。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用。您可以查看现有钉钉应用或创建一个钉钉应用。
-
导航到设置标签,然后从扩展组件功能部分中选择移动 微应用(或先进行添加)。
-
在配置标签中,定义以下设置:
名称 描述 CorpID(必填)钉钉企业账号的唯一标识。在钉钉开发平台账户管理中找到 CorpID。AgentID(必填)企业应用程序的唯一标识。在钉钉 Web 管理面板 > 自构建应用程序 > 应用程序信息中找到此信息。 应用代码 (必填)企业应用程序代码。开发人员创建应用程序时会自动生成此值。在钉钉 Web 管理面板 > 自构建应用程序 > 应用程序信息中找到此信息。 | 应用密钥 | (必填)企业应用程序密钥。开发人员创建应用程序时会自动生成此值。在钉钉 Web 管理面板 > 自构建应用程序 > 应用程序信息中找到此信息。 | -
在服务密钥标签中,对于某些功能,您可以实施服务密钥,这使应用程序可以使用服务密钥作为其凭据来访问服务实例。请参阅服务密钥。
-
在信息标签上,您可以找到其他信息,包括功能描述和文档以及支持 URL。
管理 微应用 用户注册¶
管理 微应用 的多个用户注册。注册与一个或多个设备上的验证用户或匿名用户相关联。
请注意,仅对于微信,您可以从用户标签中导出用户数据和冻结用户(请参阅管理 微应用 )。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用,然后选择应用程序。
-
选择应用程序,导航到设置标签,然后选择客户端设置,接着导航到用户注册标签。
-
在自动移除下,您可以启用自动用户移除,并以小时、天和月为单位指示移除的时间范围。
-
在汇总下,查看当前的用户数和注册数。
-
在注册用户下,您可以筛选并排序用户注册。
列描述
列 描述 注册标识 客户端应用程序提供的唯一标识符,或者系统生成的应用程序注册标识。 用户名 使用已注册应用程序标识的用户名。 最后连接 应用程序注册时的日期和时间,格式为 YYYY-MM-DD HH:MM:SS。值将显示为本地或 UTC 格式,这取决于您的用户设置。操作 您可以删除用户注册。 对于某些推送提供者,当您在用户和设备管理中删除自动注册的用户注册时,还必须从推送通知 > 推送通知中手动删除设备注册。这是因为提供者未提供在推送中进行自动删除所需的信息。对于这些提供者而言,必须执行手动删除:百度、自定义和 W3C。
-
选择注册用户以查看详细信息。类别可能因应用程序类型而异。
-
用户注册 – 分配给注册用户的唯一标识。
-
信息 - 有关注册用户的基本信息。
-
设备 - 有关注册用户使用的设备的已知信息。
-
(仅限微信)微信用户映射 - 微信标识符、昵称和档案照片(如果注册用户已提供)。
-
推送 - 已注册用户的任何推送通知设置。
-
自定义 - 为已注册用户配置的任何自定义项目。
-
-
(可选)选择已注册的用户,然后选择发送通知来向用户发送通知警报。请参阅发送 微应用 通知。
发送 微应用 通知¶
(仅限 WeCom 和钉钉)向注册的 微应用 用户发送不同类型的通知。发送通知时请记住这些准则。
对于 WeCom 微应用,支持的消息类型有:
- 文本
- 文件
- 图像
- Markdown
- 新闻
- 文本卡
- 视频
- 音频
- WeCom 新闻
对于 Markdown 选项,支持 markdown 语法子集:
-
标题 - 标题级别 1 到 6:
# Heading level 1 ## Heading level 2 ### Heading level 3 #### Heading level 4 ##### Heading level 5 ###### Heading level 6 -
粗体 - 格式为:
**bold** -
链接 - 将链接名称括在括号中,例如:
[This is a link name](http://work.weixin.qq.com/api/doc) -
代码 - 使用单引号(仅一行),格式为:
`code` -
锁定引号 ‒ 格式如下:
> Quotes -
字体颜色 - 最多支持三种颜色:
<font color="info">Green</font> <font color="comment">Gray</font> <font color="warning">Orange</font>
有关受支持的 markdown 元素的详细信息,请参阅:
-
微信支持的 Markdown 语法(仅限简体中文)。
-
Markdown 指南 - 基本语法
要发送 微应用 通知:
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用,然后选择应用程序。
-
选择应用程序,导航到设置标签,然后选择客户端设置,接着选择用户注册标签。
-
在注册用户下,按管理 微应用 用户注册所述,使用过滤和排序选项选择一个或多个用户注册。
-
在注册设备下,选择已注册的用户,然后选择发送通知来向用户发送通知警报。在发送 WeCom/钉钉推送通知中,选择消息类型。
对于文件,请选择不超过 20MB 的文件进行发送。
-
选择浏览并导航到文件。
-
选择文件,然后打开。
对于图像,请选择不超过 2MB 的
.PNG或.JPG文件。-
选择浏览并导航到图像文件。
-
选择文件,然后打开。
对于 Markdown,选择要发送的 markdown 文件。该文件必须遵循上述指南。
-
选择浏览并导航到
.md文件。 -
选择文件,然后打开。
对于新闻,指定一个或多个要发送的文章:
-
选择 添加一个或多个新闻文章。
-
提供信息以识别文章。
新闻文章属性
属性 描述 标题 文章标题。 描述 文章描述。 URL 文章 URL。 新闻封面 URL 新闻封面 URL。 操作 可删除文章。 对于文本消息,选择文本,并撰写要发送的消息文本。
对于文本卡,选择文本卡,然后定义文本卡属性:
文本卡属性
属性 描述 标题 文本卡标题。 描述 文本卡描述。 URL 文本卡的数据端点 URL。 按钮文本 显示在文本卡按钮上的文本。 对于视频,请选择不超过 10MB 的
.MP4文件,然后定义视频属性。视频属性
属性 描述 标题 视频标题。 描述 视频描述。 对于音频,请选择大小不超过 2MB 且长度不超过 60 秒的
.AMR文件。-
选择浏览并导航到视频文件。
-
选择文件,然后打开。
对于 WeCom 新闻,每批次最多可发送 8 条新闻。每个文章均可以包含封面图片、源 URL 和其他信息。如果您改变了想法,则可以在发送之前删除一个或多个文章。
WeCom 新闻属性
属性 描述 标题 所选文章的标题。 封面图片 浏览以选择不超过 2MB 的 .PNG或.JPG图像文件。作者 作者姓名。 内容来源 URL 提供内容来源 URL。 内容 提供内容来源 URL。 描述 新闻文章包的描述。 -
-
选择发送。所选用户将收到通知。
微应用 API¶
查看 微应用 的已配置 API 的列表。
-
在 SAP 移动服务主控室中,选择移动应用程序 > 微应用,然后选择应用程序。
-
选择 API 标签,并在 API 下查看常用 API URL 的列表。
对于 WeCom:
-
WeCom 消息处理器 - API 用于控制消息传递。只有在 WeCom 设置中配置了消息处理器端点后,才会显示此 API。
-
WeCom 推送 - 用于控制推送通知的 API。
有关详细信息,请参阅 WeCom 消息处理器 API和 WeCom 推送 API。
对于微信:
微信消息处理器 - API 用于控制消息传递。只有在微信设置中配置了消息处理器端点后,才会显示此 API。
对于钉钉:
- 钉钉推送 - API 用于控制推送通知。
-
WeCom 消息处理器 API¶
将 WeCom 消息处理器 API 用于 Cloud Foundry 环境的独立 WeCom Java 应用程序开发和部署。WeCom 消息处理器 API 用于控制 WeCom 消息接收。只有在 WeCom 设置中配置了消息处理器端点后,才会显示该 API。
此 API 用于通过 WeCom 服务器接收来自 WeCom 最终用户的 XML WeCom 消息。在 WeCom 文档(仅限简体中文)中记录从 WeCom 服务器收到的 XML 有效负载。
WeCom 服务器的响应有效负载(将推送回 WeCom 最终用户)还应遵循与接收有效负载相同的 XML 格式。
WeCom 推送 API¶
将 WeCom 推送 API 用于 Cloud Foundry 环境的独立 WeCom Java 应用程序开发和部署。WeCom 推送 API 用于控制推送通知。
对于 WeCom 消息推送功能,我们将支持不同的消息类型。您可以对含有以下信息的 WeCom 推送 API 进行 POST 调用以将 WeCom 消息推送给最终用户。
-
Header X-API-Key:这是通过 WeCom 设置上的服务密钥标签生成的 API 密钥。
-
标头内容- 类型:
application/json。 -
请求正文:
JSON消息负载。
在以下部分提供 JSON 有效负载示例。
text
{
"notification": {
"wechat": {
"createtime": "2019-12-17T06:24:26.451Z",
"text": {
"content": "hello world!"
},
"msgtype": "text"
}
},
"users": ["P000001"]
}
textcard
{
"notification": {
"wechat": {
"createtime": "2019-12-17T06:24:58.808Z",
"textcard": {
"btntext": "MoreInfo",
"description": "Test for textcard msg type",
"title": "title_textcard",
"url": "http://www.abc.com"
},
"msgtype": "textcard"
}
},
"users": ["P000001"]
}
markdown
{
"notification": {
"wechat": {
"createtime": "2019-12-17T06:25:02.936Z",
"markdown": {
"content": "Meeting room already reserved. rn>**items**>Meeting<font color=" info ">meeting1</font> rn >john@abcdef rn>If required, please click [modify resource](https://abcde.com)"
},
"msgtype": "markdown"
}
},
"users": ["P000001"]
}
image
应对图像文件进行 base64 编码。
-
图像文件大小限制:2 MB
-
支持的格式:
.jpg、.png
{
"notification": {
"wechat": {
"image": {
"media_file_encoded": "data:image/jpeg;base64,XXXXXXXXXXXXXX",
"media_file_name": "testimage.jpg"
},
"createtime": "2019-12-17T06:25:09.509Z",
"msgtype": "image"
}
},
"users": ["P000001"]
}
voice
应对音频文件进行 base64 编码。
-
音频文件大小限制:2 MB
-
音频时间限制:60 秒
-
支持的格式:仅支持
.amr
{
"notification": {
"wechat": {
"voice": {
"media_file_encoded": "data:application/octet-stream;base64,XXXXXXXXXXXXX",
"media_file_name": "test.amr"
},
"createtime": "2019-12-17T06:52:14.515Z",
"msgtype": "voice"
}
},
"users": ["P000001"]
}
video
应对视频文件进行 base64 编码。
-
视频文件大小限制:10 MB
-
支持的格式:仅支持
.mp4
{
"notification": {
"wechat": {
"createtime": "2019-12-17T06:52:19.631Z",
"video": {
"media_file_encoded": "data:video/mp4;base64,XXXXXXXXXXXXXXXXX",
"media_file_name": "test.mp4",
"description": "video description",
"title": "Video Title"
},
"msgtype": "video"
}
},
"users": ["P000001"]
}
file
将常规文件推送给用户,应对文件进行 base64 编码。
-
文件大小限制:20 MB
-
无文件扩展名限制。
{
"notification": {
"wechat": {
"createtime": "2019-12-17T06:52:23.417Z",
"file": {
"media_file_encoded": "data:application/x-zip-compressed;base64,XXXXXXXXXX",
"media_file_name": "abc.zip"
},
"msgtype": "file"
}
},
"users": ["P000001"]
}
WeCom news
{
"notification": {
"wechat": {
"news": {
"articles": [{
"picurl": "https://abc/def/pic1.jpg",
"description": "description for news1",
"title": "News1",
"url": "http://www.wechatnews1.com"
}, {
"picurl": "https://abc/def/pic2.jpg",
"description": "description for news2",
"title": "News2",
"url": "http://www.wechatnews2.com"
}, {
"picurl": "https://abc/def/pic3.jpg",
"description": "description for news3",
"title": "News3",
"url": "http://www.wechatnews3.com"
}
]
},
"createtime": "2019-12-17T06:52:25.765Z",
"msgtype": "news"
}
},
"users": ["P000001"]
}
WeCom mpnews
应对缩略图文件进行 Base64 编码。
- 缩略图文件的限制应与图像消息限制相同。
{
"notification": {
"wechat": {
"createtime": "2019-12-17T06:52:28.337Z",
"mpnews": {
"articles": [{
"thumb_media_file_name": "pic1.jpg",
"thumb_media_file_encoded": "data:image/jpeg;base64,XXXXXXXXX",
"author": "user1",
"digest": "digest1",
"content_source_url": "http://www.wechatmpnews1.com",
"title": "Title1",
"content": "content1"
}, {
"thumb_media_file_name": "pic2.jpg",
"thumb_media_file_encoded": "data:image/jpeg;base64,XXXXXXXXX",
"author": "user2",
"digest": "digest2",
"content_source_url": "http://www.wechatmpnews2.com",
"title": "Title2",
"content": "content2"
}
]
},
"msgtype": "mpnews"
}
},
"users": ["P000001"]
}
管理应用程序主题¶
(仅限本机/MDK)作为管理员,您可以从 SAP 移动服务主控室 管理应用程序主题并为所选移动应用启用自定义主题。
主题更改移动客户端在用户设备上的外观。移动服务 服务器使用这些设置将主题应用到移动应用客户端。每个主题定义都包含主题的浅色和深色版本。移动客户端用户可以从设备设置活动主题。主题在空间级别进行管理。
主题是使用 SAP 主题设计器创建的,并以 ZIP 格式分配。上传后,您可以设置活动主题。如果您决定取消选择主题,SDK 应用程序不会从 移动服务 服务器获取主题。
请注意,对于单个应用程序主控室(软件即服务,SaaS),仅有一个定制主题可供用户使用。启用定制主题后,会自动为应用程序启用主题。您可以更新和删除主题。如果删除了主题,SDK 应用程序将使用初始默认主题,而不是从 移动服务 服务器获取主题。外观信息已清除,可以导入其他主题。
在相应的管理应用程序主题 指南中查找更多详细信息。