go_import 3.0.16 → 3.0.17

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    Nzk0YTFmNGY4MzJkMDA0MTBhZDAyZTlkNzFmMjUxMzM4YmM1ZjAzYQ==
+  data.tar.gz: !binary |-
+    MDIzNTY0NDAzZDk5MmFjNmZmZGNmNWRmZWRkMTgyNDYzZWM3NzI1Nw==
+SHA512:
+  metadata.gz: !binary |-
+    NWUwNTJlNTZkMzgxYTg5ODk1NjQ4OGY1Y2FjNzkzYTFmNjc4Y2EzOWYzOTNl
+    MGVmZTQ4YTY1NDc5NjFmNDhjNjJlN2ZhZGQwMDFmNmExYjRjZTQ2NmI3MjAx
+    Mjk2ZDI0NWVhZjc0MmQ2NjNkNWIxMGVkZGIzMDA2NDJkNjI2NDE=
+  data.tar.gz: !binary |-
+    MThiMjRkOTZlYTk1MGY2NTVjMDg1NzEzMzA2MTNmOWZlOWM2MjhlNGU1NDc4
+    OTAyZDYyNDAzNGUzOTQzYzJhOGRkMzhhNmYwNjZiZmU5YWE1N2UwMTI3Y2Vk
+    NzA3NmZmMDA2MjExMWZhMDY3YWQ0ZmI0ZWZmM2JkMjRmZDE4ZDk=

data/bin/go-import

@@ -24,6 +24,14 @@ class GoImportCommandLine < Thor
         end
 
         puts "\nCreate a new project with 'go-import new' with one of these sources."
+        puts "Use 'go-import about <SOURCE>' for more information about a specific source."
+    end
+
+    desc "about <SOURCE>", "Prints information about the specifed source"
+    def about(source)
+        sources = GoImport::Sources.new(source_path)
+
+        sources.about_source(source)
     end
 
     desc "new <PROJECT> <SOURCE>", "Creates a new migration project with a specifed name and source"

data/lib/go_import/source.rb

@@ -36,6 +36,27 @@ module GoImport
             end
         end
 
+        def about_source(source_name)
+            if !source_exists?(source_name)
+                puts "The source '#{source_name}' doesnt exist."
+                return false
+            end
+            
+            print_about_file_for_source(source_name)
+        end
+
+        private
+        def print_about_file_for_source(name)
+            about_path = ::File.expand_path("#{name}/.go_import/readme.txt", @path)
+
+            if ::File.exists?(about_path)
+                about_contents = ::File.open(about_path, "rb").read
+                puts about_contents
+            else
+                puts "No about text specifed for source '#{name}'."
+            end
+        end
+        
         private
         def source_exists?(name)
             source = list.find { |s| s.downcase == name.downcase }

data/sources/VISMA/.go_import/readme.txt

@@ -0,0 +1 @@
+This source converts a VISMA database to LIME Go.

data/sources/csv/.go_import/readme.txt

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

data/sources/custom/.go_import/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/easy/.go_import/readme.txt

@@ -0,0 +1 @@
+This source converts a LIME Easy database to LIME Go.

data/sources/excel/.go_import/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?

data/sources/excel-basic/.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-basic/.go_import/readme.txt

@@ -0,0 +1,3 @@
+The Excel Basic source should be used when we have a customer that has some unstructured data they want to import to LIME Go.
+
+When the ask "do you have an excel tempate we can use?" we should create a project from this source and send them the 'Exempelfil.xslx'. When we get the excelfile back, copy it to the project folder and run 'go-import run'.

data/sources/excel-basic/.go_import/runner.rb

@@ -0,0 +1,138 @@
+# encoding: UTF-8
+
+require 'go_import'
+require 'roo'
+require_relative("../converter")
+
+def convert_source
+    puts "Trying to convert Excel source to LIME Go..."
+
+    converter = Converter.new
+
+    # First we read each sheet from the excel file into separate
+    # variables
+
+    if defined?(EXCEL_FILE) && !EXCEL_FILE.empty?()
+        if !::File.exists?(EXCEL_FILE)
+            puts "ERROR: Cant find excel file to import: '#{EXCEL_FILE}'."
+            raise
+        end
+    else
+        puts "ERROR: You must set EXCEL_FILE in converter.rb to point to the excel file that should be imported."
+        raise
+    end
+
+    excel_workbook = GoImport::ExcelHelper.Open(EXCEL_FILE)
+
+    if defined?(COWORKER_SHEET)
+        if excel_workbook.has_sheet?(COWORKER_SHEET)
+            coworker_rows = excel_workbook.rows_for_sheet COWORKER_SHEET
+        else
+            puts "WARNING: can't find sheet '#{COWORKER_SHEET}'"
+        end
+    end
+
+    if defined?(ORGANIZATION_SHEET)
+        if excel_workbook.has_sheet?(ORGANIZATION_SHEET)
+            organization_rows = excel_workbook.rows_for_sheet ORGANIZATION_SHEET
+        else
+            puts "WARNING: can't find sheet '#{ORGANIZATION_SHEET}'"
+        end
+    end
+
+    if defined?(PERSON_SHEET)
+        if excel_workbook.has_sheet?(PERSON_SHEET)
+            person_rows = excel_workbook.rows_for_sheet PERSON_SHEET
+        else
+            puts "WARNING: can't find sheet '#{PERSON_SHEET}'"
+        end
+    end
+
+    if defined?(DEAL_SHEET)
+        if excel_workbook.has_sheet?(DEAL_SHEET)
+            deal_rows = excel_workbook.rows_for_sheet DEAL_SHEET
+        else
+            puts "WARNING: can't find sheet '#{DEAL_SHEET}'"
+        end
+    end
+
+    if defined?(NOTE_SHEET)
+        if excel_workbook.has_sheet?(NOTE_SHEET)
+            note_rows = excel_workbook.rows_for_sheet NOTE_SHEET
+        else
+            puts "WARNING: can't find sheet '#{NOTE_SHEET}'"
+        end
+    end
+
+    if defined?(FILE_SHEET)
+        if excel_workbook.has_sheet?(FILE_SHEET)
+            file_rows = excel_workbook.rows_for_sheet FILE_SHEET
+        else
+            puts "WARNING: can't find sheet '#{FILE_SHEET}'"
+        end
+    end
+
+    # Then we create a rootmodel that will contain all data that
+    # should be exported to LIME Go.
+    rootmodel = GoImport::RootModel.new
+
+    # And configure the model if we have any custom fields
+    converter.configure rootmodel
+
+    # Now start to read data from the excel file and add to the
+    # rootmodel. We begin with coworkers since they are referenced
+    # from everywhere (orgs, deals, notes)
+    if defined?(coworker_rows) && !coworker_rows.nil?
+        puts "Trying to convert coworkers..."
+        coworker_rows.each do |row|
+            rootmodel.add_coworker(converter.to_coworker(row))
+        end
+    end
+
+    # Then create organizations, they are only referenced by
+    # coworkers.
+    if defined?(organization_rows) && !organization_rows.nil?
+        puts "Trying to convert organizations..."
+        organization_rows.each do |row|
+            organization = converter.to_organization(row, rootmodel)
+            rootmodel.add_organization(organization)
+        end
+    end
+
+    # Add people and link them to their organizations
+    if defined?(person_rows) && !person_rows.nil?
+        puts "Trying to convert persons..."
+        person_rows.each do |row|
+            # People are special since they are not added directly to
+            # the root model
+            converter.import_person_to_organization(row, rootmodel)
+        end
+    end
+
+    # Deals can connected to coworkers, organizations and people.
+    if defined?(deal_rows) && !deal_rows.nil?
+        puts "Trying to convert deals..."
+        deal_rows.each do |row|
+            rootmodel.add_deal(converter.to_deal(row, rootmodel))
+        end
+    end
+
+    # Notes must be owned by a coworker and the be added to
+    # organizations and notes and might refernce a person
+    if defined?(note_rows) && !note_rows.nil?
+        puts "Trying to convert notes..."
+        note_rows.each do |row|
+            rootmodel.add_note(converter.to_note(row, rootmodel))
+        end
+    end
+
+    if defined?(file_rows) && !file_rows.nil?
+        puts "Trying to convert files..."
+        file_rows.each do |row|
+            rootmodel.add_file(converter.to_file(row, rootmodel))
+        end
+    end
+
+    return rootmodel
+end
+

data/sources/excel-basic/Gemfile

@@ -0,0 +1,6 @@
+source 'http://rubygems.org'
+
+gem 'rspec'
+gem 'roo'
+gem 'thor'
+gem 'go_import'

data/sources/excel-basic/converter.rb

@@ -0,0 +1,168 @@
+# encoding: UTF-8
+require 'go_import'
+require 'roo'
+
+# This Converter will convert an Excel file to a XML file that can be
+# imported into LIME Go.
+#
+# You need to customize this script to suit your Excel file.
+
+# First set the name of the Excel file to convert. It is a filename
+# relative to this folder.
+EXCEL_FILE = "Exempelfil.xlsx"
+
+COWORKER_SHEET = "Medarbetare"
+ORGANIZATION_SHEET = "Företag"
+PERSON_SHEET = "Kontaktperson"
+NOTE_SHEET = "Anteckningar"
+
+# Then you need to modify the script below according to the TODO
+# comments.
+
+# To generate the xml-file that should be sent to LIME Go with the
+# command:
+# go-import run
+
+class Converter
+    def configure(rootmodel)
+        # *** TODO: Add custom field to your rootmodel 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( { :integration_id => 'source', :title => 'Källa', :type => :Link } )
+        # end
+    end
+
+    def import_person_to_organization(row, rootmodel)
+        person = to_person(row, rootmodel)
+        organization = rootmodel.find_organization_by_integration_id(row['Kundnummer/FöretagsID'])
+
+        if !organization.nil?
+            organization.add_employee(person)
+        end
+    end
+
+    def to_coworker(row)
+        coworker = GoImport::Coworker.new()
+
+        # *** TODO:
+        #
+        # Set coworker properties from the row.
+
+        coworker.parse_name_to_firstname_lastname_se row['Namn/Titel']
+        coworker.integration_id = row['Namn/Titel']
+        if GoImport::EmailHelper.is_valid?(row['Email'])
+            coworker.email = row['Email']
+        end
+
+        return coworker
+    end
+
+    def to_organization(row, rootmodel)
+        organization = GoImport::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['Kundnummer/FöretagsID']
+
+        # Sets the organization's relation. Relation must be a value
+        # from GoImport::Relation.
+        organization.relation = GoImport::Relation::IsACustomer
+
+        # *** TODO:
+        #
+        # Set organization properties from the row.
+
+        organization.name = row['Namn']
+        organization.organization_number=row['Organisationsnummer']
+
+        # Postaladdress
+        organization.with_postal_address do |address|
+             address.street = row['Postadress']
+             address.zip_code = row['Postnummer']
+             address.city = row['Postnummer']
+        end
+
+        # Visitingaddress
+        organization.with_visit_address do |addr|
+             addr.street = row['Besöksadress']
+             addr.zip_code = row['Besökspostnummer']
+             addr.city = row['Besöksort']
+        end
+
+        # Set responsible such as
+        # organization.responsible_coworker = rootmodel.find_coworker_by_integration_id(row['Ansvarig saljare'])
+
+        # Set categorytag
+         if row['Företagskategori']
+             category = row['Företagskategori'].split(',')
+             category.each do |categorytag|
+                 organization.set_tag(categorytag.strip)
+             end
+         end
+
+        # Custom fields should be set like this.
+        # organization.set_custom_value("source", "internet")
+
+        ## LIME Go Relation.
+        # let's say that there is a option field in Easy called 'Customer relation'
+        # with the options '1.Customer', '2.Prospect' '3.Partner' and '4.Lost customer'
+
+        if row['Relation'] == 'Kund'
+        # We have made a deal with this organization.
+             organization.relation = GoImport::Relation::IsACustomer
+        elsif row['Relation'] == 'Prospekt'
+        # Something is happening with this organization, we might have
+        # booked a meeting with them or created a deal, etc.
+             organization.relation = GoImport::Relation::WorkingOnIt
+        elsif row['Relation'] == 'Tidigare kund'
+             organization.relation = GoImport::Relation::WasACustomer
+        # We had something going with this organization but we
+        # couldn't close the deal and we don't think they will be a
+        # customer to us in the foreseeable future.
+        #     organization.relation = GoImport::Relation::BeenInTouch
+        else
+             organization.relation = GoImport::Relation::NoRelation
+        end 
+
+        return organization
+    end
+
+    def to_person(row, rootmodel)
+        person = GoImport::Person.new()
+
+        # *** TODO:
+        #
+        # Set person properties from the row.
+
+        person.parse_name_to_firstname_lastname_se(row['Namn'])
+        if GoImport::EmailHelper.is_valid?(row['Email'])
+            person.email = row['Email']
+        end
+
+        person.direct_phone_number = row['Telefon']
+        person.mobile_phone_number = row['Mobiltelefon']
+
+        person.position = row['Titel']
+
+        return person
+    end
+
+    def to_note(row, rootmodel)
+        note = GoImport::Note.new()
+
+        # *** TODO:
+        #
+        # Set note properties from the row.
+
+        note.organization = rootmodel.find_organization_by_integration_id(row['Kundnummer/FöretagsID'])
+        note.created_by = rootmodel.find_coworker_by_integration_id(row['Skapad av medarbetare'])
+        note.text = row['Textanteckningar/Historik']
+        note.date = row['Skapad den']
+
+        return note
+    end
+end

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: go_import
 version: !ruby/object:Gem::Version
-  version: 3.0.16
-  prerelease: 
+  version: 3.0.17
 platform: ruby
 authors:
 - Oskar Gewalli
@@ -12,12 +11,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-31 00:00:00.000000000 Z
+date: 2014-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: iso_country_codes
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -25,7 +23,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -33,7 +30,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -41,7 +37,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -49,7 +44,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -57,7 +51,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -65,7 +58,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: roo
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -73,7 +65,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -81,7 +72,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: sixarm_ruby_email_address_validation
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -89,7 +79,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -97,7 +86,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: global_phone
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -105,7 +93,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -113,7 +100,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -121,7 +107,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -129,7 +114,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -137,7 +121,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -145,7 +128,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -153,7 +135,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
@@ -205,6 +186,7 @@ files:
 - lib/go_import.rb
 - bin/go-import
 - sources/csv/.gitignore
+- sources/csv/.go_import/readme.txt
 - sources/csv/.go_import/runner.rb
 - sources/csv/converter.rb
 - sources/csv/data/coworkers.csv
@@ -213,15 +195,18 @@ files:
 - sources/csv/data/persons.csv
 - sources/csv/Gemfile
 - sources/custom/.gitignore
+- sources/custom/.go_import/readme.txt
 - sources/custom/.go_import/runner.rb
 - sources/custom/converter.rb
 - sources/custom/Gemfile
 - sources/easy/.gitignore
+- sources/easy/.go_import/readme.txt
 - sources/easy/.go_import/runner.rb
 - sources/easy/converter.rb
 - sources/easy/Export/readme.txt
 - sources/easy/Gemfile
 - sources/excel/.gitignore
+- sources/excel/.go_import/readme.txt
 - sources/excel/.go_import/runner.rb
 - sources/excel/converter.rb
 - sources/excel/files/avtal.docx
@@ -231,7 +216,19 @@ files:
 - sources/excel/files/offert.docx
 - sources/excel/Gemfile
 - sources/excel/sample-data.xlsx
+- sources/excel-basic/.gitignore
+- sources/excel-basic/.go_import/readme.txt
+- sources/excel-basic/.go_import/runner.rb
+- sources/excel-basic/converter.rb
+- sources/excel-basic/Exempelfil.xlsx
+- sources/excel-basic/files/avtal.docx
+- sources/excel-basic/files/more/avtal.docx
+- sources/excel-basic/files/more/offert-2.pdf
+- sources/excel-basic/files/offert-2.docx
+- sources/excel-basic/files/offert.docx
+- sources/excel-basic/Gemfile
 - sources/VISMA/.gitignore
+- sources/VISMA/.go_import/readme.txt
 - sources/VISMA/.go_import/runner.rb
 - sources/VISMA/converter.rb
 - sources/VISMA/Database/KONTAKT.DBF
@@ -261,33 +258,26 @@ files:
 - spec/spec_helper.rb
 homepage: 
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 1057665117
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 1057665117
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.1.11
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Library to generate Lime Go xml import format
 test_files:
 - spec/address_spec.rb