Software AG Products 10.5 | Using CentraSite | Runtime Governance | Virtual Service Asset Management | Managing Virtual Service Assets through CentraSite Business UI | Virtual Service Management | Adding Virtual Service to Your Asset Catalog | Adding Virtual Service from Scratch
 
Adding Virtual Service from Scratch
Pre-requisites:
To add a Virtual Service asset to an organization's asset catalog, you must belong to a role that has the Create Assets or Manage Assets permission for that organization.
Note:
By default, users with the CentraSite Administrator or Asset Administrator role have this permission.
Before you add a Web Service asset to the catalog, you must have the WSDL specification 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.
*To add a Virtual Service from scratch
1. In the CentraSite Business UI activity bar, click Create Asset.
This opens the Create Asset wizard.
2. In the area labeled Basic Information, provide the required information for each of the displayed data fields:
Field
Description
Name
(Optional). Name of the Virtual Service asset.
The name of a Virtual Service asset must be NCName-conformant, meaning that:
*The name must begin with a letter or the underscore character (_).
*The remainder of the name can contain any combination of letters, digits, or the following characters: . - _ (that is, period, dash, or underscore). It can also contain combining characters and extender characters (for example, diacriticals).
*The name cannot contain any spaces.
*Furthermore, if the Virtual Service name contains any non-conformant character, upon publishing the Virtual Service to any gateway, the non-conformant character is simply replaced with the underscore character (_) in Mediator. However, in CentraSite the Virtual Service name defined by you is displayed.
For more information about the NCName type, see http://www.w3.org/TR/xmlschema-2/#NCName
Note:
The name of a Virtual Service asset must be unique within an organization. If, for example, a Virtual Service with the same name already exists within the CentraSite registry, a warning message will be issued.
By default, CentraSite populates the Create a New Virtual Alias field with the display name that was specified for the Native Service.
Type
The asset type, Virtual Service.
Organization
The organization to which you want to add the Virtual Service. (The Organization list only displays organizations for which you have the Manage Assets permission or at least the Create Assets permission.)
Version
(Optional). The version identifier for the Virtual Service. 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 Virtual Service. The default is 1.0.
Examples:
0.0a
1.0.0 (beta)
Pre-release 001
V1-2007.04.30
Description
(Optional). The description for the Virtual Service.
Note:
This is the description information that users will see when they view this Virtual Service asset in the CentraSite user interfaces. Therefore, we recommend that you specify a meaningful description for each Virtual Service.
Import a File
The input WSDL file for the Virtual Service. You may want to read the input WSDL file from a URL-addressable location on the network (the URL option) or from your local file system (the File option).
Option
Description
URL
If the WSDL file you are importing resides on the network, you can specify its URL.
File
If the specification resides in your local file system, specify the file name. You can use the Browse button to navigate to the required folder.
3. Click the Advanced Settings chevron to expand the additional options that are available for the Virtual Service asset. Provide the required information for each of the displayed fields:
Field
Description
Credentials
If you have specified a URL and the site you want to access through the URL requires user authentication, type a username and password for authentication at the URL site.
Resolution
Select a resolution strategy, which will allow you to specify how an already existing imported and included file is handled. For each of the imported and included files you have one of these options:
*Create new version: Creates a new version of the file with the new content (if, for example, you want to modify a WSDL file but want to retain its previous version).
*Always overwrite: Overwrites the importing file with new content.
4. Click Next.
You cannot navigate to the next screen unless all the required attributes have been set.
5. In the Preview panel, review the basic information for the Virtual Service before you add to the CentraSite registry.
6. Click Save.
A Virtual Service asset instance is created in the specified organization and registered with the CentraSite registry/repository. The details page for the Virtual Service asset that you just created is displayed.
7. Configure the extended attributes of the Virtual Service asset as described later in this topic.