機械翻訳について
  1. ServiceNow RESTコネクタ・インストレーションおよび構成ガイド
  2. コネクタのインストールおよび構成

2 コネクタのインストールおよび構成

この章では、ServiceNowコネクタおよび関連タスクを設定および構成するための次の情報を提供します:

前提条件

ServiceNowコネクタは、ServiceNow表REST APIを介して通信します。 ServiceNowコネクタを使用する前に、次の前提条件を満たしていることを確認してください:

  • ServiceNowユーザーは、"ITIL"ロールが適用された状態で存在します。

  • HTTPS用SSLの有効化の説明に従って、「Root Certificate Authority - Entrust.net Certification Authority (2048)」証明書を追加します

  • My Oracle Supportの優先資格証明が設定されていること。 資格証明を設定するには、次のステップを実行します。

    1. Enterprise Managerコンソールの「設定」メニューから「My Oracle Support」、「資格証明の設定」の順に選択します。

    2. ユーザー名とパスワード情報を入力し、「適用」をクリックします。

    3. Enterprise Managerコンソールの「設定」メニューから「拡張性」、「自己更新」の順に選択します。

    4. 「自己更新」ページで、表リストのServiceNow RESTチケット・コネクタを探します。 表示されていない場合は、次のステップに進みます。

    5. 次の図に示すように、「更新を確認」をクリックして、コネクタのメタデータを収集するジョブをスケジュールします。

      関連項目:

      詳細は、「Oracle Enterprise Manager Cloud Control管理者ガイド」の「自己更新の設定」セクションを参照してください。

      ノート:

      オフライン・モードで自己更新を設定することもできます。 詳細は、Oracle Enterprise Manager Cloud Control管理者ガイドのオフライン・モードでの更新の適用の項を参照してください。

      イメージは、Enterprise Managerの「自己更新」ページを示しています。

コネクタのインストール

この項では、コネクタをダウンロードしてインストール(適用)するために必要な手順を説明します。 ServiceNowコネクタは即時付属していないため、Oracle Enterprise Managerストアからダウンロードする必要があります。 Enterprise Managerストア内のすべてのコネクタは「自己更新」ページからダウンロードできます。

コネクタをインストールするには、次のようにします。

  1. Enterprise Managerコンソールの「設定」メニューから「設定」を選択し、「拡張性」、「自己更新」の順に選択します。

  2. 「タイプ」列の「管理コネクタ」リンクをクリックします。

    ServiceNowコネクタは、ステータスが使用可能のリストに表示されます。

  3. 適切なServiceNowコネクタをクリックして選択し、「ダウンロード」をクリックします。

    ダウンロードを実行する時期を決定できる「スケジュール・ダウンロード」ウィンドウが表示されます。

  4. すぐにダウンロードするには、「選択」をクリックします。

    後でダウンロードするようにスケジュールする場合は、ダウンロードを実施する日時を指定し、「選択」をクリックします。 その場合は、スケジュールしたダウンロード日時より後に、この手順に戻って残り部分を完了する必要があります。

  5. 必要に応じて、コネクタのステータスが「ダウンロード済」に変わるまで画面をリフレッシュします。

  6. ServiceNow RESTチケット・コネクタをクリックして選択し、「適用」をクリックします。

    操作の確認を求めるプロンプトに応答すると、リクエストが送信されたことを示すページが表示されます。

  7. コネクタのステータスが「適用スケジュール済み」から「適用」に変わるまで、画面をリフレッシュします。

コネクタ・インスタンスの作成

ServiceNowコネクタを使用するには、このコネクタ・タイプのインスタンスを1つ以上作成する必要があります。 コネクタ・インスタンスは、ServiceNowインスタンスのコネクタ名、ユーザー名、パスワードなど、特定の詳細を持つコネクタの構成済インスタンスを参照します。 同じコネクタ・タイプの複数のコネクタ・インスタンスがサポートされており、Enterprise Managerで複数のServiceNowインスタンスを柔軟に構成できます。

たとえば、Enterprise Managerは本番ターゲットおよびテスト・ターゲットを監視しているので、コネクタのインスタンスを2つ作成して、本番ターゲットのインシデントが1つめのコネクタ・インスタンスでチケットを作成し、テスト・ターゲットのインシデントが2つめのコネクタ・インスタンスでチケットを作成するようにEnterprise Managerを構成することができます。

コネクタ・インスタンスを作成するには、次の手順を実行します。

  1. Enterprise Managerコンソールで、「設定」をクリックします。

  2. ペインで拡張性を選択します。

  3. 左ペインで「管理コネクタ」を選択します。

  4. 「コネクタの作成」ドロップダウン・リストからコネクタ・タイプを選択して、実行ボタンをクリックします。

  5. 次の画面で、コネクタの名前と説明を入力し、「OK」をクリックします。

    コネクタ・インスタンスは、次の図に示すように、「管理コネクタ」ページに未構成として表示されます。

    図2-1 「管理コネクタ」ページ


    ServiceNow管理コネクタ・ページ

コネクタの構成

基本的な構成の場合、次のステップを実行します。

  1. スーパー管理者として、Enterprise Managerコンソールで「設定」をクリックします。

  2. 拡張性」、「管理コネクタ」の順にクリックします。

    「管理コネクタ」ページには、すべての作成済コネクタ・インスタンスのリストが表示されます。

    ノート:

    緑色のチェック・マークが付いたステータス列は、コネクタがすでに構成されていることを示します。

  3. ServiceNowの「構成」ボタンをクリックします。 「管理コネクタの構成」ページの「一般」タブが表示されます。

  4. 必要な設定を行います。 詳細は、「一般設定の指定」を参照してください。

  5. 「OK」をクリックします。

    「管理コネクタ」ページが再度表示されます。 次の図に示すように、ServiceNowコネクタの行にはステータス列にチェック・マークが付いている必要があります。


    イメージは、Enterprise Managerの管理コネクタ・ページと、テストが成功したという確信を示しています。

  6. オプション: ORACLE_HOME/binディレクトリからemctlコマンドを実行して、カスタマイズしたテンプレートを登録します。ここで、ORACLE_HOMEはOMSのOracleホーム・ディレクトリです。

    「チケット・テンプレート」タブをクリックすると、すべてのチケット・テンプレートを表示できます。

コネクタの有効化または無効化

システムからコネクタを再構成または削除することなく、コネクタ・インスタンスを有効または無効にできます。

「管理コネクタ」ページからコネクタを有効化または無効化するには、コネクタを選択し、「有効化」または「無効化」ボタンをクリックします。 コネクタを無効化すると、「ステータス」列に赤い十字アイコンが表示されます。 デフォルトでは、コネクタ・インスタンスが構成されるとすぐに有効になります。

ノート:

チケットの発行操作には、有効なコネクタのみを使用できます。

一般設定の指定

次の項では、次の図に示すように、「管理コネクタの構成」ページの一般タブに様々な構成の詳細を指定する方法について説明します。


「一般」タブの入力例を示します

接続設定

ServiceNowコネクタは、Webサービスを介してサービス・デスクと通信します。 必須フィールドはアスタリスク(*)で示されています。

  • 「WebServiceエンド・ポイント」- ServiceNowによって公開されたcreateTicket、updateTicketおよびgetTicketwebservicesのエンド・ポイント。 それぞれに、ServiceNowサブドメインで更新する必要があるサブドメインと呼ばれる変数があります。
  • 「ユーザー名」- ServiceNowへの接続に使用するアカウントのユーザー名。 これは、ServiceNowにアカウント・チケットが作成されます。
  • 「パスワード」- ServiceNowへの接続に使用するアカウントのパスワード。
  • 「インシデント番号」- ServiceNowシステムへの接続をテストする既存のチケットID。 このチケットを開く必要はありません。

Webコンソールの設定

インシデントのコンテキストでEnterprise Managerによって作成されたServiceNowチケットへのリンクをコネクタに提供する場合は、Webコンソール設定が必要です。

この機能を有効にするには、次のWebコンソールの設定を指定します。

  • 「webコンソールの有効化」- このボックスにチェックマークを入れると、Enterprise Managerのコンテキスト内でServiceNowインシデント・ページを起動できます。

  • 「ServiceNowサブドメイン」- ServiceNowアカウントのサブドメイン。

猶予期間

管理者は、猶予期間の有効と無効を切り替えたり、その値を構成したりできます。 デフォルトでは、猶予期間は無効になっています。 詳細は、猶予期間を参照してください。 この設定は、ServiceNowコネクタで処理されるすべてのインシデントに適用されます。 猶予期間の間隔には、任意の整数値として時間数を使用できます。 たとえば、1または2です。

再試行

「再試行」オプションを有効または無効にしたり、その間隔値を構成できます。 デフォルトでは、「再試行」は無効化されています。 詳細は、再試行を参照してください。 この設定は、ServiceNowコネクタ・プロセスのすべてのインシデントに適用されます。 再試行間隔には時間数を任意の整数値で使用できます。 たとえば、- 1または2です。

チケット・テンプレートの使用

Enterprise Managerでコネクタ・インスタンスを作成すると、関連するすべてのテンプレートをチケットの作成または更新操作に使用できます。 デフォルトのServiceNowテンプレートが3つあります:

  • serviceNowIncidentCreateAndUpdate.xsl
  • serviceNowCreateUpdateAndClose.xsl
  • serviceNowCreateUpdateAndResolve.xsl

ヒント:

これらのテンプレートの詳細情報は、「テンプレート・プロセス」を参照してください。

次の各項では、チケット・テンプレートの追加、表示、削除、および置換に関する情報を提供します。

チケット・テンプレートの追加

チケット・テンプレートはEnterprise Managerで認識される前に追加する必要があります。 コネクタは、コネクタ・インスタンスが作成されたときに自動的に登録される即時利用可能なテンプレートを提供します。 これらを編集する場合は、Enterprise Managerで直接編集できます。 ただし、新しいテンプレート(即時利用可能なテンプレート以外)を使用する必要がある場合は、emctlコマンドを使用して新しいテンプレートを登録する必要があります。 そうすれば、Enterprise Managerでテンプレートを編集できます。 詳細は、「テンプレートの編集」を参照してください。

テンプレートを追加して登録するには:

  1. emctlの実行権限と、チケット・テンプレートを読解する能力を持っていることを確認します。

  2. テンプレートごとに、次のemctl register_templateコネクタ・コマンドを実行します: 

    $ORACLE_HOME/bin/emctl register_template connector
[-t <template.xml>]
[-repos_pwd <repos password>]
[-cname <connectorName>]
[-iname <internalName>]
[-tname <templateName>]
[-ttype <templateType>]
[-d <description>]

    説明:

    -t           Template(full path)
-repos_pwd   Enterprise Manager Root (SYSMAN) Password
-cname       Connector Name
-iname       Template Internal Name
-tname       Template Name Displayed
-ttype       Template Type
             <templateType> 1 - inbound transformation
             <templateType> 2 - outbound transformation
             <templateType> 3 - XML outbound transformation
-d           Description

例2-1 テンプレートの登録

The following command adds a new outbound template (newTemplate.xsl) for a connector instance with the name ServiceNow Connector Instance:

emctl register_template connector
-t <template.xml>
-repos_pwd <repos password>
-cname "ServiceNow Connector Instance"
-iname "newTemplate"
-tname "newTemplateOutbound"
-ttype 2
-d "Demo template"

テンプレート・コードの表示

テンプレート・コードを表示するには、次の手順を実行します。

  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。

  2. 次の図に示すように、「テンプレート」タブを選択します。


    テンプレート・タブ

  3. テンプレートのXSLTコードを表示するには、テンプレート名か「表示」をクリックします。

チケット・テンプレートはXSLT形式です。 コードを理解するには、XSLTの基礎知識が必要です。

テンプレートの削除

テンプレートを削除するには、次の手順を実行します。

  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。

  2. 「テンプレート」タブを選択します。

  3. テンプレートを選択して「削除」をクリックします。

  4. 「はい」をクリックして削除操作を確認します。

ノート:

削除するテンプレートにインシデント・ルールが関連付けられている場合は、削除後、この特定のインシデント・ルールに対するチケット発行が機能しなくなります。

テンプレートの編集

既存のチケット・テンプレートを編集するには、次の手順を実行します:

  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。

  2. 「テンプレート」タブを選択します。

  3. テンプレートを選択して「編集」をクリックします。

  4. 必要に応じて「説明」および「テンプレート・コンテンツ」フィールドを編集し、「保存」をクリックします。

チケット・テンプレートが自動的に登録されます。 登録されているテンプレートを保存すると、リポジトリ内でテンプレートが更新されます。

テンプレートのリストア

テンプレートを編集またはカスタマイズした後、必要に応じて以前のデフォルト・コンテンツにリストアするには、次のステップを実行します。

ノート:

これまでに編集したりカスタマイズした即時利用可能なテンプレートをデフォルト値にリストアできます。

  1. コネクタ・インスタンスを選択し、「管理コネクタの構成」ページに移動します。

  2. 「テンプレート」タブを選択します。

  3. テンプレートを選択して「リストア」をクリックします。

  4. リストアするために表示される確認のページで「はい」をクリックします。

コネクタの削除

「管理コネクタ」ページから、コネクタを選択して「削除」ボタンをクリックすることにより、コネクタを削除できます。 コネクタを削除すると、関連付けられたすべてのインシデント・ルールがチケット発行操作用に構成されていない状態になります。

また、削除されたコネクタがそのコネクタ・タイプの唯一のコネクタ・インスタンスである場合は、対応するコネクタ・タイプも削除されます。

ノート:

前述のルールは、即時利用可能なコネクタ・タイプには適用されません。