Class DocumentManager

Provides access to documents in local and remote locations.

Inheritance

object

DocumentManager

Namespace: ABB.Robotics.RobotStudio.Documents

Assembly: ABB.Robotics.RobotStudio.Documents.dll

Syntax

public static class DocumentManager

Properties

View Source

ProviderTypes

Returns a list of all registered DocumentProvider types.

Declaration

public static Collection<Type> ProviderTypes { get; }

Property Value

Type	Description
Collection<Type>

View Source

Providers

Returns a DocumentProviderCollection containing all registered DocumentProviders.

Declaration

public static DocumentProviderCollection Providers { get; }

Property Value

Type	Description
DocumentProviderCollection

View Source

UrlSubstitutions

Returns a list of all registered UrlSubstitutions.

Declaration

public static Collection<UrlSubstitution> UrlSubstitutions { get; }

Property Value

Type	Description
Collection<UrlSubstitution>

Methods

View Source

BeginBrowse(BrowseSpec)

Starts an asynchronous browse.

Declaration

public static void BeginBrowse(BrowseSpec spec)

Parameters

Type	Name	Description
BrowseSpec	spec

Remarks

This method returns immediately, and BrowseComplete is raised when the operation completes.

View Source

BeginSearch(SearchSpec)

Starts an asynchronous search.

Declaration

public static void BeginSearch(SearchSpec spec)

Parameters

Type	Name	Description
SearchSpec	spec

Remarks

This method returns immediately, and SearchComplete is raised when the operation completes.

View Source

BrowseAsync(BrowseSpec, Action<FolderInfo>, Action<DocumentInfo>)

Executes an asynchronous browse.

Declaration

public static Task BrowseAsync(BrowseSpec spec, Action<FolderInfo> folderResult, Action<DocumentInfo> documentResult)

Parameters

Type	Name	Description
BrowseSpec	spec
Action<FolderInfo>	folderResult	Called when a folder is found.
Action<DocumentInfo>	documentResult	Called when a document is found.

Returns

Type	Description
Task	A System.Threading.Tasks.Task that completes when the operation is completed.

Remarks

FolderResult, DocumentResult and BrowseComplete are not raised when calling this.

View Source

BrowseSync(BrowseSpec)

Executes a synchronous browse.

Declaration

public static void BrowseSync(BrowseSpec spec)

Parameters

Type	Name	Description
BrowseSpec	spec

View Source

BrowseSync(BrowseSpec, Action<FolderInfo>, Action<DocumentInfo>)

Executes a synchronous browse.

Declaration

public static void BrowseSync(BrowseSpec spec, Action<FolderInfo> folderResult, Action<DocumentInfo> documentResult)

Parameters

Type	Name	Description
BrowseSpec	spec
Action<FolderInfo>	folderResult	Called when a folder is found.
Action<DocumentInfo>	documentResult	Called when a document is found.

Remarks

FolderResult, DocumentResult and BrowseComplete are not raised when calling this.

View Source

ExportProviders(string, IEnumerable<DocumentProvider>)

Exports providers to an XML file.

Declaration

public static void ExportProviders(string fileName, IEnumerable<DocumentProvider> providers)

Parameters

Type	Name	Description
string	fileName	Path to XML file.
IEnumerable<DocumentProvider>	providers	Providers to export.

View Source

FindDocument(string)

Finds a document given it's full URL (provider URL + folder separator + document URL), or path to local copy.

Declaration

public static DocumentInfo FindDocument(string documentUrl)

Parameters

Type	Name	Description
string	documentUrl

Returns

Type	Description
DocumentInfo	DocumentInfo, or null if not found.

View Source

FindReverseSubstitution(string)

Replaces an Id from UrlSubstitutions at the start of an URL.

Declaration

public static string FindReverseSubstitution(string urlWithSubstitution)

Parameters

Type	Name	Description
string	urlWithSubstitution

Returns

Type	Description
string	Empty string is no substitution was found.

View Source

FindSubstitution(string)

Replaces the start of an URL with an Id from UrlSubstitutions

Declaration

public static string FindSubstitution(string originalUrl)

Parameters

Type	Name	Description
string	originalUrl

Returns

Type	Description
string	Empty string is no substitution was found.

View Source

GetLocalCopy(DocumentInfo)

Downloads (if needed) a document.

Declaration

public static string GetLocalCopy(DocumentInfo documentInfo)

Parameters

Type	Name	Description
DocumentInfo	documentInfo	The document info of the file to download.

Returns

Type	Description
string	Path to the local copy of the file.

View Source

GetLocalCopyAsync(DocumentInfo)

Asynchronously downloads (if needed) a document.

Declaration

public static Task<string> GetLocalCopyAsync(DocumentInfo documentInfo)

Parameters

Type	Name	Description
DocumentInfo	documentInfo	The document info of the file to download.

Returns

Type	Description
Task<string>	Path to the local copy of the file.

View Source

GetLocalCopyAsync(DocumentInfo, IProgressCallback2)

Asynchronously downloads (if needed) a document, with progress and cancellation if supported by the provider.

Declaration

public static Task<string> GetLocalCopyAsync(DocumentInfo documentInfo, IProgressCallback2 progress)

Parameters

Type	Name	Description
DocumentInfo	documentInfo	The document info of the file to download.
IProgressCallback2	progress

Returns

Type	Description
Task<string>	Path to the local copy of the file.

Exceptions

Type	Condition
OperationCanceledException	The download was canceled.

View Source

GetLocalCopyInfo(string)

Returns a DocumentInfo corresponding to a local copy.

Declaration

public static DocumentInfo GetLocalCopyInfo(string localPath)

Parameters

Type	Name	Description
string	localPath	Path to the local copy of the document.

Returns

Type	Description
DocumentInfo	Null if no document corresponding to the local copy was found.

View Source

GetLocalCopyStatus(DocumentInfo)

Returns the status of the local copy of a document.

Declaration

public static LocalCopyStatus GetLocalCopyStatus(DocumentInfo docInfo)

Parameters

Type	Name	Description
DocumentInfo	docInfo

Returns

Type	Description
LocalCopyStatus

View Source

GetLocalCopyStatus(string)

Returns the status of the local copy of a document.

Declaration

public static LocalCopyStatus GetLocalCopyStatus(string localPath)

Parameters

Type	Name	Description
string	localPath	Path to the local copy of the document.

Returns

Type	Description
LocalCopyStatus

View Source

Initialize()

Initializes this instance.

Declaration

public static void Initialize()

Remarks

Note that provider configurations may be dependant on externally configured UrlSubstitutions, which must be set before Initialize is called.

View Source

LoadProviders(string)

Loads providers from an XML file, but does not add them to the Providers collection.

Declaration

public static IEnumerable<DocumentProvider> LoadProviders(string fileName)

Parameters

Type	Name	Description
string	fileName	Path to XML file.

Returns

Type	Description
IEnumerable<DocumentProvider>

View Source

RaiseDocumentActivated(DocumentActivatedEventArgs)

Raises the DocumentActivated event.

Declaration

public static void RaiseDocumentActivated(DocumentActivatedEventArgs eventArgs)

Parameters

Type	Name	Description
DocumentActivatedEventArgs	eventArgs

View Source

SearchAsync(SearchSpec, Action<DocumentInfo>)

Executes an asynchronous search.

Declaration

public static Task SearchAsync(SearchSpec spec, Action<DocumentInfo> documentResult)

Parameters

Type	Name	Description
SearchSpec	spec
Action<DocumentInfo>	documentResult	Called when a matching document is found.

Returns

Type	Description
Task	A System.Threading.Tasks.Task that completes when the operation is completed.

Remarks

DocumentResult and SearchComplete are not raised when calling this.

View Source

Shutdown()

ABB internal use

Declaration

public static void Shutdown()

Events

View Source

BrowseComplete

Raised when a browse operation is complete.

Declaration

public static event EventHandler<ResultEventArgs> BrowseComplete

Event Type

Type	Description
EventHandler<ResultEventArgs>

View Source

DocumentActivated

Raised when a document is activated (e.g. double-clicked) in a GUI.

Declaration

public static event EventHandler<DocumentActivatedEventArgs> DocumentActivated

Event Type

Type	Description
EventHandler<DocumentActivatedEventArgs>

View Source

DocumentResult

Raised when a mathcing document is found during a search or browse operation.

Declaration

public static event EventHandler<DocumentEventArgs> DocumentResult

Event Type

Type	Description
EventHandler<DocumentEventArgs>

View Source

Error

Raised when a DocumentProvider causes an exception.

Declaration

public static event EventHandler<ExceptionEventArgs> Error

Event Type

Type	Description
EventHandler<ExceptionEventArgs>

View Source

FolderResult

Raised when a folder is found during a browse operation.

Declaration

public static event EventHandler<FolderEventArgs> FolderResult

Event Type

Type	Description
EventHandler<FolderEventArgs>

View Source

Progress

Raised during a search operation to indicate the folder being searched.

Declaration

public static event EventHandler<FolderEventArgs> Progress

Event Type

Type	Description
EventHandler<FolderEventArgs>

View Source

SearchComplete

Raised when a search operation is complete.

Declaration

public static event EventHandler<ResultEventArgs> SearchComplete

Event Type

Type	Description
EventHandler<ResultEventArgs>