Skip to main content

知识库

Back to support overview

安装

上次修改时间: 2025年2月10日

客户要求

该扩展需要使用 Mobile Services 进行通信的 SAP Asset Manager （SAM） 的有效安装。将通过添加两个允许与扩展后端通信的新目标来修改 Mobile Services 实例。

要使用自动报告上传，需要一个有效的 DMS 设置，该设置通过 集成选项 API （CMIS API） 公开存储库。用于身份验证和 浏览器绑定访问 的客户端凭证和 DMS 端点需要传达给 TeamViewer 以配置扩展后端。

Mobile Services 修改

修改用于 Asset Manager 的 Mobile Services 实例，以便向扩展的 Asset Manager 提供信息和服务。此修改不会更改 Asset Manager作，而只会在现有服务的基础上添加功能。

注意： 您将需要 TeamViewer 提供的有关 Frontline 实例的信息来执行此步骤。

移动连接

在您的 Mobile Services 实例中，打开 Mobile Connectivity 设置。

Isam 1

移动目的地

您创建了两个新的 Mobile Destinations。创建的顺序无关紧要。

I 2

目的地 DEST_AM_URL

目标DEST_AM_URL将返回有关扩展的 Frontline 实例的信息。

在 URL 字段中使用 /connector/am/settings 输入实例的 URL。

I 3

在 Custom Headers （自定义标头） 部分中，添加以下标头：

  • 接受 值 application/json;字符集=UTF8

，然后选择 Override Client （覆盖客户端）。

这是从后端创建正确响应所必需的。

I 4

将其余字段保留为 default。没有身份验证/SSO 机制。 

注意： 此终端节点不返回敏感数据。

完成终端节点的创建。

您可以通过在浏览器中打开终端节点来测试终端节点。

I 5

这将返回一个小型 JSON 结构，其中包含有关 Frontline 实例的信息，例如

  • {“amUrl”：“https://fccam.c-48c3187.kyma.shoot.live.k8s-hana.ondemand.com/connector/amapp.html”}

如果您看到此类响应，则表示目标设置正确。

目的地 DEST_CALL_TOKEN

DEST_CALL_TOKEN 目标用于从 Frontline 后端请求可用于建立视频通话的签名令牌。

在 URL 字段中输入 Frontline 实例的 URL，并在 URL 字段中使用 /connector/am/getCallToken 。

I 6

在 Custom Headers （自定义标头） 部分中，添加以下标头：

  • 接受 值 application/json;字符集=UTF8

，然后选择 Override Client （覆盖客户端）。

这是从后端创建正确响应所必需的。

I 7

在 目标配置 部分，选择 基本身份验证 作为 SSO 机制，并提供 TeamViewer 提供的凭据。

I 8

通过在浏览器中打开终端节点来完成终端节点的创建：

I 9

您首先会收到如下错误：

{"timestamp":"2022-07-14T15:48:20.255+00.00","status"400,error":"BadRequest","path":"/connector/am/getCallToken"}

您可以将 '&subject=tester' 添加到生成的 URL 中并再次加载页面，例如

https://<your-mobile-service-host>/DEST_CALL_TOKEN?auth=uaa&subject=tester

这将产生如下 JSON 结构：

{"token":"eyJhbGciOiJIUZUxMiJ9.eyJpc3MiOiJGcm9udGxpbmUtQUOiLCJzdW liOiJOZXNoZXIiLCJpYXQiOjE2NTc4MTM3MzUslmV4cCI6MTY1NzgxNDYzNXO.a5ePJ_zHffOAj69h2Q8znYHgog_slzzQKrrJ96/CXCXGCK6RIKKZjJ8-HecFGIOW8IBmjWXNTLq_YhLv040KGw","issuedAt":1657813735623,"expiresAt":1657814635623}

注意： 这些令牌仅在短时间内有效，当需要调用功能时，分机会请求这些令牌。

如果您看到此类响应，则表示目标设置正确。

{"token":"eyJhbGciOiJIUZUxMiJ9.eyJpc3MiOiJGcm9udGxpbmUtQUOiLCJzdW liOiJOZXNoZXIiLCJpYXQiOjE2NTc4MTM3MzUslmV4cCI6MTY1NzgxNDYzNXO.a5ePJ_zHffOAj69h2Q8znYHgog_slzzQKrrJ96/CXCXGCK6RIKKZjJ8-HecFGIOW8IBmjWXNTLq_YhLv040KGw","issuedAt":1657813735623,"expiresAt":1657814635623}

Asset Manager 捆绑包导入

如果已获得 Asset Manager 集成的现成元数据包，则可以将其直接部署到 Mobile Services 实例。

在您的 Mobile Services 实例中，打开 Mobile App Update 设置。

I 10

选择 Upload 选项。

I 11

按照说明上传您的捆绑包文件。

上传完成后， 部署 新的应用程序版本。

I 12

您的 Asset Manager 应用程序将自动获取更新，并请求用户应用它。

Asset Manager 元数据扩展

如果您未使用提供的元数据包，还可以使用 Business Application Studio 修改现有的 Asset Manager。该扩展作为与组件集成元数据 （CIM） 集成的 MDK 项目提供。CIM 文件与项目一起提供以供参考。

扩展资源在 FrontlineExtension.zip 存档中提供。

导入项目

从提供的存档中，将 FrontlineExtension 项目导入到您的工作区中。i18n 文件夹中的文件包含扩展使用的邮件的翻译。

注： 这些文件将覆盖 Asset Manager 项目中的翻译消息。如果您对翻译进行了任何修改，则需要手动合并翻译。

de 的合并属性示例：

I 14

设置 CIM

将提供的 FrontlineExtension.cim 文件放在 Asset Manager 项目中。这将为自定义客户端设置所需的集成点。

您应该查看 CIM 设置，以确保集成点不会影响其他自定义设置。

I 15

部署

完成这些修改后，您可以将修改后的元数据部署到 Mobile Services 实例。

您的 Asset Manager 应用程序将自动获取更新并请求用户应用它。

DMS 访问

DMS 访问允许扩展后端将 PDF 报告上传到客户存储。这是可选的，如果需要，可以在初始设置后进行设置。

遵循有关如何为您的设置启用 DMS 集成选项 API 的 SAP 准则，例如，请参阅 SAP 帮助门户中使用 API 连接到 Document Management Service、存储库选项。

一线后端需要能够请求 JSON Web 令牌以访问 DMS;您将在创建的 Service Key 中找到所需的设置和凭证：

I 16

您需要通过安全通道向 TeamViewer 联系人提供有关端点和身份验证的信息：

从 endpoints 部分的 ecmservice / url 值。

在 uaa 部分中，clientid、clientsecret 和 url（身份验证 URL）值。

除了访问凭证之外，我们还需要知道要使用哪个存储库。如果使用 DMS 应用程序选项，您可以在存储库概述中找到名称，例如：

I 17