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:
The export feature creates a zip file containing one or more assets from the repository, as well as all associated registry objects. The export feature is described in the document Importing/Exporting Registry Objects.
The download feature creates a zip file containing just the source file of a single asset from the repository, without any of the associated registry objects. If the source file refers to other source files in the repository (for example, a WSDL file can reference XML schema files), the referenced files will also be included in the zip file. If the asset refers to files in the Supporting Document Library, these can optionally be included in the zip file.
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.
If you use the download feature to create a zip file, it contains only the files that you have permission to view.
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:
To download an asset and its associated files
Use the
or feature to locate the asset you want to download.Choose
from the context menu of the asset,OR
choose
from the menu of the asset.In the Download Documents dialog, check the box Include Supporting Documents if you want to include attached documents from the Supporting Document Library.
Click
. This starts the creation of the zip file.The default location to which the zip file is downloaded is My Documents\Downloads.
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
You can download a document from the Supporting Document Library or from an asset, as usual text file. To do this, proceed as follows:
To download documents directly from the Supporting Document Library
Open the Supporting Document Library of a specific organization by clicking Asset Catalog > Supporting Documents.
Select the checkbox for the required document or documents.
Click
.Note:
If you selected more than one document, the output is directed to
a zip file.
To download an attached document from the Supporting Document Library
Open the detail view of the asset to which the supporting document is attached.
Open the Specification or the Details profile, as appropriate for the asset type.
This shows the files that are attached to the asset.
Locate the supporting document that you want to download. Click the
button for this entry.Specify the location in the file system where you want to store the supporting document, then click
.To download a WSDL document from a Service or an XSD document from a Schema
Open the Summary tab of the asset.
Click on the WSDL/URL hyperlink.
Click the
button.Specify the location in the file system where you want to store the supporting document, then click
.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.
To download schemas from REST services or XML services
Locate the Technical Details profile.
Click the
button adjacent to the attribute "Schema Name".