Panes File Structure

From MT Marvelit
Revision as of 22:38, 6 August 2007 by Rmortensen (Talk | contribs)

Jump to: navigation, search

Pane PSML File Location

When using the Portal Site Manager, Jetspeed stores these panes on the portal server in a specific directory. Starting with the directory where Jetspeed was installed (in the example dash212_mysql ), the structure is as follows (from bottom to top) :

Folder1.jpg

Pages Folder Structure

Within the Pages folder - you see folders (representing highest levels on a menu), pages (single pages on the top menu) and subsites (more on later). In addition you see some standard psml files that control the functioning of the highest menu bar.


This example shows the structure of the DASH download after installation. Welcome.psml (Dash in the menu) is the first page displayed after login. This is specifed by setting welcome.psml as the default page for the / (root) entry in the Portal Site Manager. Refer to Adding Panes for information on how to use the Portal Site Manger.


Folder2.jpg

Specific Pane Folder Structure

Folders within the Pages sub-directory represent the hightest level of menus in DASH. Inside each of the folders are the individual page psml files saved when pages are added using the portal site manager. These psml files control pane functions within the portal. There is also a folder.metadata file that controls how the folder functions.

Folder3.jpg

Folder.metadata Contents

The folder.metadata file contains specifc tags that tell the portal how to display pages and who can access the page. The <document-order> tag can be placed in the file to control the order of panes displayed. By default - the portal displays them in alphabetical order. A default page can be set up using the default-page tag. In the following example, no page is set as the default as the <default-page> tag is empty.

An important part of any dashboard is security. Currently, you set which users, roles and groups have what kind of access to the panes in this folder by using the <security> tags. In the following example, the admin role has access to update the panes and portlets that exist on those panes within this directory.

For additional information on setting security in the psml files see Advanced Security Features


Folder3a.jpg

Pane PSML Contents

The page.psml (in the example below: DASH Administration.psml) file contains specifc tags that tell the portal the decorator to use and the portles placed with their unique tags. The <defaults> tag can be placed in the file to control which decorator is used. This can also be set at Adding Portlets to a Pane.

The <fragment> tag displays the unique portlet id (<fragment-id>), the portlet (name) and decorator to be utilized (decorator). All of these values are placed in these psml files when portlets are added to a pane. For further information see Adding Portlets to a Pane

Additionally, you can specifiy security tags described above in the page.psml file as well. This would enable certain users, groups, or roles to have access or be denied access to a specific page. For additional information on setting security in the psml files see Advanced Security Features



Folder4.jpg