DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

CsvImport

Important: This is a JavaScript interception handler, most likely activated on PostDisplay interception.

First of all, you might wonder, what this does if it's (only) a javascript interceptor. Well, it does, what the name says. It implements an import wizard for CSV files, which get processed client-sided through PapaParse (https://github.com/mholt/PapaParse) and which, ultimately, calls a multiple add function to create the newly imported entries.

Not yet impressed? Well, it provides a lot of functions, though: - raw text import as well as file upload - step-by-step wizard - preview of data - easy column-csv allocation - easy skipping of csv parts - automatic delimiter recognition - automatic encoding (charset) recognition - possibility to change automatically recognized settings (delimiter, encoding) - possibility to skip/include headlines - csv data goes through data/aField column handlers as well (i.e., necessary for timestamps)

Okay, but again: Why JavaScript? Because CSV files are easy-going and don't really need an interpreter. Hence, the compution time can be done within the client's browser and, thus, increase performance. Already extracted data, then, is submitted to the server.

The configuration is pretty straight-forward: Set as PostDisplay handler (type: JS) and you are ready to go. Please take care that within eClass "Csvimport" is written only with a capital "C". Configuration example:

    "interception": {
    "PostDisplay": {
                    "10": {
                            "eType": "js",
                    "eClass": "Csvimport"
        }
    }
}

However, if you want to specify more, you may do so.

sImportLinkSelector

String, default is a.head_import CSS selector to find the import link again.