在 Oracle Integration Cloud 中使用流程在 Oracle Content and Experience Cloud 中建立資料夾或文件

使用文件開始事件來建立可由文件起始的程序模型。使用資料夾開始事件來建立資料夾可起始的程序模型。

您必須先有一個 Oracle Content Management 帳戶，且必須設定該服務與 Oracle Integration 之間的連線，才能建立這些處理作業。

啟用 Oracle Content Management 整合後，您可以為每個處理執行處理定義在 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 Management 上的資料夾，以在文件到達時起始處理作業。

或者，您也可以使用 REST API 提供所有輸入值。

定義傳入的文件或資料夾

您可以使用 Oracle Integration (處理產生器) 中的文件頁面來定義內送的文件或資料夾。

開啟您正在建立的處理應用程式，然後按一下文件。「文件」頁面會列出已經定義的內送文件和內送資料夾。

若要建立新的內送文件或資料夾，請按一下新建，選取適當的類型，輸入名稱，然後選取預設存取權限。

可從文件或資料夾開始事件啟動的模型處理

您可以在 Oracle Integration 中，從文件開始或資料夾開始事件開始建立程序模型。

開始之前，請先從「元素」選用區新增文件開始或資料夾開始事件。僅支援您新增至處理的第一個開始事件。

在「應用程式首頁」頁籤上，按一下程序。
按一下新建程序以開啟「建立程序」對話方塊。
選取無
輸入程序的名稱，確定已選取立即開啟核取方塊，然後按一下建立。
在元素選盤中，按一下事件。
將文件開始事件或資料夾開始事件拖曳至畫面中。
將順序流程從新文件或資料夾開始事件新增至結束事件。
刪除空的開始事件。
繼續修改與定義處理。請務必測試和部署。

啟用使用者角色以啟動文件或資料夾啟動的處理

您可以啟用特定使用者角色，在 Oracle Integration 中啟動文件或資料夾啟動的處理。

若要啟用使用者角色上傳文件以開始處理：

開啟處理。
在含有文件或資料夾啟動事件的泳道中，按一下角色名稱，然後按一下編輯。
在角色欄位中，選取自動處理程式。

自訂已起始文件或資料夾啟動的處理

在 Oracle Integration 中建立程序模型後，可以在程序中新增開始文件或資料夾並加以自訂。

自訂文件起始或資料夾起始的程序：

在程序圖中，按一下文件開始或資料夾開始事件。
按一下功能表，然後選取開啟特性。
定義處理傳入文件或資料夾的方式。
- 就地：選取此值會保持文件的位置。如有需要，您可以將傳入的文件或資料夾對應至其管理的其中一個預先定義的文件或資料夾。(若要這麼做，請開啟下拉式清單。)
  
  如果沒有適用於此特定處理作業的預先定義內送文件或資料夾，請按一下新建來建立。
- 未管理：目前的處理作業會忽略文件或資料夾。Oracle Integration Cloud 不會在程式實際執行時顯示未管理的文件或資料夾。處理模型建立者能夠處理傳入的文件或資料夾。例如，如果您要將內送資料夾或文件移至其他位置，可以使用 XPath 表示式取得特性 (例如 Id 或 Type)，然後將特性資訊傳送至 REST 服務。

設定資料夾

若要將文件上傳至資料夾時自動啟動處理，您必須在 Oracle Content Management 上設定資料夾。

若要設定資料夾以起始文件到達時的處理作業：

登入 Oracle Content Management。
選取資料夾。
從功能表選取特性。
啟用文件到達時起始處理作業設定。
從清單中選取一個處理作業。
按一下儲存。

您現在就可以在 Oracle Integration 介面中使用資料夾與其子資料夾。對資料夾中的檔案或任何上傳至資料夾的新檔案所做的任何變更都會觸發與資料夾相關聯的程序。您可以覆寫子資料夾的已繼承處理作業，但無法停用處理作業的關聯。

從 Oracle Content Management 上傳檔案至設定為搭配 Oracle Integration 使用的資料夾時，檔案會用於與該資料夾關聯的作業。Oracle Integration 中的使用者可以在該處對檔案採取任何動作，例如核准。工作步驟完成後，檔案就會根據已定義的處理作業而移動或管理。

當 Oracle Content Management 啟動處理作業時，傳送給啟動處理作業的有效負載會包含下列資訊：

文件 ID
文件名稱
啟動處理的使用者 ID
類型
角色 (表示用來產生後續應用程式連結的角色)
版本

下列範例只使用文件 ID 和文件名稱，在 Oracle Integration 的表單中顯示。此外，它會在 REST API 呼叫將 Oracle Content Management 中的檔案移至工作資料夾時使用文件 ID。

{
   "processDefId":"testing~UserFileApproval!1.0~FormApprovalProcess",
   "operation": "startEvent",
   "params": {
        "id": "D2806600E495B744E66BF3981212FF6185DE89BE6812",
        "type": "d",
        "name": "document-name",
        "startedBy": "user-id",
        "role": "role that should be used to generate subsequent applinks",
        "version": "version"
   }
}

身為開發人員，您必須注意下列您發展的處理程序需求：

處理必須使用 Oracle Content Management 啟動事件。
部署處理時，您必須與指定要啟用整合的使用者共用該處理。否則，使用者將沒有觸發處理程序的權限。
對於上傳檔案，以開始工作的使用者身分顯示，處理程序必須使用開頭為欄位中傳遞的值作為啟動器的顯示名稱。
如果您啟用資料夾的程序整合，則必須將此資料夾與用來啟用 Oracle Integration 整合的 Oracle Content Management 使用者帳戶共用。