Difference between revisions of "PT Profile v3.6 Upgrade"
From ADF Docs
Gcronkright (talk | contribs) (→Application Code) |
Gcronkright (talk | contribs) |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
Back to [[Profiles_Overview|PT Profiles]] | Back to [[Profiles_Overview|PT Profiles]] | ||
| − | '''IMPORTANT''': v3.6 of this application requires '''ADF 2.7''' or greater and '''CommonSpot 11.0, 10.9.1 or 10.8. | + | '''IMPORTANT''': v3.6 of this application requires '''ADF 2.7''' or greater and '''CommonSpot 11.0, 10.9.1 or 10.8.3''' or greater. |
== Overview == | == Overview == | ||
| Line 34: | Line 34: | ||
# Once completed, Reset the ADF. | # Once completed, Reset the ADF. | ||
| − | == Disabling the CCAPI == | + | == Disabling the CCAPI for Custom Elements == |
IMPORTANT: For CommonSpot 11.x or above. If you are using this app with CommonSpot 10.9.1 or 10.8.3 or below, '''DO NOT''' disable the CCAPI for this App!! | IMPORTANT: For CommonSpot 11.x or above. If you are using this app with CommonSpot 10.9.1 or 10.8.3 or below, '''DO NOT''' disable the CCAPI for this App!! | ||
| − | # Find your CCAPI conduit page for the | + | # Find your CCAPI conduit page for the Profile App. This page is generally called 'ccapi' or 'ccapiProfile' built from the 'Blank Layout Template''. |
## The ccapi.cfm file may be located in the '/webadmin/profile/' subsite. | ## The ccapi.cfm file may be located in the '/webadmin/profile/' subsite. | ||
# Once you find the CCAPI Conduit page that has the 'Profile' element on it, disable this page. | # Once you find the CCAPI Conduit page that has the 'Profile' element on it, disable this page. | ||
# In the '/_cs_apps/config/ccapi.cfm' file for the site remove the <Profile> node from the <elements> section of the XML block. | # In the '/_cs_apps/config/ccapi.cfm' file for the site remove the <Profile> node from the <elements> section of the XML block. | ||
| + | # Once completed, Reset the ADF. | ||
| − | Note: If no other | + | Note: If no other CE nodes are listed in the <elements> node, other ADF CCAPI functions may still use the <wsVars> configuration information, so do not remove this file. |
== Reset the ADF == | == Reset the ADF == | ||
[[Reset ADF|Reset the ADF]] for the server and site. | [[Reset ADF|Reset the ADF]] for the server and site. | ||
Latest revision as of 22:39, 6 February 2025
Back to PT Profiles
IMPORTANT: v3.6 of this application requires ADF 2.7 or greater and CommonSpot 11.0, 10.9.1 or 10.8.3 or greater.
Contents
Overview
This guide is to upgrade the PT Profile v3.6 from v3.5. If you are updating from a version earlier than v3.5, please complete the v1.0 - v3.5 Upgrade Guides in order.
Download
Download the Profile Application from the Community Site Project or from the SVN Repository.
ADF Application Code Review
This is only for reviewing the code in the "/ADF/apps/" directory, not at the site level.
- 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.
Application Code
- Rename directory "/ADF/apps/pt_profile" to "/ADF/apps/pt_profile_v3.5".
- Rename file "/ADF/apps/pt_profile_v3.5/appBeanConfig.cfm" to "/ADF/apps/pt_profile_v3.5/appBeanConfig.cfm.old".
- Move the PT Profile v3.6 app files into the "/ADF/apps/pt_profile/" directory.
- Reset the ADF
Site Level Customizations Review
This is only for reviewing the site-level customizations in the "/_cs_apps/pt_profile/" 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 with customized functions at the site level "/_cs_apps/". The best practice is to identify the functions that have been customized and compare them 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.
Disabling the CCAPI for Custom Elements
IMPORTANT: For CommonSpot 11.x or above. If you are using this app with CommonSpot 10.9.1 or 10.8.3 or below, DO NOT disable the CCAPI for this App!!
- Find your CCAPI conduit page for the Profile App. This page is generally called 'ccapi' or 'ccapiProfile' built from the 'Blank Layout Template.
- The ccapi.cfm file may be located in the '/webadmin/profile/' subsite.
- Once you find the CCAPI Conduit page that has the 'Profile' element on it, disable this page.
- In the '/_cs_apps/config/ccapi.cfm' file for the site remove the <Profile> node from the <elements> section of the XML block.
- Once completed, Reset the ADF.
Note: If no other CE nodes are listed in the <elements> node, other ADF CCAPI functions may still use the <wsVars> configuration information, so do not remove this file.
Reset the ADF
Reset the ADF for the server and site.
