機械翻訳について
  1. Oracle Content Managementの統合および拡張
  2. Oracle Content Managementの拡張機能の開発
  3. コンテンツ・コネクタの開発
  4. 新規コンテンツ・コネクタのビルド

新規コンテンツ・コネクタのビルド

新しいコンテンツ・コネクタをRESTfulサービスとして構築するには、開発者は、コネクタ・フレームワークによって提供されるRESTfulインタフェースを実装する必要があります。

Oracle Content Managementコネクタ・フレームワークには次のインタフェースがあります。

  • APIResource Interface: このインタフェースはコンテンツ・コネクタの開始点です。 サポートされているバージョンのみを返します。

  • ServerResource Interface : 開発者または管理者がOracle Content Managementサーバーにコンテンツ・コネクタを登録すると、Oracle Content Managementはこのサービスをコールして、コネクタ・サーバーに関する次のような基本詳細を取得します:

    • 承認タイプ:

      • OAUTH: リモート・クラウド・ストアが3本脚のOAuth認証をサポートしている場合
      • BASIC_AUTH: リモート・クラウド・ストアがBasic認証をサポートしている場合

        ノート:

        Oracleでは、一般的な消費に対するBasic認証がサポートされなくなりました。
      • NO_AUTH: リモート・ストアで認証が必要でない場合

    • ピッカー・タイプ: Oracle Content Managementは、ファイル・システムをリストするOracle Content Management汎用ピッカーをサポートしています。 コンテンツ・コネクタでネイティブ・ピッカーがサポートされている場合、コンテンツ・コネクタ実装者はJavaScript APIを実装して、そのピッカーをOracle Content Management UIと統合できます。 ピッカー・タイプは次の3つの値のいずれかになります:

      1. COMMON:共通UIの使用
      2. CUSTOM、カスタムUIの使用
      3. NATIVE、Google DriveやMicrosoft OneDriveなどのネイティブUIを使用

    • また、このインタフェースを使用して、コンテンツ・コネクタのカスタム・フィールドを定義します。 カスタム・プロパティはコネクタ固有であるため、コネクタ・フレームワーク自体はこのようなプロパティ・リストを提供できません。 各コンテンツ・コネクタは、リモート・ストアへの接続には独自の要件を持っています。たとえば、あるコンテンツ・コネクタはClientIDとClientSecretのみ必要とし、別のコンテンツ・コネクタには、ClientID、ClientSecret、AppIDなどが必要となる場合があります。 各コンテンツ・コネクタは、ServerResourceによってOracle Content Managementサーバーにカスタム・プロパティ・リストを提供できます。 これらのプロパティを構成時に開発者または管理者が入力する必要がある場合、コネクタ・フレームワークは管理UIでこれらを表示します。

    このサービスは、登録時に一度だけ呼び出されます。

  • AuthorizationResource Interface: リモート・ストアのコンテンツをOracle Content Managementリポジトリにコピーする前に、認可を完了するために使用されます。 このインタフェースは、OAuthおよびBasicの両方の認証プロトコルをサポートしています。

    • 3-legged OAuth認証

      • OAuthフローでは、コンテンツ・コネクタによって提供されるカスタム・プロパティ値に基づくOracle Content Management UIは、OAuth認証をサポートします。 これにより、コネクタ・フレームワークをコールしてOAuthフローがトリガーされ、このフレームワークでは、承認URLを取得するためにコンテンツ・コネクタの/authorization/authorization URLサービスをコールします。

      • Oracle Content Management UIは、認可URLをブラウザでレンダリングし、そこでユーザーがアプリケーションを認可し、さらに通信するためにトークンにアクセスするOracle Content Management権限を付与します。 認可を完了してOAuthトークンを取得するには、Oracle Content Managementサーバーがコンテンツ・コネクタの/authorization/completedAuthorizationsサービスをコールします。 3-legged OAuthを完了するために、Oracle Content Managementサーバーにはリダイレクト・コールバック・サーブレットも用意されており、リモート・ストアは認可プロセスを完了するためにコールします。

    • 基本認証: コンテンツ・コネクタがBasic認証をサポートする場合、Oracle Content Management UIでは、Oracle Content Management (コネクタ・フレームワーク)に渡すユーザー名とパスワードの入力がユーザーに求められます。 コネクタ・フレームワークから/authorization/ basicAuthorizationサービスが呼び出されて資格証明が渡され、資格証明が正しい場合は、コンテンツ・コネクタがリモート・ストアで検証するように求められます。

  • FileSystemResource Interface: コネクタ・フレームワークでは汎用ファイル・ピッカーがサポートされており、これをコンテンツ・コネクタで使用して、ユーザーがファイルを参照するためのファイルシステム情報をレンダリングできます。 ただし、この機能を使用するには、コンテンツ・コネクタに/filesystemサービスを実装する必要があります。 このサービスの特長は次のとおりです:

    • ユーザーは、その他のファイル・ピッカー(Google DriveやMicrosoft OneDriveピッカーなど)と同様にファイル・システムを参照できます。

    • これでページ区切りがサポートされます。

    • ユーザーは、フィルタ処理された結果を取得するための検索基準を指定することもできます。

  • ContentResource Interface: コネクタ・フレームワークでは、サービス/contentを使用して、クラウド・ストアに格納された実際のコンテンツ(ファイルのバイト)を取得します。

    このサービスはレスポンスとしてjavax.ws.rs.core.Responseを返し、レスポンス・エンティティはファイルの内容です。 レスポンスには次のヘッダーを含める必要があります:

    • Content-Length: エンティティの長さに設定するか、-1(不明な場合)。

    • Content-Type: コンテンツ・タイプに設定するか、より正確なタイプが不可能な場合はapplication/octet-stream。

    • Content-Disposition: 添付ファイルの処理タイプに設定し、filenameパラメータを含めます(たとえば、Content-Disposition: attachment; filename="meeting agenda.doc")。 空白を含むファイル名は引用符で囲む必要があります。 ヘッダーのフォーマットおよびエンコーディングの詳細は、RFC 6266を参照してください。

これらの各インタフェースの詳細は、RESTペイロードの例とともに、次のセクションで説明します: