Detail widget: Add Version

From the enhanced Detail widget for a business capability item or subtype, you can create new versions of the capability if your administrator has enabled the feature.

The ability to add versions is configured in the Detail Display Settings window of the Detail widget (see Configuring the Detail widget).

When you access the Detail widget, if no version has yet been created for the business capability, the following message is displayed with an Add Version link: There are currently no versions.

Adding a version where none is available

If at least one version exists, you can click the arrow next to the version title to display a drop-down list that shows the available versions, and an Add Version link.

Adding a version where at least one is already available

To add a new version to the capability, click Add Version. The resulting "Add Version to: Capability_Name" panel is displayed with Overview, Interface, and Endpoints tabs. You can specify details about the version in these tabs in a similar manner to accessing the tabs in edit mode from the Detail widget.

Overview tab

From the Overview tab, specify a standard set of properties and relationship targets:

Specify the default mandatory properties for the version being created; for example, the name, and a unique version or release.
Specify optional properties such as a description, namespace, and the availability and termination dates of the version.
Add relationship targets for the set of configured relationships that are displayed. For example, if Owning Organization and Assigned Artifacts are displayed as relationships, you can specify which organization owns the version, and add one or more documents as artifacts.

For more information about completing the Overview tab, see Edit mode: Overview tab.

Interface tab

From the Interface tab, add related SLDs and service interfaces to the version. The type of SLDs (service level definition only, extended service level definition only, or both) that you can add is configured by your system administrator.

Use either of the following methods:

Add a service interface and simultaneously add or create its related SLD by clicking Add Service Interface. You can either find or load a WSDL-based service interface, or find or create a REST service interface:
- If you find or load a WSDL-based service interface, its related SLD and assigned operations are also added to the version and are shown in the Interface tab.
- If you find a REST service interface, its related SLD and assigned operations are also added to the version and are shown in the Interface tab.
- If you create a REST service interface, an SLD named SLD - REST_interface_name is automatically created and added to the version. The newly created SLD and service interface, and any operations that you added while creating the service interface are shown in the Interface tab.
Add an SLD, and then subsequently add a service interface by clicking Add Service Level Definition:
- You can find and add one or more existing SLDs to the version simultaneously. When you add an existing SLD, any defined service interface and available operations are also added to the version and are shown in the Interface tab.
- You can create and add an SLD to the version. After the SLD is shown in the Interface tab, you can then add a service interface and available operations to the SLD.

For any SLD that you add, you can replace or remove the defined service interface, and add or remove available operations. You can also remove an SLD from the version by clicking the Remove icon () next to the SLD name. For more information about completing the Interface tab, see Edit mode: Interface tab.

Note: The count on the Interface tab is automatically updated to reflect the number of service interface items on the added SLDs. These SLDs are also automatically added to the Endpoints tab, and any service endpoints that are defined for an existing SLD are shown within the SLD section in the tab. Likewise, SLDs that you remove from the Interface tab are automatically removed from the Endpoints tab.

Endpoints tab

From the Endpoints tab, you can add related SLDs and service endpoints to the version. The type of SLDs (service level definition only, extended service level definition only, or both) that you can add is configured by your system administrator.

If you have not yet added any SLDs to the Interface tab, the Endpoints tab is shown with the message "There are no endpoints.", and the Add Service Level Definition link.

If you have added SLDs and service interfaces to the Interface tab, those SLDs are shown in the Endpoints tab, together with any endpoints that are assigned to each service interface. The Add Service Level Definition link is also shown.

You can add an SLD, and subsequently add endpoints by clicking Add Service Level Definition and completing either of the following steps:

Find and add one or more existing SLDs to the version simultaneously. When you add an existing SLD, any defined endpoints are also added to the version and are shown in the Endpoints tab.
Create and add an SLD to the version. The SLD is shown in the Endpoints tab.
Note: If you add a new or existing SLD with no defined service interface, you can add endpoints only after adding a service interface from the Interface tab.

After you add an SLD, you can add service endpoints to, or remove them from, the SLD. You can also remove an SLD from the version by clicking the Remove icon () next to the SLD name. For more information about completing the Endpoints tab, see Edit mode: Endpoints tab.

Note: The count on the Endpoints tab is automatically updated to reflect the number of service endpoints on the added SLDs. Any SLDs that you add to the Endpoints tab are also automatically added to the Interface tab, and any service interface and operations that are assigned to an existing SLD are shown within the SLD section in that tab. Likewise, SLDs that you remove from the Endpoints tab are automatically removed from the Interface tab.

After you complete these tabs, you can click Finish to save the details and close the panel, or click Cancel to exit without saving. After you click Finish, the version details are displayed in up to five tabs (as configured by your system administrator) named Overview, Interface, Endpoints, Consumers, and Consumes. For more information about these tabs, see Detail widget.