19.08.2013 Views

BES DATABASE API

BES DATABASE API

BES DATABASE API

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>BES</strong>_ACTIONS<br />

ν ActionID<br />

ν ComputerID<br />

ν Name<br />

ν Username<br />

ν StartTime<br />

ν FixletID<br />

ν Sitename<br />

ν ActionStatus<br />

The <strong>BES</strong>_ACTIONS view contains an entry for every {action, computer} pair where the action was received by the<br />

computer.<br />

Example: “select * from <strong>BES</strong>_ACTIONS where ActionStatus = ‘Executed’”<br />

<strong>BES</strong>_RELEVANT_FIXLET_HISTORY<br />

ν Sitename<br />

ν ID<br />

ν ComputerID<br />

ν FirstBecameRelevant<br />

ν LastBecameRelevant<br />

ν LastBecameNonRelevant<br />

The <strong>BES</strong>_RELEVANT_FIXLET_HISTORY view contains an entry for every {Fixlet, Computer} pair that has ever<br />

been relevant, with timestamps indicating the first time it became relevant, the last time it became relevant (the same<br />

as FirstBecameRelevant if it only became relevant once), and the last time it became non-relevant. Some of these<br />

fields may be NULL if the event in question never occurred or if it occurred before upgrading to the <strong>BES</strong> 4.0 Server.<br />

<strong>BES</strong>_FIXLET_PROPERTIES<br />

ν Sitename<br />

ν ID<br />

ν PropertyName<br />

ν PropertyValue<br />

The <strong>BES</strong>_FIXLET_PROPERTIES view lists the different properties associated with each Fixlet, such as the<br />

severity.<br />

Example: “select BF.Sitename, BF.ID, BF.Name, BFP.PropertyValue AS 'Severity'<br />

from <strong>BES</strong>_FIXLETS BF, <strong>BES</strong>_FIXLET_PROPERTIES BFP<br />

where BF.SItename = BFP.Sitename AND BF.ID = BFP.ID AND BFP.PropertyName = 'Source Severity'”<br />

Future Changes<br />

In the future we may add additional columns to some of these views, introduce new views and/or stored procedures.<br />

The tables outlined here will only be changed if the underlying content changes in such a way as to make them<br />

inapplicable.<br />

Example Report Generation<br />

The following perl script, with the appropriate dns name and login supplied in line #15, will access the database and<br />

print out the contents of the four principal views in HTML tables.<br />

# viewbesdb.pl<br />

#<br />

# An example cgi script which shows the contents of a<br />

Copyright © BigFix, Inc. 2004. Page 2 of 4

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!