Querying Using SOAP

You can also access Web Reports using SOAP. Most client libraries require the location of a Web Services Description Language (WSDL) file, a method name, and parameters to pass into the method. The WSDL file describes the network endpoints required to query the IBM BigFix Database using Web Reports. The WSDL can be accessed from the Web Reports server as in the following example: http://server/webreports?wsdl.

Alternatively, you can find a sample file, relevance.wsdl, in the IBM BigFix installation directory. This WSDL file defines relevanceExpr, which allows you to evaluate a relevance expression. If you installed IBM BigFix to a folder named BigFix Enterprise, you can find the file in this directory:

BigFix Enterprise\BES Server\BESReportsServer\wwwroot\soap

The registry location for your installation is HKLM\SOFTWARE\Wow6432Node\BigFix\Enterprise Server\BESReports\Paths.

This registry key has a string value named wsdl that contains the path name for the WSDL file.

The request includes a tag labeled relevanceExpr, which contains the relevance expression number of IBM BigFix computers. This is one of the operations defined in the WSDL file.

Some of the available methods include:

GetRelevanceResult( String relevanceExpression, String username, String password )
StoreSharedVariable( dashID, variableName, variableValue, [success/failure 
callback], [database id] )
DeleteSharedVariable( dashID, variableName, [success/failure callback], 
[database id] )

To submit queries from SOA clients specify the following BigFix http path:

http://web_report_server/soap

where web_report_server is the hostname or IP address of the Web Report server.