1. Oracle Integration Generation 2スタート・ガイド
  2. レシピ・リファレンス
  3. Customer Relationship Management (CRM)レシピ
  4. ServiceNowインシデントのBoxフォルダの作成
  5. レシピをインストールする前に
機械翻訳について

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

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

  1. ServiceNowの構成
  2. Boxの構成

ServiceNowの構成

Oracle IntegrationでServiceNow接続を構成するときに、管理アカウント資格証明またはカスタム・アカウント資格証明を使用できます。

管理アカウントを使用しない場合は、カスタム統合ユーザーを作成し、必要なロールおよび権限をユーザーに割り当てます。 カスタム・ユーザーの作成の詳細は、「Oracle IntegrationとServiceNowアダプタの使用」の「接続を作成するための前提条件」を参照してください。

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

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

このレシピでは、Box内のフォルダに関連付けられた一意のIDを使用して、ServiceNowインシデント用の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に接続し、新しいServiceNowインシデントのフォルダをBoxの右親フォルダの下に作成するには、次の前提条件タスクを完了する必要があります。

  1. Boxアプリケーションの作成と構成
  2. Boxでの親フォルダの作成
  3. 親フォルダIDの取得

Boxアプリケーションの作成と構成

Boxプラットフォームでアプリケーションを作成し、Oracle IntegrationからBoxに正常に接続するように構成する必要があります。

  1. Box Developerコンソール(https://developer.box.com)にログインします。
  2. カスタム・アプリケーションを作成します。
    1. 「新しいアプリケーションを作成」をクリックします。
    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. ページの上部にあるWebhooksタブをクリックします。
    2. 「キーの生成」をクリックして、主キーおよびセカンダリ・キーを生成します。
    3. 主キーとセカンダリ・キーをコピーします。
    4. 主キーおよびセカンダリ・キーの値を書き留めます。 これらは、後でOracle IntegrationからBox接続を構成するときに必要です。
      シグネチャ・キーの詳細は、「Oracle Integrationでのボックス・アダプタの使用」の「シグネチャ・キーの取得」を参照してください。

Boxでの親フォルダの作成

Boxで親フォルダを作成する必要があります。 新しいServiceNowインシデントのすべてのフォルダがこの親フォルダの下に作成されます。

  1. Boxアカウントhttps://account.box.com/loginにログインします。
  2. 「すべてのファイル」ページの右上にある「新規」をクリックします。
  3. 表示されるメニューから、「フォルダ」をクリックします。
  4. 「新規フォルダ」の作成ダイアログで、「フォルダ名」フィールドに適切な名前を入力します。
  5. オプションで、他のユーザーがフォルダにアクセスできるようにするには、「追加担当の招待」フィールドにその電子メール・アドレスを入力します。 各電子メール・アドレス間にカンマを使用します。
    他のユーザー・アクセス・レベルを制御するには、「権限」フィールドのドロップダウン・リストから適切なロール(共同所有者、エディタ、ビューアなど)を選択します。 ロールとその機能を確認するには、フィールドの横にある「詳細」をクリックします。
  6. 「作成」をクリックします。
フォルダが作成され、「すべてのファイル」ページに表示されます。

親フォルダIDの取得

新しいServiceNowインシデントのフォルダが適切な親フォルダの下に作成されるように、Box内の親フォルダのIDを取得し、それをOracle Integrationの統合プロパティに渡す必要があります。

  1. Boxアカウントhttps://account.box.com/loginにログインします。
  2. Boxインスタンスの「すべてのファイル」ページで、作成した親フォルダを検索して検索します。
  3. 親フォルダにマウスを置きます。
  4. ページの左側に表示されるリンクに注意してください。 たとえば、https://app.box.com/folder/135666632045
  5. リンクの最後のスラッシュ(/)の後ろにある数字はフォルダIDです。 フォルダIDを書き留めます。 これは、後でOracle Integrationの統合プロパティを更新するときに使用します。