Using DefaultLocation with IMANEXT2Lib.IManBrowseCmd

bfelknor

Hi Everyone.

I'm want to implement a browse command starting in the parent of the currently selected object (folder, workspace, etc). I've seen the examples using DefaultLocation property of the that concatenate object id's and literals "My Folders" or "My Matters".

What if the current object is a workspace shortcut in My Matters ? In that case, I want to open the browser in My Matters. (Same thing for all the pseudo collections in the browser root, Favorites, etc....)

What are the literals that must be used...or is there a different method ?

Thanks.

Bruce

jny

Hi Everyone. I'm want to implement a browse command starting in the parent of the currently selected object (folder, workspace, etc). I've seen the examples using DefaultLocation property of the that concatenate object id's and literals "My Folders" or "My Matters". What if the current object is a workspace shortcut in My Matters ? In that case, I want to open the browser in My Matters. (Same thing for all the pseudo collections in the browser root, Favorites, etc....) What are the literals that must be used...or is there a different method ? Thanks. Bruce

Unfortunately, there isn't an API to automate the defaultlocation string format. This key (below) is used to hold the formatted string thus you may use it to concatenate your own, by first, navigate to the location through the WorkSite Desktop Client.

[HKEY_CURRENT_USER\Software\Interwoven\WorkSite\8.0\iManExt\BrowseDlg\Last Location]

For example, if you navigated to a folder belonging to a workspace shortcut under MyMatters, then under this key, you would see:

"Path" = "\!nrtdms:0:!sessionSSDMS:!WorkArea:!RecentPages:\!nrtdms:0:!sessionSSDMS:!database:WS8DSS1:!page:51:\!nrtdms:0:!sessionSSDMS:!database:WS8DSS1:!folderrdinary,52:"

So, in your code, you would need to string up the corresponding objectid's like so:

    ReDim arrSelectableItems(0 To 1)
    arrSelectableItems(0) = imObjectType.imTypeDocument
    arrSelectableItems(1) = imObjectType.imTypeDocumentFolder

    Dim sLoc As String
    sLoc = "\" & osess.WorkArea.RecentWorkspaces.ObjectID & "\" & ows.ObjectID & "\" & ofldr.ObjectID

    ocontext.Add "IManExt2.DefaultLocation", sLoc

Likewise, for a folder under MyFavorites, it would look something like this under the same Last Location key:

"Path" = "\!nrtdms:0:!sessionSSDMS:!database:WS8DSS1:!RootFavoritesFolder:42:\!nrtdms:0:!sessionSSDMS:!database:WS8DSS1:!ShortcutFolder:549:\!nrtdms:0:!sessionSSDMS:!database:WS8DSS1:!folderrdinary,154:"

And your code would look like so:

    Dim sLoc As String
    sLoc = "\" & osess.WorkArea.FavoritesFolder.ObjectID & "\" & oscfldr.ObjectID & "\" & ofldr.ObjectID

    ocontext.Add "IManExt2.DefaultLocation", sLoc

Also, this might be of interests to you: if you follow the code example of using the Path Property to build the location string which is part of the C# sample code of ImportDocToSpecifiedLoc.zip in Technical Article 53218, it should work as well. The technical article is available when search by the Article ID 53218 (IManFileSaveCmd) in the Tech Library page.