DataImporter - Import Value Lists



This article presents the method to import Value Lists used in forms,CI attributes and plug-ins.

When creating one of these elements, you can aid data entry for Combo boxes and in the case of forms Radio buttons. The values for these lists can be created or modified via an import with DataImporter, with the exeption of the Plug-in category that is managed by the people at Octopus. 

What you need to know

When updating a list, the imported elements overwrite the old data.

You must make sure that when you reimport all the elements of the list are included. 



What you need to know:

The reference template files (.xlsx et .xml) to prepare imports are included in the file.

Required Fields

  • NameFR - Text (255)
    • Indicates the name of the list in French.
  • ​​NameEN - Text (255)
    • Indicates the name of the list in English.

  • ValueFR - Text (1000)
    • Name of the value in French.
  • ValueEN - Text (1000)
    • Name of the value in English.

Optional Fields

  • Category
    • Indicates in which category the list will be added or modified.
    • Must be a category that exists.
    • The possible choices are CI Attribute, Form or All.
    • The Plug-in category can only be changed by the people from Octopus, unless specified otherwise.
    • If no category is specified, the list will be added to the Form category.
  • Rank - Whole number
    • Indicates the value position in the list.

    • If no rank is specified, the values will be presented to the user in alphabetical order, according to his language. 

Configuration File Content (ImportValueLists.xml)

The declaration of the source is done by indicating CustomLookupGroup in the <Content> tag.

NOTEThe XML file used as this example is for an import done from Excel 2007 or 2010. 
<?xml version="1.0" encoding="utf-8" ?>
      <Source Name="Value list" >
             <ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\ImportValueLists.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
             <ViewName>[Import Value Lists$]</ViewName>

To explain the tags used in all types and to find out more about the types of files, please refer to the XML Configuration File article

Help us improve our articles

Help us improve our articles