Identifying a requirement for a new business capability

An important part of scoping an application or service is to identify how it adds value to the business. WSRR uses business capabilities to define the business view of an application or service.

If there is no existing business capability that the service realizes, then you must now create and define a business application. The key defining components that you must add are a service charter, to define the scope and role of the business application, and an owning organization; the owning organization is responsible for defining requirements for the capability, and owning any realizations of this capability, such as the Address Formatter service that is being reused from a service provider.

1. Create a business application.
   1. If you have security enabled, and have assigned separate user IDs to each of the governance enablement profile roles, as described in Governing an SCA service: the consumer story, log in to the Business Space user interface with the user ID that is assigned to the Business role. Otherwise, go to the next step.
   2. In the Business Space user interface, switch to the Business space if necessary, by clicking Go to Spaces > Business, and ensure that the Overview page is selected.
   3. In the Service Registry Actions widget, click Create a Business Application.
   4. Enter Commercial Address Formatter in the Name field, and Locale based address formatting application in the Description field.
   5. Click Add Other Document under the Charter relationship, and click Load. Select Load from file system, click Browse and navigate to the directory to which you extracted the tutorial sample files.
   6. Select CommercialAddressFormatterCharter.odt, and click Open.
   7. Click Next, and then click Finish to load the charter document.
   8. Click Finish. The Browse page is displayed. The Detail widget shows the new business application, and the governance state is Business Capability Identified.
2. Move the Commercial Address Formatter application through its lifecycle to the Approved state.
   1. In the Service Registry Detail widget, click Action > Propose Charter. The business service enters the Charter Review state, where an SOA Governance Center of Excellence can authorize or reject the capabilities, requirements, or ownership that have been defined so far.
   2. If you have security enabled, and have assigned separate user IDs to each of the governance enablement profile roles, as described in Governing an SCA service: the provider story, log in to the Business Space user interface with the user ID that is assigned to the SOAGovernance role. Otherwise, go to the next step.
   3. In the Business Space user interface, switch to the SOA Governance perspective, if necessary, by selecting Go to Spaces > SOAG, and ensure that the Overview page is selected.
   4. In the Watch List (SOA Governance) widget, click Commercial Address Formatter to display the business application details.
   5. Assign an owning organization to the business application.
      1. In the Service Registry Detail widget, click the Edit the metadata for this object icon ().
      2. Under Owning Organization, click Add Organization.
      3. Enter C in the Name field, and select Commercial from the list. The Commercial organization is added as a target of the Owning organization relationship. Note that the Commercial organization was created in the tutorial Creating an organizational structure.
      4. Click Finish to save your changes.
   6. In the Service Registry Detail widget, click Action > Approve Charter, and note that the new governance state is Business Capability Approved, meaning that it becomes visible to any other potential users of the capability.
3. Identify that the Commercial Address Formatter application is a version or realization of this capability, by referencing the Commercial Address Formatter application version from the Commercial Address Formatter business application.
   1. If you have security enabled, and have assigned separate user IDs to each of the governance enablement profile roles, as described in Governing an SCA service: the provider story, log in to the web user interface and log in with the user ID that is assigned to the Development role. Otherwise, go to the next step.
   2. In the web user interface, switch to the Development perspective, if necessary, by selecting Development from the Perspective list.
   3. Click View > Business Governance > Business Capabilities > Business Applications.
   4. Click Commercial Address Formatter to view the details.
   5. Click New Capability Version. A new Capability Version that is called Commercial Address Formatter is created under the Versions relationship.
4. View the Commercial Address Formatter business application structure that has been defined.
   1. Click Graphical View.
   2. Examine the structure of the Commercial Address Formatter business application, and its relationship to the Commercial Address Formatter application, as it is now stored in WSRR.