Version 9.6
 —  Using the Asset Catalog  —

Downloading an Asset

CentraSite Control offers two methods of retrieving the source files of CentraSite assets, namely exporting and downloading. The source file is the file that was imported into CentraSite in order to create the registry entry for the asset. For example, the source file for a web service asset is the service's WSDL file. The source file for an XML schema asset is its schema file. The difference between exporting and downloading is as follows:

If an asset was not created by an importer, but was instead created from scratch without using a source file, the download feature can still be activated. In this case, however, the downloaded zip file does not contain an asset source file but instead only contains files from the Supporting Document Library that are attached to the asset.


Permissions

If you use the download feature to create a zip file, it contains only the files that you have permission to view.

Top of page

Performing the Zip Download

The asset that you want to download must belong to an asset type for which there is an importer. The importer can be either one of the predefined importers (see the list of available importers in the section Publishing a New Asset into the Catalog), or a user-defined importer.

To download an asset and its associated files, proceed as follows:

Start of instruction setTo download an asset and its associated files

  1. Use the Asset Catalog > Browse or Asset Catalog > Search feature to locate the asset you want to download.

  2. Click OK. This starts the creation of the zip file.

    The default location to which the zip file is downloaded is My Documents\Downloads.

Top of page

Structure of the Zip File

The zip file is organized as a directory that holds all the downloaded files. Subfolders are only created if any of the names of the downloaded files are not unique; in this case, the files are stored in consecutively numbered subfolders (for example: 1/SchemaA.xsd, 2/SchemaA.xsd, etc.).

If a downloaded file refers to one or more other downloaded files, for example if a WSDL file refers to a schema, the reference within the file is adjusted so that it points relatively to the file in the zip file. This is also true if the referenced file is located within a numbered subfolder.

Example: The WSDL file Service.wsdl refers to SchemaA.xsd, to another SchemaA.xsd with a different namespace, and to SchemaB.xsd. The resulting zip file has the following structure:

Service.wsdl
1/SchemaA.xsd
2/SchemaA.xsd
SchemaB.xsd

Top of page

Performing the Single Document Download

You can download a document from the Supporting Document Library or from an asset, as usual text file. To do this, proceed as follows:

Start of instruction setTo download documents directly from the Supporting Document Library

  1. Open the Supporting Document Library of a specific organization by clicking Asset Catalog > Supporting Documents.

  2. Select the checkbox for the required document or documents.

  3. Click Download.

    Note:
    If you selected more than one document, the output is directed to a zip file.

Start of instruction setTo download an attached document from the Supporting Document Library

  1. Open the detail view of the asset to which the supporting document is attached.

  2. Open the Specification or the Details profile, as appropriate for the asset type.

    This shows the files that are attached to the asset.

  3. Locate the supporting document that you want to download. Click the Download button for this entry.

  4. Specify the location in the file system where you want to store the supporting document, then click OK.

Start of instruction setTo download a WSDL document from a Service or an XSD document from a Schema

  1. Open the Summary tab of the asset.

  2. Click on the WSDL/URL hyperlink.

  3. Click the Download button.

  4. Specify the location in the file system where you want to store the supporting document, then click OK.

    If the WSDL or schema file includes a reference to another file (usually a relative address) in the repository, then this reference will be changed to an absolute repository address.

Start of instruction setTo download schemas from REST services or XML services

  1. Locate the Technical Details profile.

  2. Click the Download button adjacent to the attribute "Schema Name".

Top of page