Read Sapelli project and load data from CSVs to GeoKey
Project description
geokey-sapelli
Extension for GeoKey to add support for Sapelli. This extension enables users to upload Sapelli project files (resulting in corresponding GeoKey projects), and Sapelli-produced data via the admin interfaces.
Installation instructions
Note: This guide assumes you have a working GeoKey installation, and also have Java (JRE or JSK, version 7 or up) installed.
Clone the repository:
git clone https://github.com/ExCiteS/geokey-sapelli.git
Install the package:
cd geokey-sapelli
pip install -e .
Go to your GeoKey installation and edit settings.py file (usually in local_settings\) to add 'geokey_sapelli', to the INSTALLED_APPS list.
Download the latest available version of the Sapelli Collector CmdLn front-end. The file you want looks like sapelli-collector-cmdln-X.X.X-XXXXXX-with-dependencies.jar. You have 2 options regarding the installation of this jar file:
Rename the file to sapelli-collector-cmdln-with-dependencies.jar and place it in the geokey-sapelli/lib folder;
or, place the file in a folder of your choice (you can rename it as well if you want) and again edit the above-mentioned settings.py file to add the absolute path to the file, like so: SAPELLI_JAR = '/path/to/sapelli-collector-cmdln-X.X.X-XXXXXX-with-dependencies.jar'.
To use the extension via the API, first register a new OAuth application with Authorisation type password. You will then get the Client ID. Add the Client ID to your settings.py (usually in local_settings\) as follows:
SAPELLI_CLIENT_ID = 'YOUR_CLIENT_ID'
Add the database tables:
python manage.py migrate geokey_sapelli
Run tests specific to this extension to ensure everything is correctly installed. Go to your GeoKey installation folder and run:
python manage.py test geokey_sapelli
Restart the server.
Open a browser and go to the /admin/sapelli/ path on your GeoKey server (e.g. http://localhost:8080). If you see a page titled “Sapelli” you have correctly installed the geokey-sapelli extension.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.