collective.csv2atvocabularymanager 0.1.0

Introduction

This library is an utility that helps developers to integrate vocabulary done using ATVocabularyManager to be imported using Generic Setup Python handlers and CSV sources.

It also support LinguaPlone (if present).

How to use

Just import the createVocabulary function and use it:

>>> portal_vocabularies = getToolByName(portal, 'portal_vocabularies')
>>> from collective.csv2atvocabularymanager.csv_import import createVocabulary
>>> createVocabulary(portal_vocabularies, fs_path, 'my.vocabulary.id',
...                  "My vocabulary", description='A vocabulary for...')

Where:

portal_vocabularies

is the ATVocabularyManager tool created after installing it

fs_path

is a filesystem path of a folder, where you must put you CSV sources.

If the code is called from a setuphandlers.py script, you can call something like:

>>> os.path.join(os.path.dirname( __file__ ), 'vocabularies')

This way the code will look for a “vocabularies” folder inside you project

vid

is the vocabulary id that will be created and a file with that name and “.csv” extension will be searched inside the fs_path folder.

title

is the title of the vocabulary

description

is the description of the vocabulary

Also, you have other optional additional parameters:

type_name

If the portal_type name of the vocabulary created (default is “SimpleVocabulary”)

sortMethod

is the sort method of the vocabulary

null_values

is a list of possible values that must be used as “null” (can be useful is your CSV is taken from a raw export from SQL database, and strings like “NULL” can be found inside the source).

change_master_with_language_id

is a boolean flag used to change the generated vocabulary term id, adding to it the language code suffix.

"id","en"
"item-1","Item one"
"item-2","Item two"
...

"id","en","it"
"item-1","Item one","Elemento 1"
"item-2","Item two","Elemento 2"
...

Final notes

Please, keep in mind that ATVocabularyManager already support Generic Setup integration for creating vocabularies at install time.

However you are foced to use the “IMS VDEX Vocabulary File”.

Please note also that vocabulary implementation from ATVM already provides a importCSV method.

Authors

This product was developed by RedTurtle Technology team.

Changelog

0.1.0 (2012-11-12)

• Initial release