NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Scrollbar
iconsfalse

...

Page info

...

title
title

Panel
titleContents of this Page
Table of Contents
minlevel5
Summary

...

Description of the profile

...

Policy discovery allows application developers to find and retrieve policies on services.
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.
    Artifact 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.

Architectural implications of composition on the Semantic Infrastructure are reflected in the following capabilities:

  • tools to facilitate identifying description elements that are to be aggregated to assemble the composite description;
  • tools to facilitate identifying the sources of information to associate with the description elements;
  • tools to collect the identified description elements and their associated sources into a standard, referenceable format that can support general access and understanding;
  • tools to automatically update the composite description as the component sources change, and to consistently apply versioning schemes to identify the new description contents and the type and significance of change that occurred.
    Discovery is the set of capabilities which enable searching for artifacts that best meet the search criteria specified by the service participant.

Aspects of discovery include:

  • Search for services, policies, and other artifact descriptions accessible via some repository mechanism
  • Search for operational characteristics of artifacts, which are metrics defined in artifact descriptions. The information is accessible via infrastructure monitoring capabilties or directly from services.
  • Tracking and notification mechanisms related to artifact usage, service availability, operational conformance

Capabilities associated with discovery are delineated in the functional profiles inherited, and specialized, by the discovery profile, namely:

  • Artifact
  • Metrics
  • Interoperability
    Descriptions of interactions are important for enabling auditability and repeatability, thereby establishing a context for results and support for understanding observed change in performance or results. Infrastructure services provide mechanisms to support service interaction.

Architectural implications of interactions on the Semantic Infrastructure are reflected in the following capabilities:

  • one or more mechanisms to capture, describe, store, discover, and retrieve interaction logs, execution contexts, and the combined interaction descriptions;
  • one or more mechanisms for attaching to any results the means to identify and retrieve the interaction description under which the results were generated.
  • mediation services such as message and event brokers, providers, and/or buses that provide message translation/transformation, gateway capability, message persistence, reliable message delivery, and/or intelligent routing semantics;
  • binding services that support translation and transformation of multiple application-level protocols to standard network transport protocols;
  • auditing and logging services that provide a data store and mechanism to record information related to service interaction activity such as message traffic patterns, security violations, and service contract and policy violations
  • security services that abstract techniques such as public key cryptography, secure networks, virus protection, etc., which provide protection against common security threats in a SOA ecosystem;
  • monitoring services such as hardware and software mechanisms that both monitor the performance of systems that host services and network traffic during service interaction, and are capable of generating regular monitoring reports.
    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.

Architectural implications of interoperability on the Semantic Infrastructure are reflected in the following capabilities:

  • one or more discovery mechanisms that enable searching for described resources that best meet the criteria specified by a service participant, where the discovery mechanism will have access to individual descriptions, possibly through some repository mechanism;
  • tools to appropriately track users of the descriptions and notify them when a new version of the description is available.
    Artifact Descriptions include references to metrics which describe the operational characteristics of the subjects being described

Architectural implications of metrics on the Semantic Infrastructure are reflected in the following capabilities:

  • access to platform infrastructure monitoring and reporting capabilities
  • access to metrics information generated or accessible by related services
  • mechanisms to catalog and enable discovery of which metrics are available for a described artifact and information on how these metrics can be accessed;
  • mechanisms to catalog and enable discovery of compliance records associated with policies, contracts, and constraints that are based on these metrics.

...

Capabilities

...

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
_16_5_1_24a0131_1283090102020_915508_4551
Administer Services

policiesAndContractsDiscovery,

 

Semantic Profile::OASIS SOA::

Anchor
_16_5_1_24a0131_1283763638521_214441_4616
_16_5_1_24a0131_1283763638521_214441_4616
Governance Model

monitor from inherited abstract profile Metrics, metrics from inherited abstract profile Metrics, discovery from inherited abstract profile Artifact, identity from inherited abstract profile Artifact, metadata from inherited abstract profile Artifact, store from inherited abstract profile Artifact,

 

Semantic Profile::OASIS SOA::

Anchor
_16_5_1_24a0131_1283763631267_880282_4612
_16_5_1_24a0131_1283763631267_880282_4612
Interacting with Services Model

interactionLog from inherited abstract profile Interaction, interactionResults from inherited abstract profile Interaction, mediation from inherited abstract profile Interaction, binding from inherited abstract profile Interaction, logging from inherited abstract profile Interaction, security from inherited abstract profile Interaction, monitoring from inherited abstract profile Interaction,

Policy and Rules Management allow non-developer secondary users to create policies and rules and apply them to services. The scope of policies includes, but is not limited to, definition and configuration of business processing policy and related rules, compliance policies, quality of service policies, and security policies. Some key functional requirements for managing policies include capabilities to author policies and store policies, and to approve and validate policies and execute policies at runtime. The Semantic Infrastructure will provide a mechanism to specify policies, including business processing policies and related rules, compliance policies, and quality of service policies. Tools and services for creating security specific policies will be provided by the caGRID 2.0 platform and will be used by the semantic infrastructure. All other policies specified in the Semantic Infrastructure will be enforced by the platform at runtime. Link to use case satisfied from caGRID 2.0 Roadmap: Each institution has different data sharing needs, access control needs, and business rules for processing that are defined and customized. For example, policy at the pathologist's institution may state that the patient is scheduled for a visit when the review is complete.

Semantic Infrastructure Requirements::caGRID 2.0 Platform and Terminology Integration::

Anchor
_16_5_1_24a0131_1283090071657_38228_4518
_16_5_1_24a0131_1283090071657_38228_4518
Policy and Rules Management

policiesAndContractsDiscovery,

 

Semantic Profile::OASIS SOA::

Anchor
_16_5_1_24a0131_1283763560612_868976_4608
_16_5_1_24a0131_1283763560612_868976_4608
Service Description Model

discovery from inherited abstract profile Artifact, identity from inherited abstract profile Artifact, metadata from inherited abstract profile Artifact, store from inherited abstract profile Artifact, monitor from inherited abstract profile Metrics, metrics from inherited abstract profile Metrics, metricsDiscovery from inherited abstract profile Metrics, complianceDiscovery from inherited abstract profile Metrics, interactionLog from inherited abstract profile Interaction, interactionResults from inherited abstract profile Interaction, compositionArchive from inherited abstract profile Composition, assembly from inherited abstract profile Composition, compositionChange from inherited abstract profile Composition, componentAcquisition from inherited abstract profile Composition, interoperabilityDiscovery from inherited abstract profile Interoperability, serviceChangeNotification from inherited abstract profile Interoperability,

This group of requirements focuses on enabling developers of composite services and applications to discover, compose, and invoke services. This includes the discovery of published services based on service metadata and the generation of client APIs in multiple languages to provide cross-platform access to existing services. The platform will use the semantic infrastructure service metadata to address all the service discovery requirements. The semantic infrastructure relies on metadata about services and artifacts. Link to use case satisfied from caGRID 2.0 Roadmap: As institutions share de-identified glioblastoma data sets, they are available to others via data discovery. The treatment recommendation service used by the oncologist is able to discover these new data sets and their corresponding information models, and include that data for subsequent use in recommendation of treatment. Link to use case satisfied from caGRID 2.0 Roadmap: all of the data management and access services in the use case are utilized by application developers to build the user interfaces that the clinicians use during the course of patient care.

Semantic Infrastructure Requirements::caGRID 2.0 Platform and Terminology Integration::

Anchor
_16_5_1_24a0131_1283090073139_167512_4524
_16_5_1_24a0131_1283090073139_167512_4524
Service Discovery and Utilization

policiesAndContractsDiscovery,

to be done

Semantic Infrastructure Requirements::Artifact Management::

Anchor
_16_5_1_24a0131_1283090052776_749198_4497
_16_5_1_24a0131_1283090052776_749198_4497
Specification Content

policiesAndContractsDiscovery,

Anchor
_16_5_1_24a0131_1283703443772_860088_3293
_16_5_1_24a0131_1283703443772_860088_3293
assembly

...

Description

...

Tools to facilitate identifying description elements that are to be aggregated to assemble the composite description.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283774411368_995660_5431
_16_5_1_24a0131_1283774411368_995660_5431
binding

...

Description

...

binding services that support translation and transformation of multiple application-level protocols to standard network transport protocols;

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283702219073_894098_3212
_16_5_1_24a0131_1283702219073_894098_3212
complianceDiscovery

...

Description

...

Mechanisms to catalog and enable discovery of compliance records associated with policies, contracts, and constraints that are based on these metrics.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283704509983_673729_3325
_16_5_1_24a0131_1283704509983_673729_3325
componentAcquisition

...

Description

...

Tools to facilitate identifying the sources of information to associate with the description elements.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283703443770_810122_3292
_16_5_1_24a0131_1283703443770_810122_3292
compositionArchive

...

Description

...

Tools to collect the identified description elements and their associated sources into a standard, referenceable format that can support general access and understanding.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283703443775_178969_3294
_16_5_1_24a0131_1283703443775_178969_3294
compositionChange

...

Description

...

Tools to automatically update the composite description as the component sources change, and to consistently apply versioning schemes to identify the new description contents and the type and significance of change that occurred.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283714222600_103266_4106
_16_5_1_24a0131_1283714222600_103266_4106
discovery

...

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.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283714222601_506267_4107
_16_5_1_24a0131_1283714222601_506267_4107
identity

...

Description

...

Descriptions which include a unique identifier for the artifact.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283703044067_803205_3257
_16_5_1_24a0131_1283703044067_803205_3257
interactionLog

...

Description

...

One or more mechanisms to capture, describe, store, discover, and retrieve interaction logs, execution contexts, and the combined interaction descriptions.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283703044069_331285_3258
_16_5_1_24a0131_1283703044069_331285_3258
interactionResults

...

Description

...

One or more mechanisms for attaching to any results the means to identify and retrieve the interaction description under which the results were generated.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283704952692_78857_3340
_16_5_1_24a0131_1283704952692_78857_3340
interoperabilityDiscovery

...

Description

...

One or more discovery mechanisms that enable searching for described resources that best meet the criteria specified by a service participant, where the discovery mechanism will have access to individual descriptions, possibly through some repository mechanism.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283774412029_665259_5444
_16_5_1_24a0131_1283774412029_665259_5444
logging

...

Description

...

auditing and logging services that provide a data store and mechanism to record information related to service interaction activity such as message traffic patterns, security violations, and service contract and policy violations

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283774410554_993474_5418
_16_5_1_24a0131_1283774410554_993474_5418
mediation

...

Description

...

mediation services such as message and event brokers, providers, and/or buses that provide message translation/transformation, gateway capability, message persistence, reliable message delivery, and/or intelligent routing semantics;

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283714222603_853936_4108
_16_5_1_24a0131_1283714222603_853936_4108
metadata

...

Description

...

A representation of the meaning of terms used to describe the artifact, its functions, and its effects.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283702219069_775824_3210
_16_5_1_24a0131_1283702219069_775824_3210
metrics

...

Description

...

Access to metrics information generated or accessible by related services

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283702219071_411273_3211
_16_5_1_24a0131_1283702219071_411273_3211
metricsDiscovery

...

Description

...

Mechanisms to catalog and enable discovery of which metrics are available for a described artifact and information on how these metrics can be accessed.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283702219067_789210_3209
_16_5_1_24a0131_1283702219067_789210_3209
monitor

...

Description

...

Access to platform infrastructure monitoring and reporting capabilities.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283774413444_304515_5470
_16_5_1_24a0131_1283774413444_304515_5470
monitoring

...

Description

...

monitoring services such as hardware and software mechanisms that both monitor the performance of systems that host services and network traffic during service interaction, and are capable of generating regular monitoring reports.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283167159500_54051_3062
_16_5_1_24a0131_1283167159500_54051_3062
policiesAndContractsDiscovery

...

Description

...

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.

Service policies help establish constraints on the service specifications and mandate an approach. Policies can be specified around governance, access control and other design and runtime constraints.

In the realization of policies and contracts for a SOA, there are common policy principles that will be encountered in many of the standards and/or technology choices used for the realization.

Policy Discovery provides the following capabilities

  • one or more discovery mechanisms that enable searching for policies that best meet the search criteria specified by the service participant; where the discovery mechanism will have access to the individual policy descriptions through some repository mechanism;
  • accessible storage of policy descriptions, so service participants can access, examine, and use the policies as defined.
  • access to metrics information about policies obtained from the platform infrastructure monitoring and notification capabilities
  • mechanisms to catalog and enable discovery of which metrics are available for a described policy and information on how these metrics can be accessed;
  • mechanisms to catalog and enable discovery of compliance records associated with polcies that are based on these metrics.
  • one or more mechanisms to capture, describe, store, discover, and retrieve interaction logs, execution contexts, and the combined interaction descriptions;
  • one or more mechanisms for attaching to any results the means to identify and retrieve the interaction description under which the results were generated.
  • tools to facilitate identifying description elements that are to be aggregated to assemble the composite description;
  • tools to facilitate identifying the sources of information to associate with the description elements;
  • tools to collect the identified description elements and their associated sources into a standard, referenceable format that can support general access and understanding;
  • tools to automatically update the composite policy as the component sources change, and to consistently apply versioning schemes to identify the new description contents and the type and significance of change that occurred.
  • tools to appropriately track users of the polcies and notify them when a new version of the policy is available.
    Requirements addressed

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283793030699_512571_7056
_16_5_1_24a0131_1283793030699_512571_7056
provenance

...

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.

...

Requirements addressed

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283774412802_440973_5457
_16_5_1_24a0131_1283774412802_440973_5457
security

...

Description

...

security services that abstract techniques such as public key cryptography, secure networks, virus protection, etc., which provide protection against common security threats in a SOA ecosystem;

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283704952697_176583_3341
_16_5_1_24a0131_1283704952697_176583_3341
serviceChangeNotification

...

Description

...

Tools to appropriately track users of the descriptions and notify them when a new version of the description is available.

...

Requirements addressed

...

...

Overview of possible operations

...

Anchor
_16_5_1_24a0131_1283714222609_981432_4109
_16_5_1_24a0131_1283714222609_981432_4109
store

...

Description

...

Accessible storage of artifacts and artifact descriptions, so service participants can access, examine, and use the artifacts as defined.

...

Requirements addressed

...

...

Overview of possible operations

...

Scrollbar
iconsfalse