Resolver um incidente do ServiceNow

Resolve um incidente existente no ServiceNow usando a Table API.

Para a configuração de autenticação, consulte as ações do ServiceNow Incident.

Campo de entrada	Opcionalidade	Tipo	Descrição	Exemplo
domínio	Obrigatório	Corda	Domínio da instância do ServiceNow. Usado para construir a URL base `your-domain.service-now.com` .	`"your-domain"`
apiKey	Obrigatório	Corda	Chave de API REST do ServiceNow para autenticação. Passado como o cabeçalho da requisição `x-sn-apikey` . Deve ser fornecido como um segredo.	`"${{ :secrets:serviceNowApiKey }}"`
sysId	Obrigatório	Corda	ID exclusivo do sistema do incidente a ser resolvido. Deve ser uma string alfanumérica de 32 caracteres (não no formato UUID).	`"fa7616894723b210f89ff3ac416d43c2"`
closeCode	Obrigatório	Corda	Código de encerramento do incidente. Consulte a tabela de referência de códigos de encerramento abaixo.	`"User error"`
closeNotes	Obrigatório	Corda	Notas de encerramento descrevendo como o incidente foi resolvido.	`"Issue resolved by restarting the service"`
resolvedAt	Opcional	Corda	Timestamp quando o incidente foi resolvido.	`"2024-03-11 10:30:00"`
resolvedBy	Opcional	Corda	Nome de usuário da pessoa que resolveu o incidente.	`"john.doe"`
parâmetro	Opcional	Mapa	Parâmetros de consulta de URL opcionais para a requisição da API do ServiceNow. Controla o formato e o conteúdo da resposta da API. Consulte a tabela de referência de parâmetros abaixo.	`"{\"sysparm_fields\": \"name,short_description\", \"sysparm_exclude_reference_link\": \"true\", \"sysparm_input_display_value\": \"false\", \"sysparm_display_value\": \"true\"}"` Consulte now_table_api_latest_spec.json ou Exportar para a especificação OpenAPI para obter uma lista de parâmetros aceitos.
seletores	Opcional	Lista		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

Referência de parâmetros comuns de URL

Parâmetro	Tipo	Descrição	Padrão
sysparm_fields	Corda	Lista de campos separados por vírgula a serem retornados na resposta.
sysparm_exclude_reference_link	Corda	`true` ou `false` para excluir links de referência da resposta.	`false`
sysparm_display_value	Corda	`true` , `false` ou `all` para retornar valores de exibição em vez de valores reais.	`false`
sysparm_input_display_value	Corda	`true` ou `false` . Quando `true` , define os valores dos campos usando seu valor de exibição em vez do valor real.	`false`
sysparm_suppress_auto_sys_field	Corda	`true` ou `false` . Quando `true` , suprime a geração automática de campos do sistema.	`false`
sysparm_view	Corda	Renderiza a resposta de acordo com uma visualização de interface específica. Sobrescrito por `sysparm_fields` .	`default`
sysparm_query_no_domain	Corda	`true` ou `false` . Quando `true` , permite o acesso a dados entre domínios, se autorizado.	`false`

Fechar referência a código

Código de fechamento
Duplicate
Erro do usuário
Erro conhecido
Nenhuma resolução fornecida
Resolvido pelo chamador
Resolvido por mudança
Resolvido por problema
Resolvido por solicitação
Solução fornecida
Solução alternativa fornecida

Campo de saída	Tipo	Exemplo
response	Objeto	`{ "result": { "number": "INC0019382", "sys_id": "ed59ab193b67ba10e811026aa5e45a2d", "short_description": "The server is on fire.", .... .... } }`
sucesso	Boleano	`success: true \| false`
mensagem de erro	Corda	`[ { "success": false, "errorMessage": "{\"error\":{\"message\":\"User Not Authenticated\",\"detail\":\"Required to provide Auth information\"},\"status\":\"failure\"}" } ]`

Campo de saída

Tipo

Exemplo

response

Objeto

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

sucesso

Boleano

success: true | false

mensagem de erro

Corda

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

Exemplo de fluxo de trabalho
`name: resolve-servicenow-incident description: to resolve a basic incident in ServiceNow steps: - type: action name: resolveIncident action: serviceNow.incident.resolve version: 1 inputs: domain: "your-domain" apiKey: "${{ :secrets:serviceNowApiKey }}" sysId: "a62bcdbd476b3610f89ff3ac416d4357" closeCode: "Duplicate" closeNotes: "Issue resolved by restarting the application server" resolvedAt: "2024-03-11 10:30:00" resolvedBy: "john.doe" parameters: sysparm_display_value: "true" next: end`

Exemplo de fluxo de trabalho

name: resolve-servicenow-incident
description: to resolve a basic incident in ServiceNow
steps:
  - type: action
    name: resolveIncident
    action: serviceNow.incident.resolve
    version: 1
    inputs:
      domain: "your-domain"
      apiKey: "${{ :secrets:serviceNowApiKey }}"
      sysId: "a62bcdbd476b3610f89ff3ac416d4357"
      closeCode: "Duplicate"
      closeNotes: "Issue resolved by restarting the application server"
      resolvedAt: "2024-03-11 10:30:00"
      resolvedBy: "john.doe"
      parameters:
        sysparm_display_value: "true"
    next: end

Esta tradução de máquina é fornecida para sua comodidade.

Referência de parâmetros comuns de URL

Fechar referência a código