Guida per l'utente › Gestione del livello di servizio › Ambito di business logic › Come utilizzare Business logic › Oggetti business logic › Oggetto Strumenti

Oggetto Strumenti

Un oggetto globale che contiene alcuni utili metodi.

AddEventAnnotation(<Info>, <EventId>)

Salva una nota dell'evento per l'evento specificato. Queste informazioni possono essere utili in seguito durante la visualizzazione di dati non elaborati (eventi). L'annotazione salvata può spiegare alcune situazioni specifiche durante l'esecuzione della formula di business logic in uno specifico momento.

Il parametro Information (Informazioni) specifica che il testo di nota deve essere scritto.

Inoltre, accetta un parametro EventId che specifica gli eventi annotati.

AddRootCauseComment(<Info>, <Timestamp>, <ResourceId>)

Salva un commento relativo alla causa. Queste informazioni possono essere utili in seguito nei report generati. Il commento relativo alla causa salvato descrive una specifica situazione durante l'esecuzione della formula di business logic in un determinato momento.

Il parametro Information (Informazioni) specifica che il commento deve essere scritto.

Il metodo riceve un'informazione di data e orario per essere salvato con il commento. Accetta inoltre un parametro ResourceId (ID risorsa) che specifica la risorsa associata al contesto di metodo. Questo parametro è facoltativo e può essere omesso.

GetCustomAttributeForResource(resourceName, timestamp, customAttributeName)

Restituisce il valore dell'attributo personalizzato specificato, dalla risorsa specificata, all'ora specificata.

Se l'attributo non esiste al momento dell'evento, si verifica un errore.

Esempio:

Dim AttribVal
AttribVal = Tools. GetCustomAttributeForResource. "MyResource", #12/12/06 12:34:56#, "MyAttribute"

GetExternalData (connectionString, query)

Questo metodo restituisce un set di record provenienti dal database specificato dalla stringa di connessione, in base alla query specificata.

Entrambe le stringhe devono terminare con un punto e virgola (;).

L'utente può utilizzare questo set di record come segue:

• Recordset.MoveNext - spostare al record successivo nel set di record.
• Recordset.MovePrev - spostare al record precedente nel set di record.
• Val = RecordSet("Field1") - ottenere il valore di Field1 dal record attuale nel set di record.
• Do Until ruleNames.EOF - interrompe il loop quando il record attuale è alla fine del file.
• Do Until ruleNames.BOF - interrompe il loop quando il record attuale è all'inizio del file.
• RecordSet.Close - chiudere la connessione di database.

Esempio:

Dim rs
Set rs = Tools.GetExternalData(
"dsn=oblicore;uid=oblicore;pwd=oblicore;", "select * from t_rules")
Do Until rs.EOF
  Out.Log "Name=" & rs("RULE_NAME"), "I"
  rs.MoveNext
Ciclo
rs.Close

GetLocaleTime(<utcTime>)

Il metodo converte un orario dato in base all'ora UTC nel fuso orario della metrica corrente.

GetUtcTime(<localeTime>)

Il metodo converte un orario dato in base al fuso orario della metrica corrente in UTC.

HasCustomAttributeForResource(resourceName, timestamp, customAttributeName)

Specifica se l'attributo specificato esiste nella risorsa specificata nel momento indicato.

Esempio:

Dim AttribExistsNow
AttribExistsNow = Tools. HasCustomAttributeForResource "MyResource", #12/12/06 12:34:56#, "MyAttribute"

NetTime(<Begin time>, <End time>)

Accetta due parametri che indicano un periodo di tempo.

Il metodo calcola e restituisce la quantità di tempo (in secondi) dall'inizio del periodo alla sua fine, all'interno di periodi di applicazione.

Se l'ora di inizio è successiva all'ora di fine, il risultato è un numero negativo.

SaveFields(<tableName>, <Key>, fieldName1, fieldValue1, fieldName2, fieldValue2,…)

Simile a SaveRecord, tranne che invece di enumerare di tutti i valori, fornisce coppie di nomi di campo e i relativi valori di campo. I numeri del campo possono sostituire i nomi di campo. (il numero del primo campo valore è 1).

Nota: questo metodo viene eseguito solo dall'agente Periodo di riferimento.

SaveRecord <tableName>, <key>, <val1>, <val2>,…

Salva un record in una tabella utente. Le tabelle utente vengono utilizzate per generare informazioni durante il calcolo del livello di servizio. Queste informazioni possono essere utilizzate successivamente per generare rapporti. Possono esistere più tabelle utente.

Il parametro tableName specifica la tabella in cui devono essere scritte le informazioni. Ogni record nella tabella utente ha una chiave univoca, che specifica i record in cui devono essere scritte le informazioni. Ogni record anche molti campi valore di tipo stringa. Il numero esatto di campi valore in ogni tabella utente e i nomi dei campi sono definiti durante l'implementazione.

Il metodo SaveRecord riceve un nome di tabella utente e una chiave. Accetta inoltre tutti i campi valore nella tabella utente. (Questi parametri di valore sono facoltativi e possono essere omessi). Se un record con la stessa chiave esiste già, verrà aggiornato. Solo i campi valore trasferiti come parametri vengono aggiornati. Se un record con questa chiave non esiste, verrà creato.

Nota: questo metodo viene eseguito solo dall'agente Periodo di riferimento.

SendEvent(<eventName>, <resourceName>, <Timestamp>, <TimeUnit>, <args>)

Questo metodo crea un nuovo evento di metrica. Le definizioni dei parametri sono le seguenti:

• EventTypeName: il nome del tipo di evento di questo evento.
• ResourceName: il nome della risorsa per cui questo evento viene inviato. Questo parametro è facoltativo. Se non è specificato, l'evento viene inviato a tutte le risorse. Il nome può inoltre contenere un nome del gruppo di risorse. In questo caso, l'evento viene inviato nel gruppo di risorse. Il sistema riconosce da solo se il nome specificato è il nome della risorsa o del gruppo di risorse. Questo può essere sostituito con un nome ResourceGroup. Non ci sono altri valori che vengono modificati quando si utilizza un nome di gruppo anziché un nome di risorsa.
• Data/ora: data e ora di questo evento. Questo parametro è facoltativo. Se questo parametro non è specificato, il le indicazioni di data e ora sono le stesse dell'ultimo evento ricevuto dal metrica.
• Unità di tempo: questo è l'unità di tempo che deve essere inviata. I tipi di unità di tempo che l'utente può inviare sono:
  • Tutti
  • Tracking
  • Ora
  • Giorno
  • Settimana
  • Mese
  • Trimestre
  • Anno

  L'unità di tempo è un parametro obbligatorio, gli eventi non vengono inviati se il parametro non è definito o è definito in modo non corretto.

  Il parametro non distingue tra maiuscole e minuscole.

  Un errore viene scritto nel log, se l'unità di tempo è definita in modo non corretto nella business logic.

• Val_1, Val_2… – i campi valore dell'evento. Il numero di campi valore dipende dal tipo di evento. Se il numero di parametri forniti è maggiore del numero di campi dati nel tipo di evento, un errore di runtime viene segnalato quando la riga è in esecuzione. Se il numero di parametri forniti è inferiore al numero di campi dati, un valore predefinito è posizionato negli ultimi parametri. Il valore predefinito dipende dal tipo di campo. Se i valori passati non sono coerenti con il tipo di valori nell'evento, e se non c'è nessun cast appropriato, viene generato un errore.

Esempio:

Tools.SendEvent "OnEvent", "MyResource", #02/01/06 13:46:00#, "All", 1, 2