If you manage your own Airhead user accounts, these must be created and updated using a csv file. To get started, simply click 'Download file' in the Provisioning tab of the admin section:


837jD4_3iTi7owd1mRnr8vgApB004Mfh6A.png


This will download a csv file that shows the current state of the users in your establishment. If you have not created any users, the file will just contain the header row. We will use the example where no users have yet been provisioned. Open the file in your csv editor of choice. Here, we will use Microsoft Excel:


0MYwW2cj2-gwd-lCook6gvu03ZL63VSwsw.png


There are 8 possible fields:


  • id - An identifier for each user which must be unique within the establishment. We recommend starting with 10001 and incrementing from there.
  • name - The display name of the user, typically in the format 'Forename Surname'
  • role - The user's role in Airhead. Choose between:
    • Teaching Staff
    • Non-teaching Staff
    • Pupil
    • Parent
    • Early Years
    • Other
  • username - the username that the user will use to login. This must be unique within the establishment, e.g. if you have 2 John Smith's, usernames could be jsmith and jsmith1
  • password - The user's password
  • emailAddress - The user's email address
  • misId - The user's MIS identifier from your MIS system. This can be used to sync MIS data such as timetable. This is an optional field.
  • groups - The groups which you wish to create as part of the provisioning process. This is an optional field.

Here is an example of a file that will create 2 users:

qoO_peAtw2Ha683jgY59ACT3vtwC8CCO4g.png


Save the file, ensuring you keep the csv format, and choose 'Upload file' from the provisioning screen:

svOPSyPJVIhgo2tW4lbXNLe5EjWMGK94bA.png


Choose the file from your filesystem and optionally add a comment. Comments are a useful addition to the provisioning history:

Ib7R6vIltl4Abt3gPV1wgyaz0aqjwH4WOw.png


Click Upload:


The data will be processed and analysed to determine your changes:


Jay5RY3qKhTEUYGWpT_fPKH3snJCdHeR-Q.png


Once the system has analysed the changes made by the file, the screen will refresh and you will be asked to approve or reject these changes:

1J5kbgvJkRSp27DlVRbolUL9pi4bWc-PFQ.png



The system has determined that 2 new users are to be added. If you wish to proceed, click Approve changes or, if you do not wish to proceed, click Reject changes. Here, we will approve changes. The system will process the changes:

-G2ixtwUcPLYCvXPL32DJv7qOaSps0uTBw.png



Once the changes have been processed, the new users will be able to login with the username and password you set.