ELIS 2.0 Manual

ELIS Data Hub 2

Batch Importing Class Info

On the Course fields tab you can set the class properties for your import. Because the course.csv file can create five different ELIS items - courses, classes, programs, tracks, and user sets, the file mapping contains more information. Go to the Settings block > Site Administration > Plugins > Blocks > Data Hub plugins > Version 1 ELIS import > Field mapping > Course fields tab.

Course fields tab

Course field mapping screen image 2

If you make changes to any property values, be sure to select the Save changes button.

The following table has the standard course fields that can be included in the class import files. ELIS custom fields can also be included.

action: The action field is always required. Enter create, update or delete.
context:
The context is always a required field. Enter class.
idnumber:
The class idnumber is a required field.
startdate:
The start date of the class if it has one. The new date format is MMM/DD/YYYY, e.g., Jan/01/2013. Formats used in 1.9 will work as well.
enddate:
The end date of the class if it has one. The new date format is MMM/DD/YYYY. Formats used in 1.9 will work as well.
starttimehour:
The start time hour. The format uses the minute drop down menu. Enter a number between 0 and 23.
starttimeminute:
The minute the class starts. Enter a number in multiples of 5 between 0 and 55.
endtimehour:
The hour the class stops. Enter a number between 0 and 23.
endtimeminute: The minute the class stops. Enter a number in multiples of 5 between 0 and 55.
maxstudent:
The seat limit/maximum number of students. Enter a number. Default is 0 which is unlimited.
enrol_from_waitlist:
Enroll users from the waitlist. Enter 1 for yes or 0 for no, or just enter yes or no.
assignment:
This is a required field. ID number of the ELIS course the class is an instance of.
track:
The idnumber of the track the class is on. For this to work the course description the class is an instance of has to be part of the program/curriculum the track is an instance of.
autoenrol:
Sets the class to auto-enroll if it is part of a track. Enter 1 for yes and 0 for no, or just enter yes or no.
link:
Enter shortname of Moodle course to link to, or "auto" to auto-create a new Moodle course from template.


The required fields for class creation are:
  1. action
  2. context
  3. idnumber
  4. assignment

The required fields for updating or deleting classes are:

  1. action
  2. context
  3. idnumber

Data Hub Actions


ELIS Data Hub tells ELIS what needs to be done with imported data via the Actions column. The sample csv file below illustrates this function. The following example is a course file with all 5 course contexts being added. Row 6 and 7 in the csv file are creating classes. The two classes are instances of the courses created in row 3 and 4. The link column is auto-creating two new Moodle courses from template and linking them to the new ELIS classes. The two classes have also been assigned to the track created in row 5.

Image of course csv file

Select this link to download the file in the previous image.

Note: The two Moodle template courses identified in the course "link" field have to be added to the site before the file will run successfully. To run the file without adding Moodle template courses delete the four values in the "link" column.


Importing/Processing Data Hub Files


ELIS Data Hub import files can be scheduled to automatically process or can be manually processed. Import files should be scheduled to process in most instances, docs for scheduling imports are at this link. Manual processing should be used for testing small files only. Manual processing is currently limited to 28 seconds of processing time in our standard Data Hub installs. Scheduled processing will continue imports on subsequent cron runs when processing takes to long, manual processing does not do this.

The sample file being used here is simple enough to process manually. To manually process files go to the Settings block > Site Administration > Plugins > Blocks > Data Hub plugins > Manage Plugins. Under the Import Plugins section go to the Version 1 ELIS import row and select the "Go" link in the Run manually column.

Manage plugins go link

Select the "Choose a file" button. Select a file to process and then select the Run Now button.

Run manually screen

Once the file is processed there will be a brief log message stating whether or not the file import was successful.

A complete log of all actions is kept in the logs file, as well as (optionally) emailed to an address or addresses each time the Data Hub script runs. Logs can be accessed from the Data Hub block > Data Hub logs link.

For information about scheduling imports to automatically process go to this page Importing/Processing files.