### Navigation

- index
- SpreadsheetLayers 1.0 documentation »

# QGIS-SpreadSheetLayers

QGIS plugin to load layers from spreadsheet files (*.ods, *.xls, *.xlsx)

## Description

This plugin adds a Add spreadsheet layer entry in Layer / Add new Layer menu and a corresponding button in Layers toolbar. These two links open the same dialog to load a layer from a spreadsheet file with some options:

- select file
- layer name
- sheet selection
- header at first line
- ignore some rows
- load geometry from x and y fields

When dialog is accepted, it creates a new GDAL VRT file in same folder as the source data file and layer name, expanded with a .vrt suffix, which is loaded into QGIS.

When reusing the same file twice, the dialog loads its values from the existing .vrt file.

## Limitations

Due to a GDAL/OGR lacks of functionalities:

- use of header line on a per file basis ;
- ignore lines at the beginning of file ;
- correct end of .xls files detection.

The plugin use an SQLITE select statement with offset and limit parameters to extract corresponding data from the source file. When one of this functionalities is in use, this could have some side effects.

With GDAL <= 1.11.1, the plugin can’t load geometry. With graceful degradation, geometry checkbox is then locked. To get the GDAL version in use, run this commands in QGIS python console:

    import osgeo.gdal
    print osgeo.gdal.__version__

When opening a spreadsheet file, GDAL/OGR will try to detect the data type of columns (Date, Integer, Real, String, ...). This automatic detection occurs outside of plugin header and ignore lines functionalities, so when using this, GDAL/OGR should be unable to correctly detect data types.

## Configuration

GDAL do not allow to define the presence of header line on a per layer basis, this choice is made through environment variables for each driver OGR_ODS_HEADERS, OGR_XLS_HEADERS and OGR_XLSX_HEADERS, with tree possible values FORCE, DISABLE and AUTO. For more details, consult the corresponding drivers documentation ie: http://www.gdal.org/drv_ods.html, http://www.gdal.org/drv_xls.html and http://www.gdal.org/drv_xlsx.html.

You can change this values in QGIS settings:

- open Settings / Options dialog;

- select System tab, and go to Environment section;

- check Use custom variables.

- add a new line. Example:

  > Overwrite | OGR_ODS_HEADERS | FORCE

- restart QGIS to take this into consideration.

## Development install (linux)

    git clone git@github.com:camptocamp/QGIS-SpreadSheetLayers.git SpreadsheetLayers
    ln -s SpreadsheetLayers ~/.qgis2/python/plugins/
    cd SpreadsheetLayers
    make

- run QGIS and activate SpreadsheetLayers plugin.

### Navigation

- index
- SpreadsheetLayers 1.0 documentation »