Moonie,
Never apologize for asking questions. It's always better to have an open mind to different points of view and to feel free to ask questions in order to learn from other people's experiences. That in my mind, is the true purpose of this forum. That having been said...
It might be easier to import data from a csv file, but I'm not expert in that process. I am very familar with the import of straight text files. However, there are some limitations to this approach. You must establish a fixed field length for each field and always make sure that it is at least as large as the lenghtiest value which might exist within it. The process I normally use for importing data involves a separate import database in which views are built to display information converted from text format into Notes document format before data is actually imported into a live application. This approach has several advantages, the biggest being that I can see what my data looks like ( and catch errors) before modifying any application data records. This involves two processes - one to import data into the import database, and two to selectively export data from this storage facility into your application database.
Step 1:
1. Create a new Notes database to house your imported data.
2. Create a configuration record form.
3. Create a document from this form which will house the field names and fixed lengths corresponding to all of the fields in your external data source.
4. Write the agent to pull data from the exernal source data into your import dabatase.
Configuration record form basics:
You will need to set up a virtual table consisting of four fields.
a. Multi value editable text field (new line as separator) in which you will be able to type the names of the fields corresponding to the incoming data records.
b. Multi value editable text field (new line as separator) in which you will place each field's starting position.
c.Multi value editable text field (new line as separator) in which you will place each field's ending position.
A sample table might look like this:
Field Name Start End
Company Name 1 10
Street Address 11 27
City Name 28 40
State 41 42
The script to import data using this config record (and massively oversimplified) would look like this:
dim db as NotesDatabase
Dim view as NotesView
Set view=db.getview("Importdata"

‘ view storing config doc
Dim importdoc as NotesDocument
Set importdoc=importdata.getfirstdocument
Dim doc As New notesdocument(thisdb)
Dim n as String
filenum% = Freefile
Open n For Input Access Read Shared As #filenum%
counter = 0
Do While Not Eof(filenum%)
Line Input #filenum%, linestring$
If Not linestring$ = "" Then
' call a routine to parse the data line out into fields
' Use the fields on the config document to set the values on the IncomingRecord document. Create an Incoming Record document for each row/line being imported.
doc.Form="IncomingRecord"
Step 2:
Once you've gotten all of your data to be imported into the application in record "form", you will be able to use whatever key you wish, a unique customer, contact, or company id is usually recommended) to easily match up data in your application with data in your import database.
I realize this is limited info to go on and a roundabout process if you are comfortable working with csv files and have that data format on hand. I wish I could be of more help, but the process is quite difficult (and unfortunately quite time-consuming) to explain via a bulletin board posting forum.
Good luck,
Simon