機械翻訳について

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

このレシピを実行する必要がある他のシステムを有効化および構成するには、次のステップを実行します:

1. ServiceNowの構成
2. Slackの構成

ServiceNowの構成

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

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

Slackの構成

Oracle Integrationを使用して正常に接続し、通知メッセージをポストするには、Slackインスタンスで特定のタスクを実行する必要があります。

1. Slack WorkSpaceおよびチャネルの設定
2. SlackチャネルIDの取得
3. Slackアプリケーションの作成と構成

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

Slackでワークスペースを設定し、ワークスペースでチャネルを作成し、特定の通知メッセージを受信するユーザーをチャネルに追加する必要があります。

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. 結果の「個人の追加」ダイアログで、指定されたフィールドに名前、Eメールまたはユーザー・グループを入力します。
   4. 「追加」をクリックします。
   4つのチャネルに対して前述のステップを繰り返します。

SlackチャネルIDの取得

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

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

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

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

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

1. Slackアプリケーションを作成します。
   1. https://api.slack.comにあるSlackアプリケーション・プラットフォームにログインします。
   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]を押します。