IDSSApplicationServices Interface Reference

List of all members.

---

Detailed Description

This interface is used to expose miscellaneous application level features.

It is used by the application services component. This component is created directly using the DSSApplicationServices CLSID (class id). It exposes a number of useful features of the API that do not belong on any particular component.

The application services component is built on top of other components in the API. All it does to perform its functionality is to make other calls on the lower level objects. It implements a number of common tasks that are inconvenient to perform directly on the API.

These features include: -

• Determining the relationship between DSS Objects and tables columns in the warehouse.
• Determining the overriding relationships between extended properties at various levels during report execution.

Public Member Functions
HRESULT	FindDependentColumns ([in] IDSSObjectInfo *pObject,[out, retval] SAFEARRAY(VARIANT)*pColumns)
	Find the columns and tables this object uses as a 2-D safe array.
HRESULT	PropertyHelper ([out, retval] IDSSPropertyHelper ppPropertyHelper)
	Get interface to component that understands overriding between extended properties.

---

Member Function Documentation

HRESULT IDSSApplicationServices::FindDependentColumns (  [in] IDSSObjectInfo *  pObject, [out, retval] SAFEARRAY(VARIANT)*  pColumns )

Find the columns and tables this object uses as a 2-D safe array. This method examines the definition of the object. If necessary it will access other objects from the metadata used to define this object. It returns the list of RDBMS objects (tables as well as columns) used to define this object. This feature is intended to support integration with products like Informaticia(tm) by making it easier to relate application and schema level objects with RDBMS objects. An application could then access some extra metadata about the RDBMS to obtain information pertinent to the DSS Object. This method returns all of the tables and columns that might be accessed when using the given object. In most contexts only some of the tables and columns would be used. Parameters: pObject  The object whose definition should be examined. It could be an attribute, fact, column, metric or aggregate metric. pColumns  An array of objects. Each row of the array contains two objects, the first object being a column, and the second being the table that contains the column. Returns: Usual COM result code: S_OK E_INVALIDARG Object is of an unexpected type.

HRESULT IDSSApplicationServices::PropertyHelper (  [out, retval] IDSSPropertyHelper   ppPropertyHelper  )

Get interface to component that understands overriding between extended properties. When running a report there are something like eight different places from which extended property information could be drawn. This interface helps applications to navigate through all of these places. For a specific object on a report instance it can show: - The source of each extended property value The value each extended property would use as its default if it were defined in its current place. Parameters: ppPropertyHelper  An object supporting the IDSSPropertyHelper interface. Returns: Usual COM result code: S_OK E_POINTER ppPropertyHelper was NULL on entry

---