AnalysisApplication.OpenFromLibrary Method (String, String)

AnalysisApplication OpenFromLibrary Method (String, String)

TIBCO Spotfire 6.5 API Reference

Opens a file from the TIBCO Spotfire Server library with a known name located at a known path.

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

Syntax

C++

Copy to Clipboard Print

[ObsoleteAttribute("Use Open(LibraryItem, DocumentOpenSettings) instead.")]
public bool OpenFromLibrary(
	string path,
	string name
)

[ObsoleteAttribute("Use Open(LibraryItem, DocumentOpenSettings) instead.")]
public bool OpenFromLibrary(
	string path,
	string name
)

Parameters

path: Type: System String
The path of the directory in which the entry to open is located.

name: Type: System String
The name of the library entry to open.

Return Value

Type: Boolean
true if the document was loaded; otherwise false.

Exceptions

Exception	Condition
System NotSupportedException	This method is called in the Spotfire Web Player.
Spotfire.Dxp.Framework.Library LibraryException	no matching saved library entry with the given path and name is found. -or- the given document is not a valid TIBCO Spotfire analysis file. -or- the file contains linked data to import, but the import fails. -or- a communication error occurs when reading the document from the Library.
Spotfire.Dxp.Framework.ApplicationModel CanceledException	If the opening of the file is canceled by the user.
System InvalidOperationException	This method is not called from the application main thread.
System ArgumentNullException	One of the arguments are null.

Remarks

This operation by default is not executed with progress, that is, no progress dialog is shown while the current document is being read from the library. Note that if the document in the library requires any prompting the prompts will be suppressed unless this operation is executed with progress.

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

Examples

To execute without progress:

Copy to Clipboard Print

string path="/DXP Files/Sales";
string name="Sales February";
bool loaded = application.OpenFromLibrary(path, name);

string path="/DXP Files/Sales";
string name="Sales February";
bool loaded = application.OpenFromLibrary(path, name);

Copy to Clipboard Print

string path="/DXP Files/Sales";
string name="Sales February";
ProgressService progressService = application.GetService<ProgressService>();
progressService.ExecuteWithProgress("Opening from Library", "Opening " + name, delegate()
{
    bool loaded = application.OpenFromLibrary(path, name);
});

string path="/DXP Files/Sales";
string name="Sales February";
ProgressService progressService = application.GetService<ProgressService>();
progressService.ExecuteWithProgress("Opening from Library", "Opening " + name, delegate()
{
    bool loaded = application.OpenFromLibrary(path, name);
});

To execute with progress and prompts:

Version Information

Obsolete (compiler warning) in 6.5
Obsolete (compiler warning) in 6.0
Obsolete (compiler warning) in 5.5
Obsolete (compiler warning) in 5.0
Obsolete (compiler warning) in 4.5