CentraSite 10.11 | CentraSite Developer's Guide | Web Service Interfaces | Approval Service | Search Service Operations
 
Search Service Operations
The Search service provides a set of operations that supplies various information about registered services inside CentraSite.
The WSDL for the Search service is located here:
http://server:port/wsstack/services/SearchService?wsdl
where server is the machine in which the Software AG Runtime is running and port is the port on which the Software AG Runtime is listening (port 53307 if CentraSite is configured to use the default Software AG Runtime port number).
The following lists the operations that the Search service provides:
*findAllServices
*findServices
*findOrganizations
*getAllServiceDetails
*getServiceDetails
*getAllAssociatedServices
*getAssociatedServices
findServices and findAllServices
The findServices operation returns a list of services in CentraSite. You can optionally filter the list by specific criteria.
The findAllServices operation, in addition, returns a list of registered services in Integration Server.
Input Message
Parameter Name
Description
locationCentraSite
(Optional). (String). The address of the CentraSite registry repository (CRR) from which you want to retrieve the search requests. The registry or repository runs at the following URL:
http://server:port/CentraSite/CentraSite
Where server is the machine on which the CRR is running and port is the port on which CentraSite is listening to requests.
If you do not specify locationCentraSite, the Search service uses the following default URL:
http://localhost:53307/CentraSite/CentraSite
keyword
(Mandatory). (String). The pattern for matching an exact service name or %, or * for matching all services.
organizationKey
(Optional). (String). (Array). The UDDI key or the organization name where the services belong to.
owner
Optional). (String). (Array). The first and last name of the owner of services to be selected. The first and last name must be separated with a ,.
lifeCycleStateName
(Optional). (String). The name of a valid lifecycle state currently active with the service type. Only the services matching that lifecycle state will be selected. You may specify multiple lifecycle state name elements to match more states.
product
(Optional). (String). A product name the service is classified with. If specified it must be a valid name among the Products taxonomy of CentraSite, for example, ARIS. You may specify multiple product name elements to match more product classifications.
locale
(Optional). (String). The locale in which you want the results to be returned.
sortCriteria
Sort criteria for returning the result in a sorted order. Possible values are:
*SortByNameAsc
*SortByNameDesc
*SortByDateAsc
*SortByDateDesc
*Organization
scroll
(Optional). (Scroll). If you want to return a particular block of entries from the result set, specify the following values in the scroll element.
start
(Integer). The first entry that you want to include in the block (where 1 represents the first entry in the entire result set).
number
(Optional). (Integer). The number of entries to be returned in the block of approval requests.
If you specify a start value, but no number value, then the remainder of the result set is returned.
Output Message
ServiceInfo[]
Parameter Name
Description
ServiceInfo - An array of ServiceInfo elements. Each ServiceInfo entry represents one registered service. The ServiceInfo message has the following details:
key
The UDDI key of the service.
name
The display name of the service.
wsdlURL
The URL of the service’s WSDL in the CentraSite repository.
lifeCycleState
The name of the current lifecycle state
owner
The user who created the service.
organizationKey
The UDDI key of the organization which owns the service.
organizationName
The organization which owns the service.
version
The user-assigned version identifier for the service.
Example SOAP Request
Returns the first 10 services for a particular organization, sorted by name in ascending order:
<soapenv:Body>
<findAllServices>
<locationCentraSite></locationCentraSite>
<keyword>*<keyword>
<organizationKey>uddi:207ff1cc-25c5-544c-415c-5d98ea91060c
</organizationKey>
<owner></owner>
<product></product>
<locale>EN</locale>
<sortCriteria>SortByNameAsc</sortCriteria>
<scroll>
<start>1</start>
<number>10</number>
</scroll>
</findAllServices>
</soapenv:Body>
findOrganizations
The findOrganizations operation returns a list of organizations in CentraSite. You can optionally filter the list by specific criteria.
Input Message
Parameter Name
Description
locationCentraSite
(Optional). (String). The address of the CentraSite registry repository (CRR) from which you want to retrieve the search requests. The registry or repository runs at the following URL:
http://server:port/CentraSite/CentraSite
Where server is the machine on which the CRR is running and port is the port on which CentraSite is listening to requests.
If you do not specify locationCentraSite, the Search service uses the following default URL:
http://localhost:53307/CentraSite/CentraSite
keyword
(Mandatory). (String). The pattern for matching an exact organization name or %, or * for matching all organizations.
locale
(Optional). (String). The locale in which you want the results to be returned.
sortCriteria
Sort criteria for returning the result in a sorted order. Possible values are:
*SortByNameAsc
*SortByNameDesc
*SortByDateAsc
*SortByDateDesc
*Organization
scroll
(Optional). (Scroll). If you want to return a particular block of entries from the result set, specify the following values in the scroll element.
start
(Integer). The first entry that you want to include in the block (where 1 represents the first entry in the entire result set).
number
(Optional). (Integer). The number of entries to be returned in the block of approval requests.
If you specify a start value, but no number value, then the remainder of the result set is returned.
Output Message
OrganizationInfo[]
Parameter Name
Description
OrganizationInfo - An array of OrganizationInfo elements. Each OrganizationInfo entry represents one organization. The OrganizationInfo message has the following details:
key
The UDDI key of the organization.
name
The display name of the organization.
description
The description for the organization.
Example SOAP Request
Returns information for the organization myorg:
<soapenv:Body>
<findOrganizations>
<locationCentraSite>
http://localhost:53305/CentraSite/CentraSite
</locationCentraSite>
<keyword>myorg</keyword>
<locale>DE</locale>
<sortCriteria></sortCriteria>
</findOrganizations>
</soapenv:Body>
getServiceDetails and getAllServiceDetails
The getServiceDetails operation returns a detailed information about a particular service in CentraSite. You can optionally filter the list of service information by specific criteria.
The getAllServiceDetails operation, in addition, returns a list of additional properties for the service.
Input Message
Parameter Name
Description
locationCentraSite
(Optional). (String). The address of the CentraSite registry repository (CRR) from which you want to retrieve the search requests. The registry or repository runs at the following URL:
http://server:port/CentraSite/CentraSite
Where server is the machine on which the CRR is running and port is the port on which CentraSite is listening to requests.
If you do not specify locationCentraSite, the Search service uses the following default URL:
http://localhost:53307/CentraSite/CentraSite
serviceKey
(Optional). (String). (Array). The UDDI key of the service.
locale
(Optional). (String). The locale in which you want the results to be returned.
Output Message
ServiceDetail[]
Parameter Name
Description
ServiceDetail - An array of ServiceDetail elements for each of the service. The ServiceDetail message has the following details:
key
The UDDI key of the service.
name
The display name of the service.
wsdlURL
The URL of the service’s WSDL in the CentraSite repository.
lifeCycleState
The name of the current lifecycle state
owner
The user who created the service.
organizationKey
The UDDI key of the organization which owns the service.
organizationName
The organization which owns the service.
version
The user-assigned version identifier for the service.
property
service namespace - The target namespace of the service.
OperationInfo[] - An array of OperationInfo for the service.
key
The UDDI key of the service.
name
The display name of the service.
description
The description for the service.
property
*input - The input message.
*output - The output message.
Example SOAP Request
Returns detailed information for two particular services:
<soapenv:Body>
<getServiceDetails>
<locationCentraSite></locationCentraSite>
<serviceKey>uddi:372ad925-d207-11e4-8844-ad99cc9211e8</serviceKey>
<serviceKey>uddi:65f11014-c8b8-11e4-9dd8-c736d339af26</serviceKey>
<locale></locale>
</getServiceDetails>
</soapenv:Body>
getAssociatedServices and getAllAssociatedServices
The getAssociatedServices operation returns information about services that are associated to a particular service in CentraSite. You can optionally filter the list of service information by specific criteria.
Input Message
Parameter Name
Description
locationCentraSite
(Optional). (String). The address of the CentraSite registry repository (CRR) from which you want to retrieve the search requests. The registry or repository runs at the following URL:
http://server:port/CentraSite/CentraSite
Where server is the machine on which the CRR is running and port is the port on which CentraSite is listening to requests.
If you do not specify locationCentraSite, the Search service uses the following default URL:
http://localhost:53307/CentraSite/CentraSite
assetKey
(Optional). (String). (Array). The UDDI key of the service.
associationType
(Optional). (String). The name of the association type, for example, Uses, through which the asset references a service.
Output Message
ServiceDetail[]
Parameter Name
Description
ServiceDetail - An array of ServiceDetail elements for each of the service. The ServiceDetail message has the following details:
key
The UDDI key of the service.
name
The display name of the service.
wsdlURL
The URL of the service’s WSDL in the CentraSite repository.
lifeCycleState
The name of the current lifecycle state
owner
The user who created the service.
organizationKey
The UDDI key of the organization which owns the service.
organizationName
The organization which owns the service.
version
The user-assigned version identifier for the service.
property
service namespace - The target namespace of the service.
OperationInfo[] - An array of OperationInfo for the service.
key
The UDDI key of the service.
name
The display name of the service.
description
The description for the service.
property
*input - The input message.
*output - The output message.