Ir para o conteúdo
Todas as ferramentas

servicenow_create_incident

ServiceNow · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Cria um incidente real na instância do ServiceNow conectada; o ticket fica visível para o service desk assim que é criado. Chamada sem confirm, retorna uma prévia de todos os campos e não envia nada; passe confirm=true para criar. urgency é 3 (Medium) por padrão. Retorna o número do incidente, seu sys_id e um link para ele. Para acrescentar a um incidente existente, use servicenow_add_comment ou servicenow_update_incident em vez de criar outro.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para servicenow_create_incident. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Cria um incidente na instância do ServiceNow conectada com connect_servicenow, usando as credenciais armazenadas. Sem confirm=true, nada é enviado: a resposta traz uma prévia de todos os campos, porque uma chamada confirmada registra um ticket real em um sistema usado por outras pessoas; mostre o texto ao usuário e obtenha o aval dele antes de confirmar. Somente um short_description em branco é recusado; urgency é 3 quando omitida. Nada verifica se existe um incidente aberto semelhante, então chamar duas vezes registra dois: procure antes com servicenow_search_incidents ou servicenow_list_my_incidents. A resposta traz o número do incidente e um link. Este servidor não pode excluir um incidente; para alterar ou encerrar um, passe seu sys_id (de servicenow_get_incident) a servicenow_update_incident.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para servicenow_create_incident. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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