Creating lineage requests for reports

Beginning in IBM® Cognos® Analytics V10.1.0, you must issue lineage requests for report data against reportService or batchReportService to obtain querySet data, which you must then deliver to metadataService in a subsequent lineage request. Lineage information can be derived for both saved reports and for reports that you have not saved.

For saved report data, you can obtain lineage for data items and layout expressions that contain data items by issuing a runSpecification(specification, parameterValues, options) lineage request against reportService or batchReportService. The runSpecification(specification, parameterValues, options) method must include metadataServiceLineageSpecification as a specification and contain the search path. See for an example. Reports saved in earlier versions of IBM Cognos Analytics will only support lineage for data items; lineage for layout expressions is not supported.

For unsaved report data, such as during an interactive session, you can obtain lineage by issuing a secondary lineage(conversation, parameterValues, options) SOAP request against reportService or batchReportService. See the Secondary Requests chapter for more information.

For both saved reports and interactive sessions, the lineage querySet response from reportService (or batchReportService) must be encoded within a V5QuerySet object and forward it to metadataService, along with the objectQuery objects for which lineage information is desired. Requests to metadataService are issued using a runSpecification(specification, parameterValues, options) method running a metadataServiceLineageSpecification specification.