Перейти к содержимому
Все инструменты

servicenow_create_incident

ServiceNow · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Создает настоящий инцидент в подключенном экземпляре ServiceNow; тикет виден службе поддержки сразу после создания. Без confirm возвращается предварительный просмотр всех полей и ничего не отправляется; для создания передайте confirm=true. urgency по умолчанию равен 3 (Medium). Возвращает номер инцидента, его sys_id и ссылку на него. Чтобы дополнить существующий инцидент, используйте servicenow_add_comment или servicenow_update_incident, а не создавайте еще один.

Обязательные входные данные

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Каноническая техническая схема на английском — 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

Назначение

Создает инцидент в экземпляре ServiceNow, подключенном через connect_servicenow, используя сохраненные учетные данные. Без confirm=true ничего не отправляется: ответ содержит предварительный просмотр всех полей, потому что подтвержденный вызов заводит настоящий тикет в системе, с которой работают другие люди; покажите пользователю текст и получите его согласие до подтверждения. Отклоняется только пустой short_description; если urgency не указан, он равен 3. Наличие похожего открытого инцидента не проверяется, поэтому двойной вызов заводит два инцидента: сначала посмотрите через servicenow_search_incidents или servicenow_list_my_incidents. Ответ содержит номер инцидента и ссылку. Этот сервер не может удалить инцидент; чтобы изменить или закрыть его, передайте его sys_id (из servicenow_get_incident) в servicenow_update_incident.

Обязательные входные данные

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Каноническая техническая схема на английском — 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"
}

Пример для документации

Пример документации для servicenow_create_incident. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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