Atualizar um incidente do ServiceNow

Atualiza 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 atualizado. Deve ser uma string alfanumérica de 32 caracteres (não no formato UUID).	`"fa7616894723b210f89ff3ac416d43c2"`
campos	Obrigatório	Mapa	Campos do incidente a serem atualizados no incidente do ServiceNow. Consulte a tabela de referência de campos abaixo.	`"{\"short_description\": \"Updated incident description\", \"state\": \"2\", \"work_notes\": \"Investigating the issue\", \"assigned_to\": \"john.doe\", \"priority\": \"2\"}"` Consulte o formato de objeto JSON para ver um objeto de exemplo.
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`

Referência de campos do incidentData

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
work_notes	Corda
aberto_por	Corda
opened_at	Corda
correlation_id	Corda
correlation_display	Corda
close_code	Corda
notas_de_encerramento	Corda
resolved_by	Corda
resolved_at	Corda

Campo de saída	Tipo	Exemplo
response	Objeto	`{ "result": { "number": "INC0019382", "sys_id": "ed59ab193b67ba10e811026aa5e45a2d", "short_description": "The server is on fire.", "description": "The server is on fire." "priority": "3" } }`
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.",
    "description": "The server is on fire."
    "priority": "3"
}
}

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-update description: to update a incident in ServiceNow steps: - type: action name: updateIncident action: serviceNow.incident.update version: 1 inputs: domain: "your-domain" apiKey: "${{ :secrets:serviceNowApiKey }}" sysId: "ed59ab193b67ba10e811026aa5e45a2d" fields: short_description: "Test incident from New Relic WFA" assigned_to: "npitchuka" contact_type: "slack" 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-update
description: to update a incident in ServiceNow

steps:
  - type: action
    name: updateIncident
    action: serviceNow.incident.update
    version: 1
    inputs:
      domain: "your-domain"
      apiKey: "${{ :secrets:serviceNowApiKey }}"
      sysId: "ed59ab193b67ba10e811026aa5e45a2d"
      fields: 
        short_description: "Test incident from New Relic WFA"
        assigned_to: "npitchuka"
        contact_type: "slack"
      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 comuns de URL

Referência de campos do incidentData