Oracle Salesおよびサービス・アプリケーション統合の構成

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

サンドボックスの作成

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

1. Oracle Salesおよびサービス管理者としてサインインします。
2. ページの左上隅にあるをクリックします。メニューから「構成」オプションを選択し、「サンドボックス」を選択します。
   
   
   図configuration.pngの説明
   
   
3. 「サンドボックスの作成」ページで、次のフィールドに入力します。
   
   
   図createsandbox.pngの説明
   
   
   1. 「サンドボックス」ページで、「サンドボックスの作成」をクリックします。
   2. 「サンドボックスの作成」ページで、「名前」フィールドにこのサンドボックスの名前を指定します(OCMドキュメント・コラボレーション統合など)。
   3. 「すべてのツール」リストから、「アプリケーション・コンポーザ」チェック・ボックスを選択します。
   4. 「作成」をクリックして入力します。
4. OCM統合の変更を行うアプリケーション・コンポーザを入力するには、ページの左上隅にある「ツール」をクリックし、ドロップダウン・リストから「アプリケーション・コンポーザ」を選択します。
   
   
   図toolsmenu.pngの説明
   
   

Webサービスの作成

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

OCMCreateFolderService

OCMフォルダWebサービスを作成するには:

1. 左側のナビゲーション・メニューから「共通設定」、「Webサービス」の順に選択します。
2. 「Webサービス」ページで、「新規Webサービスの作成」アイコンをクリックします。
3. 「接続タイプの選択」ダイアログで、「REST」オプションを選択し、「OK」をクリックします。
4. 「REST Webサービス接続の作成」ページで、次のフィールドに入力します。
   
   
   図webserviceconnection.pngの説明
   
   
   1. 「名前」フィールドで、フォルダの名前をOCMCreateFolderServiceとして指定します。
   2. 「URL」フィールドに、OCMフォルダの作成に必要なWebサービスURLをhttps://<OCMServerURL>/documents/api/1.2/folders/##OCMParentFolderId##?name=##OCMFolderName##として入力します。ここで、<OCMServerURL>は、この統合に使用されるOracle Content Managementサーバーです(例: https://mycloud.com/documents/api/1.2/folders/##OCMParentFolderId##?name=##OCMFolderName##)。
   3. 「認証スキーム」セクションで、次のステップで構成されるように「なし」オプションを選択します。
   4. 「リソースに対するメソッドの選択および構成」セクションで、「POST」チェック・ボックスを選択します。
   5. 「レスポンス・ペイロード」セクションで、「コード・サンプル」オプションを選択し、複数行のテキスト・ボックスに{}を追加します。
5. Webサービスに使用されるIDCS OAUTH認証スキームを作成するには、「REST Webサービス接続の作成」ページで、次のフィールドに入力します。

   ノート:

   これらのステップは、OCMにWebサービスを初めて作成する場合にのみ必要です。
   
   
   
   図serviceconnection.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キー」フィールドにキーを入力します(たとえば、「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. 「Save and Close」をクリックします。

OCMSearchUserService

OCM検索ユーザーWebサービスを作成するには、「REST Webサービス接続の作成」ページで、次のフィールドに入力します。

図searchuser.pngの説明

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

OCMSharedFolderUsersService

OCM共有フォルダ・ユーザーのWebサービスを作成するには、「REST Webサービス接続の作成」ページで、次のフィールドに入力します。

図sharedfolder.pngの説明

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

OCMShareFolderService

OCM共有フォルダWebサービスを作成するには、「REST Webサービス接続の作成」ページで、次のフィールドに入力します。

図share-folder.pngの説明

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

OCMDeleteFolderService

OCM削除フォルダWebサービスを作成するには、「REST Webサービス接続の作成」ページで、次のフィールドに入力します。

図deletefolder.pngの説明

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

グローバル関数の作成

グローバル関数は、ビジネス・ロジックをWebサービスでラップして、他の場所で簡単に使用できるようにするために使用されます。

OCMCreateFolderFunction

OCMCreateFolderService Webサービスを使用するOCM作成フォルダのグローバル関数を作成するには:

1. 左側のナビゲーション・メニューから「共通設定」、「グローバル機能」の順に選択します。
2. 「グローバル関数」ページで、「グローバル関数の追加」アイコンをクリックします。
3. 「Create Global Function (グローバル機能の作成)」ページで、次のフィールドに入力します。
   
   
   図globalfunction.pngの説明
   
   
   1. 「ファンクション名」フィールドで、ファンクションの名前をOCMCreateFolderFunctionとして指定します。
   2. 「戻る」ドロップダウン・メニューから「文字列」を選択します。
   3. 「説明」フィールドに、OCMの新しいOCMFolderNameフォルダを指定されたOCMParentFolderIdの下に作成し、新しく作成されたフォルダIDを返します。
   4. 「パラメータ」セクションで、「パラメータの追加」アイコンをクリックします。

      「名前」フィールドで、OCMParentFolderIdという名前を指定し、「タイプ」ドロップダウン・メニューから「文字列」を選択します。

   5. 「パラメータ」セクションで、「パラメータの追加」アイコンをクリックします。

      「名前」フィールドで、OCMFolderNameという名前を指定し、「タイプ」ドロップダウン・メニューから「文字列」を選択します。

   6. 「スクリプトの編集」フィールドに次のスクリプトを貼り付けます。

      def OCMFolder = [:]
      try {
        OCMFolder = adf.webServices.OCMCreateFolderService.POST(OCMParentFolderId, OCMFolderName)
        println("OCM Folder Created: " + OCMFolder)
        return OCMFolder.id   
      } catch (Exception e) {
        println("Create OCM Folder Error: " + e)
      }

   7. 「Save and Close」をクリックします。

OCMSearchUserFunction

OCM検索ユーザー・グローバル機能を作成するには、OCMSearchUserService Webサービスへのアクセスに使用する新しい「グローバル機能の作成」ページで、次のフィールドに入力します。

図searchuserfunction.pngの説明

1. 「ファンクション名」フィールドで、ファンクションの名前をOCMSearchUserFunctionとして指定します。
2. 「戻る」ドロップダウン・メニューから「文字列」を選択します。
3. 「説明」フィールドに、「Searches for a user in OCM by the specified userName」というテキストを入力し、そのユーザーのIDを返します。
4. 「パラメータ」セクションの「名前」フィールドで、名前をuserNameとして指定し、「タイプ」ドロップダウン・メニューから「文字列」を選択します。
5. 「スクリプトの編集」フィールドに次のスクリプトを貼り付けます。

   def response = [:]
   try {
     response = adf.webServices.OCMSearchUserService.GET(userName)
     def responseItems = [:]
     responseItems = response.items
     println("OCM Search User Result: " + responseItems.getAt(0))
     return responseItems.getAt(0).id
   } catch (Exception e) {
     println("Search OCM User Error: " + e)
   }

6. 「Save and Close」をクリックします。

OCMIsFolderSharedFunction

OCM共有フォルダ・グローバル機能を作成するには、OCMSharedFolderUsersService Webサービスへのアクセスに使用する新しい「グローバル機能の作成」ページで、次のフィールドに入力します。

図ocmis.pngの説明

1. 「ファンクション名」フィールドで、ファンクションの名前をOCMIsFolderSharedFunctionとして指定します。
2. 「戻り値」ドロップダウン・メニューから「ブール」を選択します。
3. 「説明」フィールドに、指定されたOCMUserIdが指定されたOCMFolderIdと共有されている場合はtrueを返すテキストを入力します。
4. 「パラメータ」セクションで、次の値を追加します。

   名前	タイプ
   OCMFolderId	String
   OCMUserId	String

5. 「スクリプトの編集」フィールドに次のスクリプトを貼り付けます。

   def response = [:]
   try {
     response = adf.webServices.OCMSharedFolderUsersService.GET(OCMFolderId)
     def responseItems = [:]
     responseItems = response.items
     for (item in responseItems) {
       if (item['type'] == 'share') {
         if (item['user']['id'] == OCMUserId) {
           return true
         }
       }
     }
     return false
   } catch (Exception e) {
     println("OCM Folder Shared Error: " + e)
     return false
   }

6. 「Save and Close」をクリックします。

OCMShareFolderFunction

OCM共有フォルダ・グローバル機能を作成するには、OCMShareFolderService Webサービスへのアクセスに使用する新しい「グローバル機能の作成」ページで、次のフィールドに入力します。

図sharefolderfunction.pngの説明

1. 「ファンクション名」フィールドで、ファンクションの名前をOCMShareFolderFunctionとして指定します。
2. 「戻り値」ドロップダウン・メニューから「ブール」を選択します。
3. 「説明」フィールドに、テキスト"Shares the specified OCMFolderId in OCM with the OCMUserId and OCMRole specified return true if successful."を入力します。
4. 「パラメータ」セクションで、次の値を追加します。

   名前	タイプ
   OCMFolderId	String
   OCMUserId	String
   OCMRole	String

5. 「スクリプトの編集」フィールドに次のスクリプトを貼り付けます。

   def params = [:]
   params.userID = OCMUserId
   params.role = OCMRole
   def response = [:]
   try {
     response = adf.webServices.OCMShareFolderService.POST(OCMFolderId, params)
     if (response.errorCode == "0") {
       println("OCM Folder Shared: " + OCMFolderId + "(" + OCMUserId + ":" + OCMRole + ")")
       return true
     } else {
       println("Share OCM Folder Failed: " + OCMFolderId + "(" + OCMUserId + ":" + OCMRole + ")")
       return false
     }
   } catch (Exception e) {
     println("Share OCM Folder Error: " + e)
     return false 
   }

6. 「Save and Close」をクリックします。

OCMDeleteFolderFunction

OCM共有フォルダ・グローバル機能を作成するには、OCMDeleteFolderService Webサービスへのアクセスに使用する新しい「グローバル機能の作成」ページで、次のフィールドに入力します。

図ocmdelete.pngの説明

1. 「ファンクション名」フィールドで、ファンクションの名前をOCMDeleteFolderFunctionとして指定します。
2. 「戻り値」ドロップダウン・メニューから「ブール」を選択します。
3. 「説明」フィールドに、「OCMで指定されたOCMFolderIdを削除します。」というテキストを入力します。
4. 「パラメータ」セクションの「名前」フィールドで、名前をOCMFolderIdとして指定し、「タイプ」ドロップダウン・メニューから「文字列」を選択します。
5. 「スクリプトの編集」フィールドに次のスクリプトを貼り付けます。

   def response = [:]
   try {
     adf.webServices.OCMDeleteFolderService.DELETE(OCMFolderId)
     println("OCM Folder Deleted: " + OCMFolderId)
     return true
   } catch (Exception e) {
     println("Delete OCM Folder Error: " + e)
     return false 
   }

6. 「Save and Close」をクリックします。

マッシュアップの作成

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

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

1. 左側のナビゲーション・メニューから「共通設定」および「マッシュアップ・コンテンツ」を選択します。
2. 「マッシュアップ・コンテンツ: Webアプリケーション」ページで、「Webアプリケーションの登録」ボタンをクリックします。
3. 「Webアプリケーションの登録」ページで、次のフィールドに入力します。
   
   
   図registerwebapp.pngの説明
   
   
   1. 「名前」フィールドで、アプリケーションの名前をOCMEmbeddedFolderUIMashupとして指定します。
   2. 「タイプ」フィールドで、「Groovy式」オプションを選択します。
   3. 「URL定義」フィールドに、OCM埋込みUI URLをhttps://<OCMServerURL>/documents/embed/v2/folder/として入力します。<OCMServerURL>は、統合に使用されるOracle Content Managementサーバーです。
   4. 「Save and Close」をクリックします。