ServiceNowのインシデントを更新する

Table API を使用して、ServiceNow の既存のインシデントを更新します。

認証のセットアップについては、ServiceNow インシデントアクションを参照してください。

入力フィールド	オプション性	タイプ	説明	例
ドメイン	必須	弦	ServiceNow インスタンスのドメイン。ベースURL `your-domain.service-now.com` を構築するために使用されます。	`"your-domain"`
apiKey	必須	弦	認証用のServiceNow REST APIキー。 `x-sn-apikey` リクエストヘッダーとして渡されます。シークレットとして提供する必要があります。	`"${{ :secrets:serviceNowApiKey }}"`
sysId	必須	弦	更新するインシデントの一意のシステムID。32文字の英数字文字列である必要があります（UUID形式は不可）。	`"fa7616894723b210f89ff3ac416d43c2"`
フィールド	必須	地図	ServiceNowインシデントで更新するインシデントフィールド。以下のフィールドリファレンス表を参照してください。	`"{\"short_description\": \"Updated incident description\", \"state\": \"2\", \"work_notes\": \"Investigating the issue\", \"assigned_to\": \"john.doe\", \"priority\": \"2\"}"` サンプルオブジェクトについては、JSON オブジェクト形式を参照してください。
パラメーター	オプション	地図	ServiceNow APIリクエスト用のオプションのURLクエリパラメーター。APIレスポンスのフォーマットと内容を制御します。以下のパラメーターリファレンス表を参照してください。	`"{\"sysparm_fields\": \"name,short_description\", \"sysparm_exclude_reference_link\": \"true\", \"sysparm_input_display_value\": \"false\", \"sysparm_display_value\": \"true\"}"` 受け入れられるパラメーターのリストについては、now_table_api_latest_spec.json または OpenAPI 仕様へのエクスポートを参照してください。
セレクター	オプション	リスト		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

共通 URL パラメーターリファレンス

パラメータ	タイプ	説明	デフォルト
sysparm_fields	弦	レスポンスで返すフィールドのカンマ区切りのリスト。
sysparm_exclude_reference_link	弦	`true` または、レスポンスから参照リンクを除外するには `false` を指定します。	`false`
sysparm_display_value	弦	`true` 、 `false` 、または `all` を使用して、実際の値の代わりに表示値を返します。	`false`
sysparm_input_display_value	弦	`true` または `false` 。 `true` の場合、実際の値の代わりに表示値を使用してフィールド値を設定します。	`false`
sysparm_suppress_auto_sys_field	弦	`true` または `false` 。 `true` の場合、システムフィールドの自動生成を抑制します。	`false`
sysparm_view	弦	特定のUIビューに従ってレスポンスをレンダリングします。 `sysparm_fields` によってオーバーライドされました。	`default`
sysparm_query_no_domain	弦	`true` または `false` 。 `true` の場合、承認されていればドメイン間のデータへのアクセスを許可します。	`false`

incidentData フィールドリファレンス

フィールド	タイプ
short_description	弦
description	弦
caller_id	弦
カテゴリ	弦
サブカテゴリ	弦
緊急	弦
影響	弦
プライオリティ	弦
assignment_group	弦
assigned_to	弦
ステート	弦
contact_type	弦
business_service	弦
cmdb_ci	弦
コメント	弦
work_notes	弦
opened_by	弦
opened_at	弦
correlation_id	弦
correlation_display	弦
close_code	弦
クローズノート	弦
resolved_by	弦
resolved_at	弦

出力フィールド	タイプ	例
response	オブジェクト	`{ "result": { "number": "INC0019382", "sys_id": "ed59ab193b67ba10e811026aa5e45a2d", "short_description": "The server is on fire.", "description": "The server is on fire." "priority": "3" } }`
成功	ブール値	`success: true \| false`
エラーメッセージ	弦	`[ { "success": false, "errorMessage": "{\"error\":{\"message\":\"User Not Authenticated\",\"detail\":\"Required to provide Auth information\"},\"status\":\"failure\"}" } ]`

出力フィールド

タイプ

例

response

オブジェクト

{
"result": {
    "number": "INC0019382",
    "sys_id": "ed59ab193b67ba10e811026aa5e45a2d",
    "short_description": "The server is on fire.",
    "description": "The server is on fire."
    "priority": "3"
}
}

成功

ブール値

success: true | false

エラーメッセージ

弦

[
  {
    "success": false,
    "errorMessage": "{\"error\":{\"message\":\"User Not Authenticated\",\"detail\":\"Required to provide Auth information\"},\"status\":\"failure\"}"
  }
]

ワークフローの例
name: create-servicenow-update description: to update a incident in ServiceNow steps: - type: action name: updateIncident action: serviceNow.incident.update version: 1 inputs: domain: "your-domain" apiKey: "${{ :secrets:serviceNowApiKey }}" sysId: "ed59ab193b67ba10e811026aa5e45a2d" fields: short_description: "Test incident from New Relic WFA" assigned_to: "npitchuka" contact_type: "slack" parameters: sysparm_display_value: "true" sysparm_fields: "number,short_description,description,priority,sys_id" selectors: - name: sysId expression: .responseBody.result.sys_id next: end

ワークフローの例

name: create-servicenow-update
description: to update a incident in ServiceNow

steps:
  - type: action
    name: updateIncident
    action: serviceNow.incident.update
    version: 1
    inputs:
      domain: "your-domain"
      apiKey: "${{ :secrets:serviceNowApiKey }}"
      sysId: "ed59ab193b67ba10e811026aa5e45a2d"
      fields: 
        short_description: "Test incident from New Relic WFA"
        assigned_to: "npitchuka"
        contact_type: "slack"
      parameters:
        sysparm_display_value: "true"
        sysparm_fields: "number,short_description,description,priority,sys_id"
      selectors:
        - name: sysId
          expression: .responseBody.result.sys_id
    next: end

この機械翻訳は、参考として提供されています。

ServiceNowのインシデントを更新する

共通 URL パラメーターリファレンス

incidentData フィールドリファレンス