Evento - Global

. Evento A API fornece métodos que habilitam a configuração e a obtenção de valores em um evento.

Esses eventos são enviados de um MID Server para a. ServiceNow instância. Para que você possa enviar eventos com sucesso, a conexão entre o. MID Server e o. ServiceNow a instância deve ser definida.

Use o. Evento API para adicionar/atualizar campos em um evento. Use o. SNeventSenderProvider API para instanciar um objeto remetente de evento. Em seguida, use o. IEventSender API para enviar o evento para um ServiceNow instância.

Você deve ativar o plug-in Gestão de eventos (com.glideapp.itom.snac) antes de tentar acessar esta API. O plug-in Gestão de eventos requer uma assinatura separada e deve ser ativado. Este plug-in inclui dados de demonstração e ativa plug-ins relacionados, caso ainda não estejam ativos.

Para obter informações adicionais sobre gestão de eventos, consulte Gestão de eventos .

Evento - evento ()

Instancia um construtor de evento.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

var event = new Event();
var esource = event.getField("source");
var eseverity = event.getField("severity");       

Evento - getField (campo de cadeia de caracteres)

Retorna o valor atual de Passado no campo Gestão de eventos.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Assunto:	Cadeia de caracteres	Nome do valor do campo de gestão de eventos a ser retornado.

Tabela 3. Retornos

Tipo	Descrição
Cadeia de caracteres	Valor do campo Gestão de eventos solicitada.

var event = new Event();
var eventSource = event.getField("source");
var eventSeverity = event.getField("severity");       

Evento - setAdditionalInfo(cadeia de caracteres additionalInfo)

Substitui o existente additional_infoCampo no evento associado ao passado na cadeia de caracteres JSON.

Nota:

Você pode usar o. SetField() método para atualizar um campo específico no additional_infocampo.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
additionalInfo	Cadeia de caracteres	Cadeia de caracteres JSON (pares de chave/valor) para salvar no additional_infocampo. Nota: Este parâmetro substitui as informações existentes. Não atualiza os campos existentes.

Tabela 5. Retornos

Tipo	Descrição
vazio

event.setAdditionalInfo("{\"evtComponent\":\"Microsoft-Windows- WindowsUpdateClient\",\"evtMessage\":\"Installation Failure: Windows failed. Error 0x80070490\"}");

Evento - setField (chave de cadeia de caracteres, valor de cadeia de caracteres)

Define o campo especificado no evento associado.

Se aprovado keycorresponde a um campo de evento predefinido, o método atualiza o campo de evento correspondente. Caso contrário, o método adicionará o. keyparâmetro para additional_infosessão do evento antes de aplicar o aprovado value.

Estes são os campos de evento predefinidos que você pode modificar usando este método:

Campo	Descrição
additional_info	Par de chave-valor a ser adicionado ao additional_infocampo do evento associado. Se a chave passada já existir, seu valor será substituído. Tamanho máximo: 4 000 caracteres Campo de IU associado: Informações adicionais
identifier_ic	Cadeia de caracteres JSON que identifica exclusivamente um item de configuração. Por exemplo, 01", "type":"Oracle" . Tamanho máximo: 1 000 caracteres
cmdb_ci	Sys_id do registro do item de configuração [cmdb_ci] ao qual vincular o evento. Padrão: Nulo
descrição	Descrição em formato livre do evento. Tamanho máximo: 4 000 caracteres Campo de IU associado: Descrição Padrão: Nulo
event_class	Serviço de mensagens empresarial (EMS) que gerou o evento. Por exemplo, "SolarWinds" ou "SCOM". Comprimento máximo: 100 Campo de IU associado: Instância de origem Padrão: Nulo
message_key	Identificador de evento exclusivo. Para substituir uma gravidade de evento existente, use o mesmo message_keyvalor. Tamanho máximo: 1024 caracteres Campo de IU associado: Chave de mensagem Padrão: Combinação de source, node, type, resourcee. metric name.
resolution_state	Estado de resolução do evento. Valores válidos: Novo: O estado de resolução do evento correspondente é Aberto. Encerramento: O estado de resolução do evento correspondente é Encerramento/Encerrado. Campo de IU associado: Estado de resolução Padrão: Novo
recurso	Recurso de nó a ser associado ao evento. Por exemplo, "Disco C:", "CPI-1" ou o nome de um processo ou serviço. Tamanho máximo: 100 caracteres Campo de IU associado: Recurso
gravidade	Gravidade do evento. Valores válidos: 0: Limpar - Nenhuma ação é necessária. Não foi criado um alerta a partir deste evento. Os alertas existentes estão encerrados. 1: OK - Um alerta é criado. O recurso ainda está funcional. 2: Aviso - Atenção é necessária, mesmo que o recurso ainda esteja funcional. 3: Secundário - Ocorreu perda parcial e não crítica de funcionalidade ou degradação de desempenho. 4: Grave - A funcionalidade principal está gravemente prejudicada ou o desempenho foi degradado. 5: Crítico - Ação imediata é necessária. O recurso não está funcional ou há problemas críticos iminentes. Campo de IU associado: Gravidade Padrão: Nulo
origem	Instância do EMS que acionou o evento. Normalmente, o nome da instância do conector. Tamanho máximo: 200 caracteres Campo de IU associado: Origem Padrão: Nulo
time_of_event	Hora UTC em que o evento ocorreu no sistema de origem. Formato: "aaaa-MM-dd HH:mm:ss" Tamanho máximo: 40 caracteres Campo de IU associado: Hora do evento Padrão: Data/hora atual
tipo	Tipo de métrica ao qual o evento está relacionado, como Disco ou CPU. Este valor é usado para identificar um registro de evento a partir do qual os alertas são criados. Tamanho máximo: 100 caracteres Campo de IU associado: Tipo Padrão: Nulo

Nota:

Você também pode usar o. SetText() método para atualizar o. descriptione SetTimeOfEvent() método para atualizar a hora do evento.

Para obter informações adicionais sobre eventos, consulte Gestão de eventos .

Tabela 6. Parâmetros

Nome	Tipo	Descrição
chave	Cadeia de caracteres	Nome da chave a ser adicionada ou atualizada no evento. Para obter informações adicionais sobre os campos de evento predefinidos, consulte Formato de campo de evento para coleta de eventos .
valor	Cadeia de caracteres	Informações a serem armazenadas no campo de evento associado. Nota: . valuea cadeia de caracteres é aparada antes de ser armazenada, em que vários espaços são substituídos por um único espaço.

Tabela 7. Retornos

Tipo	Descrição
vazio

var event = new Event();
event.setField("source","SAP Solman");
event.setField("severity","3");
event.setField("time_of_event", "2019-18-05 13:12:05");
event.setField("type", "SAP object");
event.setField("user", "admin"); // parameter will be added to additional_info section       

Evento - setText (texto de cadeia de caracteres)

Define o. descriptioncampo do evento associado ao valor passado.

Nota:

Você também pode usar o. Evento - setField (chave de cadeia de caracteres, valor de cadeia de caracteres) método para definir o. textcampo no evento atual. Ao contrário de SetField() este método não corta o texto passado.

Tabela 8. Parâmetros

Nome	Tipo	Descrição
texto	Cadeia de caracteres	Texto a ser armazenado no descriptioncampo do evento associado. Tamanho máximo: 4000 caracteres

Tabela 9. Retornos

Tipo	Descrição
vazio

var event = new Event();
event.setText("SAP Solman");       

Evento - setTimeOfEvent(cadeia de caracteres timeOfEvent)

Define o. time_of_eventCampo no evento associado ao valor de Passado em UTC.

Nota:

Você também pode usar o. Evento - setField (chave de cadeia de caracteres, valor de cadeia de caracteres) método para definir o. time_of_eventcampo.

Tabela 10. Parâmetros

Nome	Tipo	Descrição
Tempo DeEvento	Cadeia de caracteres	Valor de hora UTC a ser definido no time_of_eventcampo. Formato: "aaaa-MM-dd HH:mm:ss" Tamanho máximo: 40 caracteres

Tabela 11. Retornos

Tipo	Descrição
vazio

var event = new Event();
event.setTimeOfEvent("2019-18-05 13:12:05");