QueryComponentsByCondition operation


The QueryComponentsByCondition operation retrieves an array of service model components that match the Master Rule Language (MRL) conditions. These conditions follow the syntax and conventions of the MRL where-clause selection criteria. The criteria are a logical combination of expressions that define the slots associated with the component.

This query can span multiple cells to retrieve the specified service model components.

WSDL for QueryComponentsByCondition operation

<wsdl:operation name="QueryComponentsByCondition" parameterOrder="inargs">
<wsdl:input message="tns:QueryComponentsByCondition_Request"/>
<wsdl:output message="tns:QueryComponentsByCondition_Response"/>
<wsdl:fault message="tns:Execution_Fault" name="Execution_Fault"/>
</wsdl:operation>

WSDL message for QueryComponentsByCondition

<wsdl:message name="QueryComponentsByCondition_Request">
       <wsdl:part element="elems:QueryComponentsByCondition" name="inargs"/>
</wsdl:message>
<wsdl:message name="QueryComponentsByCondition_Response">
       <wsdl:part element="elems:QueryResultHandle_output" name="outargs"/>
</wsdl:message>

XSD schema for request and response for QueryComponentsByCondition

<xsd:element name="QueryComponentsByCondition">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="imname" nillable="true" type="xsd:string"/>
<xsd:element name="condition" nillable="true" type="xsd:string" />
<xsd:element name="slotsList" nillable="true" type="xsd:string" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:element>
<xsd:element name="QueryResultHandle_output">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="resultHandle" nillable="true" type="xsd:string"/>
<xsd:element name="resultCount" type="xsd:long" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>

Parameters for QueryComponentsByCondition

Name

Direction

Element name

Description

imname

In

String type that identifies the name of the BMC Impact Manager instance.

condition

In

String type value that specifies the selection criteria in a where clause following Master Rule Language syntax.

MRL syntax is case-sensitive. For guidelines on using MRL, see Master Rule Language (MRL) reference.

slotsList

In

String description that specifies the slot name or names, the values for which the query returns. The slot names in the string are separated by commas, as in ','.

resultHandle

Out

resultHandle

String type that contains the ID returned by the server's response to the initial query request. This ID is attached to all query requests in this cycle.

resultCount

Out

resultCount

xsd:long type that defines the total number of events or data objects that have been retrieved by the BMC Impact Integration Web Services server in response to the client query

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*