IMPORT / EXPORTING VIDEO CONTENT BETWEEN PLUMI SITES
----------------------------------------------------

7th Nov 2008
*** THIS IS ALPHA SOFTWARE - WORK IN PROGRESS - DONT FOLLOW THIS ON PRODUCTION SYSTEMS ***

Upgrade to plone 2.5.5 and plumi 0.2.2-final. 
    Use the  buildout for plumi 0.2.x and plone 2.5 [ http://plumi.org/browser/plumi-buildout-plone2.5/trunk ], 
    which includes JSON Migrator and others, or upgrade the Plumi products manually, and then see below for installing JSON Migrator.

    Remember to follow the upgrading steps:
    http://dev.plone.org/collective/browser/Plumi/branches/plumi-0.2.x/UPGRADING.txt

Setup a development site, especially if you are importing content into a production site, so you can 
test all the steps, and start again if necessary.

Installing JSON Migrator
------------------------
Make sure you have the simplejson egg installed
eg on Debian, etc you can do
$ sudo easy_install-2.4 simplejson

If you are using our buildout based instance for plumi 0.2.x and plone 2.5, then you may already has JSON Migrator installed.
If not, you can check out it out from SVN, into your Products directory, and install it using the quick installer.
Our branch is here:
https://svn.plone.org/svn/collective/json_migrator/branches/plumi-0.2.2/


EXPORT STEPS
------------
How to export your current data, using your existing Plumi site, to JSON files on disk.

First we need to use the JSON migrator - a tool you find in the ZMI, in the root of your plumi site you want to export from.
From your site root, in the ZMI, find where the portal_json_migrator tool listed.  

Configure the directory where the product with export your content (as JSON files).

Now you can export. Find the Export tab, and click that.

You can check, after the export is completed, that your video files themselves, are located next the video objects, inside the ATEngageVideo-jsons/ folder.



DONT NEED TO EXPORT 
    Topics
    VaporizedCloud
    SimpleVocabularyTerms
    SimpleVocabulary
    ATMediaFileTool
    VocabularyLibrary

DOESNT WORK
    Image
    Comments/'Discussion Items'
    File 

Need to check all content from each video object makes it across, the attached video file, the thumbnailImage etc

*** Syncing Members!
    Using method from http://blog.kagesenshi.org/2008/05/exporting-plone30-memberdata-and.html 
    Exports to CSV 
    XXX export our customised member data.
    XXX test ExternalMethod setup to JSONMigrator installer.
    XXX members potraits are not exported.
    XXX we have no import method.
    
*** All Metadata checklist.

*** Publish status , ie review_state

*** XXX Thumbnail files on videos are not being set on import correctly.
*** XXX Ownership of video by correct member.

Finally, you can archive this folder, for copying to your import server.


IMPORT STEPS
------------

Assuming you have a collection of JSON files on disk, you wish to import. These files can be edited/deleted by hand as you wish, of course, especially if some objects cause problems on import, or you dont need to import old data etc.

We recommened you create a clone of your plumi site you wish to import content into, and you this new cloned site as an initial test environment.

Inside the ZMI, create a blank Plone site , ie add a 'Plone Site' to your top-level Zope folder.
Do this using your cloned development site, ie your test copy of the production site. Go through the regular Plumi install process.

Next, you use the JSON migrator - a tool you find in the ZMI, in the root of your plumi site you want to export from.
From your site root, in the ZMI, find where the portal_json_migrator tool listed.  

Test importing these JSON files, into your blank Plone site, created at step 1.

When you have perfected the process, you can repeat this process on your production server. Also, if you are confident with the process, and wish to merge content, rather than creating a blank plone site, you can of course import into an existing plumi system.

------

andy@engagemedia.org
