1. Oracle Integration Generation 2でのプロセスの使用
  2. 開発者のタスク
  3. 文書の統合
  4. Oracle Content Managementとの統合方法は?
機械翻訳について

Oracle Content Managementとの統合方法

自分またはユーザーがドキュメント機能にアクセスするには、管理者がOracle Content ManagementとOracle Integrationの両方で設定を構成する必要があります。

管理者権限を持つユーザーのみが2つのサービス間の接続を確立できます。

Oracle Content Managementとの接続が構成される前に作成されたプロセス・アプリケーションの場合、ドキュメント機能はデフォルトで無効になっています。 開発者は、既存のアプリケーションのこれらの機能を手動で有効化できます。

トピック:

成功した統合のためのアクセス要件

統合に成功するためには、次のアクセス要件に注意してください:

  • Oracle Integrationで構成されているOracle Content Managementユーザーは、Oracle Content Managementに構成されているフォルダ(つまり、受信ドキュメントのフォルダ)に対してプロセスを停止できるようにフル・アクセス権を持っている必要があります。

  • フォルダ開始プロセス(つまり、「フォルダ開始」イベントを含むプロセス)の場合、Oracle Integrationで構成されているOracle Content Managementユーザーは、Oracle Integrationのフォルダにアクセスするために、そのフォルダへのマネージャ・アクセス権を持っている必要があります。 たとえば、外部アプリケーションにプロセスUIコンポーネントを埋め込むときにフォルダにアクセスするには、「タスクの詳細」ページと「プロセス・トラッキング」ページのフォルダを表示するか、Process Mobileアプリケーションのフォルダを参照するには、マネージャへのアクセスが必要です。

  • フォルダのプロセス・リストでプロセスを表示し、新しいドキュメントの受信時にプロセス・インスタンスを開始できるようにするには、Oracle Content Managementで構成されているOracle Integrationユーザーにプロセス・イニシエータ・ロールを付与する必要があります。

プロセス・アプリケーションでのドキュメントまたは添付ファイルの使用

Oracle Integrationには、プロセス・アプリケーションに標準の「添付ファイル」機能が自動的に組み込まれています。 ファイルをアップロードしてプロセスにアタッチすることができます。 Oracle Content ManagementをOracle Integrationとともに使用すると、documents機能も得られます。これにより、ファイルのアップロード、ファイルのフォルダへの編成、各フォルダへのアクセスの管理、ドキュメントのアップロードによるプロセスの開始が可能になります。 さらに、各プロセス・アプリケーションには、文書または添付ファイルのいずれかを使用するオプションがあります。

プロセスがアプリケーションレベルで文書または添付ファイルを使用するかどうかを制御します。 ドキュメントはデフォルトで有効になっています。 設定は、アプリケーションの情報ペインにあります。


enable-docs-app-level-cb.pngの説明が続きます
図enable-docs-app-level-cb.pngの説明

「ドキュメントの統合」が有効になっているアプリケーションでは、ドキュメント(およびドキュメントのみ)を使用できます。 「ドキュメントの統合」disabledを持つアプリケーションでは、添付ファイルしか使用できません。 基本的に、アプリケーションのドキュメントを無効にすると、そのアプリケーションの添付ファイルが有効になります。

この設定はアプリケーションに適用されることに注意してください。 アプリケーション内で文書または添付ファイルを使用できますが、両方を使用することはできません。

添付の場合は、「UIのカスタマイズ」画面で「添付の非表示」オプションの選択が解除されていることを確認してください。 「添付の非表示」オプションを選択した場合、タスク詳細および開始フォームで添付を表示できなくなります。

REST APIsを使用してOracle Integrationと対話する場合は、プロセス・アプリケーションでドキュメントと添付ファイルのどちらを使用するかによって、必ず適切なAPIを使用してください:

  • ドキュメントの場合は、必ず /folders REST APIを使用してください。

  • 添付ファイルの場合は、必ず /attachments REST APIを使用してください。

間違ったAPIを使用すると、アプリケーションはエラー・メッセージを返すか、操作なしで終了します。

タスクの詳細に添付を表示できない場合は、「UIのカスタマイズ」画面のオプションを選択します。 添付を表示するには、「添付の非表示」のチェック・ボックスが選択されていないことを確認します。

Oracle Content Managementでの設定の構成

Oracle Content Managementでは、管理者がOracle Integrationを有効にし、接続情報を入力し、1つ以上のフォルダに対してOracle Integrationの使用を有効にする必要があります。

各ステップについてさらに学習したいですか。 「Oracle Content Managementの統合と拡張」の「Oracle Integrationとの統合」を参照してください。

Oracle Integrationのドキュメント設定の構成

管理者は、Oracle IntegrationとOracle Content Managementの間の接続を構成する必要もあります。 Oracle Content ManagementのURLやサインイン資格証明などの情報を入力する必要があります。

Oracle Integrationで設定を構成するには:
  1. Oracle Integrationナビゲーション・ペインで、「マイ・タスク」、「ワークスペース」、「管理」の順にクリックします。
  2. 「サービス」をクリックします。
  3. Oracle Content Managementセクションで、次の情報を入力します:
    • URL: Oracle Content Managementのwebアドレス。 サービス管理者は、サービスの使用準備ができたら、Oracle Cloudへようこそを受け取ります。 電子メールには、Oracle Content ManagementのURLがあります。 たとえば、https://your_service_name.com/documentsです。
    • アイデンティティ・ドメイン: Oracle Content Managementが属するアイデンティティ・ドメインの名前。 アイデンティティ・ドメインを指定することなく、Oracle Content Management (ドキュメント機能用)への接続を正常に構成できます。
    • ユーザーとパスワード: Oracle Content Managementにアクセスできるユーザーのアカウント資格証明。 このユーザー・アカウントは、サービス間の接続をテストするために使用されます。 フォルダの作成など、サービスへの接続およびすべての実行時操作の実行にも使用されます。
  4. 「Test」をクリックします。

    構成設定を変更するたびに、入力した値が正しいことを確認することをお勧めします。 Oracle Content Managementで接続が正常に確立されたことを確認します。

    メッセージ、エラー、および警告を含むテスト結果を確認します。

  5. 続行するには、次のいずれかのオプションを選択します:
    • エラーまたは警告がある場合は、必要な変更を行い、「テスト」を再度クリックして新しい値を確認します。 設定を変更するたびにテストを繰り返します。
    • 接続テストが成功した場合は、「保存」をクリックして構成を保存します。
    • 取り消して最後に保存した値に戻す場合は、「元に戻す」をクリックします。

ドキュメントの有効化または無効化

管理者がOracle Content ManagementとOracle Integrationの間の接続を確立した後、プロセス・アプリケーションでドキュメントを使用できます。 これらの機能は、作成するすべての新しいアプリケーションに対してデフォルトで有効になっています。

Oracle Content Managementとの接続が構成される前に作成されたプロセス・アプリケーションの場合、ドキュメント機能はデフォルトで無効になっています。 既存のプロセス・アプリケーションでこの機能を使用する場合は、手動で機能を有効にする必要があります。

プロセスのモデル化、タスクの表示およびプロセス・インスタンスのトラッキングを行うときにドキュメントを使用できると、多くの利点があります。 ただし、一部のプロセス・アプリケーションでは、ドキュメント機能を使用できない場合があります。 そのような場合、手動で機能を無効化できます。

特定のプロセス・アプリケーションに対してドキュメント機能を有効または無効にするには:
  1. アプリケーションを開いて、「アプリケーション・ホーム」タブに表示されるようにします。
    QuickStartアプリケーションまたはQuickStartマスターを表示している場合は、「詳細表示に切り替える」をクリックする必要があります。
  2. 「詳細」 詳細アイコンをクリックして情報ペインを展開します。
    「ドキュメント統合」の横にあるチェック・ボックスには、このアプリケーションのドキュメント機能の現在のステータスが表示されます。
    enable-docs-app-level-cb.pngの説明が続きます
    「図enable-docs-app-level-cb.pngの説明」
  3. このチェック・ボックスは、このアプリケーションでドキュメント機能を有効または無効にする場合に使用します。
  4. プロセス・アプリケーションの新しいリビジョンをアクティブ化します。 「オプションのアクティブ化」タブで、「デフォルトを強制使用」オプションを選択します。
  • すでに使用されているプロセス・アプリケーションに対してOracle Content Managementをアクティブ化すると、新しいインスタンスではドキュメントが使用され、既存のインスタンスは引き続きネイティブ添付を使用できます。
  • 任意のプロセス・アプリケーションでは、文書と添付ファイルは相互に排他的です。 「ドキュメントの統合」が有効になっているアプリケーションでは、それらのアプリケーションはドキュメントとドキュメントのみを使用できます。 アプリケーションの「ドキュメントの統合」を無効にすると、そのアプリケーションは添付ファイルと添付ファイルのみを使用できます。 ドキュメントを無効にすると、添付ファイルが有効になります。

アクセス問題と構成の変更

Oracle IntegrationでOracle Content Managementを構成した後、アクセスの問題または構成の変更によってエラーが発生することに注意してください。

たとえば:

  • 現在使用中のOracle Content Management構成を変更すると、関連するドキュメントにアクセスできなくなります。

    • ドキュメントの場合、「Documents」「Documents」アイコンをクリックするか、「Task Details」ページまたは「Tracking」ページでリストからドキュメントにアクセスすると、エラーが発生します。

  • プロセスによって作成されたアプリケーション・フォルダが削除された場合、管理者はOracle Content Managementごみ箱フォルダからリストアする必要があります。