Service Description Editor

The Service Description Editor enables you to edit a virtual service description, including editing metadata, managing XML schemas, adding and removing operations, and defining session identifiers.

To access
  • In the Virtualization Explorer, expand a virtual service and double-click the service description.
  • In the Virtual Service Editor, under Service Description, click Edit.
  • In the Data Model Editor, select one of the following:

    • URI Spaces > Edit URI Spaces
    • Operations > Edit Operations
Important information

Not all editing operations are available for all protocols.

You can edit URI Spaces when working with the REST protocol, and edit operations when working with XML protocols.

Relevant tasks Edit a Service Description
See also Service Descriptions

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element Description
<Operations pane>

Located in the left pane of the editor. Displays a list of the operations or URI spaces in the service.

Enter text in the filter box to filter for specific operations in the list.

Select an operation or URI space to display its details.

Add Operation

Located at the bottom of the operations pane.

XML services: Opens the Add Operation dialog box, enabling you to select input and output message types. You must assign each operation a unique input message type. Available for XML services.

SAP RFC services: Connects to the SAP Server and displays a list of available operations that you can add to your virtual service.

SAP IDoc services: Select fields to use for request and response message pairing. For more details, see Virtualize SAP IDoc Communication.

FIX services: Request and response elements from the FIX dictionary are displayed. Select a request element, and (optionally) one or more response elements.

SWIFT over WebSphere MQ services: Select the MT message types for the request and response elements.

Add URI Space

Located at the bottom of the operations pane.

Opens the Add New URI Space dialog box, enabling you to create a new URI space. Enter the URI path. For additional instructions on defining a URI path, see Define the URI Space.

Available for REST services.

Delete Operation/URI Space

Located at the bottom of the operations pane.

Deletes the selected operation/URI space.

IDoc Correlation Settings

Enables you to edit settings for asynchronous IDoc message transfer between two SAP systems.

For details, see Virtualize SAP IDoc Communication.

Available for a SAP IDoc service.

Session ID Definition

Defines the elements used to identify requests coming from the same source during a Learning session.

The following identifiers are configured by default:

  • For HTTP: ClientAddress metadata
  • For MQ: UserID metadata

Other transport protocols (TibcoEMS, GenericJMS, JDBC) do not have default session identifiers. Tracks are created after each Learning session.

Click Edit to modify the settings. For details, see Session ID Definition Wizard.

Message Metadata Enables you to edit request and response metadata. Click Edit to open the Edit Metadata dialog box. For details, see Edit Metadata Dialog Box.
XML Schemas

Lists all XML schema defined in the service description. You can add an XML schema, or edit or remove schemas.

  • Add. Opens the Import XML Schema dialog box, enabling you to enter a file location for an existing schema (.xsd file), and add it to the service description.
  • Edit. Opens the schema in an XML editor, enabling you to modify the schema. Click the Tools pane to access tools for editing the schema.
  • Delete. Removes the schema from the service description.
URI Space Properties Displays the URI space path.
Data Formats

Lists the available request and response data formats.

Click Add to add a new data format. For details, see Add Data Format Dialog Box.

Available for URI spaces.

Data Masking Enables you to hide specific data elements, to protect sensitive data. For details, see Data Masking Dialog Box.