ELIS 2013 Manual

ELIS Data Hub 2

Batch Import of User Set Info

On the Course fields tab you can set the user set 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 Administration block > Site Administration > Plugins > Local plugins > 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 user set import files. ELIS custom fields can also be included.

action: This is a required field. Enter create, update, or delete.
context: This is a required field. Enter cluster. We use cluster for the context field even though clusters are now called user sets in ELIS 2.0.
name: This is a required field. Enter the name of the user set.
User set description.
The name of an existing user set, or "top" to make the user set a top-level user set.
recursive: Enter yes or no, or 1 for yes and 0 for no. This setting is only used during delete. Selecting yes will delete user sets and user sub-sets. Selecting no with delete the user set and promote user sub-sets to the user set level. Default is to promote user sub-sets to user sets when deleting the parent user set.

The required fields for creating user sets are:
  1. action
  2. context
  3. name

The required fields for updating or deleting user sets are:

  1. action
  2. context
  3. name

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 8 is adding a user set/cluster.

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 Administration block > Site Administration > Plugins > Local plugins > 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.

Manually run job link

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

Manually run job

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 Administration block > Site Administration > Reports > Data Hub logs link.

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