機械翻訳について

レシピをインストールする前に

Oracle Integrationを使用してこれらの外部システムに接続し、ServiceNowインシデントのBoxでフォルダを正常に作成するには、ServiceNowインスタンスおよびBoxインスタンスで次の構成タスクを実行する必要があります。

ServiceNowの構成

Oracle Integrationを使用してServiceNowにアクセスし、ServiceNowインシデントに対応するBoxフォルダを作成するには、ServiceNowインスタンスで特定の構成を実行する必要があります。

「管理者」としてServiceNowインスタンスにログインし、次のタスクを実行します。

  1. カスタム・ユーザー(統合ユーザーなど)を作成し、ServiceNow表へのアクセス権を持つカスタム・ロールを割り当てます。 「Oracle Integration 3でのServiceNowアダプタの使用」の「接続を作成するための前提条件」の「ユーザーおよびロールの要件を満たす」を参照してください。
  2. webサービスを有効にし、必要な表に権限を割り当てます。
    1. ServiceNowホーム・ページで、左ペインの検索ボックスで表を検索し、検索結果の「システム定義」の下にある「表」リンクをクリックします。
    2. 「検索」ボックスを使用して次の各ServiceNow表を検索するか、表示/非表示フィルタを使用して表を検索します。
      • sys_soap_message
      • sys_soap_message_function
      • sys_script
    3. 検索結果の表名をクリックします。
    4. 「アプリケーション・アクセス」タブを探してクリックします。
    5. それぞれの権限(必要な権限については次の表を参照)を選択し、「webサービス経由でこの表へのアクセスを許可」チェック・ボックスが選択されていない場合は選択します。
      表名 権限
      sys_soap_message 読取り、作成、更新、削除
      sys_soap_message_function 読取り、作成、更新、削除
      sys_script 読取り、作成、更新、削除
  3. SOAPでinsertMultipleをサポートするために複数の挿入プラグインを有効にします。
    1. ServiceNowホームページで、「システム定義」を検索します。
    2. 「プラグイン」を選択します。
    3. 「複数のWebサービスの挿入」を見つけてクリックします。
    4. ステータスが非アクティブの場合は、Activate/Repairをクリックします。
  4. ServiceNow発信者IDを取得します。
    1. ServiceNowホームページで、「ユーザー管理」を検索し、「ユーザー」をクリックします。
    2. Usersページで、ステップ1で前に構成したカスタム・ユーザーを選択します。
    3. ユーザーを選択したときに表示されるURLでsys_idの値を見つけます。
    4. sys_id値は、Oracle Integrationでルックアップ表の構成時に指定する必要があるため、注意してください。

また、新しいServiceNowインシデント用に作成されるBoxフォルダのIDを格納するカスタム・フィールドも作成する必要があります。 「ボックス・フォルダIDのカスタム・フィールドの作成」を参照してください。

ボックス・フォルダIDのカスタム・フィールドの作成

このレシピでは、Boxのフォルダに関連付けられた一意のIDを使用して、ServiceNowインシデントのBoxフォルダを作成します。 BoxフォルダIDを保持するServiceNowインシデントのカスタム・フィールドを作成します。

  1. ServiceNow | Developerインスタンスにログインします。
  2. 左側のナビゲーション・ペインで、フィルタ・ナビゲータ・フィールドにIncidentと入力します。
    セルフサービス・メニューには、「インシデント」に関連するすべてのモジュールが表示されます。
  3. セルフサービス・メニューで、「インシデント」をクリックします。
  4. インシデント・ウィンドウで、「新規」をクリックします。
  5. 「インシデント」メニューの使用可能なオプションから「構成」をクリックし、「表」をクリックします。
  6. 「名前」や「ラベル」などの必須フィールドに入力します。
  7. 「列」タブをクリックし、「新規」をクリックして新しい表の列を作成します。
  8. 「タイプ」フィールドでStringを検索し、検索結果から「文字列」を選択します。
  9. 次の詳細を入力します:
    1. 「列ラベル」フィールドに列ラベルを入力します。 たとえば、box_Idです。
    2. 「列名」フィールドに列名を入力します。 たとえば、u_box_idです。
    3. 「最大長」フィールドに値を入力します。 たとえば、255です。
  10. 「送信」をクリックします。

Boxの構成

Oracle IntegrationからBoxに接続し、Boxの右親フォルダの下に新しいServiceNowインシデントのフォルダを作成するには、次の前提条件タスクを完了する必要があります。

  1. Boxアプリケーションを作成および構成します。
    1. Box Developerコンソール(https://developer.box.com)にログインします。
    2. カスタム・アプリケーションを作成します。
      1. 「Create New App」をクリックします。
      2. 表示されるページで、アプリケーション・タイプを選択し、「カスタム・アプリ」を選択します。
      3. 「カスタム・アプリ」ダイアログで、オプション「ユーザー認証(OAuth 2.0)」を選択します。
      4. 「アプリケーション名」フィールドにアプリケーションの一意の名前を入力します。

      5. 「アプリケーションの作成」をクリックします。

        Boxアプリケーション構成ページが表示されます。

    3. OAuth 2.0資格証明を取得します。
      1. Boxアプリケーションの構成ページで、「OAuth 2.0資格証明」セクションまでスクロールします。
      2. 「クライアントID」フィールドからクライアントIDをコピーし、「クライアント・シークレット」フィールドからクライアント・シークレットをコピーします。
      3. クライアントIDとシークレットに注意してください。 これらは、後でOracle IntegrationからBox接続を構成するときに必要になります。
    4. リダイレクトURLを指定します。
      1. Boxアプリケーションの構成ページで、「OAuth 2.0リダイレクトURI」セクションまでスクロールします。

      2. 「リダイレクトURI」フィールドに、Oracle IntegrationインスタンスのOAuthコールバックURLを入力します。 リダイレクトURIの構文は次のとおりです: 

        https://Oracle-Integration-instance's-FQDN:443/icsapis/agent/oauth/callback

        ここで、Oracle-Integration-instance's-FQDNは、Oracle Integrationインスタンスの完全修飾ドメイン名です(たとえば、 oicinstance.example.com)。

    5. シグネチャ・キーを取得します。
      1. ページ上部の「Webフック」タブをクリックします。
      2. 「キーの生成」をクリックして、主キーとセカンダリ・キーを生成します。
      3. 主キーとセカンダリ・キーをコピーします。

      4. 主キーとセカンダリ・キーの値に注意してください。 これらは、後でOracle IntegrationからBox接続を構成するときに必要になります。

        シグネチャ・キーの詳細は、「Oracle Integration 3でのBoxアダプタの使用」の「シグネチャ・キーの取得」を参照してください。

  2. Boxで親フォルダを作成します。
    Boxで親フォルダを作成する必要があります。 新しいServiceNowインシデントのすべてのフォルダが、この親フォルダの下に作成されます。
    1. https://account.box.com/loginでBoxアカウントにログインします。
    2. 「すべてのファイル」ページの右上にある「新規」をクリックします。
    3. 表示されるメニューから、「フォルダ」をクリックします。
    4. 「新規フォルダの作成」ダイアログで、「フォルダ名」フィールドに適切な名前を入力します。
    5. オプションで、他のユーザーがフォルダにアクセスできるようにするには、「追加担当の招待」フィールドにその電子メール・アドレスを入力します。 各電子メール・アドレス間にカンマを使用します。
      他のユーザー・アクセス・レベルを制御するには、「権限」フィールドのドロップダウン・リストから適切なロール(共同所有者、エディタ、ビューアなど)を選択します。 ロールとその機能を確認するには、フィールドの横にある「詳細」をクリックします。
    6. 「作成」をクリックします。
      フォルダが作成され、「すべてのファイル」ページに表示されます。
  3. 親フォルダIDを取得します。
    Boxで親フォルダのIDを取得し、それをOracle Integrationの統合プロパティに渡して、新しいServiceNowインシデントのフォルダが適切な親フォルダの下に作成されるようにする必要があります。
    1. Boxインスタンスの「すべてのファイル」ページで、作成した親フォルダを検索して検索します。
    2. 親フォルダにマウスを置きます。
    3. ページの左側に表示されるリンクに注意してください。 たとえば、https://app.box.com/folder/135666632045です。
    4. リンクの最後のスラッシュ(/)の後ろにある数字はフォルダIDです。 フォルダIDを書き留めます。 これは、後でOracle Integrationの統合プロパティを更新するときに使用します。