Evento - Global

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

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

Use Evento API para adicionar/atualizar campos em um evento. Use SNeventSenderProvider API para instanciar um objeto remetente de evento. Em seguida, use 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 do passado no campo Gestão de eventos.

Tabela 2. Parâmetros

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

Tabela 3. Retornos

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

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

Evento - setAdditionalInfo(cadeia de caracteres additionalInfo)

Substitui o existente additional_infoEvento associado ao passado na cadeia de caracteres JSON.

Nota:

Você pode usar SetField() método para atualizar um campo específico em 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\"}");

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á keyparâmetro para additional_infodo 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
ic_identifier	Cadeia de caracteres JSON que identifica exclusivamente um item de configuração. Por exemplo, "Nome":"SAP ORA01", "type":"Oracle" . Tamanho máximo: 1 000 caracteres
cmdb_ci	Sys_id do registro 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	EMS (Enterprise Message Service) 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 severidade 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 é Encerrando/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
severidade	Gravidade do evento. Valores válidos: 0: Limpar - Nenhuma ação é necessária. Um alerta não foi criado a partir deste evento. Os alertas existentes estão encerrados. 1: OK - Um alerta é criado. O recurso ainda está funcional. 2: Aviso - É necessária atenção, 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: Principal - A funcionalidade principal está gravemente prejudicada ou o desempenho foi degradado. 5: Crítico - é necessária uma ação imediata. O recurso não está funcional ou há problemas críticos iminentes. Campo de IU associado: Severidade 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 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 Evento associado. Nota: . valuea cadeia de caracteres é cortada 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       

SetText (texto de cadeia de caracteres)

Define o. descriptioncampo do evento associado ao valor passado.

Nota:

Você também pode usar SetField (chave de cadeia de caracteres, valor de cadeia de caracteres) método para definir 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_eventEvento associado ao valor Aprovado em UTC.

Nota:

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

Tabela 10. Parâmetros

Nome	Tipo	Descrição
TimeOfEvent	Cadeia de caracteres	Valor de hora UTC a ser definido em 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");