ServiceNowのインシデントを作成する

Table API を使用して ServiceNow に新しいインシデントを作成します。

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

入力フィールド	オプション性	タイプ	説明	例
ドメイン	必須	弦	ServiceNow インスタンスのドメイン。ベースURL `your-domain.service-now.com` を構築するために使用されます。	`"your-domain"`
shortDescription	必須	弦	インシデントの簡単な説明。	`"Test Incident"`
apiKey	必須	弦	認証用のServiceNow REST APIキー。 `x-sn-apikey` リクエストヘッダーとして渡されます。シークレットとして提供する必要があります。	`"${{ :secrets:serviceNowApiKey }}"`
パラメーター	オプション	地図	ServiceNow APIリクエスト用のオプションのURLクエリパラメーター。APIレスポンスのフォーマットと内容を制御します。以下のパラメーターリファレンス表を参照してください。	`"{\"sysparm_fields\": \"name,short_description\", \"sysparm_exclude_reference_link\": \"true\", \"sysparm_input_display_value\": \"false\", \"sysparm_display_value\": \"true\"}"` 受け入れられるパラメーターのリストについては、OpenAPI 仕様へのエクスポートを参照してください。
フィールド	オプション	地図	リクエストボディに含める追加のインシデントフィールド。すべてのフィールドは`shortDescription`とマージされます。以下のフィールドリファレンス表を参照してください。	`"{\"description\": \"Detailed description\", \"urgency\": \"2\", \"impact\": \"2\", \"priority\": \"3\", \"assignment_group\": \"IT Support\", \"assigned_to\": \"john.doe\", \"category\": \"Software\", \"subcategory\": \"Application\", \"caller_id\": \"jane.smith\", \"contact_type\": \"email\", \"state\": \"1\", \"cmdb_ci\": \"web-server-01\"}"` サンプルオブジェクトについては、JSON オブジェクト形式を参照してください。
セレクター	オプション	リスト		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

パラメーターリファレンス

パラメータ	タイプ	説明	デフォルト
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`

フィールドリファレンス

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

出力フィールド	タイプ	例
response	オブジェクト	`{ "result": { "number": "INC0019382", "sys_id": "ed59ab193b67ba10e811026aa5e45a2d", "short_description": "The server is on fire.", .... .... } }`
成功	ブール値	`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.",
    ....
    ....
}
}

成功

ブール値

success: true | false

エラーメッセージ

弦

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

ワークフローの例
name: create-servicenow-incident description: to create a incident in ServiceNow steps: - type: action name: createIncident action: serviceNow.incident.create version: 1 inputs: domain: "your-domain" apiKey: "${{ :secrets:serviceNowApiKey }}" shortDescription: "Test incident from New Relic WFA" fields: description: "This is a test incident created from New Relic WFA using access token authentication." priority: "2" impact: "2" urgency: "2" assignment_group: "IT Support" assigned_to: "admin" contact_type: "email" 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-incident
description: to create a incident in ServiceNow
steps:
  - type: action
    name: createIncident
    action: serviceNow.incident.create
    version: 1
    inputs:
      domain: "your-domain"
      apiKey: "${{ :secrets:serviceNowApiKey }}"
      shortDescription: "Test incident from New Relic WFA"
      fields:
        description: "This is a test incident created from New Relic WFA using access token authentication."
        priority: "2"
        impact: "2"
        urgency: "2"
        assignment_group: "IT Support"
        assigned_to: "admin"
        contact_type: "email"
      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のインシデントを作成する

パラメーターリファレンス

フィールドリファレンス