ReportingHome < Main

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>MainOslcCommonArchitecture>ReportingHome (01 Nov 2011, KartikKanakasabesan) (raw view)

---+ OSLC Reporting
 <table width="100%" align="left" cellspacing="5" style="background-color: #ffffff; border-width: 0pt; border-color: #ffffff; border-style: solid" 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: The draft specification is in convergence. Implementation validation is in progress.

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]] | Convergence |
| [[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.
   1 ModelingDataUC
---++ Milestones

*Overall Milestones*

| *Scope* | *Draft* | *Converge* | *Finalize* |
| Oct 2009 | Apr 2010 | May 2010 | August 2010 |

</td><td valign="top">

---++++ Participants

TackTong (lead)<br />[[ArthurRyman]]<br />[[BenjaminWilliams]]<br />[[DragosCojocari]]<br />[[MikKersten]]%BLUE%<u><br /></u>%ENDCOLOR%[[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

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

Topic revision: r37 - 01 Nov 2011 - 17:40:21 - KartikKanakasabesan

Main

Webs
Main
Sandbox
TWiki

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