API Management 10.4 | Using CentraSite | Runtime Governance | Virtual Service Asset Management | Managing Virtual Service Assets through CentraSite Control | Virtual SOAP Service Management | Adding Virtual Service from Scratch
 
Adding Virtual Service from Scratch
To create and manage a Virtual Service asset in CentraSite Control, you must have the following permissions:
*Create Assets —OR— Manage Assets
*Manage Runtime Policies (required to configure Virtual Services)
*Mediator Publisher (required to deploy Virtual Services)
Note: If user has View permission on a Web Service and Create Assets permission for the organization where you will add the Virtual Service, then the user can virtualize that Service. However, the user will not be permitted to configure the processing steps for the Virtual Service that is virtualized unless the user also has the Manage Runtime Policies permission for that organization. Only users with Manage Runtime Policies permission can configure these steps.
Consider identifying a small group of users who will be responsible for configuring the processing steps for a Virtual Service and give this group a role that includes the Manage Runtime Policies permission. Because these users might configure the Virtual Services that other users have added to the catalog, they will also need Modify permission on the actual Virtual Service. To ensure that these users have access to the Virtual Services that they need to configure, consider creating a design/change-time policy that automatically gives this group of users Modify permission on the Virtual Service after it is virtualized.
The following general guidelines apply when adding a Virtual Service in CentraSite Control:
*Ensure that the interface for the Native Service is completely implemented, and that interface is reflected in the WSDL file that is registered for the Web Service in the CentraSite registry.
*An instance of the Web Service is deployed and running at a known point in network.
*The metadata for the Native Service is valid and up-to-date. If the metadata for the Native Service has not been completely specified or is out-of-date, you should update it before you generate the Virtual Service so that you do not carry inaccurate/incomplete data into the Virtual Service.
* To add a Virtual Service asset from scratch
1. In CentraSite Control, go to Asset Catalog > Browse.
2. Click Add Asset.
3. In the Add Asset dialog box, provide the required information for each of the displayed data fields.
Field
Description
Type
The asset type, Virtual Service.
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 asset with the same name already exists in the CentraSite registry, a warning message will be issued.
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.
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.)
Note: Select the organization with care. You cannot change the organization assignment after the Virtual Service is added to the catalog. You can, however, export a Virtual Service from one organization and import it to another.
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 to indicate that the Virtual Service has been updated. The default is 1.0.
Examples:
0.0a
1.0.0 (beta)
Pre-release 001
V1-2007.04.30
You can use any versioning scheme you choose. The version identifier does not need to be numeric. This is the "public" version identifier that CentraSite Control shows to users when it displays the list of services.
In addition, CentraSite automatically generates a system version number, which is visible on the Virtual Service detail page. The system version number is independent from the version number you specify here. For more information, see the CentraSite User’s Guide.
Create a Run-Time Policy
Select this check box to specify the behavior for the run-time policy (or policies) associated with the Virtual Service. If you select the check box, the run-time policy or policies associated with the Virtual Service will be created automatically when the Web Service is virtualized. If you do not select the check box, the run-time policy or policies will not be created when the Web Service is virtualized.
You can only select the check box if you have the Manage Runtime Policies organization-level permission; without this permission, the check box is deactivated.
4. Click OK.
Important: During virtualization of a Web Service asset, CentraSite will not allow you to add the Virtual Service asset to the catalog unless you specify all of the required attributes defined in the asset type definition, and all the referenced objects to which the asset has an association.
The details page of the newly created Virtual Service asset is displayed.
5. Configure the extended attributes (contained within the profiles) of the Virtual Service asset to suit your requirements.
Copyright © 2015- 2019 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release