CentraSite Documentation : CentraSite User’s Guide : Using the Asset Catalog : Publishing a New Asset into the Catalog : Adding an Asset to the Catalog Using an Importer : Importing Web Services (including Abstract Services) : How to Import a Web Service
How to Import a Web Service
To import a Web Service asset to the catalog
Before you begin, you must have the WSDL file that you want to import. This file can reside on the file system of the computer where your browser is running or it can reside anywhere on the network, as long as its location is addressable through a URL.
1. In CentraSite Control, go to Asset Catalog > Browse.
2. Click the Import icon.
3. In the Import dialog, specify the following attributes:
In this field...
Do the following...
Organization
Choose the organization to which the asset will be added. (The drop-down list will contain the list of organizations to which you are permitted to add assets.) If you select an organization other than your own organization, you will nevertheless be the owner of the asset.
Note:  
Choose the organization with care. You cannot change the organization assignment after the asset is added to the catalog. You can, however, export an asset from one organization and import it to another.
Import as
Choose Web Service.
Initial Version
Enter an identifier for the initial version of the asset. This is the user-defined version, as opposed to the automatically assigned system version. You can enter any string in this field, that is, the version identifier does not need to be numeric. You can also leave the field blank. You can later create new versions of the asset, Generating New Asset Versions.
If the versioning feature is disabled for this asset type, the field is nevertheless displayed, thus allowing you to assign an identifier for this first version.
If the import of the asset also causes other related objects to be imported (for example, if the WSDL definition for a Web service includes references to other WSDL or schema definition files), the initial version is only assigned to the main asset identified in this dialog, and the initial version of the other imported objects is not assigned.
Name
Optional. Enter a the name for the service.
If you do not specify a name, the name is set automatically to the value of the name attribute in the definitions element of the WSDL. If the name attribute is not specified in the WSDL, a dialog opens in which you can specify the name.
Import from
Specify whether the input file will be read from a URL-addressable location on the network (the URL option) or from your local file system (the File option).
URL or File
If the file you are importing resides on the network, specify its URL.
If the file resides in your local file system, specify the file name. You can use the Browse button to navigate to the required folder.
URL Authentication
If you have specified a URL, and the site you want to access through the URL requires user authentication, check this box. This opens an Authentication sub-dialog in which you can enter a username and password for authentication at the URL site.
Interactive resolution of Import/Includes
This option determines how referenced WSDLs/schemas are handled when the WSDL/schema that is referred to already exists in the registry. When this option is enabled, you will be prompted during import to specify whether you want to reuse any WSDL/schema files referred to in the main file or upload new files.
4. Click Finish.
CentraSite retrieves the specified file and generates the catalog entry. The Web service asset’s details page is displayed.
What Happens When You Import a New WSDL File?
CentraSite retrieves the specified file and generates the catalog entry. If you have specified Interactive resolution of Import/Includes, you will be prompted to specify whether you wish to reuse any of the WSDL/schema files referred to in the main WSDL file or upload new files.
What Happens When You Import an Existing WSDL File?
If the importer detects that the service you are trying to import already exists within CentraSite, the import dialog will prompt you to specify whether you want to Overwrite latest version or Create new version. If you have specified Interactive resolution of Import/Includes, you will be prompted to specify whether you wish to reuse any of the WSDL/schema files referred to in the main WSDL file using IMPORT or INCLUDE statements or upload new files.
5. During import of a Web Service asset, CentraSite will not allow you to add the service to the asset catalog unless you have specified all "required" attributes in the Web Service type definition and all referenced objects to which the WSDL file has an association. The value for the "required" attribute must be specified in the Web service’s profile. Additionally, if the Web service asset has internally referenced objects, the value for the "required" attributes of all such referenced objects should be specified by choosing the Next button at the top right side of the details page in order to add the Web Service asset to the asset catalog. Thus, for example, if the WSDL/XML schema files that are referenced in the main WSDL file have "required" attributes, then you will be prompted to specify a value for the required attributes in order to save the asset.
6. After you specify the value for all of the required attributes, click Save to save the Web Service asset.
7. Review the import log that CentraSite displays after the import process. If errors occur while reading and processing the file, they will be reported in this log.
8. Configure the asset's extended attributes as described in Editing an Asset in the Catalog.
Tip:  
If you have previously imported a WSDL that has an associated schema file and you now re-import the same WSDL with a modified schema file, your browser might not display the updated contents of the schema file when you click on the external link for the schema file. This can happen if the browser cache is not being updated automatically. To rectify the problem, you can change your browser settings so that pages are always updated on every visit.
Copyright © 2005-2016 Software AG, Darmstadt, Germany.
Product LogoContact Support   |   Community   |   Feedback