updateDrillPath(object, options)

Use this method to modify an existing bibus » drillPath object in the content store.

This method performs a number of activities before it updates the specified object in the content store by calling the content » update(objects, options) method:

  • The drill-through specification is validated. If the specification is not valid, this method fails and returns an appropriate error.

  • The following properties are set to reflect the corresponding values in the drill-through specification:

Use of this method requires:

  • write permission for the object

  • traverse permission for all ancestors of the object

  • read permission for the updated object to retrieve property values

  • setPolicy permission to read or write to the bibus » baseClass » policies property

Java and Apache Axis

 
public  com.cognos.developer.schemas.bibus._3.DrillPath 
updateDrillPath(com.cognos.developer.schemas.bibus._3.DrillPath 
object,  com.cognos.developer.schemas.bibus._3.UpdateOptions  options) 

C# .NET

 
public  drillPath  updateDrillPath(drillPath  @object,  updateOptions 
options) 

References

Part of the following method sets:
Implemented by the following services:

The services that implement the updateDrillPath method, along with the associated SOAP actions, are listed in the following table.

Table 1. Services implementing the updateDrillPath method.

Service

SOAP Action
batchReportService

http://www.ibm.com/xmlns/prod/cognos/batchReportService/201404/
reportService

http://www.ibm.com/xmlns/prod/cognos/reportService/201404/

What's new

New in Version 8.4 — Supporting New Drill-through Targets

This method was added.

Input parameters

Use the following parameters when calling this method.

object

Specifies the object to be updated.

The bibus » baseClass » searchPath property is used to select the object.

This argument

options

Specifies additional options for the method.

This argument

Return values

This method returns the following values.

result

Returns information about the object that was updated. The information that is returned is determined by the value of the bibus » updateOptions » returnProperties property.

This result