Learning analytics processor data extraction handler for Sakai. This will extract the learning system data that is needed for LAP to do processing from a Sakai LMS
There are two files that will be generated:
- activity.csv
- grades.csv
The files will be placed in a directory named as the current date and time the extraction was run. For example, a "scheduled" extraction occurring on June 27, 2014 at 15:30:00 will be in a directory named: 20140627_153000_S ("_M" will be used to denote a "manual" extraction)
You can configure where on the server (an NFS or similar is suggested), by setting the property 'lap.data.extraction.storage.path' to the path on the server. The default is to use the setting from bodyPath@org.sakaiproject.content.api.ContentHostingService and adding "/lap-data/" to the end.
Data extraction can occur in two ways:
- Manually, via a button press
- Scheduled, via threading
You may initiate a manual extraction of data by:
- (OPTIONALLY) Setting a search criteria on site titles (e.g. 'FA14', 'FA%', etc.)
- (OPTIONALLY) Setting a start date for the activity extraction
- (OPTIONALLY) Setting an end date for the activity extraction
- Pressing the 'Extract Data' button
You may also set up the system to automatically run a data extraction at certain times. To do so:
- Enable the scheduled extraction by setting 'lap.scheduled.extraction.enabled=true' in sakai.properties
- Set the times you wish the scheduled extraction to run by setting the 'lap.data.extraction.times' property in sakai.properties. The default is midnight (00:00:00) and noon (12:00:00). The times must be set in 24-hour notation.
Configuration:
sakai.properties:
# LAP Sakai Data Extractor
# Enable scheduled data extraction
# Default: false
#lap.scheduled.extraction.enabled=true
# File system path to store data extraction files
# Default: bodyPath@org.sakaiproject.content.api.ContentHostingService + lap-data
#lap.data.extraction.storage.path=
# Time of day that the scheduled data extraction will run
#lap.data.extraction.times.count=2
#lap.data.extraction.times.1=00:00:00
#lap.data.extraction.times.2=12:00:00