ServiceNowインシデントの管理

ノート:

これらのレシピは、統合ストアのREST - ServiceNow | インシデントの管理パッケージで使用できます。 Oracleには、これらのレシピがサンプルとしてのみ用意されています。これらのレシピはガイダンスのみを目的としており、エラーがないことを保証するものではありません。これらのレシピはサポートされていません。

概要

RESTでのレシピの使用 - ServiceNow | Manage Incidents Package。次のことができます:

ServiceNowでのインシデントの作成
ServiceNowでのインシデントの更新
ServiceNow内のインシデントの削除

ServiceNowレシピを実行するには、ServiceNowへのアクセスに必要な詳細を使用して、Oracle ServiceNow接続を構成する必要があります。その後、RESTリクエストを介して統合をトリガーし、リクエスト・パラメータを指定できます。これにより、リクエストで指定されているServiceNowでインシデントを作成、更新または削除するためのServiceNowアダプタが起動されます。

Oracle REST ServiceNowインシデントの作成の場合、RESTリクエストとの統合をトリガーし、ペイロードのリクエスト・パラメータとしてincidentdescriptionを指定します。その後、ServiceNowアダプタが起動され、ServiceNowでインシデントが「作成」になります。インシデント番号とインシデントIDを含むレスポンスが返されます。
Oracle REST ServiceNow更新インシデントの場合、RESTリクエストとの統合をトリガーし、ペイロードのリクエスト・パラメータとしてincidentId、incidentStateおよびincidentUrgencyを指定します。その後、ServiceNowアダプタが起動され、ServiceNowでインシデントの詳細がupdatesになります。
Oracle REST ServiceNowのインシデントの削除で、RESTリクエストとの統合をトリガーし、ペイロードのリクエスト・パラメータとしてincidentIdを指定します。その後、ServiceNowアダプタが起動され、ServiceNowでインシデントの詳細が「削除」になります。

Integration Name 説明 RESTコマンドおよびペイロードの例

Integration Name	説明	RESTコマンドおよびペイロードの例
Oracle REST ServiceNowインシデントの作成	ServiceNowインスタンスにインシデントを作成します。	REST APIコマンド: `POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_SERVIC_CREATE_INCIDE/1.0/create` リクエスト・ペイロードの例: `{ "incidentdescription" : "Employee phone number missing" }` レスポンス・ペイロードの例: `{ "serviceNowNr": "INC0010031", "serviceNowSysId": "fe6a74e62f503010f129811df699b6e7" }`
Oracle REST ServiceNow更新インシデント	ServiceNowインスタンスのインシデントを更新します。	REST APIコマンド: `POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_SERVIC_UPDATE_INCIDE/1.0/update` リクエスト・ペイロードの例: `{"incidentId":"bec4ce452f603010f129811df699b6cc","incidentState":"2","incidentUrgency":"2"}` リクエスト・パラメータ`incidentState`および`incidentUrgency`の有効な値に注意してください: `incidentState` 1 =新規 2 =進行中 3 =保留中 6 =解決済 7 =クローズ 8 =取消済 `incidentUrgency` 1 = 高 2 = 中 3 = 低レスポンス・ペイロードの例: `{ "incidentStatus": "bec4ce452f603010f129811df699b6cc" }`
Oracle REST ServiceNowインシデントの削除	ServiceNowインスタンスのインシデントを削除します。	REST APIコマンド: `POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_SERVIC_DELETE_INCIDE/1.0/delete` リクエスト・ペイロードの例: `{"incidentId":"fe6a74e62f503010f129811df699b6e7"}` レスポンス・ペイロード: `{ "status": "1" }`

Oracle REST ServiceNowインシデントの作成

ServiceNowインスタンスにインシデントを作成します。

REST APIコマンド:

POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_SERVIC_CREATE_INCIDE/1.0/create

リクエスト・ペイロードの例:

{ "incidentdescription" : "Employee phone number missing" }

レスポンス・ペイロードの例:

{
    "serviceNowNr": "INC0010031",
    "serviceNowSysId": "fe6a74e62f503010f129811df699b6e7"
}

Oracle REST ServiceNow更新インシデント

ServiceNowインスタンスのインシデントを更新します。

REST APIコマンド:

POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_SERVIC_UPDATE_INCIDE/1.0/update

リクエスト・ペイロードの例:

{"incidentId":"bec4ce452f603010f129811df699b6cc","incidentState":"2","incidentUrgency":"2"}

リクエスト・パラメータincidentStateおよびincidentUrgencyの有効な値に注意してください:

incidentState

1 =新規
2 =進行中
3 =保留中
6 =解決済
7 =クローズ
8 =取消済

incidentUrgency

1 = 高
2 = 中
3 = 低

レスポンス・ペイロードの例:


{
    "incidentStatus": "bec4ce452f603010f129811df699b6cc"
}

Oracle REST ServiceNowインシデントの削除

ServiceNowインスタンスのインシデントを削除します。

REST APIコマンド:

POST: https://<host:port>/ic/api/integration/v1/flows/rest/ORCL-R-REST_SERVIC_DELETE_INCIDE/1.0/delete

リクエスト・ペイロードの例:

{"incidentId":"fe6a74e62f503010f129811df699b6e7"}

レスポンス・ペイロード:

{
    "status": "1"
}

システムおよびアクセスの要件

Oracle Integration
ServiceNow

レシピのインストール、構成および実行

レシピのインストール、構成および実行の詳細は、「統合アクセラレータおよびレシピの開始」を参照してください。

RESTでレシピを使用するには - ServiceNow | Manage Incidentsパッケージでは、Oracle REST接続およびOracle ServiceNow接続を構成する必要があります。これらの接続を構成する必要があるのは一度だけです。パッケージ内のすべてのレシピで同じ接続を使用します。

接続名	パラメータ
Oracle REST接続	接続の詳細はすでに構成されています。接続をテストして保存します。
Oracle ServiceNow接続	接続プロパティ ServiceNowインスタンス名: ServiceNowインスタンスのURLを入力します。セキュリティセキュリティ・ポリシー: デフォルトでは、Basic認証ポリシーのみがサポートされます。ユーザー名: ServiceNowインスタンスに接続するためのユーザー名を入力します。パスワード: ServiceNowインスタンスに接続するためのパスワードを入力します。詳細は、「ServiceNowアダプタ接続の作成」 (「Oracle IntegrationとServiceNowアダプタの使用」)を参照してください。

接続名

パラメータ

Oracle REST接続

接続の詳細はすでに構成されています。接続をテストして保存します。

Oracle ServiceNow接続

接続プロパティ

ServiceNowインスタンス名: ServiceNowインスタンスのURLを入力します。

セキュリティ

セキュリティ・ポリシー: デフォルトでは、Basic認証ポリシーのみがサポートされます。
ユーザー名: ServiceNowインスタンスに接続するためのユーザー名を入力します。
パスワード: ServiceNowインスタンスに接続するためのパスワードを入力します。

詳細は、「ServiceNowアダプタ接続の作成」 (「Oracle IntegrationとServiceNowアダプタの使用」)を参照してください。