Difference between revisions of "PT Poll Upgrade v2"

From ADF Docs
Jump to: navigation, search
(→‎Custom Element Updates)
(→‎Poll Administration)
 
(8 intermediate revisions by the same user not shown)
Line 7: Line 7:
 
# Move the PT Poll v2.0 and exported into the "/ADF/apps/pt_poll/" directory.
 
# Move the PT Poll v2.0 and exported into the "/ADF/apps/pt_poll/" directory.
  
−
== Custom Field Types ==
+
== Custom Elements ==
  
−
=== Vote Options ===
+
=== Poll Question Gallery ===
−
# Check in the Site Admin and Field Types and Masks.
+
# Open the field definitions for the Poll Question Gallery element.
−
# Identify if a "Vote Options" custom field type is registered.
+
# Edit the "pollName" field.
−
# If not, then import the custom field type from the following exported object path:
+
## Go to the properties tab and set the size value to "50".
−
## /ADF/apps/pt_poll/exported-objects/Vote-Options-Custom-Field-Type.zip
+
# Edit the "pollQuestionID" field.
 +
## Go to the properties tab and set "Load All Available Selections" to "true".
  
−
== Custom Element Updates ==
+
== Pages ==
  
−
=== Poll Question ===
+
=== Poll Administration ===
−
# Add the following new field:
+
Rename this page to the following:
−
## Create a new tab called "Options".
+
# Name: index
−
## In the "Options" tab add a new field with the following:
+
# Title: Poll Manager
−
### Field Name: voteOptions
 
−
### Label: Vote Options
 
−
### Type: Vote Options
 
−
### Required: Yes
 
  
−
This "Vote
+
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 ==
 +
This is only for reviewing the site level customizations in the "/_cs_apps/pt_poll/" directory, not in the ADF directory.
 +
 
 +
# Analyze the updated app code compared to the app customization code on your server.
 +
## Identify any customizations that you have made to the application code to make sure these are updated with any functionality.
 +
## 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. 
 +
## 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.
 +
# Once completed, Reset the ADF.
 +
 
 +
== Reset the ADF ==
 +
[[Reset ADF|Reset the ADF]] for the server and site.

Latest revision as of 21:29, 22 February 2013

Overview

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

Application Code

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

Custom Elements

Poll Question Gallery

  1. Open the field definitions for the Poll Question Gallery element.
  2. Edit the "pollName" field.
    1. Go to the properties tab and set the size value to "50".
  3. Edit the "pollQuestionID" field.
    1. Go to the properties tab and set "Load All Available Selections" to "true".

Pages

Poll Administration

Rename this page to the following:

  1. Name: index
  2. Title: Poll Manager

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.

  1. Create a new page:
    1. Name: vote manager
    2. Title: Vote Manager
  2. Insert a datasheet element into the page and define the datasheet.
    1. Select the Poll Vote element
    2. Add the UserID, QuestionID, Vote, Date
  3. Click on "Edit Columns"
    1. Add the action column for delete and select the "delete-form-data.cfm" module.
  4. Click to edit Layout
    1. Default Sorting: Date DESCENDING
    2. Results Per Page: 50

Poll Question Gallery Manager

  1. Create a new page:
    1. Name: index
    2. Title: Poll Question Gallery Manager
  2. Insert a Custom Script module onto the page.
  3. Edit the Custom Script module and enter the explicit path:
    1. /ADF/extensions/customcf/genericElementManagement.cfm
    2. Add the Parameter:
      1. elementName=Poll Question Gallery
  4. There will be a datasheet on the page click to define the datasheet
    1. Select the Poll Question Gallery element
    2. Add the Poll Name and Poll Question ID fields.
  5. Click on "Edit Columns"
    1. Edit the Poll Question ID column
      1. Change its name to: "Edit/Delete"
      2. Change its renderhandler to: /ADF/extensions/datasheet-modules/datasheet-action-edit-delete.cfm
    2. Move to the first row in the datasheet.
  6. Click to edit Layout
    1. Allow JavaScript data sorting: Unchecked

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.

Retrieved from "http://community.paperthin.com/adf-docs/index.php?title=PT_Poll_Upgrade_v2&oldid=6263"