設定 Oracle IntegrationOracle Content Management 之間的處理整合

管理員必須先在 Oracle Content ManagementOracle Integration 中設定設定,您或任何使用者可以存取文件與對話功能。

只有具備管理員權限的使用者才能建立兩個服務之間的連線。

對於Oracle Content Management 連線之前建立的「處理」應用程式,預設會停用文件與對話功能。開發人員可以在現有應用程式中手動啟用這些功能。

成功整合的存取需求

請注意下列成功整合的存取需求:

  • Oracle Integration 中設定的 Oracle Content Management 使用者必須具有 Oracle Content Management 中設定的資料夾 (亦即內送文件的資料夾) 的完整存取權,才能開始處理。

  • 對於已起始資料夾的處理 (亦即含有資料夾開始事件的程序),在 Oracle Integration 中設定之 Oracle Content Management 使用者的管理員必須能夠存取資料夾,才能在 Oracle Integration 中存取其資料夾。例如,需要經理人員存取權,才能在「任務詳細資料」頁面與「處理追蹤」頁面上查看資料夾、在外部應用程式中內嵌「處理 UI」元件時存取資料夾,或在「處理行動」應用程式中查看資料夾。

  • 若要在資料夾的處理程序清單中查看處理程序,並可在新文件到達時起始處理程序實例,則必須在 Oracle Content Management 中設定的 Oracle Integration 使用者必須被授予處理起始者角色。

在處理應用程式中使用文件或附件

Oracle Integration 會自動在處理應用程式中包含標準檔案附件功能。您可以上傳檔案,並將其附加至處理程序。當您使用 Oracle Content ManagementOracle Integration 時,也會取得文件功能,可讓您上傳檔案、將檔案上傳到資料夾、管理每個資料夾的存取權,甚至可以上傳文件來啟動程序。此外,每個處理程序應用程式皆可選擇使用文件或附件。

您可以控制處理程序是否在應用程式階層使用文件或附件。文件預設為啟用。設定位於應用程式的「資訊」窗格中。


enable-docs-app-level-cb.png 的描述如下
enable-docs-app-level-cb.png 圖解的描述

啟用文件整合的應用程式可以使用文件 (而且只有文件)。停用文件整合的應用程式只能使用附件。基本上,藉由停用應用程式的文件,即可為該應用程式啟用附件。

請記住,設定會套用至應用程式。您可以在應用程式中使用文件或附件,但不能同時使用兩者。

對於附件,請確定已在「UI 自訂」畫面中取消選取隱藏附件選項。如果選取隱藏附件選項,您將無法查看任務明細與開始表單中的附件。

如果您使用 REST API 與 Oracle Integration 互動,請根據處理應用程式是否使用文件或附件,請務必使用適當的 API:

  • 對於文件,請務必使用 / folder REST API。

  • 針對附件,請務必使用 /attachments REST API。

如果您使用錯誤的 API,應用程式就會傳回錯誤訊息或者結尾是不作業。

請注意,如果您無法查看任務明細中的附件,則請檢查「UI 自訂」畫面中的選項。確定已取消選取隱藏附件核取方塊,以查看附件。

Oracle Content Management 中設定 Oracle Integration 設定值

Oracle Content Management 中的文件啟用 Oracle Integration

  1. 以管理員身分登入 Oracle Content Management
  2. 管理功能表中,選擇整合
  3. 應用程式底下,選取 Oracle Integration 以啟用服務,然後設定以下的值:
    • 服務 URL:使用者可以存取其應用程式的 REST 服務 URL,結尾為 bpm/api/4.0/processes (例如,https://servicename/bpm/api/4.0/processes)。
    • 服務使用者:Oracle Content Management 中,輸入擁有處理作業的使用者電子郵件地址。
    • 服務密碼:輸入使用者密碼。

工作步驟完成後,檔案就會根據定義的處理作業來管理。對於傳入的文件,使用者可根據該文件的指派角色執行動作:提供者、下載者或檢視器。

Oracle Content Management 啟動處理時,會傳送下列有效負載以啟動處理:

{

        "operation":"startEvent",

        "processDefId":"testing~LoanApplicationProcessing!1.0~LoanApplicationProcessing"

        "params": {

               "id": "abc123",

               "name": "document name",

               "startedBy": "user id",

               "type": "d",

               "role": "role that should be used to generate subsequent applinks",

                "version": "version"

         }

}

身為開發人員,您需要知道下列發展程序的要求:

  • 它必須是使用 Oracle Content Management Document Start 事件的程序。
  • 部署處理時,您需要與指定要啟用整合的使用者共用,以便使用者擁有觸發程序的權限,
  • 對於上傳檔案,以開始工作的使用者身分顯示,處理程序必須使用開頭為欄位中傳遞的值作為啟動器的顯示名稱。

Oracle Integration 中設定文件設定值

身為管理員,您也必須設定 Oracle IntegrationOracle Content Management 之間的連線。您必須輸入 Oracle Content Management 的 URL 和登入證明資料等資訊。

設定 Oracle Integration 中的設定值:
  1. Oracle Integration 導覽窗格中,按一下我的工作、按一下工作區,然後按一下管理
  2. 按一下服務
  3. Oracle Content Management 區段中,輸入下列資訊:
    • URL:您 Oracle Content Management 的網址。服務就緒可供使用時,您的服務管理員會收到歡迎使用 Oracle Cloud 電子郵件。電子郵件具有您 Oracle Content Management 的 URL。例如,https://your_service_name.com/ddocument。
    • 識別網域:您 Oracle Content Management 所屬識別網域的名稱。您可以順利設定 Oracle Content Management 連線 (針對文件功能),但不提供識別網域。
    • 使用者密碼:具有 Oracle Content Management 存取權之使用者的帳戶憑證。此使用者帳號用於測試服務之間的連線。它也是在程式實際執行時用來連線服務並執行所有程式實際執行作業 (例如建立資料夾)。

    重要事項:

    如果您想要使用對話進行合作,則您在此處指定的使用者必須被指派下列角色:

    service_instance_name.CECIntegrationUser

    您可以使用 Oracle Cloud My Services 應用程式將角色指派給您的使用者。

  4. 按一下測試

    每當您對組態設定值進行任何變更時,最好驗證您所輸入的值是否正確。您想要確認已順利建立 Oracle Content Management 連線。

    複查測試結果,其中可能包含訊息、錯誤和警告。

  5. 請選取下列其中一個選項以繼續:
    • 如果有任何錯誤或警告,請進行必要的變更,然後再按一下測試以驗證新值。每次變更設定時重複測試。
    • 如果連線測試成功,請按一下儲存以儲存組態設定值。
    • 如果您想要取消並返回上一個儲存的值,請按一下回復