機械翻訳について

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

Oracle Integrationを使用してこれらの外部システムに正常に接続し、Slackで通知メッセージをポストするには、SlackおよびServiceNowインスタンスに対して次の構成タスクを実行する必要があります。

ServiceNowの構成

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

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

Slackの構成

Oracle Integrationを使用して正常に接続し、通知メッセージを投稿するには、Slackインスタンスで次のタスクを実行します。

Slack WorkSpaceおよびチャネルの設定

  1. Slackにワークスペースを作成します。
    1. 次のURLを使用して、Slackスタート・ページを開きます:
      https://slack.com/get-started#/createnew
    2. 電子メールを入力し、「続行」をクリックします。
    3. 電子メールで受信する確認コードを入力し、「ワークスペースの作成」をクリックして、プロンプトに従います。
  2. 通知を投稿するチャネルを作成します。
    1. Slackインスタンスで、ワークスペースを選択します。
    2. 左側のナビゲーション・ペインでワークスペース名をクリックし、表示されるメニューから「チャネルの作成」を選択します。
    3. 「チャネルの作成」ダイアログで、チャネルの名前を「名前」フィールドに入力します。 たとえば、#incident-creationです。
    4. オプションで、「説明」フィールドに適切な説明を入力して、チャネルについて他のユーザーに知らせます。 例: このチャネルは、インシデントがServiceNowに作成されるたびに通知します。
    5. 「作成」をクリックします。
      前述のステップを繰り返して、4つのチャネルを作成します。
      • ServiceNowアセット作成通知(#asset-creation)を投稿するチャネル。
      • ServiceNowインシデント作成通知(#incident-creation)を投稿するチャネル。
      • ServiceNowリクエスト作成通知(#request-creation)をポストするチャネル。
      • ServiceNowリクエスト・クローズ通知(#request-closure)をポストするチャネル。
  3. チャネルにユーザーを追加します。
    1. Slackワークスペースで、左側のナビゲーション・ペインからチャネルを選択して開きます。
    2. チャネルの右上にある「個人の追加」をクリックします。
    3. 結果のAdd people(個人の追加)ダイアログで、指定されたフィールドに名前、Eメールまたはユーザー・グループを入力します。
    4. 「追加」をクリックします。

    4つのチャネルに対して前述のステップを繰り返します。

SlackチャネルIDの取得

Slackワークスペースで作成したチャネルのチャネルIDを取得する必要があります。 チャネルIDを使用して、Oracle Integrationで統合プロパティを構成し、通知が適切なSlackチャネルに送信されるようにします。

  1. Slackワークスペースで、左側のナビゲーション・ペインの「チャネル」の下にあるチャネルに移動します。
  2. チャネル名を右クリックします。
  3. 表示されるメニューで、「リンクをコピー」をクリックします。
  4. リンクをノート帳などのテキスト・エディタにコピーします。
  5. リンクの最後のスラッシュ(/)の後の9文字に注意してください。 これは、SlackチャネルのチャネルIDです。 チャネルIDには文字と数字の組合せを指定できます。 たとえば、CB64YSB2Dです。

4つのSlackチャネルすべてについて前述のステップを繰り返して、チャネルIDを取得します。

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

Slackアプリケーションを作成し、アセット、インシデントまたはリクエストが作成されたとき、およびリクエストがServiceNowでクローズされたときにOracle Integrationによって送信される通知を受信するように構成する必要があります。

  1. Slackアプリケーションを作成します。
    1. Slackアプリケーション・プラットフォーム(https://api.slack.com)にログインします。
    2. Slack APIタイトル・バーで、「アプリケーション」をクリックします。
    3. 「アプリケーションの作成」をクリックし、表示される「アプリケーションの作成」ダイアログで「最初から」を選択します。
    4. 「名前」アプリケーション&「ワークスペースの選択」ダイアログで、次の詳細を入力します。
      フィールド 入力する情報
      アプリケーション名 アプリケーションの名前を入力します。 たとえば、Oracle Integration Appです。
      ワークスペースを選択してアプリケーションを開発 ドロップダウン・リストからワークスペースを選択します。
    5. 「アプリケーションの作成」をクリックします。

      アプリケーションが作成され、その「基本情報」ページが表示されます。

  2. SlackアプリケーションAPI資格証明を取得します。
    1. アプリケーションの「基本情報」ページで、「アプリケーション資格証明」セクションまで下にスクロールします。
    2. 「クライアントID」フィールドのクライアントIDと、「クライアント・シークレット」フィールドのクライアント・シークレットに注意してください。 クライアントIDおよびシークレットであるこれらのAPI資格証明は、アプリケーションの作成時に自動的に生成されました。 これらは、後でOracle IntegrationからSlackインスタンスへの接続を構成するときに使用します。
  3. Slackアプリケーションの権限を設定します。
    1. 左側のメニューの「機能」で、「OAuth &権限」を選択します。
    2. OAuth &の権限ページで、「リダイレクトURL」セクションに移動します。
    3. 「新規リダイレクトURLの追加」をクリックし、Oracle IntegrationインスタンスのURLを入力します。 たとえば、https://your_instance_URL:443/icsapis/agent/oauth/callbackです。your_instance_URLは、Oracle IntegrationインスタンスのホストURLです。
    4. 「追加」をクリックし、「URLの保存」を次にクリックします。
    5. 「スコープ」セクションまでスクロールし、「ユーザー・トークン・スコープ」で「OAuthスコープの追加」をクリックします。
    6. 次のスコープを入力します:
      • channels:read
      • channels:write
      • chat:write
      • groups:read
      • groups:write
      • usergroups:write

      スコープを書き留めてください。 これらは、後でOracle IntegrationからSlackインスタンスへの接続を構成するときに使用します。

    7. [Enter]を押します。