|
<< Clique para Mostrar o Sumário >>
LogTrackingEvent |
LogTrackingEvent([Message], [ActorID], [Area], [Severity], [EventTime], [Source], [EventCategory], [EventType], [UserFields], [AlarmSourceName], [FullAlarmSourceName])
Simula um Evento ou Alarme e o envia direto para o banco de dados do Servidor de Alarmes, sem passar pelo E3Alarm. Por isto, este Evento não pode ser visto no E3Alarm, nem tampouco o Alarme pode ser reconhecido.
Cada parâmetro deste método permite especificar o valor do campo de mesmo nome no Evento. Os campos do Evento são preenchidos de acordo com os parâmetros deste método, descritos na tabela a seguir.
Parâmetros do método LogTrackingEvent
Nome |
Descrição |
|---|---|
Message |
Parâmetro texto que especifica o conteúdo do campo Mensagem do Evento. Se omitido, assume uma String vazia |
ActorID |
Parâmetro texto que especifica o conteúdo do campo Operador do Evento. Se omitido, assume o logon do usuário do E3 Viewer, "Anonymous" se não há usuário logado ou "System" se a chamada deste método originou-se no servidor |
Area |
Parâmetro texto que especifica o conteúdo do campo Área do Evento. Se omitido, assume uma String vazia |
Severity |
Parâmetro numérico que determina a severidade do Evento. Se omitido, assume o valor 0 (zero), ou seja, severidade alta |
EventTime |
Especifica a estampa de tempo do Evento. Se omitido, assume o valor da estampa de tempo do momento da chamada deste método |
Source |
Parâmetro texto que especifica o conteúdo do campo Fonte do Evento. Se omitido, assume uma String vazia |
EventCategory |
Parâmetro texto que especifica a categoria do Evento. Se omitido, assume uma String vazia |
EventType |
Parâmetro texto que especifica o tipo do Evento. Se omitido, assume o valor "Tracking" |
UserFields |
Parâmetro do tipo Vetor, em que cada posição assume o valor do campo especificado pelo usuário. Se omitido, usa os valores definidos na Coleção de Campos de Usuário de Alarmes do Servidor de Alarmes |
AlarmSourceName |
Parâmetro texto que especifica o nome da Fonte de Alarme. Se omitido, assume uma String vazia |
FullAlarmSourceName |
Parâmetro texto que especifica o caminho completo da Fonte de Alarme, incluindo a Área, a Configuração de Alarme e as possíveis Pastas onde o Alarme está inserido. Se omitido, assume uma String vazia |
Os demais campos do Evento não podem ser especificados e sempre assumem os valores a seguir:
•Valor (CurrentValue): 0.0
•Qualidade (Quality): ""
•Condição Ativa (ConditionActive): 0 (Falso)
•Nome da Condição (ConditionName): ""
•Nome da Subcondição (SubConditionName): ""
•Reconhecido (Acked): 1 (Verdadeiro)
•Precisa Ack (AckRequired): 0 (Falso)
•Habilitado (Enabled): 1 (Verdadeiro)
•EventTimeUTC: *Sempre igual a EventTime (como em Eventos de Alarme)
•Máscara (ChangeMask): 0 (zero)
•Cookie: 0 (zero)
NOTA |
Este método falha se a opção Armazenar alarmes em banco de dados está desmarcada, ou quando falha o armazenamento no banco de dados. |
O código a seguir contém um exemplo de uso deste método.
Sub CommandButton1_Click()
' No parâmetro UserFields, para cada elemento do array,
' é mostrado o valor atribuído a este elemento.
Application.GetObject("ServidorAlarmes1").LogTrackingEvent_
"Clicou no botão", Application.User, "Operação", 2, , _
"Botão1", , , array(1, 2, "a", "b")
End Sub