Loading documents

You can load documents into WSRR by using the Load Document wizard.

About this task

You can load various types of document that contain service information into WSRR:

The documents themselves are stored in the repository, but as they are loaded, WSRR "shreds" them to produce a number of logical objects. WSRR in turn "correlates" the logical objects to create a number of business model objects. These objects represent the contents of the file in a form that you can use to control, model, and govern the services used in your enterprise.

The documents that you load might often be dependent on other documents (for example, WSDL documents and XSD documents). The wizard identifies these dependencies and enables you to resolve them by identifying the locations of the required documents.

You can load files from the local system, by specifying or browsing for a file path. You can load files from a remote system by specifying a URL.

In addition to the service documents, you can load supporting documents into WSRR. You can then link these documents to the objects they support.

You can use the Load Document wizard to load the following types of document:
  • WSDL
  • XSD
  • XML
  • Policy
  • SCA integration module
  • ZIP/JAR file
  • Other (files of any other format than those listed)
You can use the wizard to specify a number of documents and then load them into WSRR in a single operation.

Procedure

  1. Start the Load Document wizard. You can start the wizard from the Actions widget in spaces based on the development or operations templates. You can also start the wizard to load a document when editing a relationship property in the Detail widget view of an item.
  2. Specify whether to load a local or remote file:
    • To load a local file, select Load from file system and enter, or browse for, the document location.
    • To load a file from a remote system, select Load from remote location and enter the URL for the document location.
  3. Specify the document that you want to load by typing the path or URL directly, or click Browse and browse for the file.
  4. Specify the type of document you are loading, or keep the Automatically detect document type setting to have to wizard detect the type.
  5. Optionally, enter a description of the document.
  6. Optionally, enter a version number for the document.
  7. Click Next to go to the next screen. This screen gives a view of the documents that the wizard will load into WSRR, and of their dependencies.
  8. You can, if required, change details of the documents that you identified for loading:
    • Click Describe to add or alter a document description or version number.
    • Click Replace to specify a different document path or URL.
    • Click Remove if you change your mind about loading this document.
  9. Resolve any dependencies for the documents that you are loading. Dependencies can be in one of the following states:
    • In repository. WSRR has identified that the required document is already in the repository. You can click Replace to specify a different version of this document to be loaded if required.
    • Required. WSRR has identified that this document also needs to be loaded as the document you have specified is dependent upon it. Click Add to identify the document to be loaded to satisfy the dependency. The state of the document changes to Ready to load.
    • Multiple matches in repository. WSRR has identified more than one document in the repository that satisfy the dependency requirement. Click Select Document and select the document that you want to use, or specify another document to load to satisfy the dependency.
  10. If required, click Add Another Document and repeat steps 2 to 8 to specify another document to load.
  11. When you have specified all the documents that you want to load, and resolved all the dependencies, click Finish to load the documents into WSRR. The wizard confirms that loading was successful, and you can click a document name to view its details in the Detail widget.
  12. Click Close to close the wizard.