Discovering artifacts in a registry

The enterprise service discovery wizard finds the artifacts at a registry, lets you select which artifacts you want, and then imports the selection you have made.

Follow these steps to connect to a registry and retrieve the artifacts you want from it.
  1. Right-click the module name and from the context menu select New > Enterprise Service Discovery. Alternately, if no module or library exists, from the menu select File > New > Enterprise Service Discovery and create a module or library on the last page of the wizard. The Enterprise Service Discovery wizard opens. Select IBM WebSphere Service Registry and Repository. Click Next.


    Selecting a registry

  2. The Configure Settings for Discovery Agent page opens. Select the repository to connect to. Hover help is available. Click Next.


    Selecting a repository

  3. The Find and Discover Enterprise Services page opens. If you click Execute Query at this time then all the interfaces on the WebSphere Service Registry and Repository you selected will be queried and listed in the Objects discovered by query pane. If you want to limit the result or if you want to query other artifact types like business objects or other XML files, or both, then click the Edit Query button. We will use the Edit Query button to demonstrate how to edit a query.

    Click Edit Query. The Query Filter Properties page opens. The File type field specifies if the search will be for Web services (WSDL), business objects (XSD) or other XML code, such as business process execution language (BPEL) files.

    The Search field specifies the term that is searched in the name, description and owner properties. The search term is case sensitive. The search will find results that contain the search term in any position.

    The name, description and owner selections determine where the search term will be searched.
    • Name: If file type Web services (WSDL) is selected, then select name to find the search term in the file name, port type name or operation name. If file type Business object (XSD) is selected, then select name to find the search term in the file name, complex type name or simple type name. If file type other XML is selected, then select name to find the search term in the file name.
    • Description: If description is selected, then the search term is searched in the description property.
    • Owner: If owner is selected, then the search term is searched in the owner property.

    The search can be further constrained by specifying custom properties. For example, if there were several versions of the Web services in the WebSphere Service Registry and Repository, then your query could specify a version.

    Click OK.


    Using filtering to select the objects you want

  4. Click Execute Query to retrieve the artifacts you want. They will appear in the Objects discovered by query pane. Select the artifacts you want and click Add to import list, which will begin creating your query by adding the artifacts to the Objects to be imported pane. Return to editing the query with the Edit Query button to add more selections. Hover help provides descriptions of the artifacts you are viewing, if descriptions were added when the artifact was added into the WebSphere Service Registry and Repository. Details may also be available, which will be noticed when the Details button becomes active. The details include the name, description, Uniform Resource Identifier (URI), version and owner of the artifact.

    When you make a selection, you may receive a message asking if you want to also add the referenced files to the import list. The default is that you will add the referenced files though you may deselect this option.

    Click Next when all the objects you want have been added to the import list.


    Building a query

  5. The Generate Artifacts page opens. You can change the module at this time or create a new module. You can also specify a folder for the artifacts, which is helpful from an organizational view if you have many artifacts in the module.
    The following options are available:
    • You can overwrite existing files.
    • You can specify that inline schemas in interfaces should be placed into separate files, which is recommended if you intend to use these schemas with the WebSphere Integration Developer tools.
    • You can specify that WSDL services and bindings be placed into separate files.

    Click Finish to add the artifacts into your module.


    Specifying the properties of the artifacts you have selected

  6. The artifacts are added to the module. Schemas will be displayed in the business integration view as business objects, regardless of whether they are inline schemas or separate files.


    Artifacts added to module

Feedback
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.