配置 Oracle Sales and Service Application Integration

在本部分中,您将添加与 OCM 通信所需的 Oracle Sales and Service 应用程序公用功能。这需要创建新的 Web 服务来与 OCM 文档 REST API、Oracle Sales 和 Service 应用程序全局功能进行通信,以调用这些新 Web 服务,并创建 Oracle Sales and Service 应用程序混合以公开 OCM 嵌入式 UI 集成。

创建沙盒

要创建沙盒以实施此集成的 Oracle Sales and Service 应用程序更改,请执行以下操作:

  1. 以 Oracle Sales and Service 管理员身份登录。
  2. 单击页面左上角的 汉堡图标。从菜单中选择配置选项,然后选择沙盒

  3. 在“创建沙盒”页面上,填写以下字段:

    1. 在“沙盒”页上,单击创建沙盒
    2. 在“创建沙盒”页上,在名称字段中为此沙盒指定名称(例如 OCM 记录管理集成)。
    3. 所有工具列表中,选中应用程序编辑器复选框。
    4. 单击创建和输入
  4. 要输入将在其中进行 OCM 集成更改的应用程序编辑器,请单击页面左上角的工具,然后从下拉列表中选择应用程序编辑器

创建 Web 服务

Web 服务用于通过 OCM 文档 REST API 与 OCM 进行通信。

OCMCreateRepositoryCollectionService

要创建 OCM 创建资料档案库集合 Web 服务,请执行以下操作:
  1. 从左侧导航菜单中选择公用设置,然后选择 Web 服务
  2. 在“Web 服务”页上,单击创建新 Web 服务图标。
  3. 在“选择连接类型”对话框中,选择 REST 选项,然后单击确定
  4. 在“创建 REST Web 服务连接”页面上,填写以下字段:

    1. 名称字段中,将文件夹的名称指定为 OCMCreateRepositoryCollectionService
    2. URL 字段中,输入创建 OCM 资料档案库集合所需的 Web 服务 URL https://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections。其中,<OCMServerURL> 是用于此集成的 Oracle Content Management 服务器(例如 https://mycloud.com/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections)。
    3. 在“验证方案”部分中,选择选项,因为它将在下一步中进行配置。
    4. 在“根据资源选择和配置方法”部分中,选中 POST 复选框。
    5. 在“请求有效负载”部分中,选择代码示例选项并将 {} 添加到多行文本框中。
    6. 在“响应有效负载”部分中,选择代码示例选项并将 {} 添加到多行文本框中。
  5. 要创建将用于 Web 服务的 IDCS OAUTH 验证方案,请在当前的“创建 REST Web 服务连接”页中填写以下字段:

    注:

    仅当您首次向 OCM 创建 Web 服务时,才需要执行这些步骤。


    1. 在“验证方案”部分中,选择使用 IDCS OAUTH 调用选项。
    2. 令牌 URI 字段中,输入 IDCS 服务器 URL https://<idcsServerURL>/oauth2/v1/token。其中,<idcsServerURL> 是用于此集成的 IDCS 服务器的 URL。
    3. 范围字段中,输入在创建 IDCS OAUTH 验证方案(例如 https://BD2F184D9D2344CB8134FCD4CBFF7DF.mycloud.com:443/urn:opc:cec:all)时复制的上述范围。
    4. 要创建客户机凭证密钥,请填写以下字段:
      1. 选择客户端身份证明密钥字段旁边的创建身份证明密钥图标。
      2. CSF Key 字段中,输入密钥(例如 Fusion Web Services )。
      3. 用户名字段中,输入在创建 IDCS OAUTH 验证方案(例如 c585b2d3e97c40e491ca99112281e36 )时以上复制的客户机 ID。
      4. Password 字段中,输入在创建 IDCS OAUTH 验证方案(例如 768b9513-658e-4854-bac7-2fe72d19011 )时以上复制的客户端密钥。
      5. 单击确定
    5. 要为交换机身份创建 OCM 凭证密钥,请填写以下字段:
      1. 选择身份证明密钥的身份证明密钥字段旁边的创建身份证明密钥图标。
      2. CSF 密钥字段中,输入密钥(例如 OCM 集成密钥)。
      3. 用户名字段中,输入用于与 OCM 进行通信的 OCM 集成用户(之前用于登录 OCM 以创建基本资产资料档案库的用户)(这必须是 OCM 中的企业用户)。
      4. 密码字段中,输入 OCM 集成用户密码。
      5. 单击确定
    6. 单击保存和关闭

OCMGetDocumentsByFolderIdService

要在新的“创建 REST Web 服务连接”页面中创建“按文件夹 ID 获取文档”Web 服务,请填写以下字段:

注:

仅当 Oracle Sales and Service 业务对象具有解析选项并且已配置了 OCM 文档集成时,才需要此 Web 服务。有关文档集成的更多信息,请参阅了解如何使用文档协作扩展 Oracle Sales and Service Business Objects


  1. 名称字段中,将名称指定为 OCMGetDocumentsByFolderIdService
  2. URL 字段中,将 URL 指定为 https://<OCMServerURL>/documents/api/1.2/folders/##folderId##/search/items?querytext=fItemType%3cMATCHES%3e%60File%60。其中,<OCMServerURL> 是用于此集成的 Oracle Content Management 服务器。
  3. 在“验证方案”部分中,选择使用 IDCS OAUTH 调用选项,并使用与上面为 IDCS OAUTH 参数使用的值相同。
  4. 在“根据资源选择和配置方法”部分中,选中 GET 复选框。
  5. 在“响应有效负载”部分中,选择代码示例选项并将 {} 添加到多行文本框中。

OCMBulkOperationsService

要在新的“创建 REST Web 服务连接”页中创建 OCM 批量操作 Web 服务,请填写以下字段:
后面是 bulkoperations.png 的说明
图 bulkoperations.png 的说明

  1. 名称字段中,将名称指定为 OCMBulkOperationsService
  2. URL 字段中,将 URL 指定为 https://<OCMServerURL>/content/management/api/v1.1/bulkItemsOperations。其中,<OCMServerURL> 是用于此集成的 Oracle Content Management 服务器。
  3. 在“验证方案”部分中,选择使用 IDCS OAUTH 调用选项,并使用与上面为 IDCS OAUTH 参数使用的值相同。
  4. 在“根据资源选择和配置方法”部分中,选中 POST 复选框。
  5. 在“请求有效负载”部分中,选择代码示例选项并将 {} 添加到多行文本框中。

OCMRepositoryCollectionPermissionsService

要在新的“创建 REST Web 服务连接”页中创建 OCM 资料档案库收集权限 Web 服务,请填写以下字段:
后面是 permissionservice.png 的说明
图 permissionservice.png 的说明

  1. 名称字段中,将名称指定为 OCMRepositoryCollectionPermissionsService
  2. URL 字段中,将 URL 指定为 https://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections/##OCMCollectionsId##/permissions。其中,<OCMServerURL> 是用于此集成的 Oracle Content Management 服务器。
  3. 在“验证方案”部分中,选择使用 IDCS OAUTH 调用选项,并使用与上面为 IDCS OAUTH 参数使用的值相同。
  4. 在“根据资源选择和配置方法”部分中,选中 GET 复选框。
  5. 在“响应有效负载”部分中,选择代码示例选项并将 {} 添加到多行文本框中。

OCMPermissionOperationsService

要在新的“创建 REST Web 服务连接”页中创建 OCM 权限操作 Web 服务,请填写以下字段:
后面是 operationservice.png 的说明
图的说明 operationservice.png

  1. 名称字段中,将名称指定为 OCMPermissionOperationsService
  2. URL 字段中,将 URL 指定为 https://<OCMServerURL>/content/management/api/v1.1/permissionOperations?links=none。其中,<OCMServerURL> 是用于此集成的 Oracle Content Management 服务器。
  3. 在“验证方案”部分中,选择使用 IDCS OAUTH 调用选项,并使用与上面为 IDCS OAUTH 参数使用的值相同。
  4. 在“根据资源选择和配置方法”部分中,选中 POST 复选框。
  5. 在“请求有效负载”部分中,选择代码示例选项并将 {} 添加到多行文本框中。
  6. 在“响应有效负载”部分中,选择代码示例选项并将 {} 添加到多行文本框中。

创建 Mashup

Mashup 是一个进入独立外部应用程序的窗口,例如 OCM。

要创建混搭以嵌入 OCM 嵌入式 UI,使其可以在 Oracle Sales and Service 业务对象中公开:

  1. 从左侧导航菜单中选择公用设置合并内容
  2. 在“混合内容:Web 应用程序”页上,单击注册 Web 应用程序按钮。
  3. 在“注册 Web 应用程序”页面上,填写以下字段:

    1. 名称字段中,将应用程序的名称指定为 OCMEmbeddedAssetsUIMashup
    2. 对于类型字段,选择 Groovy 表达式选项。
    3. URL 定义字段中,输入 OCM 嵌入式 UI URL 作为 https://<OCMServerURL>/documents/embed/v2/assets。其中,<OCMServerURL> 是用于集成的 Oracle Content Management 服务器。
    4. 单击保存和关闭