http://download.oracle.com/docs/cd/E12839_01/pfrd.htm, you will notice the familiar set of docs, with one new addition. There is now a doc for the Discoverer Web Services. The "Oracle® Fusion Middleware User's Guide for Oracle Business Intelligence Discoverer Web Services API", 11g Release 1 (11.1.1), Part Number E10412-01 can be viewed at http://download.oracle.com/docs/cd/E12839_01/bi.1111/e10412/toc.htm, or downloaded as a PDF from http://download.oracle.com/docs/cd/E12839_01/bi.1111/e10412.pdf
As a brief intro, these web services are a layer of SOAP based web services that sit on top of Discoverer, provide access to a variety of functions, and provide a level of abstraction from the underlying implementation of the functionality that these services expose.
The very first instance where these web services were used was in the integration between BI Publisher and Discoverer (see my posts on this topic from 2007), that happened with the BI Publisher 10.1.3.3.0 release and Discoverer 10.1.2.2 release in 2007. Actually, there was a one-off patch that had to be applied on top of Discoverer 10.1.2.2 which contained the web services libraries. However, these web services were not yet meant to be consumed externally by customers for building their custom integrations. The intent was to document these and release them with the Discoverer 11g release. There is a slightly fascinating history behind the evolution of this project that I will try and blog about in a future post.
The other place where these web services shall be used is in the integration of Discoverer with the Oracle Business Intelligence Suite Enterprise Edition Plus, also referred to sometimes as simply OBIEE. Specifically, and since this is about functionality not yet released, please bear in mind that some or all of this could change, so do not take this as official Oracle communication, the intent is to use these Discoverer web services to publish Discoverer worksheets to an OBIEE Dashboard page, and to also use these same web services to allow OBIEE Delivers to run and send Discoverer worksheets on a scheduled basis.