People attribute data (for example department, location etc), can be used to cut and slice the insights from SWOOP in different ways. By default SWOOP will fetch the 'department' field from a person's Yammer user profile. It is possible to extend this to also include the 'location' and 'job title' attributes by enabling these in the SWOOP data miner (admin access only).
If you're wanting to add additional attributes, these can be provided to SWOOP by an administrator in different ways:
- Manual upload of file that contains the Yammer User ID and the relevant business unit for that user
- Automated upload via Azure Active Directory
- Automated upload on a periodic basis via other means (custom setup)
Note: Uploading of people attribute data into SWOOP does not change anything Yammer.
To manually upload additional user profile data, including Business Unit data, the SWOOP Admin performs the following steps:
- Download the list of users in Yammer.
- Delete all columns apart from user ID and email address from the file and save it in CSV format.
- Source a complete list of users that has the correct business unit data. Consider including other profile fields that you may find relevant such as City, Region, Country etc. Use the person's email address as the key that links the Yammer user list with the list that has the complete profile data
- Use Excel's VLOOKUP function (ask a colleague about how to do this if you don't know) to add the required additional fields to the columns in the users.csv file.
- If you include the userID in the user.csv file then you now can delete the email field if you don't want to share the email addresses with SWOOP.
- Go to the SWOOP miner: You access the miner by clicking on 'Admin' in the footer of SWOOP, then click on the tab called 'Miner', then click on the URL for the data miner.
- In the SWOOP miner, click 'Choose File' and select the user.csv file, and click 'Process File' as per the screenshot below:
SWOOP Data Miner Screenshot:
It can take up to 24 hours for the new user profile data to be available in SWOOP, but often only takes a few hours.
Automated upload via Azure Active Directory
Contact SWOOP by raising a support ticket to activate a connection to your Azure Active Directory. Read more about connecting to Azure Active Directory.
Automated upload on a periodic basis via other means
SWOOP supports the use of the 'curl' command. The curl command is available as a package on all Linux distributions. Contact SWOOP by raising a support ticket to set this up.