将 ThingWorx Navigate 连接到 SAP
您的用户可以使用 ThingWorx Navigate 中的以下任务来访问 SAP Netweaver Gateway 的数据：
• “查看部件列表”
• “查看部件特性”
• “查看部件结构”
连接到服务器以获取部件和/或 CAD 文档的信息。在为安装 ThingWorx Navigate View PLM App Extension 而导入的 PLM 文件包中，还有一个扩展包 SAPProviders_ExtensionPackage。它包括您需要的所有组件。该设置需要执行 ThingWorx Composer 中的一些连接步骤：
1. 定义与 SAP 的连接
首先，我们将设置 SAP 服务器与 ThingWorx Navigate 之间的连接器。
1. 搜索此连接器：ptc-SAP-OData-connector。
2. 在左侧的“实体信息”下，单击“配置”。Configuration for SAPODataConnector 在右侧打开。
3. 在“通用连接器连接设置”下的“身份验证类型”旁，选择 SSO。
4. “授权服务器 ID”- sso-settings.json 中定义的 SAP ID。
6. 在 OData Connector Connection Settings 下，单击“添加”，然后为 SAP 添加 tw.friendly-names.ServiceRootRelativeURL。
7. 在页面底部的 HTTP Connector Connection Settings 下，为系统提供以下 URL：
◦ “用户名”和“密码”- 将这些框留空
◦ “基本 URL”- SAP 服务器的路径
◦ “相对 URL”- 保留 URL 字段为空。
◦ “连接 URL”- 提供 REST Web 服务的位置
8. 单击“保存”。
2. 检查您的连接，然后编辑服务
在接下来的几个步骤中，我们将使用“新 Composer”。在这里，我们将定义您的用户从搜索获得的信息类型。
1. 单击“管理员”旁边的箭头，从列表中选择“首选项”。“首选项”随即打开。
2. 请确保选中“开启 New Composer 功能”旁边的复选框，然后单击“完成”。
3. 单击“新 Composer”，然后在新的 composer 中打开 ptc-SAP-OData-connector。
4. 从顶部的列表中选择“服务”。
|
|
在编辑您的服务之前，建议您检查“基本 URL”和“连接 URL”：
a. 查找 ValidateConnection 服务。
b. 单击播放按钮，然后单击“执行”。结果随即显示在右侧的“输出”下。
|
5. 选择服务 GetProductSet，然后对其进行编辑。
6. 在 > 下，选择您的组织端点。这样可确保您的用户获得在 SAP 中搜索条件的正确信息，例如物料或产品。
7. 单击“完成”，然后单击“保存”。
8. 要验证是否正确配置了 GetProductSet 服务并提供了正确的信息，请执行该服务。
3. 编辑数据形状
现在，我们将编辑关联的数据形状。您可以使用此数据形状来定义要显示在 ThingWorx Navigate 定制页面上的 SAP 属性。
1. 返回到旧款 Composer，搜索 SAP_DATA_SHAPE。
2. 在左侧，单击“字段定义”。编辑此列表以包括您的组织所需的所有属性，如 SAPQuantity、SAPCurrency 和 SAPMaterialCost。
|
|
定义字段名称列表后，还可以为每个字段定义本地化标记。
|
3. 单击“保存”。
4. 映射资源提供工具中的属性
现在，您已定义要在 ThingWorx Navigate 中显示的字段，我们将确保将它们映射到 SAP 的相应属性。
1. 搜索 SAPPartResourceProvider，然后将其打开。
2. 单击“添加”以添加在数据形状中定义的每个字段。在我们的示例中，这些字段为 SAPQuantity、SAPCurrency 和 SAPMaterialCost。字段名称显示在“规范化”列中。
3. 在“原始”下，将每个字段映射到其在 SAP 中对应的属性名称。例如，SAPMaterialCost 可能对应于 SAP 中的 MovingPr。
4. 除了您定义的字段之外，请将这两个必填字段添加到“规范化”列表中：
◦ Id
◦ “编号”
5. 将 Id 和 Number 字段映射到您的用户将要查询的 SAP 属性。例如，Material 或 ProductID。
6. 在 Resource Provider Configuration 表中，添加连接器 ptc-SAP-OData-connector。
7. 单击“保存”。
5. 将标记添加到 SAP 字段
至此，您基本上完成了设置。现在，我们使用下列资源提供工具将 SAP 标记添加到字段中：
• CompositePartResourceProvider - 支持部件信息
• CompositeEPMDocumentResourceProvider - 支持 CAD 文档信息
标记有助于区分哪些属性来自 SAP。不带此前缀的字段搜索 Windchill 中的数据。
1. 搜索 CompositePartResourceProvider，然后将其打开。
2. 在右侧，单击“配置”。
3. 添加先前步骤中定义和映射的所有字段。在我们的示例中，这些字段是 SAPQuantity、SAPCurrency 和 SAPMaterialCost，以及其他两个必填字段，Id 和 Number。添加它们时，字段名称将显示在“规范化”列中。
4. 在“原始”列中，将此标记 (包括连字符) 添加为每个字段名称的前缀：SAPPartResourceProviderTag-。因此，例如“规范化”列中的 SAPMaterialCost 应为“原始”列中的 SAPPartResourceProviderTag-SAPMaterialCost。
5. 在 Expand Terms 表中，添加标记名称 SAPPartResourceProviderTag。
6. 单击“保存”。
7. 针对 CompositeEPMDocumentResourceProvider 重复步骤 1 到 5。
与 SAP 服务器的连接已完成。在定制页面上，业务管理员可以选择向最终用户显示的 SAP 属性。
