Upgrade Guide
Changes to Visitor Tools for SP4
This appendix describes the functional and general code changes made to the Visitor Tools for SP4.
Functional Changes
The EditBook page now lets you add multiple books and pages as content. Previously, you had to select one book or page at a time.
Code Changes
This section lists specific JavaScript, JSP, Java, and other files that have been added to Visitor Tools or modified for SP4. The majority of work on Visitor Tools for SP4 has been to streamline the JSPs by relocating JavaScript to .js
files and Java code to .java
files.
In addition, the Visitor Tools code has been internationalized, and translatable strings have been placed in a .properties
file.
The following sections describes these changes in detail.
Internationalization
The file visitorTools/visitorTools.properties
was added to support internationalization. It contains translatable strings extracted from the code.
Moving JavaScript to .js Files
The following table lists the new JavaScript files that have been added to the visitorTools/js
folder. The JavaScript code in these files was removed from the JSP files listed on the right.
New .js File
|
JavaScript Code Removed From:
|
visitorTools/js/book.js
|
visitorTools/visitorToolsEditBook.jsp
|
visitorTools/js/main.js
|
visitorTools/visitorToolsMain.jsp
|
visitorTools/js/page.js
|
visitorTools/visitorToolsEditPage.jsp
|
Changes to JSP Files
The following table lists JSP files that were modified along with the reason for the change.
Modified JSP
|
Reason for Change
|
visitorTools/ visitorToolsEditBook.jsp
|
- Majority of JavaScript moved to
visitorTools/js/book.js
- Moved Java methods to
VisitorToolsUtil.java and VisitorToolsHtmlUtil.java in com/bea/jsptools/portal/util
|
visitorTools/ visitorToolsEditPage.jsp
|
- Majority of JavaScript moved to
visitorTools/js/page.js
- Moved Java methods to
VisitorToolsUtil.java and VisitorToolsHtmlUtil.java in com/bea/jsptools/portal/util
|
visitorTools/ visitorToolsMain.jsp
|
- Majority of JavaScript moved to
visitorTools/js/main.js
- Moved Java methods to
VisitorToolsUtil.java and VisitorToolsHtmlUtil.java in com/bea/jsptools/portal/util
|
Changes to Java Files
This section lists the Java files that were added or changed for Visitor Tools along with the reason for each change.
com/bea/jsptools/portal/backing/VisitorToolsEditBookBacking.java
Moved some code out of the handlePostbackData()
method to various distinct methods in same file.
com/bea/jsptools/portal/backing/VisitorToolsEditPageBacking.java
Moved some code out of the handlePostbackData()
method to various distinct methods in same file.
com/bea/jsptools/portal/backing/VisitorToolsMainBacking.java
Moved some code out of the handlePostbackData()
method to various distinct methods in same file.
com/bea/jsptools/portal/placement/BookPlacement.java
Added import optimization.
com/bea/jsptools/portal/placement/NavigablePlacement.java
Added import optimization.
com/bea/jsptools/portal/placement/PagePlacement.java
Added import optimization.
com/bea/jsptools/portal/placement/PlaceablePlacement.java
Added import optimization.
com/bea/jsptools/portal/placement/Placement.java
Added import optimization.
com/bea/jsptools/portal/placement/PortletPlacement.java
Added import optimization.
com/bea/jsptools/portal/PortalVisitorConstants.java
Added constants used by Visitor Tools code.
com/bea/jsptools/portal/PortalVisitorManager.java
Delegates to the PortalManager class for the majority of operations. This was done for code consolidation and ease of maintenance.
com/bea/jsptools/portal/util/EntitledPresentations.java
Added as a simple helper class.
com/bea/jsptools/portal/util/ResourceCount.java
Added as a simple helper class.
com/bea/jsptools/portal/util/VisitorToolsHtmlUtil.java
Added as a helper class for methods generating HTML. Contains mostly HTML generating methods pulled from visitorToolsMain.jsp
, visitorToolsEditPage.jsp
, and visitorToolsEditBook.jsp
.
com/bea/jsptools/portal/util/VisitorToolsUtil.java
Added as a helper class for methods not generating HTML. Contains mostly methods pulled from visitorToolsMain.jsp
, visitorToolsEditPage.jsp
, and visitorToolsEditBook.jsp
.
Unchanged Files
The following Visitor Tools files did not change for SP4:
visitorTools/visitorTools.portion
visitorTools/js/dialog.js
visitorTools/skeletons/edittogglebutton.jsp