NIH | National Cancer Institute | NCI Wiki  

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup

{scrollbar}
{children}

h3. {page-info:title}
	
h4. Summary

h5. Description of the profile

A classification scheme for organizing services based on business objectives, domain, and usage 

  _The Service Metadata makes use of defined semantics, where the semantics may be used for categorization or providing other property and value information for description classes. This requires the following capabilities:_  
* semantic models that provide normative descriptions of the utilized terms, where the models may range from a simple dictionary of terms to an ontology showing complex relationships and capable of supporting enhanced reasoning; 
* mechanisms to support the storage, referencing, and access to these semantic models; 
* configuration management mechanisms to capture the normative description of each semantic model and to apply a unique identifier in a manner consistent with an identified versioning scheme; 
* one or more mechanisms to support the storage, referencing, and access to conversion relationships between semantic models, and the mechanisms to carry out such conversions.  

 The SOA concept of awareness defines capabilities related to service classification definition and usage:   
* classification of Description elements according to standardized classification schemes.

*Service Classification Schemes* specializes capabilities architecturally implied by its associated concepts of  Artifact , Awareness .  The implied architectural capabilities are described in the following paragraphs. 



*Artifact*  An artifact is a managed resource within the Semantic Infrastructure. 

 An artifact is associated with the following capabilities:  
* descriptions to enable the artifact to be visible, where the description includes a unique identifier for the artifact and a sufficient, and preferably a machine processible, representation of the meaning of terms used to describe the artifact, its functions, and its effects; 
* one or more discovery mechanisms that enable searching for artifacts that best meet the search criteria specified by the service participant; where the discovery mechanism will have access to the individual artifact descriptions, possibly through some repository mechanism; 
* accessible storage of artifacts and artifact descriptions, so service participants can access, examine, and use the artifacts as defined.

*Awareness*  A service participant is aware of another participant if it has access to a description of that participant with  sufficient completeness to establish the other requirements of visibility.

  Awareness is inherently a function of a participant; awareness can be established without any action on  the part of the target participant other than the target providing appropriate descriptions. Awareness is  often discussed in terms of consumer awareness of providers but the concepts are equally valid for  provider awareness of consumers.

  Awareness can be decomposed into the creation of descriptions, making them available, and discovering  the descriptions. Discovery can be initiated or it can be by notification. Initiated discovery for business  may require formalization of the required capabilities and resources to achieve business goals. 

  Mechanisms providing support for awareness will likely have the following minimum capabilities:   
* creation of Description, preferably conforming to a standard Description format and structure; 
* publishing of Description directly to a consumer or through a third party mediator; 
* discovery of Description, preferably conforming to a standard for Description discovery.  This capability is a specialization of the inherited discovery capability of Artifact; 
* notification of Description updates or notification of the addition of new and relevant  Descriptions; 
* classification of Description elements according to standardized classification schemes.


h5.  Capabilities


* [classification|#_16_5_1_24a0131_1283949608043_14699_2667]
* [creation|#_16_5_1_24a0131_1283949606647_99489_2631]
* [discovery|#_16_5_1_24a0131_1283714222600_103266_4106]
* [identity|#_16_5_1_24a0131_1283714222601_506267_4107]
* [metadata|#_16_5_1_24a0131_1283714222603_853936_4108]
* [notification|#_16_5_1_24a0131_1283949607586_662373_2655]
* [provenance|#_16_5_1_24a0131_1283793030699_512571_7056]
* [publication|#_16_5_1_24a0131_1283949607164_356366_2643]
* [serviceClassificationModel|#_16_5_1_24a0131_1283421703501_612424_9235]
* [store|#_16_5_1_24a0131_1283714222609_981432_4109]

h4. Requirements traceability
																					
																																			
																																			
																																			
																																			
																																			
																																
																																
																																			
																																
																																			
																																
																																			
																																
																		
||Requirement||Source||Capability||	
|The use of well defined service metadata promotes better discovery and reuse of services during design and run time. Service metadata includes information about service interactions and dependencies. It also includes a classification scheme for organizing services based on business objectives, domain, and usage. It also links services to all the supporting artifacts in the specification and provides a placeholder for conformance statements. This enables better reuse across the enterprise and eliminates redundancy. |Semantic Infrastructure Requirements::Service Discovery and Governance::{anchor:_16_5_1_24a0131_1283090102020_915508_4551}Administer Services|{li}[serviceClassificationModel|#_16_5_1_24a0131_1283421703501_612424_9235]{li}|	
|Service Oriented Architecture is an architectural paradigm for organizing and utilizing distributed capabilities that may be under the control of different ownership domains. Consequently, it is important that organizations that plan to engage in service interactions adopt governance policies and procedures sufficient to ensure that there is standardization across both internal and external organizational boundaries to promote the effective creation and use of SOA-based services.     SOA governance requires numerous architectural capabilities on the Semantic Infrastructure:      _Governance is expressed through policies and assumes multiple use of focused policy modules  that can be employed across many common circumstances_  This is elaborated in the inherited Policy profile.    _Governance requires that the participants understand the intent of governance, the structures created to define and implement governance, and the processes to be followed to make governance operational.  This is provided by capabilities specialized from the inherited Management Profile._    _Governance policies are made operational through rules and regulations. This is provided by the following capabilities, most of which are specializations of the inherited Artifact Profile:_   * descriptions to enable the rules and regulations to be visible, where the description includes a unique identifier and a sufficient, and preferably a machine process-able, representation of the meaning of terms used to describe the rules and regulations;  * one or more discovery mechanisms that enable searching for rules and regulations that may apply to situations corresponding to the search criteria specified by the service participant; where the discovery mechanism will have access to the individual descriptions of rules and regulations, possibly through some repository mechanism;  * accessible storage of rules and regulations and their respective descriptions, so service participants can understand and prepare for compliance, as defined.  * SOA services to access automated implementations of the Governance Processes.     _Governance implies management to define and enforce rules and regulations.._  This is elaborated in the inherited Management profile.    _Governance relies on metrics to define and measure compliance._  This is elaborated in the inherited Metric profile. |Semantic Profile::OASIS SOA::{anchor:_16_5_1_24a0131_1283763638521_214441_4616}Governance Model|{li}[discovery|#_16_5_1_24a0131_1283714222600_103266_4106] *from inherited abstract profile* Artifact{li}{li}[identity|#_16_5_1_24a0131_1283714222601_506267_4107] *from inherited abstract profile* Artifact{li}{li}[metadata|#_16_5_1_24a0131_1283714222603_853936_4108] *from inherited abstract profile* Artifact{li}{li}[store|#_16_5_1_24a0131_1283714222609_981432_4109] *from inherited abstract profile* Artifact{li}|	
|A service description is an artifact, usually document-based, that defines or references the information  needed to use, deploy, manage and otherwise control a service. This includes not only the information  and behavior models associated with a service to define the service interface but also includes  information needed to decide whether the service is appropriate for the current needs of the service consumer. Thus, the service description will also include information such as service reachability, service functionality, and the policies and contracts associated with a service.    A service description artifact may be a single document or it may be an interlinked set of documents.     Architectural implications of service description on the Semantic Infrastructure are reflected in the following functional decomposition:   * Description will change over time and its contents will reflect changing needs and context.  This is elaborated in the inherited Change profile.  * Description makes use of defined semantics, where the semantics may be used for  categorization or providing other property and value information for description classes. This is elaborated in the inherited Semantic Model profile.  * Descriptions include reference to policies defining conditions of use and optionally contracts  representing agreement on policies and other conditions.  This is elaborated in the inherited Policy profile.  * Descriptions include references to metrics which describe the operational characteristics of the  subjects being described.  This is elaborated in the inherited Metrics profile.  * Descriptions of the interactions are important for enabling auditability and repeatability, thereby  establishing a context for results and support for understanding observed change in performance  or results.  This is elaborated in the inherited Interaction profile.  * Descriptions may capture very focused information subsets or can be an aggregate of numerous  component descriptions. Service description is an example of a likely aggregate for which  manual maintenance of all aspects would not be feasible. This is elaborated in the inherited Composition profile.  * Descriptions provide up-to-date information on what a resource is, the conditions for interacting with the resource, and the results of such interactions. As such, the description is the source of vital information in establishing willingness to interact with a resource, reachability to make  interaction possible, and compliance with relevant conditions of use.  This is elaborated in the inherited Interoperability profile.      Policy capabilities are specialization of Artifact capabilities. |Semantic Profile::OASIS SOA::{anchor:_16_5_1_24a0131_1283763560612_868976_4608}Service Description Model|{li}[discovery|#_16_5_1_24a0131_1283714222600_103266_4106] *from inherited abstract profile* Artifact{li}{li}[identity|#_16_5_1_24a0131_1283714222601_506267_4107] *from inherited abstract profile* Artifact{li}{li}[metadata|#_16_5_1_24a0131_1283714222603_853936_4108] *from inherited abstract profile* Artifact{li}{li}[store|#_16_5_1_24a0131_1283714222609_981432_4109] *from inherited abstract profile* Artifact{li}|	
|One of the key requirements for participants interacting with each other in the context of a SOA is  achieving visibility: before services can interoperate, the participants have to be visible to each other  using whatever means are appropriate. The Reference Model analyzes visibility in terms of awareness,  willingness, and reachability.    Visibility in a SOA ecosystem has the following architectural implications on mechanisms providing  support for awareness, willingness, and reachability:    _Mechanisms providing support for awareness will likely have the following minimum capabilities:_   * creation of Description, preferably conforming to a standard Description format and structure;  * publishing of Description directly to a consumer or through a third party mediator;  * discovery of Description, preferably conforming to a standard for Description discovery;  * notification of Description updates or notification of the addition of new and relevant Descriptions;  * classification of Description elements according to standardized classification schemes.     _In a SOA ecosystem with complex social structures, awareness may be provided for specific communities of interest. The architectural mechanisms for providing awareness to communities of interest will require support for:_   * policies that allow dynamic formation of communities of interest;  * trust that awareness can be provided for and only for specific communities of interest, the bases of which is typically built on keying and encryption technology.     _The architectural mechanisms for determining willingness to interact will require support for:_   * verification of identity and credentials of the provider and/or consumer;  * access to and understanding of description;  * inspection of functionality and capabilities;  * inspection of policies and/or contracts.     _The architectural mechanisms for establishing reachability will require support for:_   * the location or address of an endpoint;  * verification and use of a service interface by means of a communication protocol;  * determination of presence with an endpoint which may only be determined at the point  interaction but may be further aided by the use of a presence protocol for which the endpoints  actively participate. |Semantic Profile::OASIS SOA::{anchor:_16_5_1_24a0131_1283763628053_328597_4610}Service Visibility Model|{li}[creation|#_16_5_1_24a0131_1283949606647_99489_2631] *from inherited abstract profile* Awareness{li}{li}[publication|#_16_5_1_24a0131_1283949607164_356366_2643] *from inherited abstract profile* Awareness{li}{li}[notification|#_16_5_1_24a0131_1283949607586_662373_2655] *from inherited abstract profile* Awareness{li}{li}[classification|#_16_5_1_24a0131_1283949608043_14699_2667] *from inherited abstract profile* Awareness{li}{li}[discovery|#_16_5_1_24a0131_1283714222600_103266_4106] *from inherited abstract profile* Artifact{li}|


h4. {anchor:_16_5_1_24a0131_1283949608043_14699_2667}classification
h5. Description

Classification of Description elements according to standardized classification schemes.
h5. Requirements addressed
																			
* [Service Visibility Model|#_16_5_1_24a0131_1283763628053_328597_4610]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283949606647_99489_2631}creation
h5. Description

Creation of Description, preferably conforming to a standard Description format and structure;
h5. Requirements addressed
																			
* [Service Visibility Model|#_16_5_1_24a0131_1283763628053_328597_4610]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283714222600_103266_4106}discovery
h5. Description

One or more discovery mechanisms that enable searching for artifacts that best meet the search criteria specified by the service participant; where the discovery mechanism will have access to the individual artifact descriptions, possibly through some repository mechanism.
h5. Requirements addressed
																			
* [Service Visibility Model|#_16_5_1_24a0131_1283763628053_328597_4610]																															
* [Service Description Model|#_16_5_1_24a0131_1283763560612_868976_4608]																															
* [Governance Model|#_16_5_1_24a0131_1283763638521_214441_4616]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283714222601_506267_4107}identity
h5. Description

Descriptions which include a unique identifier for the artifact.
h5. Requirements addressed
																			
* [Governance Model|#_16_5_1_24a0131_1283763638521_214441_4616]																															
* [Service Description Model|#_16_5_1_24a0131_1283763560612_868976_4608]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283714222603_853936_4108}metadata
h5. Description

A representation of the meaning of terms used to describe the artifact, its functions, and its effects.
h5. Requirements addressed
																			
* [Governance Model|#_16_5_1_24a0131_1283763638521_214441_4616]																															
* [Service Description Model|#_16_5_1_24a0131_1283763560612_868976_4608]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283949607586_662373_2655}notification
h5. Description

Notification of Description updates or notification of the addition of new and relevant  Descriptions;
h5. Requirements addressed
																			
* [Service Visibility Model|#_16_5_1_24a0131_1283763628053_328597_4610]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283793030699_512571_7056}provenance
h5. Description

While the Resource identity provides the means to know which subject and subject description are  being considered, Provenance as related to the Description class provides information that reflects on the  quality or usability of the subject. Provenance specifically identifies the entity (human, defined role,  organization, ...) that assumes responsibility for the resource being described and tracks historic  information that establishes a context for understanding what the resource provides and how it has  changed over time. Responsibilities may be directly assumed by the Stakeholder who owns a Resource  or the Owner may designate Responsible Parties for the various aspects of maintaining the resource and  provisioning it for use by others. There may be more than one entity identified under Responsible Parties;  for example, one entity may be responsible for code maintenance while another is responsible for provisioning of the executable code. The historical aspects may also have  multiple entries, such as when  and how data was collected and when and how it was subsequently processed, and as with other  elements of description, may provide links to other assets maintained by the Resource owner.
h5. Requirements addressed
		

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283949607164_356366_2643}publication
h5. Description

Publishing of Description directly to a consumer or through a third party mediator.
h5. Requirements addressed
																			
* [Service Visibility Model|#_16_5_1_24a0131_1283763628053_328597_4610]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283421703501_612424_9235}serviceClassificationModel
h5. Description

Service Classification Model with capabilities to create, destroy, edit, maintain service descriptions. 

 A classification scheme for organizing services based on business objectives, domain, and usage 

 The ServiceClassification  Model implementation includes the following capabilities   
* metamodels and semantic annotations that provide normative descriptions of the utilized service description terms, where the models may range from a simple dictionary of terms to an ontology showing complex relationships and capable of supporting enhanced reasoning; Specific semantic concepts to be used include business objectives, domain, and usage. 
* mechanisms to support the storage, referencing, and access to these semantic models; 
* configuration management mechanisms to capture the normative description of each semantic model and to apply a unique identifier in a manner consistent with an identified versioning scheme; 
* one or more mechanisms to support the storage, referencing, and access to conversion relationships between semantic models, and the mechanisms to carry out such conversions.
h5. Requirements addressed
																			
* [Administer Services|#_16_5_1_24a0131_1283090102020_915508_4551]														

h5. Overview of possible operations



h4. {anchor:_16_5_1_24a0131_1283714222609_981432_4109}store
h5. Description

Accessible storage of artifacts and artifact descriptions, so service participants can access, examine, and use the artifacts as defined.
h5. Requirements addressed
																			
* [Service Description Model|#_16_5_1_24a0131_1283763560612_868976_4608]																															
* [Governance Model|#_16_5_1_24a0131_1283763638521_214441_4616]														

h5. Overview of possible operations



{scrollbar}