M9. Postazioni

L'Agent è stato disinstallato

Viene invocata dopo che la rimozione di Agent è stata completata.

Database

Parametri

Valore restituito

è disponibile

login — nome utente dell'amministratore,

state — stato di completamento:

true — con successo,

false — fallito,

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

message — vuoto se lo stato è true, altrimenti contiene un messaggio di errore

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when deinstallation of Agent completed

 

Database:

 available

 

Parameters:

 login           login name of administrator

 state           true    success

                 false   failed

 id                      station ID

 address                 station address

 station                 station name

 message                 empty if state is 'true' or contains error message

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.login, args.state, args.id

                -- args.address, args.station, args.message

Arresto del componente su postazione

Viene invocata alla ricezione dell'evento component completed dall'Agent.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

component — numero del componente,

pid — ID del processo,

infections — sono state rilevate minacce,

errors — sono stati rilevati errori di accesso,

exitcode — codice di uscita del componente,

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when "component completed" event received from Agent

 

Database:

 available

 

Parameters:

 id          station ID

 address     station address

 station     station name

 component   component number

 pid         process ID

 infections  infections found

 errors      access errors detected

 exitcode    component exit code

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.component,

                -- args.pid, args.exitcode, args.infections, args.errors

Il task è stato eseguito

Viene invocata alla ricezione dell'evento job executed dall'Agent.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

done — stato di esecuzione:

true — eseguito con successo,

false — esecuzione fallita,

time — tempo di completamento del task,

name — nome del task,

error — messaggio di errore o di stato

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when "job executed" event received from Agent

 

Database:

 available

 

Parameters:

 id               station ID

 address          station address

 station          station name

 done      true   executed successfully

           false  execution failed

 time             job completion time

 name             job name

 job              job ID (empty for Agent prior version 11 (protocol 3.1+))

 error            error or other message

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.done,

                -- args.name, args.job, args.time, args.error

Avvio del componente su postazione

Viene invocata alla ricezione dell'evento component started dall'Agent.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

component        — numero del componente,

pid — ID del processo,

engine — versione del motore di ricerca,

records — numero di record dei virus,

user — nome utente e gruppo del proprietario del processo,

time — ora di inizio (ora della postazione)

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when "component started" event received from Agent

 

Database:

 available

 

Parameters:

 id         station ID

 address    station address

 station    station name

 component  component number

 pid        process ID

 engine     virus-finding engine version

 records    virus records number

 user       user name and group (process owner)

 time       start time (station time)

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.component,

                -- args.pid, args.records, args.user, args.time, args.engine

È cambiata la posizione geografica di una postazione

Viene invocata quando è cambiata la posizione geografica di una postazione.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

latitude — latitudine della postazione in formato DD.DDDDDD,

longitude — longitudine della postazione in formato DD.DDDDDD

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when agent geolocation changed

 

Database:

 available

 

Parameters:

 id         station ID

 address    station address

 station    station name

 latitude   station latitude in DD.DDDDDD format

 longitude  station longitude in DD.DDDDDD format

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.name, args.latitude, args.longitude

È necessario riavviare la postazione

Viene invocata dopo che il Server Dr.Web ha ricevuto il messaggio reboot required dalla postazione.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo di rete della postazione,

station — nome NetBIOS della postazione. Non viene sostituito con il nome DNS,

product — ID del prodotto,

description — descrizione del prodotto,

from_revision — numero della revisione corrente,

to_revision — numero della revisione nuova,

from_revision_date — data della revisione corrente,

to_revision_date — data della revisione nuova

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 after server received 'reboot required' station message.

 

Database:

 available

 

Parameters:

 id                  station ID

 address             station network address

 station             station name (this is NetBIOS station name not replaced by DNS one)

 product             product ID

 description         product description

 from_revision       current revision number

 to_revision         new revision number

 from_revision_date  current revision date

 to_revision_date    new revision date

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.product, args.description, args.from_revision, args.to_revision, args.from_revision_date, args.to_revision_date

È stata rilevata una minaccia alla sicurezza della postazione

Viene invocata alla ricezione dell'evento virus detected dall'Agent.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

component — numero del componente,

pid — ID del processo,

time — ora del verificarsi dell'evento (ora della postazione),

user — nome utente e gruppo del proprietario del processo,

object — percorso dell'oggetto nel file system,

owner — nome utente e gruppo del proprietario dell'oggetto,

virus — nome del virus,

action — codice dell'operazione,

objecttype — tipo di oggetto:

-1 sconosciuto,

0 file,

1settore di avvio,

2blocco di memoria o processo,

3attività dei virus

infectiontype — tipo di minaccia (v. Dr.Web API),

compsid — SID della postazione,

compmac — indirizzo MAC della postazione,

description — descrizione della postazione,

compdn — LDAP DN della postazione (solo per i client SO Windows),

sha1 — hash SHA-1 dell'oggetto rilevato,

sha256 — hash SHA-256 dell'oggetto rilevato,

hashdb — bollettino contenente l'hash

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when "virus detected" event received from Agent

 

Database:

 available

 

Parameters:

 id               station ID

 address          station address

 station          station name

 component        component number

 pid              process ID

 time             event time (station time)

 user             user name and group (process owner)

 object           filesystem object path

 owner            object owner (user name and group)

 virus            virus name

 action           action code (see Dr.Web API; only errors bit set)

 objecttype       object type

                    -1    unknown

                     0    file

                     1    boot sector

                     2    memory block / process

                     3    virus like activity

 infectiontype    infection type (see Dr.Web API)

 compsid          computer sid

 compmac          computer MAC

 description      computer description

 compdn           computer LDAP DN

 sha1             object SHA-1 hash

 sha256           object SHA-256 hash

 hashdb           hash database containing object

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.component,

                -- args.pid, args.time, args.user, args.object, args.owner,

                -- args.virus, args.action, args.objecttype, args.infectiontype

                -- args.compsid, args.compmac, args.description, args.compdn

                -- args.sha1, args.sha256, args.hashdb

Report di Protezione preventiva

Viene invocata quando viene ricevuto un report di Protezione preventiva dalla postazione.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

time — ora di comparsa dell'evento sulla postazione,

pid — ID del processo,

path — percorso del file eseguibile del processo con un'attività sospetta,

target_path — percorso dell'oggetto protetto a cui è stato effettuato un tentativo di accesso,

hips_type — tipo di oggetto protetto (valore numerico),

shell_guard_type — motivo di blocco del codice non autorizzato (valore numerico),

denied — vietato accesso (true | false),

is_user_action — azione chiesta all'utente (true | false),

event_count — numero di eventi automaticamente vietati (solo se per is_user_action il valore è false),

event_user — utente che ha avviato il processo con un'attività sospetta,

action_user — utente che ha impostato una reazione a un'attività sospetta del processo (solo se per is_user_action il valore è true),

sha1 — hash SHA-1 dell'oggetto rilevato,

sha256 — hash SHA-256 dell'oggetto rilevato,

hashdb — bollettino contenente l'hash

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when HIPS event received from Agent

 

Database:

 available

 

Parameters:

 id                 station ID

 address            station address

 station            station name

 time               station time

 pid                numeric,process id

 path               process file path

 target_path        affected resource path

 hips_type          numeric, HIPS type

 shell_guard_type   numeric, Shell Guard event type

 denied             boolean, access was denied

 is_user_action     boolean, user was asked

 event_count        event number (for accumulation period - if is_user_action is false)

 event_user         user which initiated the suspicious activity

 action_user        user which allowed or denied the activity (non-empty only if is_user_action is true)

 sha1               process file SHA-1 hash

 sha256             process file SHA-256 hash

 hashdb             hash database containing process file

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.time,

                -- args.pid, args.path, args.target_path, args.hips_type, args.shell_guard_type,

                -- args.denied, args.is_user_action, args.event_count, args.event_user, args.action_user

                -- args.sha1, args.sha256, args.hashdb

Errore di autenticazione della postazione

Viene invocata dopo che la connessione all'Agent è stata rifiutata a causa di errore di autenticazione.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

reason — causa di fallimento,

type — uno dei station, installer, proxy,

compsid — SID della postazione,

compmac — indirizzo MAC della postazione,

description — descrizione della postazione

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 just after Agent connection rejected due authorization error

 

Database:

 available

 

Parameters:

 id          station ID

 address     station address

 station     station name

 reason      failure reason

 type        one of 'station' | 'installer' | 'proxy'

 compsid     station UID (SID on Windows)

 compmac     station MAC address

 description station description

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.reason, args.type, args.compsid, args.compmac, args.description

Errore di data/ora sulla postazione

Viene invocata al rilevamento sulla postazione di un'ora/una data non valida.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

now — ora sul Server Dr.Web (in millisecondi),

time — ora sulla postazione (in millisecondi),

valid_delta — differenza di ora ammissibile (in millisecondi),

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when invalid station time/date detected

 

Database:

 available

 

Parameters:

 id              station ID

 address         station address

 station         station name

 now             server time (in milliseconds)

 time            station time (in milliseconds)

 valid_delta     valid time delta (in milliseconds)

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station

                -- args.now, args.date, args.valid_delta

Errore di aggiornamento della postazione

Viene invocata dopo che il Server Dr.Web ha ricevuto il messaggio update failed dalla postazione.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo di rete della postazione,

station — nome NetBIOS della postazione. Non viene sostituito con il nome DNS,

product — ID del prodotto,

description — descrizione del prodotto,

from_revision — numero della revisione corrente,

to_revision — numero della revisione nuova,

from_revision_date — data della revisione corrente,

to_revision_date — data della revisione nuova

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 after server received 'update failed' station message.

 

Database:

 available

 

Parameters:

 id                  station ID

 address             station network address

 station             station name (this is NetBIOS station name not replaced by DNS one)

 product             product ID

 description         product description

 from_revision       current revision number

 to_revision         new revision number

 from_revision_date  current revision date

 to_revision_date    new revision date

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.product, args.description, args.from_revision, args.to_revision, args.from_revision_date, args.to_revision_date

Errore di scansione su postazione

Viene invocata alla ricezione dell'evento scan error dall'Agent.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

component — numero del componente,

pid — ID del processo,

time — ora del verificarsi dell'evento (ora della postazione),

user — nome utente e gruppo del proprietario del processo,

object — percorso dell'oggetto nel file system,

owner — nome utente e gruppo del proprietario dell'oggetto,

action — codice dell'operazione,

compsid — SID della postazione,

compmac — indirizzo MAC della postazione,

description — descrizione della postazione,

ldapdn — LDAP DN della postazione (solo per i client SO Windows),

sha1 — hash SHA-1 dell'oggetto rilevato,

sha256 — hash SHA-256 dell'oggetto rilevato,

hashdb — bollettino contenente l'hash

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when "scan error" event received from Agent

 

Database:

 available

 

Parameters:

 id               station ID

 address          station address

 station          station name

 component        component number

 pid              process ID

 time             event time (station time)

 user             user name and group (process owner)

 object           filesystem object path

 owner            object owner (user name and group)

 action           action code (error bit(s) set)

 compsid          computer SID

 compmac          computer MAC

 description      computer description

 ldapdn           computer LDAP DN

 sha1             object SHA-1 hash

 sha256           object SHA-256 hash

 hashdb           hash database containing object

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.component,

                -- args.pid, args.time, args.user, args.object, args.owner,

                -- args.action, args.compsid, args.compmac, args.description, args.ldapdn

                -- args.sha1, args.sha256, args.hashdb

La lista dei componenti è stata ricevuta

Viene invocata quando l'Agent comunica la lista dei componenti installati.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

count — numero di componenti segnalati,

component_0 — nome componente,

time_0 — ora di installazione,

from_0 — fonte di installazione (indirizzo del Server Dr.Web, MSI ecc.),

path_0 — percorso di installazione

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when Agent reported installed components

 

Database:

 available

 

Parameters:

 id                 station ID

 address            station address

 station            station name

 count              number of components reported

 component_0        component name

 time_0             installation time

 from_0             installation source (server address, MSI, etc)

 path_0             installation path

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.count

                -- args.component_0, args.time_0, args.from_0, args.path_0

                -- args.component_1, args.time_1, args.from_1, args.path_1

              -- ...

Ricevute le informazioni sui database dei virus

Viene invocata quando l'Agent invia informazioni sui database dei virus.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

count — numero di database dei virus,

name_0 — nome del file del database dei virus,

md5_0 — MD5 del file del database dei virus,

version_0 — versione del database dei virus,

issued_0 — data e ora di rilascio del database dei virus,

records_0 — numero di record nel database dei virus,

type_0 — tipo di database dei virus

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when Agent sent virus bases information

 

Database:

 available

 

Parameters:

 id          station ID

 address     station address

 station     station name

 count       number of found virus bases

 name_0      virus base file name

 md5_0       virus base file MD5

 version_0   virus base version

 issued_0    virus base issue date and time

 records_0   number of records

 type_0      virus base type

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.count,

                -- args.name_0, args.md5_0, args.version_0,

                -- args.issued_0, args.records_0, args.type_0,

                -- args.name_1, args.md5_1, args.version_1,

                -- args.issued_1, args.records_1, args.type_1,

                -- ...

Stato della postazione

Viene invocata quando l'Agent comunica lo stato dei componenti, dei database dei virus e di alcuni criteri locali (invio di eventi, ricezione di aggiornamenti e task).

Database

Parametri

Valore restituito

è disponibile

events — messaggio di eventi:

true — l'Agent invia informazioni su eventi,

false — l'Agent non invia informazioni su eventi,

jobs — accettazione di task (secondo il calendario e scansioni remote):

true — l'Agent accetta task,

false — l'Agent non accetta task,

updates — ricezione di aggiornamenti:

true — l'Agent riceve aggiornamenti,

false — l'Agent non riceve aggiornamenti

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when Agent report its local policy

 

Database:

 available

 

Parameters:

 events    true     Agent send events

           false    Agent do not send events

 jobs      true     Agent accept jobs (schedule & remote scan)

           false    Agent do not accept jobs

 updates   true     Agent accept updates

           false    Agent do not accept updates

 

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.events, args.jobs, args.updates

La postazione viene autenticata

Viene invocata se la postazione cerca di autenticarsi (l'ID e la password sono già stati verificati, sono validi e conosciuti).

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

connected — controllo della presenza di postazioni con questo ID già connesse al Server Dr.Web:

true — un'altra postazione con questo ID è già connessa al Server Dr.Web,

false — non vi sono altre postazioni con questo ID connesse,

current_address — indirizzo di rete della postazione con questo ID già connessa (non è vuoto solo se connected assume il valore true),

current_name — nome della postazione con questo ID già connessa,

last_address — indirizzo di rete della postazione con questo ID all'ultima connessione,

last_time — ora dell'ultima comparsa della postazione con questo ID,

last_server — Server Dr.Web della postazione con questo ID alla sua ultima connessione,

new_name — nome della postazione che si connette,

new_address — indirizzo di rete della postazione che si connette

string — risultato della richiesta di connessione della postazione

nil — comportamento predefinito del Server Dr.Web

deny — nega l'autenticazione della postazione

force — consenti l'autenticazione anche se un'altra postazione con questo ID è già connessa (scollega la postazione connessa)

newbie — resetta la postazione in nuovi arrivi

Testo della procedura personalizzata:

--[[

Called:

 when station tries to authorize (id and password already checked, valid and known)

 

Database:

 available

 

Parameters:

 id                      station ID

 connected       true    station with same ID already connected to server

                 false   no any station with same ID connected

 current_address         already connected station network address (not empty only if 'connected' is true)

 current_name            last connected station name

 last_address            last disconnected station network address

 last_time               last disconnected station seen time

 last_server             last connected station server

 new_name                now connecting station name

 new_address             now connecting station network address

 

Returned value:

         nil             default server behavior

 string  'deny'          deny authorization for station

         'force'         allow authorization even if other station with same ID already connected (by disconnecting it)

         'newbie'        reset station to newbie

 

Procedure from next set will be called if returned nothing.

]]

 

local args = ... -- args.id, args.connected, args.current_address, args.current_name, args.last_address,

                -- args.last_time, args.last_server, args.new_name, args.new_address

 

-- no return => `nil' value

La postazione è connessa

Viene invocata se l'Agent si è connesso con successo.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

os — SO della postazione,

platform — piattaforma della postazione,

compsid — SID della postazione,

compmac — indirizzo MAC della postazione,

description — descrizione della postazione

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when Agent connected successfully

 

Database:

 available

 

Parameters:

 id          station ID

 address     station address

 station     station name

 os          station os

 platform    station platform

 compsid     station UID (Security ID on Windows)

 compmac     station MAC address

 description station description

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.name, args.os, args.platform, args.compsid, args.compmac, args.description

La postazione è stata creata

Viene invocata quando è stata completata la creazione di una postazione.

Database

Parametri

Valore restituito

è disponibile

login — nome utente dell'amministratore,

id — ID della postazione,

name — nome della postazione,

state — stato di completamento dell'operazione:

0 — creata con successo,

1 — errore durante l'esecuzione dell'operazione (errore di database),

2 — il timeout dell'operazione è scaduto (il database è sovraccaricato),

3 — non ci sono licenze disponibili,

4 — la postazione esiste già

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when station create completed

 

Database:

 available

 

Parameters:

 login         administrator`s login name

 id            station ID

 name          station name

 state         operation completion state:

                 0  created successfully

                 1  operation failed (database error)

                 2  operation timed out (database overloaded)

                 3  no free license

                 4  already exists

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.login, args.id, args.name, args.state

La postazione è stata rimossa

Viene invocata alla rimozione della postazione.

Database

Parametri

Valore restituito

è disponibile

login — nome utente dell'amministratore,

id — ID della postazione

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when station deleted

 

Database:

 available

 

Parameters:

 login     administrator`s login name

 id        station id

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.login, args.id

Statistiche di scansione su postazione

Viene invocata alla ricezione dell'evento scan statistics dall'Agent.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

station — nome della postazione,

component — numero del componente,

pid — ID del processo,

user — nome utente e gruppo del proprietario del processo,

time — ora del verificarsi dell'evento (ora della postazione),

size — dimensione totale di tutti gli oggetti scansionati,

elapsedtime — tempo impiegato,

scanned — numero di oggetti scansionati,

infected — numero di oggetti infettati da un virus conosciuto,

modifications — numero di oggetti infettati da una variante di virus,

suspicious — numero di oggetti sospetti,

cured — numero di file curati,

deleted — numero di file eliminati,

renamed — numero di file rinominati,

moved — numero di file trasferiti in quarantena,

locked — numero di file bloccati (solo SpIDer Guard),

errors — numero di file non scansionati a causa di errore di accesso

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when "scan statistics" event received from Agent

 

Database:

 available

 

Parameters:

 id                 station ID

 address            station address

 station            station name

 component          number of component

 pid                process ID

 user               user name and group (process owner)

 time               event time (station time)

 size               summary size of all scanned objects

 elapsedtime        elapsed time

 scanned            number of scanned objects

 infected           number of objects infected by known virus

 modifications      number of objects infected by virus modification

 suspicious         number of suspicious objects

 cured              number of cured files

 deleted            number of deleted files

 renamed            number of renamed files

 moved              number of quarantined files

 locked             number of locked files (SpIDer Guard only)

 errors             number of not scanned files (due access error)

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station, args.component,

                -- args.pid, args.time, args.user, args.scanned,

                -- args.infected, args.modifications, args.suspicious,

                -- args.cured, args.deleted, args.renamed, args.moved,

                -- args.locked, args.errors, args.size, args.elapsedtime

Installazione di Agent

Viene invocata dopo che è stato ricevuto l'evento installation.

Database

Parametri

Valore restituito

è disponibile

id — ID dell'installazione (attenzione: non è l'ID della postazione),

address — indirizzo della postazione,

station — nome della postazione,

event — tipo di evento:

0inizio dell'installazione,

1completato con successo,

2rifiuto,

3il tempo è scaduto,

4fallito,

5non completato

message — messaggio di errore (o vuoto se non è occorso nessun errore),

sessionid — ID della sessione di installazione

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when "installation" event occured

 

Database:

 available

 

Parameters:

 id                installation ID (not station!)

 address           station address

 station           station name

 event             event type:

                     0   installation begin

                     1   successully completed

                     2   rejected

                     3   timed out

                     4   failed

                     5   incomplete

 message           error message (or empty if there is no error)

 sessionid         installation session ID

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id, args.address, args.station

                -- args.event, args.message, args.sessionid

Dispositivo è bloccato

Viene invocata al blocco del dispositivo sulla postazione.

Database

Parametri

Valore restituito

è disponibile

id — ID della postazione,

address — indirizzo della postazione,

name — nome della postazione,

user — nome utente,

instance_id — identificatore dell'esemplare del dispositivo,

friendly_name — nome descrittivo del dispositivo,

description — descrizione del dispositivo,

guid — GUID del dispositivo,

class — classe di dispositivo (nome del gruppo padre)

viene ignorato

Testo della procedura personalizzata:

--[[

Called:

 when device on station blocked

 

Database:

 available

 

Parameters:

 id              station ID

 address         station address

 station         station name

 user            user name

 instance_id     device instance id

 friendly_name   device friendly name

 description     device description

 guid            device guid

 class           device group class guid

 blocktime       time when station was blocked

 blockrcvtime    time when server received alert

 

Returned value:

 ignored

 

]]

 

local args = ... -- args.id args.address args.station args.user args.instance_id

                -- args.friendly_name args.description args.guid args.class

                -- args.station_time args.args.recv_time