Crear un incidente de ServiceNow

Crea un nuevo incidente en ServiceNow usando la Table API.

Para la configuración de la autenticación, consulte las acciones de incidente de ServiceNow.

Campo de entrada	Opcionalidad	Tipo	Descripción	Ejemplo
dominio	Requerido	Cadena	Dominio de la instancia de ServiceNow. Se utiliza para construir la URL base `your-domain.service-now.com` .	`"your-domain"`
Descripción corta	Requerido	Cadena	Breve descripción del incidente.	`"Test Incident"`
apiKey	Requerido	Cadena	Clave de API REST de ServiceNow para autenticación. Se pasa como el encabezado de la solicitud `x-sn-apikey` . Se debe proporcionar como un secreto.	`"${{ :secrets:serviceNowApiKey }}"`
parámetro	Opcional	Mapa	Parámetros de consulta de URL opcionales para la solicitud de la API de ServiceNow. Controla el formato y el contenido de la respuesta de la API. Consulte la tabla de referencia de parámetros a continuación.	`"{\"sysparm_fields\": \"name,short_description\", \"sysparm_exclude_reference_link\": \"true\", \"sysparm_input_display_value\": \"false\", \"sysparm_display_value\": \"true\"}"` Consulte Exportar a la especificación de OpenAPI para ver una lista de parámetros aceptados.
campos	Opcional	Mapa	Campos adicionales del incidente para incluir en el cuerpo de la solicitud. Todos los campos se fusionan con `shortDescription`. Consulte la tabla de referencia de campos a continuación.	`"{\"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 el formato de objeto JSON para ver un objeto de muestra.
selectores	Opcional	Lista		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

Referencia de parámetros

Parámetro	Tipo	Descripción	Por defecto
sysparm_fields	Cadena	Lista de campos separados por comas para devolver en la respuesta.
sysparm_exclude_reference_link	Cadena	`true` o `false` para excluir los enlaces de referencia de la respuesta.	`false`
sysparm_display_value	Cadena	`true` , `false` o `all` para devolver valores de visualización en lugar de valores reales.	`false`
sysparm_input_display_value	Cadena	`true` o `false` . Cuando `true` , establece los valores de los campos usando su valor de visualización en lugar del valor real.	`false`
sysparm_suppress_auto_sys_field	Cadena	`true` o `false` . Cuando `true` , suprime la generación automática de campos del sistema.	`false`
sysparm_view	Cadena	Renderiza la respuesta según una vista de UI específica. Sobrescrito por `sysparm_fields` .	`default`

Referencia de campos

Campo	Tipo
descripción_breve	Cadena
descripción	Cadena
caller_id	Cadena
categoría	Cadena
subcategoría	Cadena
urgencia	Cadena
impacto	Cadena
prioridad	Cadena
assignment_group	Cadena
asignado_a	Cadena
estado	Cadena
contact_type	Cadena
servicio_de_negocio	Cadena
cmdb_ci	Cadena
comentarios	Cadena
abierto_por	Cadena
opened_at	Cadena
correlation_id	Cadena
visualización_de_correlación	Cadena

Campo de salida	Tipo	Ejemplo
response	Objeto	`{ "result": { "number": "INC0019382", "sys_id": "ed59ab193b67ba10e811026aa5e45a2d", "short_description": "The server is on fire.", .... .... } }`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena	`[ { "success": false, "errorMessage": "{\"error\":{\"message\":\"User Not Authenticated\",\"detail\":\"Required to provide Auth information\"},\"status\":\"failure\"}" } ]`

Campo de salida

Tipo

Ejemplo

response

Objeto

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

éxito

Booleano

success: true | false

mensaje de error

Cadena

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

Ejemplo de flujo de trabajo
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

Ejemplo de flujo de trabajo

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Referencia de parámetros

Referencia de campos