Operaciones de incidencia

Las operaciones de incidencia se pueden utilizar con cualquier tipo de objeto para el script.

El objeto contiene los datos de incidencias y los métodos de ayudante adicionales. Los datos de incidencias solo contienen datos de campos de incidencias; no contienen sus notas, tareas, objetivos, artefactos o adjuntos.

Escriba incident. para acceder a los datos de un campo de incidencia específico o para ejecutar un método de ayuda. Los nombres de campo y los métodos de ayudante aparecen en un cuadro de tecleo anticipado a medida que escribe.

Nota: Al cambiar el estado de un campo de incidencia, utilice 'C', 'A' u 'O' en lugar de Cerrado, Activo u Abierto, respectivamente. Por ejemplo, utilice

"incident.plan_status = 'C'"

en lugar de

"incident.plan_status = 'Closed'"

En la tabla siguiente se describen los métodos del ayudante.

Operación	Descripción
`addArtifact(type, value, description)`	Añade un artefacto a la incidencia con el tipo, valor y descripción dados. Devuelve un objeto de script Artefacto para una mayor personalización.
`addEmailAttachment(id) addEmailAttachment(id, filename, content_type)`	Adjunta el archivo adjunto de correo electrónico a la incidencia y devuelve el objeto de archivo adjunto a la incidencia. A continuación, otras operaciones de script pueden actuar en el objeto de archivo adjunto devuelto. Consulte el final de esta tabla para obtener más información.
`addMilestone(title, description, date)`	Añade un objetivo a la incidencia con el título dado, descripción y fecha. Devuelve un objeto de script Objetivo para una mayor personalización.
`addNote(text)`	Añade una nota a la incidencia con el texto dado. Devuelve un objeto de script Nota para una mayor personalización.
`addRow(name)`	Añade una fila a la tabla de datos definida en la incidencia. Devuelve un objeto de script Fila para una mayor personalización.
`addTask(name, phase_id, instr_text)`	Añade una tarea ad hoc a la incidencia con el nombre dado, fase e instrucciones. Devuelve un objeto de script Tarea para una personalización adicional.

El objeto de adjunto devuelto por addEmailAttachment(id) y addEmailAttachment(id, filename, content_type) define dos campos modificables: filename y content_type. addEmailAttachment(id) utiliza los valores de los campos suggested_filename y suggested_content_type del mensaje de correo electrónico para los valores de nombre de archivo y tipo de contenido, respectivamente, al crear el archivo adjunto del incidente. addEmailAttachment(id, filename, content_type) le permite especificar el nombre de archivo y los valores de content_type . Por ejemplo, si se utilizaran los valores presented_filename y presented_content_type en su lugar, se podrían especificar utilizando esta variación de firma de función.

El siguiente script es un ejemplo simple de adición de una fila a una tabla de datos, denominada infected_systems. Se da por supuesto que la tabla de datos incluye una columna Grupo de propietarios y una columna de ID. Cuando el script se invoca en una fila de la tabla de datos, toma el ID de dicha fila y añade 1 para convertirlo en un número exclusivo. A continuación, añade una nueva fila con la misma información, pero un ID actualizado y un valor diferente, HR, para el grupo propietario.

oldId = int(row.system_id)
newRow = incident.addRow("infected_systems")
newRow.updated(row)
newRow["system_id"] = str(oldId + 1)
newRow["owner_group"] = "HR"