Mashup Service Developer

Introduction
This document is intended for use with the IBM® Cognos® Mashup Service, which allows you to develop applications that expose IBM Cognos outputs, such as reports and analyses, as Web services (both SOAP and REST).
What's new?
This section contains a list of new, changed, and deprecated features for this and previous releases. It will help you plan your upgrade and application deployment strategies and the training requirements for your users.
Overview of the Mashup Service
The IBM Cognos Mashup Service gives you a simplified programmatic access to IBM Cognos content. This service exposes the application content built with IBM Cognos products (such as reports, analyses, and PowerPlay® reports) as Web services, both SOAP and REST. This allows you to integrate IBM Cognos content into new client environments like mashups, BPM/BPEL workflow processes, desktop widgets, alternate visualizations like third party charting engines and rich Internet applications.
Cognos Mashup Service samples
The IBM Cognos Mashup Service includes code samples that illustrate how to use the SOAP and REST interfaces to develop mashup applications.
Developing Mashup Service applications using the REST interface
You can develop IBM Cognos Mashup Service applications that use the representational state transfer (REST) interface. REST is a lightweight interface that uses HTTP requests to communicate with the IBM Cognos Analytics server. This interface has a low overhead when dealing with large amounts of data.
Developing Mashup Service applications using the SOAP interface
You can develop IBM Cognos Mashup Service applications that use a simple object access protocol (SOAP) interface in which SOAP messages are used to transmit requests and responses between client applications and the IBM Cognos Analytics server. This interface provides an object-oriented model that is easily integrated into Java™^TM or .NET applications.
Performing additional tasks using the Mashup Service
You can use the Mashup Service to perform a number of tasks related to running reports. You can perform the following tasks:
Understanding the Layout Data format
A Layout Data (LDX) document instance is an XML document that is an abstraction of rendered IBM Cognos content. This content is referred to in this document as a resource and can be a:
Understanding the Simple format
You can render an IBM Cognos resource in Simple format when you are developing a client application that works with specific reports or other resources and you need a format that is smaller and simpler than the layout data (LDX) format. This format is deprecated and will be removed in a future release of this product.
Understanding the DataSet format
You can render an IBM Cognos resource in the DataSet format when you are only interested in the data contained in the report output, and not in any formatting data.
Troubleshooting Mashup Service applications
This section provides information about potential problems you may encounter when using the IBM Cognos Mashup Service and provides solutions and workarounds.
Upgrading Mashup Service applications
To take advantage of new features in the IBM Cognos Mashup Service, upgrade your Mashup Service applications to comply with the latest version. Some features of previous releases are deprecated in a current release, and will not be available in future releases. You can make minor changes so that your existing applications can function with a current release, however, we recommend that you fully upgrade your applications to the latest version if possible.
SOAP methods reference
You can use the methods described in this chapter to retrieve and manipulate report outputs.
REST interface reference
The REST interface syntax for initial requests is
Authentication schema reference
For each layout data specification element, this section provides
RDS schema reference
For each RDS specification element, this section provides
Layout Data (LDX) schema reference
For each layout data schema element, this section provides
Notices