1. 添付の管理によるOracle SalesとServiceのビジネス・オブジェクトの拡張
  2. Oracle Sales and Serviceアプリケーション統合の構成

Oracle Sales and Serviceアプリケーション統合の構成

この項では、OCMとの通信に必要なOracle Sales and Serviceアプリケーションの共通機能を追加します。これには、OCMドキュメントのREST API、Oracle Salesおよびサービス・アプリケーションのグローバル機能と通信してこれらの新しいWebサービスを呼び出すための新しいWebサービス、およびOCM埋込みUI統合を公開するためのOracle Sales and Serviceアプリケーションのマッシュアップの作成が含まれます。

サンドボックスの作成

この統合のOracle Sales and Serviceアプリケーションの変更を実装するサンドボックスを作成するには:

  1. Oracle Sales and Service管理者としてサインインします。
  2. ページの左上隅にあるハンバーガー・アイコンをクリックします。メニューから「構成」オプションを選択し、「サンドボックス」を選択します。
    configuration.pngの説明が続きます
    図configuration.pngの説明

  3. 「サンドボックスの作成」ページで、次のフィールドに入力します。
    createsandbox.pngの説明が続きます
    図createsandbox.pngの説明

    1. 「サンドボックス」ページで、「サンドボックスの作成」をクリックします。
    2. 「サンドボックスの作成」ページで、「名前」フィールドにこのサンドボックスの名前を指定します(OCMレコード管理統合など)。
    3. 「すべてのツール」リストから、「アプリケーション・コンポーザ」チェック・ボックスを選択します。
    4. 「作成して入力」をクリックします。
  4. OCM統合の変更を行うアプリケーション・コンポーザを入力するには、ページの左上隅にある「ツール」をクリックし、ドロップダウン・リストから「アプリケーション・コンポーザ」を選択します。
    sandboxes.pngの説明が続きます
    図sandboxes.pngの説明

Webサービスの作成

Webサービスは、OCMドキュメントのREST APIを介してOCMと通信するために使用されます。

OCMCreateRepositoryCollectionService

OCMリポジトリ作成コレクションWebサービスを作成するには:
  1. 左側のナビゲーション・メニューから「共通設定」、「Webサービス」の順に選択します。
  2. 「Webサービス」ページで、「新規Webサービスの作成」アイコンをクリックします。
  3. 「接続タイプの選択」ダイアログで、「REST」オプションを選択し、「OK」をクリックします。
  4. 「REST Webサービス接続の作成」ページで、次のフィールドに入力します。
    collectionservice.pngの説明が続きます
    図collectionservice.pngの説明

    1. 「名前」フィールドで、フォルダ名をOCMCreateRepositoryCollectionServiceと指定します。
    2. 「URL」フィールドに、OCMリポジトリ・コレクションの作成に必要なWebサービスURLをhttps://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collectionsとして入力します。ここで、<OCMServerURL>は、この統合に使用されるOracle Content Managementサーバーです(例: https://mycloud.com/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections)。
    3. 「認証スキーム」セクションで、次のステップで構成する「なし」オプションを選択します。
    4. 「リソースに対するメソッドの選択および構成」セクションで、「POST」チェック・ボックスを選択します。
    5. 「リクエスト・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行テキスト・ボックスに{}を追加します。
    6. 「レスポンス・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行テキスト・ボックスに{}を追加します。
  5. Webサービスに使用されるIDCS OAUTH認証スキームを作成するには、現在の「REST Webサービス接続の作成」ページで、次のフィールドに入力します。

    ノート:

    これらのステップは、OCMへのWebサービスを初めて作成する場合にのみ必要です。

    idcsoauth.pngの説明が続きます
    図idcsoauth.pngの説明

    1. 「認証スキーム」セクションで、「IDCS OAUTHを使用したコール」オプションを選択します。
    2. 「トークンURI」フィールドに、IDCSサーバーURL https://<idcsServerURL>/oauth2/v1/tokenを入力します。ここで、<idcsServerURL>は、この統合に使用されるIDCSサーバーへのURLです。
    3. 「スコープ」フィールドに、IDCS OAUTH認証スキームの作成時に前述にコピーしたスコープ(https://BD2F184D9D2344CB8134FCD4CBFF7DF.mycloud.com:443/urn:opc:cec:allなど)を入力します。
    4. クライアント資格証明キーを作成するには、次のフィールドに入力します:
      1. 「クライアント資格証明キー」フィールドの横にある「資格証明キーの作成」アイコンを選択します。
      2. 「CSFキー」フィールドに、キー(Fusion Webサービスなど)を入力します。
      3. 「ユーザー名」フィールドに、IDCS OAUTH認証スキームの作成時にコピーしたクライアントID (c585b2d3e97c40e491ca99112281e36など)を入力します。
      4. 「パスワード」フィールドに、IDCS OAUTH認証スキームの作成時にコピーしたクライアント・シークレット(768b9513-658e-4854-bac7-2fe72d19011など)を入力します。
      5. 「OK」をクリックします。
    5. 切替えIDのOCM資格証明キーを作成するには、次のフィールドに入力します。
      1. 「資格証明キーの資格証明キー」フィールドの横にある「資格証明キーの作成」アイコンを選択します。
      2. 「CSFキー」フィールドに、キー(OCM統合キーなど)を入力します。
      3. 「ユーザー名」フィールドに、OCMとの通信に使用されるOCM統合ユーザー(ベース資産リポジトリを作成するために以前にOCMにログインしたユーザー)を入力します(これはOCMのエンタープライズ・ユーザーである必要があります)。
      4. 「パスワード」フィールドに、OCM統合ユーザーのパスワードを入力します。
      5. 「OK」をクリックします。
    6. 「保存して閉じる」をクリックします。

OCMGetDocumentsByFolderIdService

新しい「REST Webサービス接続の作成」ページでOCMフォルダID別ドキュメントの取得Webサービスを作成するには、次のフィールドに入力します。

ノート:

このWebサービスは、Oracle Sales and Serviceビジネス・オブジェクトに解決オプションがあり、OCM文書統合で構成されている場合にのみ必要です。ドキュメント統合の詳細は、ドキュメント・コラボレーションによるOracle Sales and Serviceビジネス・オブジェクトの拡張方法について学習を参照してください。

folderidservice.pngの説明が続きます
図folderidservice.pngの説明

  1. 「名前」フィールドで、OCMGetDocumentsByFolderIdServiceという名前を指定します。
  2. 「URL」フィールドで、URLをhttps://<OCMServerURL>/documents/api/1.2/folders/##folderId##/search/items?querytext=fItemType%3cMATCHES%3e%60File%60と指定します。ここで、<OCMServerURL>は、この統合に使用されるOracle Content Managementサーバーです。
  3. 「認証スキーム」セクションで、「IDCS OAUTHを使用したコール」オプションを選択し、IDCS OAUTHパラメータで前述と同じ値を使用します。
  4. 「リソースに対するメソッドの選択および構成」セクションで、「GET」チェック・ボックスを選択します。
  5. 「レスポンス・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行テキスト・ボックスに{}を追加します。

OCMBulkOperationsService

新しい「REST Webサービス接続の作成」ページでOCMバルク操作Webサービスを作成するには、次のフィールドに入力します。
bulkoperations.pngの説明が続きます
図bulkoperations.pngの説明

  1. 「名前」フィールドで、OCMBulkOperationsServiceという名前を指定します。
  2. 「URL」フィールドで、URLをhttps://<OCMServerURL>/content/management/api/v1.1/bulkItemsOperationsと指定します。ここで、<OCMServerURL>は、この統合に使用されるOracle Content Managementサーバーです。
  3. 「認証スキーム」セクションで、「IDCS OAUTHを使用したコール」オプションを選択し、IDCS OAUTHパラメータで前述と同じ値を使用します。
  4. 「リソースに対するメソッドの選択および構成」セクションで、「POST」チェック・ボックスを選択します。
  5. 「リクエスト・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行テキスト・ボックスに{}を追加します。

OCMRepositoryCollectionPermissionsService

新しい「REST Webサービス接続の作成」ページでOCMリポジトリ収集権限Webサービスを作成するには、次のフィールドに入力します。
permissionservice.pngの説明が続きます
図permissionservice.pngの説明

  1. 「名前」フィールドで、OCMRepositoryCollectionPermissionsServiceという名前を指定します。
  2. 「URL」フィールドで、URLをhttps://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections/##OCMCollectionsId##/permissionsと指定します。ここで、<OCMServerURL>は、この統合に使用されるOracle Content Managementサーバーです。
  3. 「認証スキーム」セクションで、「IDCS OAUTHを使用したコール」オプションを選択し、IDCS OAUTHパラメータで前述と同じ値を使用します。
  4. 「リソースに対するメソッドの選択および構成」セクションで、「GET」チェック・ボックスを選択します。
  5. 「レスポンス・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行テキスト・ボックスに{}を追加します。

OCMPermissionOperationsService

新しい「REST Webサービス接続の作成」ページでOCM権限操作Webサービスを作成するには、次のフィールドに入力します。
operationservice.pngの説明が続きます
図operationservice.pngの説明

  1. 「名前」フィールドで、OCMPermissionOperationsServiceという名前を指定します。
  2. 「URL」フィールドで、URLをhttps://<OCMServerURL>/content/management/api/v1.1/permissionOperations?links=noneと指定します。ここで、<OCMServerURL>は、この統合に使用されるOracle Content Managementサーバーです。
  3. 「認証スキーム」セクションで、「IDCS OAUTHを使用したコール」オプションを選択し、IDCS OAUTHパラメータで前述と同じ値を使用します。
  4. 「リソースに対するメソッドの選択および構成」セクションで、「POST」チェック・ボックスを選択します。
  5. 「リクエスト・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行テキスト・ボックスに{}を追加します。
  6. 「レスポンス・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行テキスト・ボックスに{}を追加します。

マッシュアップの作成

マッシュアップは、OCMなどの独立した外部アプリケーションへのウィンドウです。

Oracle Sales and Serviceビジネス・オブジェクトに公開できるようにOCM埋込みUIを埋め込むマッシュアップを作成するには:

  1. 左側のナビゲーション・メニューから「共通設定」および「マッシュアップ・コンテンツ」を選択します。
  2. 「マッシュアップ・コンテンツ: Webアプリケーション」ページで、「Webアプリケーションの登録」ボタンをクリックします。
  3. 「Webアプリケーションの登録」ページで、次のフィールドに入力します。
    mashup.pngの説明が続きます
    図mashup.pngの説明

    1. 「名前」フィールドで、アプリケーションの名前をOCMEmbeddedAssetsUIMashupとして指定します。
    2. 「タイプ」フィールドで、「Groovy式」オプションを選択します。
    3. 「URL定義」フィールドに、OCM埋込みUI URLをhttps://<OCMServerURL>/documents/embed/v2/assetsとして入力します。<OCMServerURL>は、統合に使用されるOracle Content Managementサーバーです。
    4. 「保存して閉じる」をクリックします。