Developing Content for My VT
My VT Wrapper
General Details
| Script name: |
myvt_frame.jsp |
| Location: |
/apps/[instance name]/src/portal/webpages/ |
| Sample URL: |
http://staging.portal.iad.vt.edu/myvt_frame.jsp?url=http://www.vt.edu |
Linking
Internal linking (links that are embedded in the framework)
such as filebox, WebMail, etc. can use relative links like
<a href=/myvt_frame.jsp?url=some_site> where some_site
is a link to an external Web site.
External linking (links that are embedded in external XHTML
and RSS channel documents) should use absolute linking like
<a href=http://[instance string].vt.edu/myvt_frame.jsp?url=some_site>
where the instance string would be something like "staging.portal.iad"
for staging or "portal" (eventually "my")
for production.
Parameters
- title: Optional
- Default value is "My VT" but it can accept any
value. Note that multiple words need to be joined with
the "+" sign. (e.g. ?title=My+VT+Example)
- sso: Optional
- Any value other than "yes" will default to "no".
If "yes" is present, the "Do not leave
this window open unattended without logging out"
message is displayed on the page.
- url: Required
- If not provided, it displays myvt_frame_error.html in
the lower frame. The url parameter is the tricky one.
Passing a simple url such as http://www.vt.edu is very
easy, but passing a url that contains additional parameters
requires more attention. Sending a url with multiple "?"
results in an error. To avoid this situation, you must
convert the url string that contains parameters to Unicode.
The following lists the Unicode mappings for most of the
characters you will experience in a url string:
| Unicode mapping |
| ? -> %3F |
| = -> %3D |
& -> %26 or
& -> %26amp%3B |
| : -> %3A |
| ; -> %3B |
| / -> %2F |
Examples
A simple link within a channel that point to www.vt.edu: <a
href="/myvt_frame.jsp?url=http://www.vt.edu/">
A simple link from an RSS or XHTM file that points to www.vt.edu
and also contains title and sso: <a href="/myvt_frame.jsp?title=VT+Homepage&sso=yes&url=http://www.vt.edu/">
A more complex link that includes parameters inside parameter:
This example is for the "View/Update Addresses and Phone
Numbers" sso link into banner. Currently links to: <a
href="http://staging.portal.iad.vt.edu/AuthportalStub?authportalservice=banner&authportalurl=pls/bprod/bwgkogad.P_SelectAtypUpdate"
Correct link for the wrapper: <a href="http://staging.portal.iad.vt.edu/myvt_frame.jsp?sso=yes&url=http%3A%2F%2Fstaging.portal.iad.vt.edu%2FAuthportalStub%3Fauthportalservice%3Dbanner%26amp%3Bauthportalurl%3Dpls%2Fbprod%2Fbwgkogad.P_SelectAtypUpdate">
|
