Criar um incidente do ServiceNow

Cria um novo incidente 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"`
Descrição curta	Obrigatório	Corda	Breve descrição do incidente.	`"Test Incident"`
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 }}"`
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 Exportar para a especificação OpenAPI para obter uma lista de parâmetros aceitos.
campos	Opcional	Mapa	Campos adicionais de incidente para incluir no corpo da solicitação. Todos os campos são mesclados com `shortDescription`. Consulte a tabela de referência de campos abaixo.	`"{\"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\"}"` Consulte o formato de objeto JSON para ver um objeto de exemplo.
seletores	Opcional	Lista		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

Referência de parâmetros

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`

Referência de campos

Campo	Tipo
descrição_curta	Corda
descrição	Corda
caller_id	Corda
categoria	Corda
subcategoria	Corda
urgência	Corda
impacto	Corda
prioridade	Corda
assignment_group	Corda
atribuído_a	Corda
estado	Corda
contact_type	Corda
business_service	Corda
cmdb_ci	Corda
comentários	Corda
aberto_por	Corda
opened_at	Corda
correlation_id	Corda
correlation_display	Corda

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: 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

Exemplo de fluxo de trabalho

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

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

Referência de parâmetros

Referência de campos