Implemented document migration. Fixed module enabling for documents.

Author: Tom Copeland

README.rdoc

@@ -55,6 +55,7 @@ Some notes on the differences between the GForge and the Redmine object models:
 * The GForge <tt>artifact_group_list</tt> table gets mapped into rows in the Redmine <tt>projects_trackers</tt> table (<tt>projects</tt> HABTM <tt>trackers</tt>).  Redmine <tt>trackers</tt> are not per <tt>project</tt>; they are shared for the whole system.  The current migration only provisions rows in the <tt>projects_trackers</tt> table as they are needed - e.g., a <tt>project</tt> won't get a "Bug" <tt>tracker</tt> unless there's a GForge <tt>artifact</tt> in a "Bug" GForge <tt>artifact_group_list</tt> in this project.  If there's a GForge <tt>artifact_group_list</tt> with an unexpected name (e.g., "Tom's Issues") those get mapped into the "Bug" <tt>tracker</tt>.
 * GForge <tt>artifacts</tt> have only three statuses (open/closed/deleted) whereas Redmine issues have six possible <tt>IssueStatus</tt> settings, so I just map them over to the <tt>IssueStatus</tt> with the same name.  GForge <tt>artifacts</tt> have five priority levels; these map onto Redmine's five standard <tt>IssueCategory</tt> values.  GForge base64 encodes artifact files; Redmine stores the metadata as an <tt>Attachment</tt> and stores the data in the <tt>RAILS_ROOT/files</tt> directory.
 * The GForge forum system handles nested message threads whereas Redmine forum threads are flat (details at http://www.redmine.org/boards/1/topics/15509).  So there's some lost information there, but, meh.
+* GForge documents had an option to store a URL as a document.  I just convert these into a file containing only the URL.
 
 
 === GForge table to Redmine table mapping
@@ -67,7 +68,7 @@ Some notes on the differences between the GForge and the Redmine object models:
   artifact_message             journals
   artifact_monitor             watchers
   artifact_status              enumerations
-  doc_data
+  doc_data                     documents
   doc_groups                   document_categories
   filemodule_monitor
   forum                        messages

lib/tasks/gforge_models.rb

@@ -148,8 +148,31 @@ class GForgeDocument < GForgeTable
     #        5 | private
     set_table_name "doc_data"
     belongs_to :group, :class_name => "GForgeGroup", :foreign_key => 'group_id'
+    belongs_to :user, :class_name => "GForgeUser", :foreign_key => 'created_by'
     belongs_to :document_group, :class_name => "GForgeDocumentGroup", :foreign_key => 'doc_group'
     named_scope :not_deleted, :conditions => "stateid != 2"
+    def convert_to_redmine_document_in(document_category)
+      document = document_category.project.documents.create!(:category => document_category, :title => title, :description => description, :created_on => Time.at(updatedate))
+      if filetype == "URL"
+        file = ActionController::UploadedTempfile.new(filename.gsub(/[^a-z]/, ""))
+        file.binmode
+        file.write(filename)
+        file.original_path = filename.gsub(/[^a-z]/, "")
+        file.rewind
+      else
+        # refactor this into a create_uploaded_temp_file_from(self)
+        file = ActionController::UploadedTempfile.new(filename)
+        file.binmode
+        file.write(extract_content)
+        file.original_path = filename
+        file.rewind
+      end
+      attachment = document.attachments.create!(:description => description, :created_on => Time.at(updatedate), :author => create_or_fetch_user(user), :file => file)
+      document
+    end
+    def extract_content
+      Base64.decode64(data)
+    end
   end
 
   class GForgeArtifactMonitor < GForgeTable

lib/tasks/migrate_from_gforge.rake

@@ -62,7 +62,7 @@ namespace :redmine do
       )
       project.enabled_modules.create!(:name => "issue_tracking") if gforge_group.use_tracker
       project.enabled_modules.create!(:name => "boards") if gforge_group.use_forum
-      project.enabled_modules.create!(:name => "document") if gforge_group.use_docman
+      project.enabled_modules.create!(:name => "documents") if gforge_group.use_docman
       gforge_group.user_group.each do |user_group|
         user = create_or_fetch_user(user_group.user)
         if user_group.group_admin?
@@ -76,6 +76,11 @@ namespace :redmine do
         document_category = showing_migrated_ids(project) do
           document_group.convert_to_redmine_document_category_on(project)
         end
+        document_group.documents.each do |gforge_document|
+          gforge_document = showing_migrated_ids(document_category) do 
+            gforge_document.convert_to_redmine_document_in(document_category)
+          end
+        end
       end
       gforge_group.artifact_group_lists.each do |artifact_group_list|
         project.trackers << Tracker.find_by_name(artifact_group_list.corresponding_redmine_tracker_name) unless project.trackers.find_by_name(artifact_group_list.corresponding_redmine_tracker_name)