Buzz: Tips & Tricks

Batch creating observers and aligning them to students

Follow
Answered
Brad Marshall
  • Agilix team member

I sometimes get asked how to create many observers and align them to their respective students. This tip will show how you can do this in two simple CSV files.

In this example, we will create two new user accounts (John Parent, Suzy Counselor) and make them each an observer of two students (Henry Student, Adriana Student).

Step 1: Create the users.csv file

This file will be used to create the observer user accounts. The minimum required fields for this file are:

  • First Name
  • Last Name
  • Username
  • Password

To create an account for the two new users, my users.csv file will look like:

First Name,Last Name,Username,Password
John,Parent,johnparent,password
Suzy,Counselor,suzycounselor,password

A table view of the user.csv file will look like:

First Name Last Name Username Password
John Parent johnparent password
Suzy Counselor suzycounselor password

Download the sample users.csv file.

For more information and to see all available fields, see Importing user data.

Step 2: Create the observers.csv file

Assuming that the student accounts are already created, we can now create the observers.csv file. This file will be used to make the observer user accounts observe student user accounts. The minimum required fields are:

  • User Id
  • Observee Id

In both cases, you may not know the user (the observer) or the observee (the student) IDs without having to search for them. However, as a tip, you can use their userspace and username instead (see Constructing an Extended ID).

If I were using the usernames, my observers.csv file will look like:

User Id,Observee Id
//mydomain//johnparent,//mydomain//henrystudent
//mydomain//johnparent,//mydomain//adrianastudent
//mydomain//suzycounselor,//mydomain//henrystudent
//mydomain//suzycounselor,//mydomain//adrianastudent

A table view of the observers.csv will look like:

User Id Observee Id
//mydomain//johnparent //mydomain//henrystudent
//mydomain//johnparent //mydomain//adrianastudent
//mydomain//suzycounselor //mydomain//henrystudent
//mydomain//suzycounselor //mydomain//adrianastudent

In the example above, the user with username 'johnparent' from domain userspace 'mydomain' will be made an obsever of the user with username 'henrystudent' and 'adrianastudent' from domain userspace 'mydomain'. Same thing for 'suzycounselor'. 

Download the sample observers.csv file.

For more information and to see all available fields, see Importing observer data.

Step 3: Upload the users.csv file to Buzz

Open the Users tool and select Import. For more information, see How do I use the Users tool?

Step 4: Upload the observers.csv file to Buzz

Open the Domain tool and from the "more" option on the Details tab, select "Import observers". For more information, see How do I use the Domain tool?

Comments

Please sign in to leave a comment.