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

コンテンツ・コネクタのサンプル実装

Pexelsコンテンツ・コネクタのこのサンプル実装を使用すると、独自のカスタム・コンテンツ・コネクタのビルドに役立ちます。 Pexelsコンテンツ・コネクタを使用すると、コンテンツ作成者は、PexelsライブラリからOracle Content Managementアセット・リポジトリにリッチで高品質なイメージを提供できます。

Pexelsは、無料で使用する写真がデザイナ、ブロガーおよびその他によって検出されたストック写真サイトです。 Pexelsコンテンツ・コネクタは、Oracle Content Managementで提供されるコネクタ・フレームワークSDKを使用して構築されています。 このコンテンツ・コネクタの2つのバージョンを使用できます:

  1. 角度形のJSを使用して作成されたカスタム・ピッカーを使用するコンテンツ・コネクタ。 このバージョンは、デフォルトで構築されます。
  2. Oracle Content Managementによって提供される一般的なピッカーを使用するコンテンツ・コネクタ。

次の各項では、Pexelsコンテンツ・コネクタの開発方法について説明します。

コンテンツ・コネクタのインストール

Pexelsコンテンツ・コネクタをインストールするには、インストールの前提条件を満たしてから、コンテンツ・コネクタWARファイルをビルドする必要があります。

次の各項では、前提条件と、WARファイルをビルドする方法について説明します。

インストールの前提条件チェック

Pexelsコンテンツ・コネクタをインストールする前に、ノード、npm、JDK、およびApache Mavenでシステムを設定する必要があります。

  1. コンピュータにノードおよびnpmがインストールされており、PATHに設定されていることを確認してください。 必要に応じてプロキシを構成します。

    「プロキシ・サービス設定の構成」を参照してください。

  2. 最新のJDKがインストールされ、PATHに設定されていることを確認してください。

  3. Apache Mavenがインストールされ、PATHに設定されていることを確認し、必要に応じてプロキシ構成を行います。

コンテンツ・コネクタのWARファイルのビルド

コンテンツ・コネクタ・ソース・バンドルをダウンロードして、マシン上のロケーションにバンドルを解凍し、Readmeファイル内の手順に従ってWARファイルを生成します。

Oracle Content Managementコンテンツ・コネクタのサンプルおよびSDKは、ここからダウンロードできます: 

https://<your-cec-service>/_sitesclouddelivery/renderer/app/sdk/connector/cec-connector-sample.zip

https://<your-cec-service>/_sitesclouddelivery/renderer/app/sdk/connector/cec-connector-sdk.zip

簡単に言えば、手順は次のとおりです:

  1. コマンド行インタフェースで、pexelsPickerWeb\src\main\webappに移動します。
  2. pexels_setup.batまたはpexels_setup.shを(環境に基づいて)実行します。
  3. 実行に成功すると、pexels-picker.warファイルがpexelsPickerWeb\targetフォルダで使用可能になります。

生成されたWARファイルは、エン・ポピュラーJSを使用して作成されたカスタム・ピッカーUIを使用するファイルです。

このWARファイルをサーバーにデプロイします。 次のURLsを実行して、正常に機能するかどうかをテストします:

  1. GET http://<host:port>/pexels-picker/rest/api
  2. GET http://<host:port>/pexels-picker/rest/api/v1/server

予想される出力については、「コンテンツ・コネクタのソース・コードの理解」を参照してください。

コンテンツ・コネクタの登録

Pexelsコンテンツ・コネクタを使用するには、最初にPexels APIにアクセスする必要があります。 これを行うには、Pexelsに登録してアクセスをリクエストする必要があります。

Pexels APIドキュメントの手順に従って、コンテンツ・コネクタを登録し、アクセスをリクエストします。 リクエストを行うと、取得する必要のあるAPIキーが表示されます。 Pexels APIは、時間当たりの200リクエストおよび月当たりの20,000リクエストに制限されます。 より高い制限が必要な場合は、Pexelsに連絡してください。

  1. 開発者または管理者としてOracle Content Managementインスタンスにサインインします。
  2. 「管理>統合>コンテンツ・コネクタ」に行き、「作成」をクリックして下さい。
  3. Pexelsコンテンツ・コネクタの登録の詳細を入力します。
    1. 名: Pexels
    2. 説明: Connector to bring Pexels images into Oracle Content Management asset repository
    3. コネクタ・サービスURL: http://<host:port>/pexels-picker/rest/api (前にテストしたURL)
  4. 「設定の確認」をクリックし、次に「保存」をクリックします。
  5. 「コンテンツ・コネクタ」タブで、「構成」をクリックしてコンテンツ・コネクタの構成に戻り、次の値を指定します。
    1. カスタム・ピッカーURL: http:// <host:port> /pexels-picker/web/ index.html

      これは、コンテンツ・コネクタにパッケージ化されたカスタム・ピッカーです。 この設定は、共通UIを使用する場合には適用できません。

    2. OK/取消の非表示:

      この設定は選択しないままにします。 これは、Oracle Content Managementでピッカーをダイアログに埋め込むかどうかを示します。これは共通UIを使用する場合には適用されません。

  6. 「カスタム・フィールド」セクションに「クライアントID」も指定します。
  7. 「エンド・ユーザーに有効化」を選択します。

configure_connector.pngの説明は以下のとおりです
「図configure_connector.pngの説明」

コンテンツ・コネクタのデフォルト・タイムアウト値は、次の2つのプロパティで設定します:

  • ConnectorConnectionTimeout=20000

  • ConnectorReadTimeout=30000

これらのプロパティの値を変更する場合は、config.cfgにプロパティを追加して、一方または両方の値を変更できます。

コンテンツ・コネクタのテスト

Pexelsコンテンツ・コネクタの機能を確認します。

コンテンツ・コネクタをテストするには、「アセット」タブに移動し、「追加」をクリックします。 ドロップダウン・メニューに「Pexelsからのインポート」が表示されています。 アセット・リポジトリを作成して、選択した後に「追加」をクリックする必要があります。 これにより、前にキュレートされたイメージを表示するPexelsピッカーが起動されます。

このピッカーは、インストールした対象に応じて、コンテンツ・コネクタまたは共通ピッカーにパッケージ化されたカスタムUIです。

必要なイメージの検索、必要なイメージの選択、OKの順にクリックできます。 これにより、「リポジトリに追加」ダイアログが開き、追加できる選択したイメージがリストされます。 これらを追加すると、イメージがアセット・リポジトリに表示されます。


prexels_custom_picker.pngの説明は以下のとおりです
「図prexels_custom_picker.pngの説明」

コンテンツ・コネクタのソース・コードの理解

Pexelsコンテンツ・コネクタのソース・コードには、REST APIおよびカスタム・ピッカーが含まれます。

Pexelsコンテンツ・コネクタには、Oracle Content Managementコンテンツ・コネクタ・インタフェースを使用して実装される一連のREST APIが含まれています。 これはJAX-RS仕様に従って実装されます。

コネクタSDKとサンプルの実装は次のファイルに格納されます:

  • cec-connector-sdk.zip

    このファイルには、SDKインタフェースJAR、Javadocおよびconnector.yamlファイルが含まれています。このファイルでは、REST APIとそのペイロードを説明します。

  • oracle-oce-custompicker.js

    これは、コンテンツ・コネクタのカスタムUIがOracle Content Managementとやり取りするためにパッケージする必要があるJSファイルです。

  • pexelsPickerWeb.zip

    このファイルには、Pexelsコンテンツ・コネクタのリファレンス実装が含まれています。

カスタム・ピッカーUI

コンテンツ・コネクタにパッケージ化されたPexelsピッカーは、Angular JSを使用して作成されます。 カスタム・ピッカーUIを提供します。

Pexelsピッカー・ファイルは、pexelsPickerWeb\src\main\webapp\srcにあります。

Pexels REST APIs

Pexelsコンテンツ・コネクタには、REST APIのセットが含まれます。

コンテンツ・コネクタ・コードの変更およびテスト

コンテンツ・コネクタ・コードを変更した場合は、pexelsPickerWeb\src\main\webappからコマンドを実行して、変更内容をテストし、WARファイルをリビルドできます。

  1. package.jsonを変更して追加のライブラリを含める場合は、pexelsPickerWeb\src\main\webappから次のコマンドを実行します: 

    npm install

  2. UIコードを変更する場合は、 pexelsPickerWeb\src\main\webappから次のコマンドを実行します: 

    ng build

  3. 最後に、pexelsPickerWebからmvnを実行してWARファイルをリビルドします: 

    mvn clean install