This wiki is locked. Future workgroup activity and specification development must take place at
our new wiki
. For more information, see
this blog post about the new governance model
and
this post about changes to the website
.
TWiki
>
Main Web
>
OslcCommonArchitecture
?
>
ReportingHome
(revision 33) (raw view)
---+ OSLC Reporting <table width="100%" align="left" cellspacing="5" style="border: 0pt solid #ffffff; background-color: #ffffff" cellpadding="10" border="0"><tbody><tr><td valign="top"> ---++ Introduction The goal of this effort is to define a common set of features that [[http://en.wikipedia.org/wiki/Restful][RESTful]] services should implement to enable reporting. Reporting is an important capability across the entire software development lifecycle. For example, reporting is very important in software project management both for communications and for performance management. We are addressing the topic as a common function across all lifecycle domains. REST services defined on software development tool repositories, e.g. for Change Management, Quality Management, etc., provide a natural source of data for reports. The data may be used in the following contexts: * operational reporting - e.g. generate tabular or graphical business reports showing the latest data, on demand * documentation - e.g. generate complex documents showing tracibility of requirements to architectural elements and test cases * analytics - e.g. batch load bulk data nightly to populate a data warehouse for business intelligence reporting Further discussion of [[ReportingMeeting20091002#goals][goal and scope]] in the kickoff meeting. ---++ Scope<a name="scope" title="scope"></a> Scoping assumption: 1 The Reporting 1.0 specification must be sufficient to support the Reporting 1.0 use cases. 1 The Reporting 1.0 specification only supports domain specification 2.0, and not previous versions of domain specification. ---++ Status The Reporting Specification has heavy dependency on the [[OSLCCoreSpecDRAFT][OSLC Core Specification]] and thus will trail the Core Specification progress closely. Current status: A draft specification is available for review. Current plan: * Convergence : 1st week in May * Final Specification : Mid June Current progress can be viewed in [[ReportingMeetings][workgroup meeting agenda and minutes]]. ---++ Approach The specifications will be developed by establishing [[ReportingUseCases][use cases]] and then defining the [[ReportingSpecifications][Reportable REST Service Specifications]] to support them. This workgroup does not define a Reporting Specification on its own, like a domain specification. Instead, it defines a set of extra specification on top of domain specification to enable domain resources for reporting. It is assumed that all domain resources will have REST service defined for retrieving data as part of the OSLC specifications. Currently, there are topics in OSLC on Change Management, Requirement Management, Quality Management, Software Configuration Management, Softare Estimation and Measurement, Asset Management, Architecture Management,.....etc. The REST service defined by these domain specifications are mainly focused on use cases that are transactional. Reporting use cases are typically involved retrieving large volume of data. Reporting clients are typically generic in nature and have no prior knowledge of the domain resources they are dealing with. Thus these unique reporting use cases introduce extra requirements. The objective of this Reporting specification (OSLC Reporting Specification) is to specify these extra requirements on top of the domain specificaitons. The intention is to have this as a cross domain specification. Any service provider can implement this specification to make their OSLC services consumable by reporting clients. The OSLC Reporting Specification 1.0 should be scoped to address the mandatory features (i.e. features to make it work) first and then address those features for optimization as time allows. ---++ Relationship with OSLC Core Specification<a name="core" title="core"></a> * The Reporting WG will input requirements based on its ReportingUseCases to the Core Specification WG. * The Reporting WG will review Core Specification related to Reporting topics to ensure they meet Reporting requirements. * Core Specification will be discussed and defined by the Core Specification WG. Reporting specification will make references to them as appropriate. * The following table summarizes the Reporting topics that are driven from the ReportingUseCases and their relationship with OSLC Core Specification. | *Reporting Topics* | *Core Specification* | | Resource Shape | Yes | | Query | Yes | | Resource XML Representation | Yes | | Service Discovery | Yes | | Paging | Yes | | Authentication | Yes | | Resource Deletion Notification | No (may be Yes for the future) | | Last Modified Date | No | ---++ Working Documents | *Document* | *Status* | | [[ReportingUseCases][Reporting Use Cases]] | Completed | | [[ReportingSpecifications][Reporting Specifications]] | In Progress | | [[ReportingResourceSchema][%BLUE%Resource Schema %ENDCOLOR%]] | Obsolete | | [[ReportingRESTApi][%BLUE%Reporting REST API%ENDCOLOR%]] | Obsolete | | [[ResourceFormat][Resource Format]] | Obsolete | | [[ResourceQuery][Resource Query]] | Obsolete | | [[ReportingServiceDiscovery][Service Discovery]] | Obsolete | | ImplementationScenario | In Progress | Note: Document becomes obsolete as the topic has moved to Core Workgroup. ---++ Prior Work * [[%PUBURL%/Main/ReportingHome/Reportable_Rest_Services_Interfaces-OSLC_Submission.pdf][Insight/RPE Reportable REST Specification]] - current spec. defined for working with current version of Insight/RPE. This could be a good source of use cases and requirements. However, we need to be vigilant not too much influence by this spec. in choosing technologies and defining interfaces. * [[CmSpecificationV1][OSLC-CM 1.0 Specification]] has many features that are somehow related to Reporting. This could be a good source to factor those out as part of the OSLC Reportable Specification and generalize for cross domain purpose. ---++ Topics for Future Consideration <a name="future" title="future"></a> 1 [[RSxUC][New use case based on RSx]]. 1 Sample data annotation in Resource Shape description. ---++ Milestones *Overall Milestones* | *Scope* | *Draft* | *Converge* | *Finalize* | | Oct 2009 | Apr 2010 | May 2010 | Jun 2010 | </td><td valign="top"> ---++++ Participants TackTong (lead)<br />[[ArthurRyman]]<br />[[BenjaminWilliams]]<br />[[DragosCojocari]]<br />[[MikKersten]]<br />[[ScottBosworth]]<br />[[SebRose]]<br />[[SteveAbrams]]<br />[[JamesMoody]] <br />[[VishyRamaswamy]]<br />[[XiangDongHu]]<br />SteveSpeicher ScottFairbrother JimDaly StevePitschke JoanTouzet PaulMcMahan PaulTasillo EinarKarlsen ---++++ Feedback [[http://open-services.net/bin/view/Main/OSLCReportingV1Issues][V1 Specification comments and issues]] ---++++ Mailing List [[http://open-services.net/mailman/listinfo/oslc-reporting_open-services.net][Reporting Mailing List]] [[http://open-services.net/mailman/listinfo/community_open-services.net][General Open Services]] </td></tr></tbody></table>
Attachments
Attachments
Topic attachments
I
Attachment
Action
Size
Date
Who
Comment
pdf
Reportable_Rest_Services_Interfaces-OSLC_Submission.pdf
manage
90.2 K
30 Jul 2009 - 19:14
ArthurRyman
IBM Submission for Reportable REST Specification
Edit
|
Attach
|
P
rint version
|
H
istory
:
r37
|
r35
<
r34
<
r33
<
r32
|
B
acklinks
|
V
iew topic
|
Raw edit
|
More topic actions...
Topic revision: r33 - 26 Apr 2010 - 00:12:02 -
TackTong
Main
Main Web
Create New Topic
Index
Search
Changes
Notifications
RSS Feed
Statistics
Preferences
Webs
Main
Sandbox
TWiki
Български
Cesky
Dansk
Deutsch
English
Español
Français
Italiano
日本語
Nederlands
Polski
Português
Русский
Svenska
简体中文
簡體中文
Copyright � by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use
Ideas, requests, problems regarding this site?
Send feedback