Criar uma auditoria com script

Versão de lançamento: Yokohama

Atualizado 30 de jan. de 2025

8 min. de leitura

Uma auditoria com script é uma auditoria cujas condições são definidas por um script.

Procedimento

Navegar até Tudo > Conformidade > Auditorias com Script > Auditorias.

Um tipo de auditoria Com script filtra a lista.
Clique em Novo.
Preencha o formulário (ver tabela).
Crie a auditoria com script.

O campo Executar este script inclui um script de exemplo contendo instruções sobre como executar a auditoria e gerar as tarefas de acompanhamento. Este campo é exibido somente quando você acessa auditorias do módulo Auditorias com script.

Clique em Enviar.

Script de exemplo:

/*
/////////////////////////////////////////////////////
/// This script works with Data Center Zones filter //
/////////////////////////////////////////////////////
 
var desiredFloorSpaceUsage = 30;		// Value to audit against
var assignToUser = '46d44a23a9fe19810012d100cca80666';	 // Beth Anglin
var assignToGroup = '8a5055c9c61122780043563ef53438e3';	// Hardware group
var taskMsg = 'See the audit results below for the discrepancies that must be addressed';
 
// API call to retrieve records based on the filter
var gr = new SNC.CertificationProcessing().getFilterRecords(current.filter);
 
// Loop over all records defined by the filter
while(gr.next()) {
	var sysId = gr.getValue('sys_id');	// Sys ID of audited record
	var floorSpaceInUse = gr.getValue('floor_space_in_use');	// Value to audit
 
	// Determine if certification condition passes or fails
	if (floorSpaceInUse < desiredFloorSpaceUsage) {
		var columnNameSpace = gr.floor_space_in_use.getLabel();	// String value of column audited against
 
		// Call create Follow on Task API and save the returned sys_id for use in logging audit result fail
		// Params: 
		// auditId - Sys id of the audit record executed
		// ciId Sys - id of the configuration item.  Empty string if not a cmdb ci
		// assignedTo - Sys id of user to assign task to.  Can be empty
		// assignmentGroup - Sys id of group to assign task to.  Can be empty
		// shortDescr - Short description for the Follow On Task.  Can be empty
		// Return value: Sys id of the created follow on task
		var followOnTask = new SNC.CertificationProcessing().createFollowOnTask(current.sys_id, sysId, assignToUser, '', taskMsg);
 
		// Call log failed result API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// followOnTask - Sys id of the follow on task associated with the audited record(@see auditedRecordId). Can be empty
		// columnDisplayName - Label of the column audited(ex. Disk space (GB)).  Can be empty
		// operatorLabel - Label of the operator used to audit the column(ex. is not empty, greater than). Can be empty
		// desiredValue - Desired value of the column.  Can be empty
		// discrepancyValue - Discrepancy value.  Can be empty
		// isCI - True, if audited record is a CI. False, otherwise.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty
		new SNC.CertificationProcessing().logAuditResultFail(current.sys_id, sysId, followOnTask, columnNameSpace, 'greater than', desiredFloorSpaceUsage, floorSpaceInUse, true);
	} else { // If certification condition pass, write a Audit Result Pass via API
		// Params:
		// auditId - Sys id of audit record executed
		// auditedRecordId - Sys id of the record audited
		// isCI - True, if audited record is a CI. False, otherwise.  Can be empty.
		// domainToUse - Sys domain of the "cert_audit" record.  Can be empty.
		new SNC.CertificationProcessing().logAuditResultPass(current.sys_id, sysId, true);
	}
}
*/

Tabela 1. Nova tabela de auditoria com script.
Campo	Descrição
Nome	Nome desta auditoria.
Filtro	Filtro a ser usado quando o tipo de auditoria for Com script. Este campo é obrigatório para auditorias com script, mas está oculto para todos os outros tipos de auditoria.
Modelo	[Obrigatório] Modelo a ser usado quando esta auditoria for executada. O tipo de auditoria filtra a lista de modelos disponíveis e somente as versões ativas do modelo estarão disponíveis para seleção. Este campo permanece oculto quando o tipo de auditoria é Com script.
Tabela	[Somente leitura] Exibe a tabela do modelo.
Criar tarefas	Cria tarefas de acompanhamento para correção de discrepâncias quando selecionado. Em uma auditoria com script, é possível criar a lógica de qualquer estado de tarefa usando verdadeiro para criar uma tarefa ou falso se nenhuma tarefa for criada. Por padrão, essa caixa de seleção está desmarcada (falso) em um novo registro de auditoria.
Tipo de atribuição	Uma lista de opções para selecionar como a auditoria atribui as tarefas de acompanhamento. Este campo fica visível apenas quando a caixa de seleção Criar tarefa é marcada. As opções são: Campo do usuário: defina um campo de referência do usuário na tabela que está sendo auditada. Por exemplo, escolha o usuário nomeado no campo Gerenciado por no registro com falha para executar as tarefas. Essa seleção exibe os campos Atribuído a e Atribuir a vazios. Se o campo de referência no registro estiver vazio, o valor no campo Atribuir a vazios será usado. Usuário específico: selecione um usuário específico para executar as tarefas. Essa seleção exibe o campo Usuário. Campo de grupo: selecione um campo de referência de grupo na tabela que está sendo auditada. Como exemplo, selecione o grupo Suporte no registro com falha para executar as tarefas. Esta seleção exibe os campos Atribuir ao grupo e Atribuir a vazios. Todos os membros do grupo do campo de referência no registro com falha são atribuídos às tarefas. Se o campo de referência no registro estiver vazio, o valor no campo Atribuir a vazios será usado. Grupo específico: selecione um grupo específico para executar as tarefas. Essa seleção exibe o campo Grupo. As tarefas são atribuídas a todos os membros do grupo selecionado.
Usuário	Refere-se ao usuário específico ao qual a auditoria atribui tarefas de acompanhamento. Esse campo está disponível nestas condições: O tipo de atribuição é definido como Usuário específico. Atribuir a vazios é definido como Criar tarefa atribuída, e o Tipo de atribuição é definido como Campo do usuário. Nota: Certifique-se de que o usuário especificado tenha a função de certificação.
Atribuir ao grupo	Refere-se ao campo de grupo que define a qual grupo esta auditoria atribui a tarefa de acompanhamento. Este campo estará disponível somente quando o Tipo de atribuição for Campo de grupo.
Grupo	Refere-se ao grupo específico ao qual a auditoria atribui tarefas de acompanhamento. Esse campo estará disponível somente quando o tipo de atribuição for Grupo específico e você selecionar Campo de grupo como o tipo de atribuição.
Atribuir a	Refere-se ao campo do usuário que define a qual usuário esta auditoria atribui a tarefa de acompanhamento. Esse campo estará disponível somente quando o Tipo de atribuição for Campo do usuário.
Atribuir a vazios	O comportamento a ser usado se o campo selecionado em Atribuir a ou Atribuir ao grupo estiver em branco no registro que está sendo auditado. Por exemplo, se for preciso atribuir uma tarefa de acompanhamento a um gerente, mas nenhum gerente foi identificado, o valor nesse campo determinará o que acontece. Esse campo é exibido apenas quando o Tipo de atribuição for Campo do usuário ou Campo de grupo. As seleções possíveis são: Não criar tarefa: nenhuma tarefa de acompanhamento é criada quando o campo Atribuir a ou Atribuir ao grupo está vazio. Criar tarefa não atribuída: crie uma tarefa de acompanhamento, mas não a atribua a nenhum usuário ou grupo. A tarefa pode ser atribuída manualmente mais tarde. Criar tarefa atribuída: crie uma tarefa de acompanhamento e atribua-a ao usuário ou ao grupo específico. Se você selecionou Campo do usuário como o tipo de atribuição, o campo Usuário ficará disponível. Se você selecionou o tipo de Campo de grupo, o campo Grupo ficará disponível. A auditoria cria automática tarefas de acompanhamento para todos os registros nos quais Atribuir a está preenchido, independentemente da sua seleção para Atribuir a vazios.
Descrição resumida	Breve descrição da finalidade da auditoria.
Descrição da tarefa	Descrição geral do trabalho necessário para as tarefas de acompanhamento criadas por esta auditoria. Todas as tarefas de acompanhamento criadas por esta auditoria herdam esta descrição.
Ativo	Ativa esta programação de auditoria e gera tarefas de acompanhamento na data e hora programadas. Desmarque a caixa de seleção para ocultar campos de programação no formulário (exceto Data da última execução) e não gerar tarefas de acompanhamento.
Executar	A frequência de execução da programação que gera a auditoria. Diariamente Semanalmente Mensalmente Periodicamente Uma vez Sob demanda
Dia	Se Executar for definido como Semanalmente, indicará o dia da semana em que a auditoria será executada. Se Executar for definido como Mensalmente, indicará o dia do mês em que a auditoria será executada. Se o dia for 29, 30 ou 31, para meses mais curtos, a auditoria será executada no último dia do mês.
Intervalo de repetição	Se Executar for definido como Periodicamente, a frequência de execução da auditoria será inserida no formato hora, dias ou ambos. Por exemplo, defina Dias como 10 e Horas como 14:00:00 para executar a auditoria a cada 10 dias às 14h.
Iniciando	Se Executar for definido como Periodicamente ou Uma vez, indicará a data e a hora em que a auditoria será executada.
Hora	Se Executar for definido como Diariamente, Semanalmente, Mensalmente ou Uma vez, indicará a hora do dia, no formato de 24 horas, em que a auditoria será executada.
Data da última execução	[Somente leitura] A última data e hora em que a auditoria foi executada, em sua programação regular ou manualmente. As visualizações de auditoria não atualizam esse campo.
Próxima execução programada	[Somente leitura] A próxima data e hora em que a auditoria será executada. O sistema recalcula esse campo quando você altera a programação.
Tipo de auditoria	[Somente leitura] O tipo atribuído à auditoria. O sistema seleciona o tipo de auditoria com base na aplicação a partir da qual a auditoria é criada e pode ser: Estado desejado Conformidade da arquitetura Compliance Com script
Executar este script	Script de auditoria a ser executado. Este campo estará disponível somente se o tipo de auditoria for Com script. O formulário Auditoria inclui um script de exemplo contendo instruções para executar a auditoria e gerar as tarefas de acompanhamento. Consulte Métodos de script para obter uma lista dos métodos fornecidos e os parâmetros aceitos.