学ぶ (英語版)
ドキュメント (英語版)
サポート (英語のみ)
コミュニティ (英語版)

ServiceNow - インシデント管理コネクタThinklet

Configure ServiceNow - Incident management connector thinklets to take specific actions within your workflow;

操作: インシデントに影響を受けている構成アイテムを追加

インシデントに影響を受けている構成アイテムを追加は、インシデントチケットの影響を受けているCIタブにタスクエントリを追加します。

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPOST API エンドポイントに依存しています。

  • パラメーター: この操作に使用するエントリーパラメーターを設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータのマッピング方法と必要なデータについての詳細情報が表示されます。

    • インシデント番号またはID

    • 影響を受けている構成アイテム名またはID

  • 出力: コネクタThinkletの出力を表示します。

    • タスク構成アイテムレコードID (TaskCIRecordID)

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

api/now/table/task_ci

メソッド

POST

ペイロード

{"ci_item": "{{AffectedConfigurationItemRefernce}}","task": "{{IncidentReference}}"}

出力

タスクレコードID: $.result.sys_id

操作: インシデント作業ノートを追加

インシデント作業ノートを追加は、インシデントチケットに作業ノートを追加します。&#x20

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPATCH APIエンドポイントに依存しています。

image-20240604-120125.png

  • 名前: コネクタThinklet用の一意な名前を入力します。

  • ID: システムは名前に基づいてIDを自動的に生成します。

  • 説明（オプション）: コネクタThinkletの目的とその働きを説明してください。 この情報は、これを知らない他のワークフローユーザーにとって有用です。

  • 操作を選択: 実行する操作を選択してください。

  • 資格情報: 統合用の接続資格情報を選択してください。 まず、Administtrationモジュールのコネクタ資格情報ページでそれらを設定してください。 詳細については、コネクタ資格情報ドキュメントを参照してください。

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメーターがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • ServiceNowチケットID: ServiceNowチケットを追跡するための識別

    • デバイス名: デバイスの名前

    • 作業ノート: インシデント用に入力された作業ノートのテキスト

  • 出力: コネクタThinkletの出力を表示します。

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

/api/now/table/incident/{{ServiceNowTicketID}}

メソッド

PATCH

ペイロード

{"work_notes":"Device Name: {{DeviceName}}, {{WorkNote}}"}

出力

-

操作: インシデントの割り当てグループを変更

インシデントの割り当てグループを変更は、インシデントチケットの割り当てグループフィールドを入力パラメータで提供された値に更新します。&#x20

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPOST API エンドポイントに依存しています。

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • ServiceNowチケットID

    • ユーザーグループ名

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

api/now/table/incident/{{ServiceNowTicketID}}

メソッド

PATCH

ペイロード

{"assignment_group":"{{UserGroupName}}"}

出力

操作: インシデントを作成

インシデントを作成するは、新しいServiceNowインシデントチケットを作成します。&#x20

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPOST API エンドポイントに依存しています。

image-20240604-114738.png

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • デバイス名: デバイスの名前

    • ServiceNow割り当てグループ: インシデントのために設定されている割り当てグループ

    • ビジネスサービス: インシデントのために設定されているビジネスサービス

    • 通報者: インシデントのために設定されている通報者

    • 説明: インシデントのために設定される説明

    • 影響: インシデントの影響レベル 1- 高、2- 中、3- 低

    • 簡単な説明: インシデントのために設定される簡単な説明

    • 緊急度: インシデントの緊急度, 1- 高, 2- 中, 3- 低

  • 出力: コネクタThinkletの出力を表示します。

    • ServiceNowチケットID (ServiceNowTicketID): ServiceNowチケットID

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

/api/now/table/incident

メソッド

POST

ペイロード

{"assignment_group": "{{ServiceNowAssignmentGroup}}", "business_service": "{{BusinessService}}","caller_id": "{{Caller}}","description": "{{Description}}","impact": "{{Impact}}","short_description": "{{ShortDescription}}","urgency": "{{Urgency}}", "cmdb_ci": "{{DeviceName}}"}

出力

ServiceNowTicketID: $.result.sys_id

操作: ユーザーグループの詳細を名前で取得

ユーザーグループの詳細を名前で取得するは、グループ名を検索基準として使用してグループの詳細を取得します。&#x20

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPOST API エンドポイントに依存しています。

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • ユーザーグループ名: グループの名前

  • 出力: コネクタThinkletの出力を表示します。

    • グループID (GroupID)

    • デフォルト担当者 (DefaultAssignee)

    • グループメールアドレス (GroupEmailAddress)

    • グループ管理者ID (GroupManagerID)

    • グループ状態 (GroupStatus): グループがアクティブかどうか - true または false

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

api/now/table/sys_user_group?sysparm_query=name={{UserGroupName}}

メソッド

GET

ペイロード

出力

GroupStatus $.result[0].active

DefaultAssignee $.result[0].default_assignee

GroupEmailAddress $.result[0].email

GroupManagerID $.result[0].manager.value

操作: インシデントを解決

インシデントを解決するは、インシデントチケットの状態を解決済みに変更し、解決コードと解決ノートを更新します。&#x20

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPATCH API エンドポイントに依存しています。

image-20240604-121433.png

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • ServiceNowチケットID

    • 解決ノート: 解決の説明

    • 解決コード: チケットに記載される解決コード、例: 完全解決

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

/api/now/table/incident/{{ServiceNowTicketID}}

メソッド

PATCH

ペイロード

{"state":"6","close_code":"{{CloseCode}}","close_notes":"{{CloseNotes}}"}

出力

操作: インシデントを検索

インシデントを検索するは、検索文字列を検索基準として使用して既存のインシデントチケットを検索します。&#x20

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPOST APIエンドポイントに依存しています。

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • 検索クエリ: 結果をフィルタリングするために使用されるエンコードされたクエリ文字列

  • 出力: コネクタThinkletの出力を表示します。

    • ServiceNowチケットID (ServiceNowTicketID)

    • ServiceNowチケット番号 (ServiceNowTicketNumber)

    • 作成日 (SysCreatedOn)

    • IDで開かれた (OpenedByID)

    • 作成者 (CreatedBy)

    • 更新日 (UpdatedOn)

    • 更新者 (UpdatedBy)

    • 通報者ID (CallerID)

    • 状態 (State)

    • インシデント状態 (IncidentState)

    • 保留理由 (HoldReason)

    • 解決者 (ResolvedBy)

    • CMDB CI ID (CmdbCi): 構成管理データベース (CMDB) 構成アイテム (CI) ID

    • ビジネスサービスID (Business service ID)

    • 影響 (Impact)

    • ビジネス影響 (BusinessImpact)

    • 重大度 (Severity)

    • 優先度 (Priority)

    • 簡単な説明 (ShortDescription)

    • 解決日時 (ResolvedAt)

    • 再開時間 (ReopenedTime)

    • クローズコード (CloseCode)

    • 割り当てグループID (AssignmentGroupID)

    • チケットクラス名 (TicketClassName)

    • クローズ担当者 (ClosedBy)

    • 担当ID (AssignedToID)

    • SLA期限 (SlaDue)

    • 期限日 (DueDate)

    • カテゴリー (Category)

以下の例の検索文字列は、ワークフローユーザーによって作成されたインシデントチケットを取得します。 閉じた、解決済み、キャンセルされたステータスのインシデントを除外し、短い説明に workflow_name が含まれているものだけを含め、取得するレコードの数に制限を適用します。

入力パラメーターの例の検索文字列
state!=6^state!=7^state!=8^sys_created_by={{global.nexthink_workflow_user}}^short_descriptionLIKEworkflow_name&sysparm_limit=1

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

api/now/table/incident?sysparm_query={{SearchQuery}}

メソッド

GET

ペイロード

出力

AssignedToID $.result[0].assigned_to.value

AssignmentGroupID $.result[0].assignment_group.value BusinessImpact $.result[0].business_impact

Business service ID $.result[0].business_service.value

CallerID $.result[0].caller_id.value

Category $.result[0].category

CloseCode $.result[0].close_code

ClosedBy $.result[0].closed_by

CmdbCi $.result[0].cmdb_ci.value

DueDate $.result[0].due_date

HoldReason $.result[0].hold_reason

Impact $.result[0].impact Incident

State $.result[0].incident_state

ServiceNowTicketNumber $.result[0].number

OpenedByID $.result[0].opened_by.value Priority $.result[0].priority

ReopenedTime $.result[0].reopened_time

ResolvedAt $.result[0].resolved_at

ResolvedBy $.result[0].resolved_by

Severity $.result[0].severity

ShortDescription $.result[0].short_description

SlaDue $.result[0].sla_due

State $.result[0].state

TicketClassName $.result[0].sys_class_name

操作: インシデント状態を設定

インシデント状態を設定するは、インシデントチケットの状態コードを次のいずれかに変更します: 1- 新規、2- 進行中、7- 閉じた、8- キャンセル済み

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPATCH APIエンドポイントに依存しています。

image-20240604-122044.png

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • ServiceNowチケットID

    • 状態コード: 1- 新規, 2- 進行中, 7- 閉じた, 8- キャンセル済み

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

api/now/table/incident/{{ServiceNowTicketID}}

メソッド

PATCH

ペイロード

{"incident_state":"{{StateCode}}"}

出力

操作: インシデントを保留に設定

インシデントを保留に設定するは、インシデントチケットを保留にし、保留理由を更新します。&#x20

ServiceNow - インシデント管理コネクタThinkletは、テーブルインシデントPATCH APIエンドポイントに依存しています。

image-20240604-122509.png

  • パラメーター: この操作に使用するデータをパラメーターとして設定します。 ツールチップアイコンにカーソルを合わせることで、パラメータがどのようにマッピングされ、どのデータが必要かについての詳細情報が表示されます。

    • ServiceNowチケットID

    • 保留理由: 1- 呼び出し待ち, 2- 証拠待ち, 3- 問題待ち, 4- ベンダー待ち, 5- 変更待ち

The table below shows the API Service connector details needed when recreating the connector:

フィールド
値

リソースパス

api/now/table/incident/{{ServiceNowTicketID}}

メソッド

PATCH

ペイロード

出力

Last updated

Was this helpful?