1. 使用受管理的附件擴充 Oracle Sales 和 Service 業務物件
  2. 設定 Oracle Sales and Service Application 整合

設定 Oracle Sales and Service Application 整合

在此區段中，您將新增與 OCM 通訊所需的 Oracle Sales and Service 應用程式通用功能。這需要建立新的 Web 服務才能與 OCM 文件 REST API、Oracle Sales 和 Service 應用程式全域功能通訊，以呼叫這些新的 Web 服務，以及 Oracle Sales and Service 應用程式混搭以顯示 OCM 內嵌 UI 整合。

建立封閉測試環境

若要建立封閉測試環境，以導入此整合的 Oracle Sales and Service Application 變更：

  1. 以 Oracle Sales and Service 管理員身分登入。
  2. 按一下頁面左上角的 漢堡圖示。從功能表中選取組態選項，然後選取封閉測試環境。
    configuration.png 的描述如下
    說明 configuration.png

  3. 在「建立封閉測試環境 (Create Sandbox)」頁面上，完成下列欄位：
    createsandbox.png 的描述如下
    說明 createsandbox.png

    1. 在「封閉測試環境 (Sandboxes)」頁面上，按一下建立封閉測試環境 (Create Sandbox) 。
    2. 在「建立封閉測試環境」頁面的名稱欄位中，指定此封閉測試環境的名稱 (例如 OCM Records Management Integration)。
    3. 從所有工具清單中，選取應用程式編寫器核取方塊。
    4. 按一下建立並輸入。
  4. 若要輸入將進行 OCM 整合變更的應用程式編寫器，請按一下頁面左上角的工具，然後從下拉式清單中選取應用程式編寫器。
    sandboxes.png 的描述如下
    說明 sandboxes.png

建立 Web 服務

Web 服務可用來透過 OCM 文件 REST API 與 OCM 通訊。

OCMCreateRepositoryCollectionService

若要建立「OCM 建立儲存區域集合」Web 服務：
  1. 從左側導覽功能表中依序選擇通用設定和 Web 服務。
  2. 在「Web 服務」頁面上，按一下建立新 Web 服務圖示。
  3. 在「選取連線類型」對話方塊中，選取 REST 選項，然後按一下確定。
  4. 在「建立 REST 網路服務連線」頁面上，完成下列欄位：
    collectionservice.png 的描述如下
    說明 collectionservice.png

    1. 在名稱 (Name) 欄位中，將資料夾名稱指定為 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. 在「認證配置 (Authentication Scheme)」區段中，選取無 (None) 選項，因為它將在下一步中配置。
    4. 在「根據資源選取和設定方法」區段中，選取 POST 核取方塊。
    5. 在「要求有效負載 (Request Payload)」區段中，選取程式碼範例選項，然後將 {} 新增至多行文字方塊。
    6. 在「回應有效負載 (Response Payload)」區段中，選取程式碼範例 (Code Sample) 選項，然後將 {} 新增至多行文字方塊。
  5. 若要建立將用於 Web 服務的 IDCS OAUTH 認證配置，請在目前的「建立 REST Web 服務連線」頁面中，完成下列欄位：

    注意：

    只有在您第一次建立 OCM 的 Web 服務時，才需要執行這些步驟。

    idcsoauth.png 的描述如下
    說明 idcsoauth.png

    1. 在「認證配置 (Authentication Scheme)」區段中，選取 Call using 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 金鑰欄位中，輸入金鑰 (例如 Fusion Web Services)。
      3. 在使用者名稱欄位中，輸入建立 IDCS OAUTH 認證配置時，上面複製的從屬端 ID (例如 c585b2d3e97c40e491ca99112281e36)。
      4. 在密碼欄位中，輸入建立 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 的 OCM 取得文件」Web 服務，請完成下列欄位：

注意：

只有在 Oracle Sales and Service 業務物件具有解決選項且已設定 OCM 文件整合時，才需要此 Web 服務。請參閱 Learn About How to Extend Oracle Sales and Service Business Objects with Document Collaboration，瞭解 Document Integration 的詳細資訊。

folderidservice.png 的描述如下
說明 folderidservice.png

  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. 在「認證配置 (Authentication Scheme)」區段中，選取使用 IDCS OAUTH 進行呼叫 選項，然後針對 IDCS OAUTH 參數使用和上述值。
  4. 在「依據資源選取和設定方法」區段中，選取 GET 核取方塊。
  5. 在「回應有效負載 (Response Payload)」區段中，選取程式碼範例 (Code Sample) 選項，然後將 {} 新增至多行文字方塊。

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. 在「認證配置 (Authentication Scheme)」區段中，選取使用 IDCS OAUTH 進行呼叫 選項，然後針對 IDCS OAUTH 參數使用和上述值。
  4. 在「根據資源選取和設定方法」區段中，選取 POST 核取方塊。
  5. 在「要求有效負載 (Request Payload)」區段中，選取程式碼範例選項，然後將 {} 新增至多行文字方塊。

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. 在「認證配置 (Authentication Scheme)」區段中，選取使用 IDCS OAUTH 進行呼叫 選項，然後針對 IDCS OAUTH 參數使用和上述值。
  4. 在「依據資源選取和設定方法」區段中，選取 GET 核取方塊。
  5. 在「回應有效負載 (Response Payload)」區段中，選取程式碼範例 (Code Sample) 選項，然後將 {} 新增至多行文字方塊。

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. 在「認證配置 (Authentication Scheme)」區段中，選取使用 IDCS OAUTH 進行呼叫 選項，然後針對 IDCS OAUTH 參數使用和上述值。
  4. 在「根據資源選取和設定方法」區段中，選取 POST 核取方塊。
  5. 在「要求有效負載 (Request Payload)」區段中，選取程式碼範例選項，然後將 {} 新增至多行文字方塊。
  6. 在「回應有效負載 (Response Payload)」區段中，選取程式碼範例 (Code Sample) 選項，然後將 {} 新增至多行文字方塊。

建立 Mashup

Mashup 是獨立外部應用程式 (例如 OCM) 中的視窗。

若要建立混搭以內嵌 OCM 內嵌 UI，使其可公開在 Oracle Sales and Service 業務物件中：

  1. 從左側導覽功能表中選擇通用設定與混搭內容。
  2. 在「混搭內容：Web 應用程式」頁面上，按一下註冊 Web 應用程式按鈕。
  3. 在「註冊 Web 應用程式」頁面上，完成下列欄位：
    mashup.png 的描述如下
    說明 mashup.png

    1. 在名稱欄位中，將應用程式的名稱指定為 OCMEmbeddedAssetsUIMashup 。
    2. 在類型欄位中，選取 Groovy 表示式選項。
    3. 在 URL 定義欄位中，將 OCM 內嵌 UI URL 輸入為 https://<OCMServerURL>/documents/embed/v2/assets。其中 <OCMServerURL> 是用於整合的 Oracle Content Management 伺服器。
    4. 按一下儲存並關閉。