Obtener un incidente de ServiceNow

Obtiene un incidente existente de 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"`
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 }}"`
sysId	Requerido	Cadena	ID único del sistema del incidente a recuperar. Debe ser una cadena alfanumérica de 32 caracteres (no en formato UUID).	`"fa7616894723b210f89ff3ac416d43c2"`
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.
selectores	Opcional	Lista		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

Referencia de parámetros comunes de URL

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`
sysparm_query_no_domain	Cadena	`true` o `false` . Cuando `true` , permite el acceso a los datos entre dominios si está autorizado.	`false`

Campo de salida	Tipo	Ejemplo
response	Objeto	`{ "result": { "number": "INC0019382", "description": "The server is on fire.", "short_description": "The server is on fire.", "priority": "3" } }`
é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",
    "description": "The server is on fire.",
    "short_description": "The server is on fire.",
    "priority": "3"
}
}

é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: get-servicenow-incident description: to get a incident from ServiceNow steps: - type: action name: getIncident action: serviceNow.incident.get version: 1 inputs: domain: "your-domain" apiKey: "${{ :secrets:serviceNowApiKey }}" sysId: "ed59ab193b67ba10e811026aa5e45a2d" parameters: sysparm_fields: "number,short_description,description,priority" selectors: - name: sysId expression: .responseBody.result.sys_id next: end`

Ejemplo de flujo de trabajo

name: get-servicenow-incident
description: to get a incident from ServiceNow
steps:
  - type: action
    name: getIncident
    action: serviceNow.incident.get
    version: 1
    inputs:
      domain: "your-domain"
      apiKey: "${{ :secrets:serviceNowApiKey }}"
      sysId: "ed59ab193b67ba10e811026aa5e45a2d"
      parameters:
        sysparm_fields: "number,short_description,description,priority"
      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 comunes de URL