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 (Process Builder)の「ドキュメント」ページを使用して、受信ドキュメントまたはフォルダを定義できます。

モデリングするプロセス・アプリケーションを開き、「ドキュメント」をクリックします。「Documents」ページに、すでに定義されている入力ドキュメントおよび入力フォルダがリストされます。

新しい入力ドキュメントまたはフォルダを作成するには、「New」をクリックし、適切なタイプを選択し、名前を入力し、デフォルトのアクセス権限を選択します。

ドキュメントまたはフォルダ開始イベントから開始できるモデル・プロセス

Oracle Integrationで、ドキュメント開始イベントまたはフォルダ開始イベントから開始できるプロセスをモデル化できます。

開始する前に、要素パレットからドキュメント開始イベントやフォルダ開始イベントを追加します。最初にプロセスに追加した開始イベントのみサポートされます。

「Application Home」タブで、「Processes」をクリックします。
「New process」をクリックして、「Create Process」ダイアログ・ボックスを開きます。
「なし」を選択します
プロセスの名前を入力します。「Open Immediately」チェック・ボックスが選択されていることを確認し、「Create」をクリックします。
要素パレットで、「Events」をクリックします。
ドキュメント開始イベントまたはフォルダ開始イベントのいずれかをキャンバスにドラッグします。
新しいドキュメント開始イベントまたはフォルダ開始イベントから終了イベントまでのシーケンス・フローを追加します。
空の開始イベントを削除します。
プロセスの変更と定義を続行します。必ずテストおよびデプロイしてください。

ユーザー・ロールによる文書またはフォルダ開始プロセスの開始の有効化

特定のユーザー・ロールを有効にして、Oracle Integrationでドキュメントまたはフォルダ開始プロセスを開始できます。

ユーザー・ロールがドキュメントをアップロードしてプロセスを開始できるようにするには:

プロセスを開きます。
ドキュメントまたはフォルダ開始イベントを含むスイムレーンで、ロール名をクリックし、「編集」をクリックします。
「ロール」フィールドで、「自動ハンドラ」を選択します。

ドキュメント開始またはフォルダ開始プロセスのカスタマイズ

Oracle Integrationでプロセスをモデル化した後で、開始ドキュメントまたはフォルダをプロセスに追加し、プロセスをカスタマイズできます。

ドキュメント開始またはフォルダ開始のプロセスをカスタマイズするには:

プロセス図で、「ドキュメント開始」イベントまたは「フォルダ開始」イベントをクリックします。
「Menu」をクリックし、「Open Properties」を選択します。
入力ドキュメントまたはフォルダを処理する方法を定義します。
- In Place:この値を選択すると、ドキュメントがそのまま維持されます。必要に応じて、受信するドキュメントまたはフォルダを、管理のために、事前定義済ドキュメントまたはフォルダのいずれかにマップできます。(これを行うには、ドロップダウン・リストを開きます。)
  
  事前定義された入力ドキュメントまたはフォルダがこのプロセスに適していない場合は、「新規」をクリックして作成します。
- Unmanaged:ドキュメントまたはフォルダは現在のプロセスでは無視されます。Oracle Integration Cloudでは、実行時に管理対象外のドキュメントまたはフォルダが表示されません。入力ドキュメントまたは受信フォルダの処理はプロセス・モデラーに任されます。たとえば、入力フォルダまたはドキュメントを別の場所に移動する場合は、XPath式を使用してIdやTypeなどのプロパティを取得し、そのプロパティ情報をRESTサービスに渡すことができます。

フォルダの構成

ドキュメントがフォルダにアップロードされたときに自動的に開始するプロセスを設定するには、Oracle Content Managementでフォルダを構成する必要があります。

ドキュメントが到着したときにプロセスを開始するようにフォルダを構成するには:

Oracle Content Managementにサインインします。
フォルダを選択します。
メニューバーから「Properties」を選択します。
「Initiate process on document receiveval」設定を有効にします。
リストからプロセスを選択します。
「保存」をクリックします。

これで、フォルダとそのサブフォルダがOracle Integrationインタフェース内で使用できるようになります。フォルダ内のファイルを変更するか、フォルダに新しいファイルをアップロードすると、そのフォルダに関連付けられたプロセスがトリガーされます。サブフォルダの継承されたプロセスをオーバーライドできますが、プロセスとの関係を無効にすることはできません。

ファイルがOracle Integrationで使用するために構成されたフォルダにOracle Content Managementからアップロードされると、ファイルはそのフォルダに関連付けられているタスクに使用されます。Oracle Integrationのユーザーは、これらのファイルに対して承認などのアクションを実行できます。タスクのステップが完了したら、定義されたプロセスに従ってファイルを移動または管理できます。

Oracle Content Managementがプロセスを開始する場合、プロセスを起動するために送信されるペイロードには、次の情報が含まれます。

ドキュメントID
文書名
プロセスを開始したユーザーのID
タイプ
ロール(後続のアプリケーション・リンクを生成するために使用する必要があるロールを示します)
バージョン

次の例では、Oracle Integrationのフォームでの表示に、ドキュメントIDとドキュメント名のみを使用しています。また、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 Startイベントを使用する必要があります。
プロセスをデプロイするときは、統合を有効にするために指定したユーザーとプロセスを共有する必要があります。そうしないと、ユーザーにはプロセスをトリガーする権限がありません。
ファイルをタスク開始者としてアップロードしたユーザーの場合、プロセスでは、開始者の表示名としてstartedbyフィールドに渡した値が使用される必要があります。
フォルダに対してプロセス統合を使用可能にする場合は、このフォルダを、Oracle Integrationでの統合を可能にするために使用したOracle Content Managementユーザー・アカウントと共有する必要があります。