Sharepoint Forum

Ask Question   UnAnswered
Home » Forum » Sharepoint       RSS Feeds

Navigation Customization

  Asked By: Pamela    Date: Nov 16    Category: Sharepoint    Views: 15774

I wish to navigate to a document in a folder tree and then click on a
doc which opens in a below webpart. The Folder tree will always be
visible so the user know excatly where they are in the system.

I am pushing the boundaries of SPS customization?



5 Answers Found

Answer #1    Answered By: Maribel Todd     Answered On: Nov 16

You don't know me, but I'd be very interested in your experience with the
Joust web part. I tried installing it and didn't get very far at all. Each
time I open the dashboard containing it, SPS would hang until something
timed-out and then the web part would be empty.

If it does work for you, I'd be very grateful if you could tell me what
steps you took to install.

Answer #2    Answered By: Akshara Negalur     Answered On: Nov 16

I have used virtual directory web part and here info how to configure it.

Macaw SPS joust menu web part didn't work.

Approaches taken

Two versions of the web part are available:

Macaw SPS joust menu.dwp (embedded code)

Macaw SPS joust menu - virtual directory.dwp (code through virtual directory)

My preference is to use the Macaw SPS joust menu web parts that use the virtual
directory (Macaw SPS joust menu - virtual directory.dwp).

Configuring the virtual directory

The virtual directory should be configured as follows:

1. Open the Internet Information Services (StartàProgramsàAdministrative
ToolsàInternet Services Manager)
2. Right click  on "Default Website", select NewàVirtual Directory
3. Create a virtual directory named MacawSPSutil (if it does not already exist)

More Macaw web parts will use this virtual directory for it's code.
4. Specify the directory containing the MacawSPSutil code. For example you could
copy it from the package to the directory c:\inetpub\wwwroot.

5. Use the default access permissions

6. Select the properties of the MacawSPSutil virtual directory and select the
"Directory Security" tab.

7. Select "Edit" on "Anonymous access and authentication control"
8. Deselect "Anonymous access". Based on your security approach select
"Integrated Windows authentication" or "Basic authentication" (or both). The
Macaw SPS joust menu accesses Sharepoint using the current security settings.

9. Done!

The MacawSPSutil virtual directory contains the directory MacawSPSjoustMenu
containing the code for the tree  control. The tree control web parts will access
the code through the url http://<servername>/MacawSPSutil/MacawSPSjoustMenu.

Using the Macaw SPS joust menu web parts

The installation of the Macaw SPS joust menu web parts is simple, use "Import a
Web Part File..." option in the Content screen and browse to the "Macaw SPS
joust menu.dwp" file or "Macaw SPS joust menu - virtual directory.dwp" file.
When the "Macaw SPS joust menu.dwp" file is imported, all related content in the
"Macaw SPS joust menu_Files" is also installed. For the "Macaw SPS joust menu -
virtual directory.dwp" web part the MacawSPSutil virtual directory must be
configured first (see above).

The web part can be configured through the
"urn:schemas-microsoft-com:webpart:PartStorage" attribute (Part Storage field in
Advanced Settings in the settings screen of the web part). In the previous
version this field contained the configuration in XML. This approach was not
easy and clear enough. The current version contains a configuration file in the
following format:



















Where three replacement variables are available:

_SERVER_ Replaced by the name of the server, for example
https://sergelaptop <https://sergelaptop/>

_WORKSPACE_ Replaced by the name of the workspace, for example

_CURRENTURL_ Replaced by the current URL within the portal, can be used in
the 'openurl' parameter to have the menu opened at the correct entry when used
on the "Document Library" dashboard or the "Categories" dashboard.

Macaw SPS joust menu configuration
Requires parameters:


Name of Sharepoint workspace we are working on


URL to menu root folder  within Sharepoint WSS (in canonicalized Utf8 format)

Optional parameters:


URL within the menu to be displayed as open entry (in canonicalized Utf8 format)


character set to be used for menu rendering, default: utf-8, can be set to other
character set.


specify a property as display name for tree entry; for example
urn:schemas-microsoft-com:office:office#Title for title (optional, default
DAV:displayname, always used for folders)


Display a root node, this is the text to display (prefix with   to get same
spacing as the rest of the menu entries, so use for example:  root


path to icon to be used for root node, if no http://, assume from root of


Show/Don't show folders/files with hidden attribute (optional, default false)


If true, clicking on folders will jump into the folder, if false clicking on
folders will expand/collapse. Folders are opened in the foldertarget (optional,
default false)


If true only folders are shown (and linkonfolder is overriden to true), if false
also files are shown in the tree (optional, default false)


If true only one folder can be open at any particular moment (unless it's a
sub-folder in which case its Parents will remain open) (optional, default false)


If true DDSC events are fired on selection of files/folders. On selection of
folders (if linkonfolders is true) the function
"onMacawSPSjoustMenuFolderSelect", strFolderURL) is called. On selection of
files the function DDSC.RaiseEvent("urn:schemas-microsoft-com:dhtml",
"onMacawSPSjoustMenuFileSelect", strFileURL) is called.

See the web part "Macaw SPS joust menu - events handling example.dwp" for an


If true, icon images based on content class for folders and extension for files
are checked for existance, and if image does not exist it is replaced with a
default image. If false this check is not performed, and no image is shown if
not available (white box with dot in center is displayed on IE) (optional,
default is false)


Width of menu area (optional, default 100%)


Width of text area (optional, default 0)


Target to display document  (optional, default "_blank", use "text" for text
area, or "_top" to replace content in current window)


Target to display folder (optional, default "_top", use "_blank" for new window)


If true some extra information is displayed in the menu for debugging purposes

Some URL parameters must be specified in canonicalized Utf8 format. This means
that spcial characters and accentuated characters are encoded using %xx codings.
You can use the provided web part "Macaw SPS Canonicalized Utf8 Converter.dwp"
to get the current url and a specified url in canonicalized Utf8 format.

Some interesting features available through the above configuration:

The web part can be used in two modes:

* a two column display, left the menu, right the document content.
* A single column display, only the menu is displayed, documents are displayed
in for example a new window or the current window

Target window specification for documents and folders

Do/don't show hidden files

DDSC events are generated on folder/file selection

Optional specification of a "root" entry (text and icon) [Thanks to Steven
Collier for the request].

Currently only one URL folder can be specified. The contents of this folder will
be displayed as top-level entries. If request for it come, I will extend this to
the selection of multiple URL's, in this case those URL's will be the top-level
entries. For example only the /Categories and /Documents entries.

Answer #3    Answered By: Timothy Davis     Answered On: Nov 16

Just use the file called spsjoustmenu.htm, which comes with the zipped file. It
walks you through the entire procedures. Very straight forward and is a very
nice web part.

Answer #4    Answered By: Adya Deshmane     Answered On: Nov 16

When you imported the Joust web part, do you do so on the server, or on a
client machine?

Answer #5    Answered By: Siobhan Waller     Answered On: Nov 16

On the server............................

Didn't find what you were looking for? Find more on Navigation Customization Or get search suggestion and latest updates.