OHSU Navigation Upgrade v3.0

From ADF Docs
Revision as of 21:27, 6 May 2016 by Gcronkright (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Back to OHSU Navigation

* This application has been deprecated and will no longer be supported.  PaperThin strongly recommends that customers utilizing this
application should migrate to the native Tree Elements introduced with CommonSpot 9.
IMPORTANT: v3.0 of this application requires ADF 2.0 or greater 

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. Rename directory "/ADF/apps/ohsu_nav" to "/ADF/apps/ohsu_nav_v2.0".
  2. Rename file "/ADF/apps/ohsu_nav_v2.0/appBeanConfig.cfm" to "/ADF/apps/ohsu_nav_v2.0/appBeanConfig.cfm.old".
  3. Move the OHSU Nav v3.0 and into the "/ADF/apps/ohsu_nav/" directory.
  4. Reset the ADF

Site Level Customizations Review

This is only for reviewing the site level customizations in the "/_cs_apps/pt_calendar/" 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.

Site Configuration

The custom field has been upgraded for CommonSpot 10.

  1. Go to Site Admin > Elements & Forms
  2. Select the Field Types and Masks option from the left menu.
  3. Scroll down until you find the Navigation custom field.
  4. Click on the pencil icon to the right of the field name.
  5. Select "edit" from the pop-up menu.
  6. Click on the Render Component tab
  7. For the Explicit Render Component Path enter URL:
    1. /ADF/apps/ohsu_nav/customfields/nav_element_render.cfc


This application uses the CommonSpot 10 resource loading.

  1. Go to Site Admin > Resources/Libraries and open the Registered Resources/Libraries dialog.
  2. Click on the Secondary tab and on the bottom of the dialog
  3. Select the "Add Resource/Library" link.
    1. For the Resource Name enter:
      1. OHSUNavCSS
    2. Leave the Resource Category radio button set to Secondary.
    3. For the description enter:
      1. "Loads the OHSUNav Interface Style Sheet"
  4. Then click on the "Resource URLS" tab and on the top of the dialog where it says "Early Loading" enter URL:
    1. "/ADF/apps/ohsu_nav/style/interface.css"
  5. Leave the type set to "Stylesheet".
  6. Hit the "Add" button.
  7. At the bottom of this dialog select the "Save" button.

Before using the App, don't forget to reset the ADF.

Reset the ADF

Reset the ADF for the server and site.