TexasSwede
texasswede@gmail.com
  • About this blog
  • My Website
  • My Resume
  • XML Export Tool
  • Photos

Import CSV from Excel into Notes documents

Posted on April 14, 2011 by Karl-Henry Martinsson Posted in Lotusscript, Old Blog Post, Programming 5 Comments
The other day there was a post on LinkedIn regarding importing Excel data into Notes documents.
Someone suggested to save into Access format, and then export from there intosome 1-2-3formatthat Notes can read.
I suggested to save the Excel spreadsheet as a CSV file, and then import it. So I decided to write a small generic importer.
I built a class called “csvFile”, which I put in a script library called “Class.ImportCSV”.
Below is the code for the actual import agent. It creates a new csvFile object, which load all the CSV data into an array in memory. Each array element is in turn a class, containing a list of entries. This is because you can not create arrays of arrays or lists, they have to be in another object/class.
If you know the row number and column label (the first row in the CSV file will be considered the column labels), you can address the value like this: csvfile.row(r).entry(“ColumnLabel”).
Option Public
Option Declare
Use "Class.ImportCSV"

Sub Initialize
  ' *** Import CSV file and create matching documents in Notes
  ' *** By Karl-Henry Martinsson, April 8, 2010
  Dim session As New NotesSession
  Dim db As NotesDatabase
  Dim doc As NotesDocument
  Dim csvfile As csvFile
  Dim rowcnt As Long
  Dim r As Long

  Set db = session.CurrentDatabase  
  Set csvfile = New csvFile("c:\Book1.csv")
  rowcnt = Ubound(csvfile.row) + 1
  ' *** Loop through the rows and create a new document for each
  For r = Lbound(csvfile.row) To Ubound(csvfile.row)
    If (r+1 Mod 10) = 0 Then    ' Update status bar every 10 documents
      Print "Importing " & r+1 & " of " & rowcnt
    End If
    Set doc = New NotesDocument(db)
    Call doc.ReplaceItemValue("Form", "MyFormName")
    ' *** Loop though entries for the row and populate corresponding fields in doc
    Forall e In csvfile.row(r).entry
      Call doc.ReplaceItemValue(Listtag(e), e)
    End Forall
    Call doc.Save(True,False)
  Next
End Sub
Here is the script library. Simply create a new script library, call it “Class.ImportCSV” and paste the code into it’s Declaration section:
' *** Created by Karl-Henry Martinsson on 2010-04-08
' *** Email: TexasSwede@gmail.com
' *** Blog: http://blog.texasswede.com
' *** ----------------------------------------------------------
' *** You are free to modify and edit this code, but please keep
' *** all comments intact, and publish any changes you make so
' *** the Lotus community can benefit. You are allowed to use
' *** this code in commercial/closed source products, but are 
' *** encouraged to share your modifications.
' *** Disclaimer: Use this code at your own risk. No warranties
' *** what so ever. Don't run code you don't know what it does.
' *** ----------------------------------------------------------

Class RowData
  Public entry List As String
End Class

Class csvFile
  Public row() As RowData         ' Storing the rows in the imported CSV file
  Public column List As String    ' List containing column labels
  Private fileno As Integer       ' File number

  Public Sub new(filename As String)
    Dim temprow As String
    Dim temparr As Variant
    Dim fixedarr() As String
    Dim i As Integer
    Dim flagQuoted As Integer

    fileno = Freefile            ' Return an unused file number
    Open filename For Input As fileno
    Redim row(0) As rowdata
    ' *** Get column header
    Do While Not Eof(fileno)
      ' *** Read row and split into cells.
      Line Input #fileno, temprow
      temparr = Split(temprow, ",")
      ' *** Commas within quoted values will cause the value
      ' *** to be split across array items, so we have to fix this.
      flagQuoted = False
      Redim fixedarr(0) As String    ' Size array to just one element, has to be done
      For i = Lbound(temparr) To Ubound(temparr)
        ' *** Check if value start with quote
        If Left$(temparr(i),1) = |"| Then  
          flagQuoted = True
        End If
        If flagQuoted = True Then
          If Left$(temparr(i),1) = |"| Then  
          ' *** For first item, just set array item to value, remove leading quote
            fixedarr(Ubound(fixedarr)) = Right$(temparr(i),Len(temparr(i))-1)
          Else
          ' *** Append value to previous array item with a comma to replace the lost one
            fixedarr(Ubound(fixedarr)) = fixedarr(Ubound(fixedarr)) & "," & temparr(i) 
          End If
          ' *** If it end with a quote, reset flag, rmove trailing quote and increase size of array
          If Right$(temparr(i),1) = |"| Then
            flagQuoted = False
            fixedarr(Ubound(fixedarr)) = Left$(fixedarr(Ubound(fixedarr)), Len(fixedarr(Ubound(fixedarr)))-1)
            Redim Preserve fixedarr(Ubound(fixedarr)+1) As String  
          End If
        Else
          ' *** Set array item to value and increase array size by one
          fixedarr(Ubound(fixedarr)) = temparr(i) 
          Redim Preserve fixedarr(Ubound(fixedarr)+1) As String  
        End If
      Next
      temparr = Fulltrim(fixedarr)    ' Remove empty items in array
      ' *** Check if this is the first row (index 0), i.e. the column header and no object exists  
      If Ubound(row) = 0 And (row(Ubound(row)) Is Nothing) Then
        ' *** Loop through temparr and build list from labels
        For i = Lbound(temparr) To Ubound(temparr)
          column(Cstr(i)) = temparr(i)
        Next
        ' *** Create an object so the code above will not be true again
        Set row(Ubound(row)) = New RowData
      Else
        ' *** Create new row data object, populate with data and increase size of row array
        Set row(Ubound(row)) = New RowData
        For i = Lbound(temparr) To Ubound(temparr)
          row(Ubound(row)).entry(column(Cstr(i))) = temparr(i)
        Next
        Redim Preserve row(Ubound(row)+1) As RowData
      End If
    Loop
    ' *** Remove the last row, as it is always empty
    Redim Preserve row(Ubound(row)-1) As RowData
  End Sub
End Class
« Domino Designer Frustrations
Domino Designer for Eclipse »

5 thoughts on “Import CSV from Excel into Notes documents”

  1. David Belusa says:
    May 17, 2016 at 09:07

    Halo, many thanks for that cool script. Do you have any trick how to import more than 32767 lines? David

    Reply
    • Karl-Henry Martinsson says:
      May 26, 2016 at 10:03

      From the online help:
      “Array subscript bounds must fall in the range -32,768 to 32,767, inclusive.”

      I never tried it, but try to change
      Redim row(0) As rowdata
      to
      Redim row(-32768) As rowdata
      i = -32768
      and see what happens. Should double the number or lines you can import. If you have more than 64K lines, you could perhaps try rewriting the code using a list instead of an array.

      Reply
  2. Mike says:
    August 6, 2018 at 20:16

    This saved my day. thank you. This code will fail if any row (other than first row which is header) has empty value

    Reply
    • Mike says:
      August 6, 2018 at 20:18

      temparr = Fulltrim(fixedarr) ‘ Remove empty items in array this line of code actually removes empty values in array which seems to be not right. it is ok to remove empty items for the first row but not subsequent rows

      Reply
  3. Kevin says:
    January 23, 2019 at 14:23

    Thank you for sharing this valuable utility. After successfully using it for English format .csv (uses a comma as the delimiter), I created a version for European format which uses the semicolon as the delimiter.

    I also added the following code to prompt the user to select the .csv file

    ‘Get .csv file name

    If userPlatform = “Macintosh/64” Or userPlatform = “Macintosh” Then
    fn=uiws.OpenFileDialog(False, “Select the .csv File to Import”)
    Else
    fn =uiws.OpenFileDialog(False,”Select the .csv File to Import”, “.csv files | *.csv”, “c:My Documents”)
    End If

    csvFilename = Cstr(fn(0)) ‘ This is the name of the .csv file that will be imported

    If Lcase(Right(csvFilename, 3)) “csv” Then
    mb = uiws.Prompt(1, “Please select a file with a .csv extension.”, “Wrong file type. A .csv file extension is expected”)
    Else
    Set csvfile = New EUcsvFile(csvFilename)
    rowcnt = Ubound(csvfile.eurow) + 1

    I also added code to coerce the values being set in the target document (doc) to the correct data type. The If statement in the code first checks if the entry is one of your text fields (you supply the name … I just used “TextField1”, “TextField2”, “TextField3”, “TextField4”, and “TextFieldn” as generic field names to illustrate the code. If the entry is not one of your text fields, then the code checks to see if it is one of your Integer fields … in this example I just check for one and generically named it “IntegerField1”. If the entry is not one of your text or integer fields, then this code makes it a Dbl.

    ‘ *** Loop though entries for the row and populate corresponding fields in doc
    Forall e In csvfile.row(r).entry
    If Listtag(e) = “TextField1” Or Listtag(e) = “TextField2” Or Listtag(e) = “TextField3” Or Listtag(e) = “TextField4” Or Listtag(e) = “TextFieldn” Then
    Call doc.ReplaceItemValue(Listtag(e), e)
    Elseif Listtag(e) = “IntegerField1” Then
    Call doc.ReplaceItemValue(Listtag(e), Cint(e))
    Else
    Call doc.ReplaceItemValue(Listtag(e), Round(Cdbl(e),8))
    End If
    End Forall

    Reply

Leave a comment Cancel reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Stack Exchange

profile for Karl-Henry Martinsson on Stack Exchange, a network of free, community-driven Q&A sites

Recent Posts

  • Domino 14 is now available
  • Domino 14 Early Access Program
  • Announced: Engage 2024
  • Integrate Node-RED with Notes and Domino
  • Notes and Domino v12 is here!

Recent Comments

  • Theo Heselmans on Announced: Engage 2024
  • Lotus Script Multi-thread Message Box [SOLVED] – Wanted Solution on ProgressBar class for Lotusscript
  • Viet Nguyen on Keep up with COVID-19 though Domino!
  • Viet Nguyen on Keep up with COVID-19 though Domino!
  • Mark Sullivan on Looking for a HP calculator? Look no further!

My Pages

  • How to write better code in Notes

Archives

  • December 2023 (1)
  • October 2023 (2)
  • September 2023 (1)
  • June 2021 (1)
  • April 2021 (2)
  • March 2021 (1)
  • August 2020 (3)
  • July 2020 (2)
  • April 2020 (2)
  • March 2020 (1)
  • December 2019 (2)
  • September 2019 (1)
  • August 2019 (2)
  • July 2019 (2)
  • June 2019 (3)
  • April 2019 (2)
  • December 2018 (1)
  • November 2018 (1)
  • October 2018 (5)
  • August 2018 (2)
  • July 2018 (3)
  • June 2018 (2)
  • May 2018 (1)
  • April 2018 (2)
  • March 2018 (1)
  • February 2018 (2)
  • January 2018 (4)
  • December 2017 (3)
  • November 2017 (2)
  • October 2017 (2)
  • September 2017 (1)
  • August 2017 (2)
  • July 2017 (6)
  • May 2017 (4)
  • February 2017 (1)
  • January 2017 (2)
  • December 2016 (2)
  • October 2016 (3)
  • September 2016 (4)
  • August 2016 (1)
  • July 2016 (2)
  • June 2016 (2)
  • May 2016 (3)
  • April 2016 (1)
  • March 2016 (4)
  • February 2016 (2)
  • January 2016 (4)
  • December 2015 (3)
  • November 2015 (2)
  • October 2015 (1)
  • September 2015 (2)
  • August 2015 (1)
  • July 2015 (5)
  • June 2015 (2)
  • April 2015 (2)
  • March 2015 (3)
  • February 2015 (2)
  • January 2015 (10)
  • December 2014 (1)
  • November 2014 (3)
  • October 2014 (3)
  • September 2014 (13)
  • August 2014 (6)
  • July 2014 (5)
  • May 2014 (3)
  • March 2014 (2)
  • January 2014 (10)
  • December 2013 (5)
  • November 2013 (2)
  • October 2013 (5)
  • September 2013 (4)
  • August 2013 (7)
  • July 2013 (3)
  • June 2013 (1)
  • May 2013 (4)
  • April 2013 (7)
  • March 2013 (8)
  • February 2013 (9)
  • January 2013 (5)
  • December 2012 (7)
  • November 2012 (13)
  • October 2012 (10)
  • September 2012 (2)
  • August 2012 (1)
  • July 2012 (1)
  • June 2012 (3)
  • May 2012 (11)
  • April 2012 (3)
  • March 2012 (2)
  • February 2012 (5)
  • January 2012 (14)
  • December 2011 (4)
  • November 2011 (7)
  • October 2011 (8)
  • August 2011 (4)
  • July 2011 (1)
  • June 2011 (2)
  • May 2011 (4)
  • April 2011 (4)
  • March 2011 (7)
  • February 2011 (5)
  • January 2011 (17)
  • December 2010 (9)
  • November 2010 (21)
  • October 2010 (4)
  • September 2010 (2)
  • July 2010 (3)
  • June 2010 (2)
  • May 2010 (3)
  • April 2010 (8)
  • March 2010 (3)
  • January 2010 (5)
  • November 2009 (4)
  • October 2009 (7)
  • September 2009 (1)
  • August 2009 (7)
  • July 2009 (1)
  • June 2009 (4)
  • May 2009 (1)
  • April 2009 (1)
  • February 2009 (1)
  • January 2009 (3)
  • December 2008 (1)
  • November 2008 (1)
  • October 2008 (7)
  • September 2008 (7)
  • August 2008 (6)
  • July 2008 (5)
  • June 2008 (2)
  • May 2008 (5)
  • April 2008 (4)
  • March 2008 (11)
  • February 2008 (10)
  • January 2008 (8)

Categories

  • AppDev (10)
  • Blogging (11)
    • WordPress (5)
  • Design (5)
    • Graphics (1)
    • UI/UX (2)
  • Featured (5)
  • Financial (2)
  • Food (5)
    • Baking (3)
    • Cooking (3)
  • Generic (11)
  • History (5)
  • Hobbies (10)
    • LEGO (4)
    • Photography (4)
  • Humor (1)
  • IBM/Lotus (178)
    • #Domino2025 (14)
    • #DominoForever (8)
    • #IBMChampion (46)
    • Administration (7)
    • Cloud (7)
    • CollabSphere (9)
    • Community (49)
    • Connect (33)
    • ConnectED (12)
    • Connections (3)
    • HCL (15)
    • HCL Master (1)
    • IBM Think (1)
    • Lotusphere (46)
    • MWLUG (25)
    • Notes/Domino (99)
      • Domino 11 (7)
    • Sametime (8)
    • Verse (14)
    • Volt (3)
    • Watson (6)
  • Life (8)
  • Microsoft (7)
    • .NET (2)
    • C# (1)
    • Visual Studio (1)
  • Movies (3)
  • Old Blog Post (259)
  • Personal (23)
  • Programming (84)
    • App Modernization (11)
    • Formula (4)
    • Lotusscript (47)
    • NetSuite (4)
      • SuiteScript (3)
    • node.js (4)
    • XPages (4)
  • Reviews (9)
  • Sci-Fi (4)
  • Software (24)
    • Flight Simulator (2)
    • Games (4)
    • Open Source (2)
    • Utilities (6)
  • Technology (37)
    • Aviation (3)
    • Calculators (2)
    • Computers (6)
    • Gadgets (7)
    • Mobile Phones (7)
    • Science (3)
    • Tablets (2)
  • Travel (7)
    • Europe (1)
    • Texas (2)
    • United States (1)
  • Uncategorized (16)
  • Web Development (50)
    • Frameworks (23)
      • Bootstrap (14)
    • HTML/CSS (12)
    • Javascript (32)
      • jQuery (23)

Administration

  • Log in
  • Entries feed
  • Comments feed
  • WordPress.org

Tracking

Creeper
MediaCreeper
  • Family Pictures
© TexasSwede 2008-2014