Load Documents

Use this page to load a document together with all its dependent documents, or to save the documents as a document group.

Import statements in the XML content of a document create dependencies on other documents (a WSDL service can import a WSDL binding, for example), and to load a document into the repository, its dependent documents must also be present.

You can use this page to add multiple documents, in a non-linear order, to a document list, and to resolve all import dependencies before loading the complete list of documents into the repository. You can also create a named document group that references all the documents.

You can load a document from a local system or a remote system. If the document is on a local system, click Local file system and either type the name of the file in the entry field, or select it using the Browse button. If the document is on a remote system, click Remote file location and specify the URL of the document.

Note: Microsoft Internet Explorer users - If you type the file name and it is not valid, Internet Explorer will not submit the form and will not respond with any error message.

Restriction: When you load documents through the web UI using a browser, such as Microsoft Internet Explorer or Mozilla Firefox, the resulting location property values set on the supplied documents do not include any path information because these browsers no longer return path information for supplied files for security reasons. Relative path information is present in the location property if the files have been loaded inside a .zip or a .jar file. In this case the level of browser does not affect the paths, because they are read from inside the file.

You can access the Load Documents page in any of the following ways:

Click Actions > Load Documents, or Service Documents > Load Documents in the navigation tree, if you have this displayed.
You can then select the required document type from a list. The document types are as follows:
- WSDL: WSDL service definition
- XSD: XML schema definition
- XML: XML metadata file
- Policy: WS-Policy definition
- Other: any type of document (for example: Word, Powerpoint, Visio, or Excel) for which the standard document types recognized by the registry is not appropriate
- SCA integration module: SCA module definition
- ZIP/JAR file: a compressed file containing one or more documents of any of the above types. All the documents in the file will be loaded in a single operation.
  Note: The file must be in .zip file format; no other compression formats are supported.
Click the Load Documents button from within a collection panel. The document type is preset to the collection type, for example WSDL.
Click the New button from within the Document Groups collection panel.
Click the Load Document button when adding targets to a relationship.

You can, optionally, enter a document description, a document version and, in the case of XML documents and documents of type Other, a namespace. Multiple versions of the same document can be stored in the registry. There is no management of the version numbering scheme, or any automatic version increments. The version field is a free-format string. However, you might find it helpful to use numeric versioning, so that users can easily find out whether one document is newer or older than another.

The description and version can consist of any characters from the UTF-8 character set, but they are limited to no more than 4000 bytes (description) and 1020 bytes (version) of storage.

Note: If you load a WSDL document, a special property is derived automatically by combining the namespace and version, and the length of this property must not exceed the 1020 byte limit, otherwise the document load fails; for more details, see the topic "Problems with loading documents, and importing and exporting archives" in the WSRR information center.

When you have provided the required information, click OK. If the document type is SCA integration module, the SCA integration module will be loaded and its details displayed, otherwise either the Documents to be loaded or the Documents to be saved as a group page will be displayed. This page displays a document list that, initially, contains the document you specified on the Load Documents page, or, if the document type is ZIP/JAR file, the documents contained in the specified compressed file. You can then add further documents to the document list, and, in the case of WSDL and XSD documents, resolve all import dependencies before loading the complete list of documents into the repository.

As you proceed with the document load operation, further pages are displayed for you to complete the operation successfully; these are described in the following subtopics: