ELIS 2014 Manual

ELIS Data Hub 2

Updating Identifying Fields

The ELIS 2.6.1.1 release has some improvements for updating the identifying user fields. There are a couple ways to update these fields. To demonstrate I will update a users email address in a couple different use cases.

Use Case 1


For this use case we will use the new Data Hub settings. Go to the Administration block > Site Administration > Plugins > Local plugins > Data Hub plugins > Version 1 ELIS import. The following image shows the screen that will open. Deselect the checkbox that controls whether the email address is used as an identifying field.

Data Hub settings for identifying fields

Now email addresses can be updated in user import files, but the email address can no longer be used as an identifying field. The following image shows an example of a user import file for updating a user's email. The 'idnumber' field is the identifying field and the 'email' field is being updated.

User import file updating the user email address

It is possible to keep the email field as an identifying field and update the email field, that is demonstrated in Use Case 2.

Use Case 2


For this second use case we will use the new fields added to the Version 1 ELIS import user field map. In this use case we do not need to edit the Data Hub settings for identifying fields, all three identifying fields are active in this use case. The following image shows the bottom of the User field map located in the Administration block > Site Administration > Plugins > Local plugins > Data Hub plugins > Version 1 ELIS import > Field mapping > User tab.

Data Hub user field map

When these new fields are added to the file they become the default identifying fields and the standard identifying fields can then be used for updating. Here are two example files that demonstrate how to set this up.

The first one will use the 'user_idnumber' field as the identifying field and the 'email' field is being updated.

Data Hub email update file

The second file will use the 'user_email' field as the identifying field and the 'email' field is being updated.

Data Hub email update use case

Note: The 'idnumber' field can not be updated once it has been set. If a file has the 'user_idnumber' field and the 'idnumber' field both values have to be the same.