AnalysisApplication.Open Method (DataSource)

AnalysisApplication Open Method (DataSource)

TIBCO Spotfire 7.0 API Reference

Opens a new document with data loaded from the specified source. Any currently open document will be closed.

Namespace: Spotfire.Dxp.Application
Assembly: Spotfire.Dxp.Application (in Spotfire.Dxp.Application.dll) Version: 18.10.8513.5432 (18.10.8513.5432)

Syntax

C++

Copy to Clipboard Print

public bool Open(
	DataSource source
)

public bool Open(
	DataSource source
)

Parameters

source: Type: Spotfire.Dxp.Data DataSource
The data source from which data is to be opened.

Return Value

Type: Boolean
This method always returns true. If there is an error during loading or if the user cancels a prompt, an exception is thrown.

Exceptions

Exception	Condition
Spotfire.Dxp.Data.Exceptions ImportException	If the import fails, for example the data reader is not able to provide the data to import.
Spotfire.Dxp.Framework.ApplicationModel CanceledException	If the opening of the file is canceled by the user.
System NotSupportedException	This method is called in the Spotfire Web Player.

Remarks

The operation is executed with progress information.

When a document is opened using a call to this method, the document will not be auto configured. This means that:

no default visual page is added
no default visualization is created
the user preferences (for example whether or not to show the cover page, the page visualization mode, the filter panel mode, etc.) are not be applied
the filter panel is not configured, that is, no filters are added.

All of these operations must be performed explicitly through calls to AutoConfigure , ApplyUserPreferences , and AutoConfigure , respectively.

This method is not supported in the Spotfire Web Player. Calling it there will cause a NotSupportedException to be thrown.

Version Information

Supported in: 7.0, 6.5, 6.0, 5.5, 5.0