PT Poll Upgrade v2

From ADF Docs
Jump to: navigation, search

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.