servicenow_create_incident

ServiceNow · macOS · Windows

効果: 書き込み. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

接続済みの ServiceNow インスタンスに、実際のインシデントを作成します。チケットは作成された時点でサービスデスクから見えます。confirm なしで呼び出すとすべてのフィールドのプレビューを返し、何も送信しません。作成するには confirm=true を渡します。urgency の既定値は 3（Medium）です。インシデント番号、その sys_id、リンクを返します。既存のインシデントに追記するには、新しく作成せず servicenow_add_comment または servicenow_update_incident を使ってください。

必須入力

short_description

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — macOS

{
  "properties": {
    "category": {
      "description": "Incident category, e.g. 'software', 'hardware', 'network'",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to send; without it nothing is sent and the call returns a preview of every field.",
      "type": "boolean"
    },
    "description": {
      "description": "Full description of the issue",
      "type": "string"
    },
    "short_description": {
      "description": "Brief summary of the issue (required)",
      "type": "string"
    },
    "urgency": {
      "description": "1=Critical, 2=High, 3=Medium (default), 4=Low",
      "type": "string"
    }
  },
  "required": [
    "short_description"
  ],
  "type": "object"
}

ドキュメント例

servicenow_create_incident のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "confirm": false,
  "short_description": "Calendar search returns an empty result."
}

Windows

目的

connect_servicenow で接続した ServiceNow インスタンスに、保存された資格情報を使ってインシデントを作成します。confirm=true がない場合は何も送信されず、応答はすべてのフィールドのプレビューを示します。確認済みの呼び出しは、他の人が使うシステムに実際のチケットを登録するためです。確認する前に、ユーザーにテキストを見せて了承を得てください。拒否されるのは short_description が空白の場合のみで、urgency は省略すると 3 です。類似する未解決のインシデントは確認されないため、2 回呼び出すと 2 件登録されます。先に servicenow_search_incidents または servicenow_list_my_incidents で調べてください。応答にはインシデント番号とリンクが含まれます。このサーバーはインシデントを削除できません。変更や終了には、その sys_id（servicenow_get_incident から）を servicenow_update_incident に渡してください。

必須入力

short_description

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — Windows

{
  "properties": {
    "category": {
      "description": "e.g. software, hardware, network",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to send. Without it nothing is sent and the answer previews every field.",
      "type": "boolean"
    },
    "description": {
      "description": "Full description",
      "type": "string"
    },
    "short_description": {
      "description": "Brief summary (required)",
      "type": "string"
    },
    "urgency": {
      "description": "1=Critical, 2=High, 3=Medium (default), 4=Low",
      "type": "string"
    }
  },
  "required": [
    "short_description"
  ],
  "type": "object"
}

ドキュメント例

{
  "confirm": false,
  "short_description": "Calendar search returns an empty result."
}