move-to-go 5.0.0

data/sources/base-crm/converter.rb

@@ -0,0 +1,56 @@
+
+class Converter
+
+  def configure(rootmodel)
+    # add custom field to your model here. Custom fields can be
+    # added to organization, deal and person. Valid types are
+    # :String and :Link. If no type is specified :String is used
+    # as default.
+    rootmodel.settings.with_organization do |organization|
+
+    end
+
+    rootmodel.settings.with_deal do |deal|
+        deal.add_status({:label => "Prospecting", :integration_id => "Prospecting"})
+        deal.add_status({:label => "Qualified", :integration_id => "Qualified"})
+        deal.add_status({:label => "Won", :integration_id => "Won",
+                            :assessment => MoveToGo::DealState::PositiveEndState })
+        deal.add_status({:label => "Lost", :integration_id => "Lost",
+                            :assessment => MoveToGo::DealState::NegativeEndState })
+    end
+  end
+
+  def to_organization(row, rootmodel)
+
+    organization = MoveToGo::Organization.new
+    # All built in fields are automagically mapped. Add your custom stuff here...
+
+    return organization
+  end
+
+  def to_organization_from_lead(row, rootmodel)
+    organization = MoveToGo::Organization.new
+    # All built in fields are automagically mapped. Add your custom stuff here...
+    return organization
+  end
+
+  def to_coworker(row)
+        coworker = MoveToGo::Coworker.new
+    # All built in fields are automagically mapped. Add your custom stuff here...
+        return coworker
+  end
+
+  def to_person(row, rootmodel)
+        person = MoveToGo::Person.new
+    # All built in fields are automagically mapped. Add your custom stuff here...
+    return person
+  end
+
+  def to_deal(row, rootmodel)
+    deal = MoveToGo::Deal.new
+    # All built in fields are automagically mapped. Add your custom stuff here...
+    deal.status = rootmodel.settings.deal.find_status_by_label row['stage_name']
+    return deal
+  end
+
+end

data/sources/base-crm/data/contacts.csv

@@ -0,0 +1,13 @@
+first_name,last_name,is_organisation,name,organisation_name,owner,tags,email,address,mobile,phone,customer_status,prospect_status,custom Name#1,custom First name#1,city,country,created_at,creator,description,facebook,fax,id,industry,last_activity_date,linkedin,linkedin_display,private,region,skype,title,twitter,updated_at,website,zip
+Håka,Lind,false,Håka Lind,AD Company,Kalle Kula,"",hakan.lind@ad.com,gatan 2,+46701234123,"",current,,,,Göteborg,Sweden,2015-08-12T09:59:32Z,Kalle Kula,,,,98153928,,,,,false,"",,"Service Manager production system, IT coordinator",,2015-10-02T09:19:17Z,,56130
+,,true,itteknik,,Kalle Kula,from iPhone,,vägen 23,,,current,,,,Malmö,Sverige,2015-11-25T15:17:20Z,Kalle Kula,,,,108910004,,,,,false,,,,,2015-11-25T15:17:21Z,,34250
+Anna,Berg,false,Anna Berg,itteknik,Kalle Kula,"Flexibla Kontoret,Hantverksappen,vvs",info@roret.se,Brunnvägen 1,070-1110000,"",current,,,,Stockholm,Sweden,2016-02-15T07:41:56Z,Kalle Kula,,,,117069853,,,,,false,"",,"Ekonomi, Admin",,2016-02-15T07:41:56Z,,57450
+Anna,Ståhl,false,Anna Ståhl,AB Bors Rör,Kalle Kula,from iPhone,,,076-800 10 00,,,,,,,,2015-08-19T08:49:26Z,Kalle Kula,,,,98708109,,,,,false,,,,,2015-08-19T08:49:26Z,,
+,,true,AB Bors Rör,,Kalle Kula,"flexibla kontoret,vvs","","","","",,,,,"","",2015-09-17T12:01:44Z,Kalle Kula,,,,101402913,,,,,false,"",,,,2015-11-09T13:45:58Z,,""
+,,true,AB Familjen,,Kalle Kula,from iPhone,,,,,,,,,Åre,Sweden,2015-08-19T06:26:58Z,Kalle Kula,,,,98702143,,,,,false,Jämtlands Län,,,,2015-08-21T07:29:44Z,,
+,,true,AB Laholms,,Kalle Kula,from iPhone,,,,,,,,,,,2015-08-19T06:21:27Z,Kalle Kula,,,,98702035,,,,,false,,,,,2015-08-19T06:21:27Z,,
+,,true,AD Company,,Kalle Kula,from iPhone,,gatan 2,,,current,,,,Lund,,2015-10-12T14:38:43Z,Kalle Kula,,,,104062513,,,,,false,,,,,2015-11-19T10:40:39Z,,553 00
+,,true,AB Affär,,Kalle Kula,"",,,,,current,,,,Lund,Sweden,2015-08-18T21:59:33Z,Kalle Kula,,,,98677167,Digital sinage mm,,,,false,,,,,2015-08-18T21:59:33Z,,
+,,true,AB Affären,,Kalle Kula,"",,,,,,,,,,,2014-09-05T07:45:04Z,Kalle Kula,,,,69769303,Redovisnings konsult,,,,false,,,,,2014-09-05T15:33:17Z,,
+,,true,Ahlgrens Bilar,,Kalle Kula,"from iPhone,flexibla kontoret,Flexibla/Hantverksappen",,,,,,,,,,,2015-08-19T06:37:39Z,Kalle Kula,,,,98702525,,,,,false,,,,,2015-08-19T06:37:39Z,,
+Alex,Alexandersson,false,Alex Alexandersson,Ahlgrens Bilar,Kalle Kula,from iPhone,Alex.Alexandersson@ahlgrens.se,,0707 840000,,,,,,,,2015-08-19T09:30:24Z,Kalle Kula,,,,98710895,,,,,false,,,,,2015-08-19T09:30:24Z,,

data/sources/base-crm/data/coworkers.csv

@@ -0,0 +1,3 @@
+first_name,last_name,email
+Kalle,Kula,Kalle@kula.se
+Kalle,Gula,Kalle@gula.se

data/sources/base-crm/data/deals.csv

@@ -0,0 +1,5 @@
+id,name,scope,pipeline_name,pipeline_id,stage_name,stage_id,owner,tags,main_contact_id,main_contact,company_id,company,added_at,added_on,created_at,creator,currency,forecasted_deal_value,hot,last_activity_date,last_stage_change_at,loss_reason,source,updated_at
+10926776,"avtal, ca 40st",300000,Sales Pipeline,60134,Prospecting,432286,Kalle Kula,"",117069853,Anna Berg,108910004,"itteknik",2015-10-05 08:28:00 UTC,2015-10-05,2015-10-05T08:29:47Z,Kalle Kula,SEK,,true,2015-10-05T08:29:47Z,2015-10-05T08:28:47Z,"",Butiken1,2015-10-05T08:29:47Z
+11973819,Deal2,100000,Sales Pipeline,60134,Qualified,432290,Kalle Kula,"ftp,filserver,service avtal",98708109,Anna Ståhl,101402913,AB Bors Rör,2015-11-19 10:38:00 UTC,2015-11-19,2015-11-19T10:39:51Z,Kalle Kula,SEK,,true,2015-11-19T10:39:51Z,2015-11-19T10:38:51Z,"",Henrik Henriksson konsult,2015-11-19T10:39:51Z
+4636237,Deal1,4500,Sales Pipeline,60134,Won,432287,Kalle Kula,cloud,98153928,Håka Lind,104062513,AD Company,2014-09-02 09:40:00 UTC,2014-09-02,2014-09-03T09:41:05Z,Kalle Kula,SEK,,true,2015-02-18T07:39:45Z,2015-02-18T07:39:45Z,"",konsollen,2015-02-18T07:39:45Z
+4653104,Deal3,2300,Sales Pipeline,60134,Won,432287,Kalle Kula,"",98710895,Alex Alexandersson,98702525,Ahlgrens Bilar,2014-09-04 07:53:00 UTC,2014-09-04,2014-09-04T07:54:31Z,Kalle Kula,SEK,,false,2014-09-04T07:55:07Z,2014-09-04T07:53:00Z,"",Hyresavtal,2014-09-04T07:54:31Z

data/sources/base-crm/data/histories.csv

@@ -0,0 +1,6 @@
+content,owner,noteable_id,noteable_type,noteable_name,created_at,id,noteable_company_name,noteable_first_name,noteable_last_name,updated_at
+Uppdatering av underhållsavtal på befintlig,Kalle Kula,10926776,Deal,Sannarp,2014-09-03T08:49:07Z,22606121,,,,2014-09-03T08:49:07Z
+"Mailat offert, Återkommer...",Kalle Kula,10926776,Deal,Sannarp,2014-09-03T08:50:01Z,22606134,,,,2014-09-03T08:50:01Z
+"Kund mailar och...",Kalle Kula,11973819,Deal,Sannarp,2014-09-03T08:50:28Z,22606143,,,,2014-09-03T08:50:28Z
+"Kört igång...",Kalle Kula,98702525,SalesAccount,,2014-09-03T08:56:28Z,22606290,"",Peder,Johansson,2014-09-03T08:56:28Z
+"Påminnelse ,1, 2...",Kalle Kula,108910004,SalesAccount,,2014-09-03T08:58:13Z,22606323,"",Peder,Johansson,2014-09-03T08:58:13Z

data/sources/base-crm/data/leads.csv

@@ -0,0 +1,4 @@
+first_name,last_name,company_name,owner,city,country,created_at,creator,description,email,facebook,fax,id,industry,linkedin,mobile,phone,region,skype,status,street,tags,title,twitter,updated_at,website,zip
+Robin,Hood,Reklam1 AB,Kalle Kula,Lund,Sweden,2014-09-04T09:42:33Z,Kalle Kula,,,,,16685740,tillverkning,,0733-11 11 11,,,,Working,,reklam,Försäljnings- och marknadschef,,2014-09-04T09:42:33Z,,
+Tony,Tonfisk,Hantverkare2,Kalle Kula,Borås,,2014-09-04T14:36:01Z,Kalle Kula,"Ringde, intresse finns",tony@tonfisk.se,,,16694927,Magasin/katalog,,0701121212,,,,Unqualified,gatan 11,,Ansvarig,,2014-09-10T14:44:29Z,,
+Thomas,Tomasso,"Bregott fabriken",Kalle Kula,Jönköping,Sweden,2015-06-30T12:47:04Z,Kalle Kula,,thomas.tomasso@bregott.se,,,35451881,,,07088000 00,090505050,,,Working,gatan 12,,Delägare,,2015-06-30T12:47:04Z,,553 17

data/sources/base-crm/data/tasks.csv

@@ -0,0 +1,5 @@
+content,owner,send_time,done_at,created_at,date,id,remind,taskable_company_name,taskable_first_name,taskable_id,taskable_last_name,taskable_name,taskable_type,updated_at
+"Ring kund ang uppföljning,Kalle Kula,2014-09-04T06:15:00Z,2014-09-04T06:59:32Z,2014-09-03T08:59:53Z,,7338118,true,"""",Petter,69512473,Johansson,,SalesAccount,2014-09-04T06:59:32Z"
+"Ring boka ny utb!,Kalle Kula,2014-09-08T07:45:00Z,,2014-09-04T07:00:36Z,,7402212,true,"""",Petter,69512473,Johansson,,SalesAccount,2014-09-07T14:45:04Z"
+"Ring boka möte för fördjupat samarbete,Kalle Kula,2014-09-08T08:00:00Z,,2014-09-04T07:25:17Z,,7402869,true,"""",Anna,69512622,Andersson,,SalesAccount,2014-09-04T07:25:17Z"
+"Boka nytt möte,Kalle Kula,2014-09-08T10:45:00Z,,2014-09-04T07:18:36Z,,7402562,true,"""",Cyrus,69512640,TheVirus,,SalesAccount,2014-09-07T14:44:51Z"

data/sources/csv/.gitignore

@@ -0,0 +1,14 @@
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile ~/.gitignore_global
+
+# Ignore bundler config
+/.bundle
+# Ignore built gems
+/*.gem
+# Ignore all logfiles and tempfiles.
+/tmp
+/spec/tmp
+pkg

data/sources/csv/.move-to-go/readme.txt

@@ -0,0 +1 @@
+This source converts a csv file to LIME Go.

data/sources/csv/.move-to-go/runner.rb

@@ -0,0 +1,65 @@
+
+require 'move-to-go'
+require_relative("../converter")
+
+# COWORKER_FILE and other file names should be defined ../converter.rb
+
+def process_rows(file_name, source_encoding)
+    data = File.read(file_name, :encoding => source_encoding)
+    rows = MoveToGo::CsvHelper::text_to_hashes(data)
+    rows.each do |row|
+        yield row
+    end
+end
+
+def convert_source
+    puts "Trying to convert CSV source to LIME Go..."
+
+    converter = Converter.new
+
+    # A rootmodel is used to represent all entitite/models that is
+    # exported
+    rootmodel = MoveToGo::RootModel.new
+
+    converter.configure(rootmodel)
+    source_encoding = defined?(SOURCE_ENCODING) ? SOURCE_ENCODING : 'ISO-8859-1'
+
+    # coworkers
+    # start with these since they are referenced
+    # from everywhere....
+    if defined?(COWORKER_FILE) && !COWORKER_FILE.nil? && !COWORKER_FILE.empty?
+        process_rows(COWORKER_FILE, source_encoding) do |row|
+            rootmodel.add_coworker(converter.to_coworker(row))
+        end
+    end
+
+    # organizations
+    if defined?(ORGANIZATION_FILE) && !ORGANIZATION_FILE.nil? && !ORGANIZATION_FILE.empty?
+        process_rows(ORGANIZATION_FILE, source_encoding) do |row|
+            organization = converter.to_organization(row, rootmodel)
+            rootmodel.add_organization(organization)
+            converter.organization_hook(row, organization, rootmodel) if defined? converter.organization_hook
+        end
+    end
+
+    # persons
+    # depends on organizations
+    if defined?(PERSON_FILE) && !PERSON_FILE.nil? && !PERSON_FILE.empty?
+        process_rows(PERSON_FILE, source_encoding) do |row|
+            # adds it self to the employer
+            converter.to_person(row, rootmodel)
+        end
+    end
+
+    # deals
+    # deals can reference coworkers (responsible), organizations
+    # and persons (contact)
+    if defined?(DEAL_FILE) && !DEAL_FILE.nil? && !DEAL_FILE.empty?
+        process_rows(DEAL_FILE, source_encoding) do |row|
+            rootmodel.add_deal(converter.to_deal(row, rootmodel))
+        end
+    end
+
+    return rootmodel
+end
+

data/sources/csv/Gemfile

@@ -0,0 +1,5 @@
+source 'http://rubygems.org'
+
+gem 'thor'
+gem 'move-to-go'
+gem 'rspec'

data/sources/csv/converter.rb

@@ -0,0 +1,218 @@
+require 'move-to-go'
+
+# This converter will convert one or more CVS files into a LIME Go XML
+# file.
+
+# You need to customize this script to suit your CVS file(s).
+
+# First we set the file names of your CVS files. If you dont need to
+# import all kind of objects, just leave the filename empty or remove
+# the line.
+COWORKER_FILE = "data/coworkers.csv"
+ORGANIZATION_FILE = "data/organizations.csv"
+PERSON_FILE = "data/persons.csv"
+DEAL_FILE = "data/deals.csv"
+# Ie if you dont want to import deals, set DEAL_FILE = ""
+
+# Default encoding for files are 'ISO-8859-1' (aka latin1)
+# If the file is in any other encoding this must be specified with 
+# SOURCE_ENCODING set to correct value
+# Ruby can handle lots of encodings, but common ones are:
+# SOURCE_ENCODING = "UTF-8"
+# SOURCE_ENCODING = "bom|UTF-8"
+# SOURCE_ENCODING = "UTF-16"
+
+# If you are importing files then you must set the FILES_FOLDER
+# constant. FILES_FOLDER should point to the folder where the files
+# are stored. FILES_FOLDER can be relative to the project directory
+# or absolute. Note that you need to escape \ with a \ so in order to
+# write \ use \\.
+FILES_FOLDER = "./files"
+
+# If you are importing files with an absolute path (eg
+# m:\documents\readme.doc) then you probably wont have files at that
+# location on the computer where "move-to-go run" is executed. Set
+# FILES_FOLDER_AT_CUSTOMER to the folder where documents are stored at
+# the customers site. Ie, in this example m:\documents.
+# Note that you need to escape \ with a \ so in order to write \ use
+# \\.
+FILES_FOLDER_AT_CUSTOMER = "m:\\documents\\"
+
+class Converter
+    # Configure your root model, add custom fields and deal statuses.
+    def configure(rootmodel)
+        # add custom field to your model here. Custom fields can be
+        # added to organization, deal and person. Valid types are
+        # :String and :Link. If no type is specified :String is used
+        # as default.
+        rootmodel.settings.with_organization do |organization|
+            organization.set_custom_field( { :integrationid => 'external_url', :title => 'Link to external system', :type => :Link } )
+        end
+
+        rootmodel.settings.with_deal do |deal|
+            deal.add_status({:label => "1. Kvalificering", :integration_id => "qualification"})
+            deal.add_status({:label => "Vunnen", :integration_id => "won",
+                                :assessment => MoveToGo::DealState::PositiveEndState })
+            deal.add_status({:label => "Lost", :integration_id => "Lost",
+                                :assessment => MoveToGo::DealState::NegativeEndState })
+        end
+    end
+
+    # Turns a row from the organization csv file into a
+    # MoveToGo::Organization.
+    # Use rootmodel to locate other related stuff such coworker
+    def to_organization(row, rootmodel)
+        organization = MoveToGo::Organization.new
+        # Integrationid is typically the id in the system that
+        # we are getting the csv from. Must be set to be able
+        # to import the same file more than once without
+        # creating duplicates
+        organization.integration_id = row['id']
+        organization.name = row['name']
+
+        # Just setting all basic properties to show whats available
+        # Remove or fix...
+        organization.organization_number = 'a number'   # needs clean up, should have helpers for that in lib. Swedish format.
+        organization.email = 'email to organizaiton, not the person'
+        organization.web_site = 'www.whatever.com'
+        organization.central_phone_number = '0000'      # needs clean up, should have helpers for that in lib. Default swedish format, convert to global format
+
+        # Addresses consists of several parts in Go.
+        # Lots of other systems have the address all in one
+        # line, to be able to match when importing it is
+        # way better to split the addresses
+        organization.with_visit_address do |address|
+            address.street = 'visit street'
+            address.zip_code = 'visit zip'
+            address.city = 'visit city'
+        end
+
+        # Another example of setting address using
+        # helper to split '226 48 LUND' into zip and city
+        organization.with_postal_address do |address|
+            address.street = 'postal street'
+            address.parse_zip_and_address_se '226 48 LUND'
+        end
+
+        # Responsible coworker is set by first locating
+        # it in the root model and then setting a reference
+        # to him/her
+        # We need to be able handle missing coworkers here
+        coworker = rootmodel.find_coworker_by_integration_id row['responsible_id']
+        organization.responsible_coworker = coworker.to_reference
+
+        # Set tags for the organization. All organizations will get
+        # the tag "import" automagically
+        organization.set_tag("Guldkund")
+
+        # When imported from web based ERP or similair that
+        # client will continue to use it can be useful to be
+        # able to link from Go to the same record in the ERP
+        # FOr instance Lime links
+        organization.set_custom_value("external_url", "http://something.com?key=#{row['id']}")
+
+        return organization
+    end
+
+    # Turns a row from the coworker csv file into a MoveToGo::Coworker.
+    def to_coworker(row)
+        coworker = MoveToGo::Coworker.new
+        coworker.integration_id = row['id']
+        coworker.first_name = row['first_name']
+        coworker.last_name = row['last_name']
+
+        # Other optional attributes
+        coworker.email = 't@e.com'
+        coworker.direct_phone_number = '+46121212'
+        coworker.mobile_phone_number = '+46324234'
+        coworker.home_phone_number = '+46234234'
+
+        # Tags and custom fields are set the same
+        # way as on organizations
+
+        return coworker
+    end
+
+    # Turns a row from the person csv file into a MoveToGo::Person.
+    #
+    # You MUST add the new person to an existing organization. Use the
+    # rootmodel to find the organization and then add the person with
+    # organization.add_employee
+    def to_person(row, rootmodel)
+        person = MoveToGo::Person.new
+        person.integration_id = row['id']
+        # Note that Go has separate first and last names
+        # Some splitting might be necessary
+        person.first_name = row['first_name']
+        person.last_name = row['last_name']
+        # other optional attributes
+        person.direct_phone_number = '+4611111'
+        person.fax_phone_number = '+4623234234234'
+        person.mobile_phone_number = '+462321212'
+        person.email = 'x@y.com'
+        person.alternative_email = 'y@x.com'
+        person.with_postal_address do |address|
+            address.street = 'postal street'
+            address.parse_zip_and_address_se '226 48 LUND'
+        end
+
+        # Tags and custom fields are set the same
+        # way as on organizations
+
+        # set employer connection
+        employer_id = row['employer_id']
+        employer = rootmodel.find_organization_by_integration_id employer_id
+        employer.add_employee person
+    end
+
+    # Turns a row form the deal csv file into a MoveToGo::Deal. Use
+    # the rootmodel to find objects that should be linked to the new
+    # deal.
+    def to_deal(row, rootmodel)
+        deal = MoveToGo::Deal.new
+        deal.integration_id = row['id']
+        deal.name = row['name']
+        # should be integer, same currency should be used in
+        # the system
+        deal.value = row['value']
+
+        # find stuff connected to deal
+        responsible = rootmodel.find_coworker_by_integration_id row['responsible_id']
+        organization = rootmodel.find_organization_by_integration_id row['customer_id']
+        person = organization.find_employee_by_integration_id row['customer_contact_id']
+        # connect the deal by references
+        deal.responsible_coworker = responsible.to_reference
+        deal.customer = organization.to_reference
+        deal.customer_contact = person.to_reference
+
+        # other optional attributes
+        deal.probability = 50           # should be between 0 - 100
+        deal.order_date = '2014-01-05'  # Format ?
+
+        # status, set this by either label, id or integration_id (use
+        # appropriate method to find status)
+        deal.status = rootmodel.settings.deal.find_status_by_label row['status']
+
+        # or set by existing status, search by label, integration_id
+        # (if string) or id (if integer).
+        # deal.status = "Won"
+
+        return deal
+    end
+
+    # HOOKS
+    #
+    # Sometimes you need to add exra information to the rootmodel, this can be done
+    # with hooks, below is an example of an organization hook that adds a history to
+    # an organization if a field has a specific value
+    #def organization_hook(row, organization, rootmodel)
+    #    if not row['fieldname'].empty?
+    #        comment = MoveToGo::Comment.new
+    #        comment.text = row['fieldname']
+    #        comment.organization = organization
+    #        comment.created_by = rootmodel.migrator_coworker
+    #        rootmodel.add_comment(comment)
+    #    end
+    #end
+
+end

data/sources/csv/data/coworkers.csv

@@ -0,0 +1,2 @@
+id;first_name;last_name
+666;Evil;Elvis

data/sources/csv/data/deals.csv

@@ -0,0 +1,2 @@
+id;name;value;responsible_id;customer_id;customer_contact_id;status
+333;Feta affären;10000;666;6;123;Vunnen

data/sources/csv/data/organizations.csv

@@ -0,0 +1,2 @@
+id;name;responsible_id
+6;Alfs Mjukvaruutveckling;666

data/sources/csv/data/persons.csv

@@ -0,0 +1,2 @@
+id;employer_id;first_name;last_name
+123;6;Rune;Rebellion

data/sources/custom/.gitignore

@@ -0,0 +1,14 @@
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile ~/.gitignore_global
+
+# Ignore bundler config
+/.bundle
+# Ignore built gems
+/*.gem
+# Ignore all logfiles and tempfiles.
+/tmp
+/spec/tmp
+pkg

data/sources/custom/.move-to-go/readme.txt

@@ -0,0 +1 @@
+This source is a basic template that you can usse if you want to write your own custom source.

data/sources/custom/.move-to-go/runner.rb

@@ -0,0 +1,30 @@
+# encoding: UTF-8
+
+require 'move-to-go'
+require_relative("../converter")
+
+def convert_source
+    puts "Trying to convert a custom source to LIME Go..."
+
+    converter = Converter.new
+
+    if !converter.respond_to?(:to_go)
+        puts "The converter must have a method called to_go that returns an instance of MoveToGo::RootModel."
+        raise "The converter must have a method called to_go that returns an instance of MoveToGo::RootModel."
+    end
+
+    rootmodel = converter.to_go
+
+    if rootmodel.nil?
+        puts "The returned rootmodel is nil. You must return a MoveToGo::RootModel."
+        raise "The returned rootmodel is nil. You must return a MoveToGo::RootModel."
+    end
+
+    if !rootmodel.is_a?(MoveToGo::RootModel)
+        puts "The returned object is not an instance of MoveToGo::RootModel."
+        raise "The returned object is not an instance of MoveToGo::RootModel."
+    end
+
+    return rootmodel
+end
+

data/sources/custom/Gemfile

@@ -0,0 +1,4 @@
+source 'http://rubygems.org'
+
+gem 'rspec'
+gem 'move-to-go'

data/sources/custom/converter.rb

@@ -0,0 +1,45 @@
+# encoding: UTF-8
+require 'move-to-go'
+
+# This Converter will convert a generic source to a XML file that can
+# be imported into LIME Go.
+#
+# You MUST customzie this script to read a source and return a
+# RootModel.
+#
+# Reference documentation for move-to-go can be found at
+# https://rubygems.org/gems/move-to-go (click Documentation)
+#
+# Generate the xml-file that should be sent to LIME Go with the
+# command:
+# move-to-go run
+#
+# Good luck.
+
+# If you are importing files then you must set the FILES_FOLDER
+# constant. FILES_FOLDER should point to the folder where the files
+# are stored. FILES_FOLDER can be relative to the project directory
+# or absolute. Note that you need to escape \ with a \ so in order to
+# write \ use \\.
+FILES_FOLDER = "./files"
+
+# If you are importing files with an absolute path (eg
+# m:\documents\readme.doc) then you probably wont have files at that
+# location on the computer where "move-to-go run" is executed. Set
+# FILES_FOLDER_AT_CUSTOMER to the folder where documents are stored at
+# the customers site. Ie, in this example m:\documents.
+# Note that you need to escape \ with a \ so in order to write \ use
+# \\.
+FILES_FOLDER_AT_CUSTOMER = "m:\\documents\\"
+
+class Converter
+    def to_go()
+        rootmodel = MoveToGo::RootModel.new
+
+        # *** TODO:
+        #
+        # Configure the model and then add coworkers, organizations, etc
+
+        return rootmodel
+    end
+end

data/sources/excel/.gitignore

@@ -0,0 +1,14 @@
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile ~/.gitignore_global
+
+# Ignore bundler config
+/.bundle
+# Ignore built gems
+/*.gem
+# Ignore all logfiles and tempfiles.
+/tmp
+/spec/tmp
+pkg

data/sources/excel/.move-to-go/readme.txt

@@ -0,0 +1,3 @@
+The Excel source lets you import a custom excelfile into LIME Go.
+
+You have to write some code to customize the script to suit your excelfile. If your customer doesnt have a specific format yet maybe you can use the Excel Basic source instead?