Difference between revisions of "PT Poll Version 3.0 Upgrade"

From ADF Docs
Jump to: navigation, search
(Created page with "== Overview == Follow the items below for upgrading the PT Poll app from v1.0 to v2.0. == Application Code == # Renamed directory "/ADF/apps/pt_poll" to "/ADF/apps/pt_poll_v1...")
 
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
== Overview ==
+
Back to [[PT_Poll|PT Poll]]
Follow the items below for upgrading the PT Poll app from v1.0 to v2.0.
 
  
== Application Code ==
+
IMPORTANT: v3.0 of this application requires '''ADF 2.0''' or greater
# Renamed directory "/ADF/apps/pt_poll" to "/ADF/apps/pt_poll_v1".
 
# Renamed file "/ADF/apps/pt_poll_v1/appBeanConfig.cfm" to "/ADF/apps/pt_poll_v1/appBeanConfig.cfm.old".
 
# Move the PT Poll v2.0 and exported into the "/ADF/apps/pt_poll/" directory.
 
  
== Custom Elements ==
+
== Overview ==
 +
Follow the items below for upgrading the PT Poll app from v2.0 to v3.0.
  
=== Poll Question Gallery ===
+
== ADF Application Code Review ==
# Open the field definitions for the Poll Question Gallery element.
+
This is only for reviewing the code that is in the "/ADF/apps/" directory, not at the site level.
# Edit the "pollName" field.
 
## Go to the properties tab and set the size value to "50".
 
# Edit the "pollQuestionID" field.
 
## Go to the properties tab and set "Load All Available Selections" to "true".
 
  
== Pages ==
+
# Download the application from the Community project page.
 +
# Unzip the application zip folder.
 +
# Analyze the updated app code compared to the current app code on your server. 
 +
## Identify any customizations that you have made to the application code to make sure these are not overwritten by the app update. 
 +
## A great tool to use is Beyond Compare to compare the new and current file to identify the exact lines of code that have been changed.
 +
# Once this is complete, then move your app customizations into the new app code package. 
  
=== Poll Administration ===
+
== Application Code ==
Rename this page to the following:
+
# Renamed directory "/ADF/apps/pt_poll" to "/ADF/apps/pt_poll_v2".
# Name: index
+
# Renamed file "/ADF/apps/pt_poll_v2/appBeanConfig.cfm" to "/ADF/apps/pt_poll_v2/appBeanConfig.cfm.old".
# Title: Poll Manager
+
# Move the PT Poll v3.0 and exported into the "/ADF/apps/pt_poll/" directory.
 
 
Update the "Vote Options" field, add the following text into the description field:
 
* Entering a comma in your option(s) will cause unexpected results.
 
 
 
=== Vote Manager ===
 
Create and setup the Vote Manager page.
 
 
 
# Create a new page:
 
## Name: vote manager
 
## Title: Vote Manager
 
# Insert a datasheet element into the page and define the datasheet.
 
## Select the Poll Vote element
 
## Add the UserID, QuestionID, Vote, Date
 
# Click on "Edit Columns"
 
## Add the action column for delete and select the "delete-form-data.cfm" module.
 
# Click to edit Layout
 
## Default Sorting: Date DESCENDING
 
## Results Per Page: 50
 
 
 
=== Poll Question Gallery Manager ===
 
# Create a new page:
 
## Name: index
 
## Title: Poll Question Gallery Manager
 
# Insert a Custom Script module onto the page.
 
# Edit the Custom Script module and enter the explicit path:
 
## /ADF/extensions/customcf/genericElementManagement.cfm
 
## Add the Parameter:
 
### elementName=Poll Question Gallery
 
# There will be a datasheet on the page click to define the datasheet
 
## Select the Poll Question Gallery element
 
## Add the Poll Name and Poll Question ID fields.
 
# Click on "Edit Columns"
 
## Edit the Poll Question ID column
 
### Change its name to: "Edit/Delete"
 
### Change its renderhandler to: /ADF/extensions/datasheet-modules/datasheet-action-edit-delete.cfm
 
## Move to the first row in the datasheet.
 
# Click to edit Layout
 
## Allow JavaScript data sorting: Unchecked
 
  
 
== Site Level Customizations Review ==
 
== Site Level Customizations Review ==

Latest revision as of 20:08, 17 May 2016

Back to PT Poll

IMPORTANT: v3.0 of this application requires ADF 2.0 or greater 

Overview

Follow the items below for upgrading the PT Poll app from v2.0 to v3.0.

ADF Application Code Review

This is only for reviewing the code that is in the "/ADF/apps/" directory, not at the site level.

  1. Download the application from the Community project page.
  2. Unzip the application zip folder.
  3. Analyze the updated app code compared to the current app code on your server.
    1. Identify any customizations that you have made to the application code to make sure these are not overwritten by the app update.
    2. A great tool to use is Beyond Compare to compare the new and current file to identify the exact lines of code that have been changed.
  4. Once this is complete, then move your app customizations into the new app code package.

Application Code

  1. Renamed directory "/ADF/apps/pt_poll" to "/ADF/apps/pt_poll_v2".
  2. Renamed file "/ADF/apps/pt_poll_v2/appBeanConfig.cfm" to "/ADF/apps/pt_poll_v2/appBeanConfig.cfm.old".
  3. Move the PT Poll v3.0 and exported into the "/ADF/apps/pt_poll/" directory.

Site Level Customizations Review

This is only for reviewing the site level customizations in the "/_cs_apps/pt_poll/" directory, not in the ADF directory.

  1. Analyze the updated app code compared to the app customization code on your server.
    1. Identify any customizations that you have made to the application code to make sure these are updated with any functionality.
    2. Again, Beyond Compare is a good tool to compare the new and current file to identify the exact lines of code that have been changed.
    3. This is important for components that have customized functions to the site level "/_cs_apps/". The best practice is to identify the function that have been customized and compare with the new app function to identify any updates. A good help is to check the function comment header to see if any updates have been made.
  2. Once completed, Reset the ADF.

Reset the ADF

Reset the ADF for the server and site.