TCAO after upgrade from TWiki to Foswiki

Question:

I am trying to migrate a wiki from TWiki for Foswiki on a new server, the upgrade itself is fine but there are some significant changes in TopicClassificationAddOn, including changes in the name of the form that is used to store data. Is there any easy way to convert the old TCAO configurations, topics and data to the new version of TCAO ?

Answer

If you are using Version 2 or later of the TWiki version of TCAO, no changes to your web are needed. However, if you are upgrading from an early version of TCAO (e.g. version 1), then you can use the following steps to upgrade your webs:

1. BACKUP THE WEB!
2. In WebPreferences reassign TCAOWEB to the newest version. Or Replace the older TCAO web with new one.
3. Rename TopicHeadline topic to Summary. This will change that field name in all topics.
4. Update forms:
   1. Rename WebForm to TopicForm. (This will update any topics using this form.)
   2. Rename TopicTypeForm form to TopicClassForm. (This will update any topics using this form.)
   3. Replace TopicForm and TopicClassForm with new versions.
5. Copy over from TCAO web the following files, replacing the older version of topics by the same name: TopicType, SubjectArea, TopicClassForm, TopicClassification, CreateNewTopic.
6. For Classification Topics (including the TopicType and SubjectArea topics):
   1. Add WebClassForm
   2. Set Classification to Classification
   3. Replace content with %INCLUDE{"%TCAOWEB%.RenderClassificationTopic"}%
7. Update SubjectArea and TopicType topics:
   • For any pre-defined TopicTypes or SubjectAreas in your web (i.e. those included with the plugin), the easiest thing to do is just replace these topics with the newer versions from the TCAO/Install web. Also replace associated template topics. You may need to edit the TopicTypes and remove the CREATETOPIC tag in the 1st line.
   • For Custom TopicTypes & SubjectAreas:
     1. Copy the content of a TopicType (or SubjectArea) topic in TCAO web.
     2. Edit your custom TopicType or SubjectArea topics. Replace most of the content with the content copied from the TCAO web. In TopicType topics, look at the section for creating new topics and copy over key pieces. Add any special form elements for creating new topics of this type to the EXTRA section. You won't have to escape double-quotes if you bracket the EXTRA definition with single quotes. Remember that many form elements can be replaced by a FACET reference.
     3. Replace the TopicTypeForm with TopicClassForm.
     4. Set the value for the Classification field to the type of topic it is. You can do this my editing the url of the topic and replace "view" with "save" and adding this url parameter: ?Classification=TopicType (or SubjectArea), and then hit return key.
8. For Custom Forms, insert a DBQUERY to find SubjectAreas (or other classes).

-- LynnwoodBrown - 20 Apr 2010