This tool is former known as the 'Presentation Tool' and was renamed to 'Portfolios' to distinguish between the sakai presentation tool and the osp presentation tool. In this description the tool is referenced as 'portfolio presentation tool' or 'presentation tool' Don't let the confuse you, we are still talking about the osp.presentation tool.
Documentation for the OSP2.0 version of this tool can be found here: Presentation Template Tool. Some (most) of that documentation still applies.
The portfolios tool is used to create online presentations. Materials that can be presented are:
- files and forms from resources
Users select which type of portfolio presentation they want to create by choosing between a freeform and template based portfolio. In the next steps they select materials from their resources of wizards to include in the presentation. Site members and guests can be invited to view the presentation and an e-mail can be sent to support the invitation. Optionally (invited) visitors can leave comments that are attached to the presentation.
Template based presentations
Conceptual Model of a Template based portfolio
The Portfolios tool allows a portfolio user (often a student) to select a portfolio template and add content to their portfolio. When the portfolio owner views their portfolio, the Portfolios tool gathers their selected content from their resources and the XSL stylesheet for the portfolio template through the Resource tool's "Security Advisor" service and processes the transformation using the Xalan XSLT processor to generate a view that is sent to the client's browser. If the template is properly constructed, links can be generated that request alternative views/portfolio pages that are dynamically generated through the XSLT processor. In this manner a complex web site may be created from the portfolio owner's content. This ability to navigate through complex data structures (such as multiple matrices and wizards) is an important feature to understand to get the most out of Sakai's portfolio software.
Hello World 3 page web site template.
Here is a sample "Hello World" presentation that actually demonstrates how to create multiple-page portfolio presentations. This xsl file actually doesn't transform anything (in other words, it does not utilize any portfolio owner supplied content) but serves as a bare bones model for learning about the portfolio tools. In this example, we focus on the lower half of our conceptual model in a very simple way (we use no supporting files for logos, css files, etc) to make a self contained web site (note the <html>, <head>, and <body> tags). It is important to note that in addition to being treated as self contained web sites, portfolios in Sakai may also be displayed within the portfolio navigation. A full discussion of the differences between these options is beyond the scope of this document: suffice to say if this template is not intended as a standalone page, the <html>, <head>, and <body> tags should be omitted.
The Missing Tool
The next part of this "tutorial" should be how to use the "Template Builder" tool to select content from your various sources and place them neatly on the page in the way you want. That tool isn't there (yet?). The process of getting fixed (supporting template files) or dynamic (portfolio owner authored) content from their various homes and into your template will require some intermediate steps and tools.
The steps are:
- add some content to your template
- create a passthrough template
- create a portfolio that uses this intermediate template
- view that portfolio and inspect (and save) its raw XML
- make a better template that selects the info you want from the raw XML and displays it the way you want
The tools you may want:
- you need an XML editor.
The Passthrough Template
There is nothing to it. Show me everything....
Save this code in an xsl file (passthrough.xsl?) and upload it to your resources.
Create a new portfolio template and use this for the stylesheet.
For grins, lets add a logo as a "supporting file" to our Hello World example.
The steps are easy:
- be sure to select "No" under "Show within Portfolio Navigation?" on step 1 of the template wizard
- select the passthrough template as the "Basic Template Outline" on step 2 (leave the "Outline Options" and "Outline Options File Element" blank).
- leave the "List Content" section in step 3 alone for now...
- add a a supporting file on step 4 of the wizard
- for the "Name (used in xpath)", enter "myLogo" (this name will be an element name in the passthrough file).
- choose an image from your resources to be your logo.
- click the "Add to List" button
- Click the "Finish" button to complete the Template wizard
Next, create a new portfolio that uses the passthrough template created above. For this example, you just select the template and click through the wizard.
View the portfolio and view its source code. It should resemble this:
Adding Some Content to your Portfolio Template
You'll note that the URI to your logo will be referenced in the passthrough XML. In the above code, the logo's url is "https://eportfolio.syr.edu:8443/access/ospPresentation/7b48753d-d64b-4548-00c1-7b801c0a31e4/\
and the XPATH to that URI is: /ospiPresentation/presentationFiles/myLogo/artifact/fileArtifact/uri
If you added a snippet like this:
to your Hello World template, you'll find that the resulting portfolio will include your logo.
Notification email text
For the time being the notification e-mail text is hardcoded in:
Student e-Portfolios and Curriculum Improvement in Biology (7th Sakai Conference, Amsterdam, Netherlands, 12-14 June 2007)
Medical registrar learning and assessment portfolio 2 (Project: Portfolio)