element findResources
diagram deservices_wsdl_diagrams/deservices_wsdl_p2440.png
namespace http://resource.api.de.bpm.tibco.com
properties
content complex
children entity-ref resource-name
attributes
Name  Type  Use  Default  Fixed  Annotation
model-version  xs:int    -1    
documentation
Identifies the major organization model version in which the identified entities are to be searched. The default value of -1 indicates that the latest version should be used. When searching for resources by name, this attribute is ignored.
current-only  xs:boolean    false    
documentation
Determines whether only resources currently associated with the identified entities are to be include (true). If false, any date ranges applied to the resource or its associations are ignored.
annotation
documentation
Request element for the findResource operation. The request identifies any number of groups, positions, organization units, organizations, locations, capabilities, or privileges from which the associated resources will be identified.

The request may also identify resources by their name.

Normally either GUIDs or resource names are specified in the request, however a mixture can be specified if necessary. Note that a request with no GUIDs or resource names is invalid - at least one of the two must be specified.

Where both GUIDs and resource names are specified in the request these lists are independent of each of other - the GUIDs do not need to match up with corresponding resource names.

The response lists those resources, giving their GUID, name, and label properties. If the same resource is associated with more than one of the entities identified in the request, that resource only appears once in the response. The response does not indicate the entity from which the resource was located.

The model version in the request identifies the organization model major version in which the search for the entities should be performed. The default value of -1 indicates that the latest version should be used. When the request is to locate resources by their names, the model version is not used (but must still be valid).

As a resource's associations, and the resource itself, can be limited by a date range, the search can selectively include only those resources that are currently associated with the identified entities. When searching by resource name or associations, a true value ensures that the response only includes those resources whose date restrictions fall within the current date/time.
source <xs:element name="findResources">
 
<xs:annotation>
   
<xs:documentation>Request element for the findResource operation. The request identifies any number of groups, positions, organization units, organizations, locations, capabilities, or privileges from which the associated resources will be identified.

The request may also identify resources by their name.

Normally either GUIDs or resource names are specified in the request, however a mixture can be specified if necessary. Note that a request with no GUIDs or resource names is invalid - at least one of the two must be specified.

Where both GUIDs and resource names are specified in the request these lists are independent of each of other - the GUIDs do not need to match up with corresponding resource names.

The response lists those resources, giving their GUID, name, and label properties. If the same resource is associated with more than one of the entities identified in the request, that resource only appears once in the response. The response does not indicate the entity from which the resource was located.

The model version in the request identifies the organization model major version in which the search for the entities should be performed. The default value of -1 indicates that the latest version should be used. When the request is to locate resources by their names, the model version is not used (but must still be valid).

As a resource's associations, and the resource itself, can be limited by a date range, the search can selectively include only those resources that are currently associated with the identified entities. When searching by resource name or associations, a true value ensures that the response only includes those resources whose date restrictions fall within the current date/time.
</xs:documentation>
 
</xs:annotation>
 
<xs:complexType>
   
<xs:sequence>
     
<xs:element name="entity-ref" minOccurs="0" maxOccurs="unbounded">
       
<xs:annotation>
         
<xs:documentation>Identifies an organization model entity (by its unique GUID) whose associated resources are to be included in the response.

The 'deep-search' attribute determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, the deep-search attribute is ignored.
</xs:documentation>
       
</xs:annotation>
       
<xs:complexType>
         
<xs:attribute name="guid" type="xs:string" use="required"/>
         
<xs:attribute name="deep-search" type="xs:boolean" use="optional" default="false">
           
<xs:annotation>
             
<xs:documentation>Determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, this attribute is ignored.</xs:documentation>
           
</xs:annotation>
         
</xs:attribute>
       
</xs:complexType>
     
</xs:element>
     
<xs:element name="resource-name" type="xs:string" minOccurs="0" maxOccurs="unbounded">
       
<xs:annotation>
         
<xs:documentation>Names the resource(s) to be searched for. There may be two, or more, resources that share the same name, so the response may include more than one result for each name provided.</xs:documentation>
       
</xs:annotation>
     
</xs:element>
   
</xs:sequence>
   
<xs:attribute name="model-version" type="xs:int" default="-1">
     
<xs:annotation>
       
<xs:documentation>Identifies the major organization model version in which the identified entities are to be searched. The default value of -1 indicates that the latest version should be used. When searching for resources by name, this attribute is ignored.</xs:documentation>
     
</xs:annotation>
   
</xs:attribute>
   
<xs:attribute name="current-only" type="xs:boolean" default="false">
     
<xs:annotation>
       
<xs:documentation>Determines whether only resources currently associated with the identified entities are to be include (true). If false, any date ranges applied to the resource or its associations are ignored.</xs:documentation>
     
</xs:annotation>
   
</xs:attribute>
 
</xs:complexType>
</xs:element>

attribute findResources/@model-version
type xs:int
properties
default -1
annotation
documentation
Identifies the major organization model version in which the identified entities are to be searched. The default value of -1 indicates that the latest version should be used. When searching for resources by name, this attribute is ignored.
source <xs:attribute name="model-version" type="xs:int" default="-1">
 
<xs:annotation>
   
<xs:documentation>Identifies the major organization model version in which the identified entities are to be searched. The default value of -1 indicates that the latest version should be used. When searching for resources by name, this attribute is ignored.</xs:documentation>
 
</xs:annotation>
</xs:attribute>

attribute findResources/@current-only
type xs:boolean
properties
default false
annotation
documentation
Determines whether only resources currently associated with the identified entities are to be include (true). If false, any date ranges applied to the resource or its associations are ignored.
source <xs:attribute name="current-only" type="xs:boolean" default="false">
 
<xs:annotation>
   
<xs:documentation>Determines whether only resources currently associated with the identified entities are to be include (true). If false, any date ranges applied to the resource or its associations are ignored.</xs:documentation>
 
</xs:annotation>
</xs:attribute>

element findResources/entity-ref
diagram deservices_wsdl_diagrams/deservices_wsdl_p2441.png
properties
minOcc 0
maxOcc unbounded
content complex
attributes
Name  Type  Use  Default  Fixed  Annotation
guid  xs:string  required      
deep-search  xs:boolean  optional  false    
documentation
Determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, this attribute is ignored.
annotation
documentation
Identifies an organization model entity (by its unique GUID) whose associated resources are to be included in the response.

The 'deep-search' attribute determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, the deep-search attribute is ignored.
source <xs:element name="entity-ref" minOccurs="0" maxOccurs="unbounded">
 
<xs:annotation>
   
<xs:documentation>Identifies an organization model entity (by its unique GUID) whose associated resources are to be included in the response.

The 'deep-search' attribute determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, the deep-search attribute is ignored.
</xs:documentation>
 
</xs:annotation>
 
<xs:complexType>
   
<xs:attribute name="guid" type="xs:string" use="required"/>
   
<xs:attribute name="deep-search" type="xs:boolean" use="optional" default="false">
     
<xs:annotation>
       
<xs:documentation>Determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, this attribute is ignored.</xs:documentation>
     
</xs:annotation>
   
</xs:attribute>
 
</xs:complexType>
</xs:element>

attribute findResources/entity-ref/@guid
type xs:string
properties
use required
source <xs:attribute name="guid" type="xs:string" use="required"/>

attribute findResources/entity-ref/@deep-search
type xs:boolean
properties
use optional
default false
annotation
documentation
Determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, this attribute is ignored.
source <xs:attribute name="deep-search" type="xs:boolean" use="optional" default="false">
 
<xs:annotation>
   
<xs:documentation>Determines whether the search for resources should extend to logical associations (true). This only applies to groups (where sub-groups will also be included) and locations (where associations by positions, organization units, and organizations will be included). For other entity types, this attribute is ignored.</xs:documentation>
 
</xs:annotation>
</xs:attribute>

element findResources/resource-name
diagram deservices_wsdl_diagrams/deservices_wsdl_p2442.png
type xs:string
properties
minOcc 0
maxOcc unbounded
content simple
annotation
documentation
Names the resource(s) to be searched for. There may be two, or more, resources that share the same name, so the response may include more than one result for each name provided.
source <xs:element name="resource-name" type="xs:string" minOccurs="0" maxOccurs="unbounded">
 
<xs:annotation>
   
<xs:documentation>Names the resource(s) to be searched for. There may be two, or more, resources that share the same name, so the response may include more than one result for each name provided.</xs:documentation>
 
</xs:annotation>
</xs:element>

WSDL documentation generated by XMLSpy WSDL Editor http://www.altova.com/xmlspy