User Population Scripts
Sym provides a collection of scripts to help with initial user population across a number of external integrations.
Overview
Sym Users are represented by a combination of Sym identity (normally an SSO-tied email address), and a series of external_ids
for each Service Type that will be used as a Sym Integration. While a Sym Integrator might know the SSO identities of all Users that should be present in the platform, it can be challenging to gather and manage the various external identities of every User.
This is where Sym's Community Scripts can help by providing a shortcut to populating the external IDs for all Users already present in Sym.
Supported services
Sym Community Scripts currently support the following external Service Types:
Community Scripts rely on managing Users via CSV
Before continuing, please make sure you're familiar with the
symflow
CLI's commands for outputting and re-importing the Sym User list.
Using the Community Scripts
1. Before you start
The Community Scripts rely on matching user emails between existing Sym users, and records in external Services. Before you start, you should ensure all Users you want to match are already present in Sym.
2. Export the User list
Run the following command to export your User list to a local file:
symflow users list -o users.csv
This is the file you'll be using for the rest of this guide.
3. Follow the Community Scripts instructions
The Community Scripts repo has instructions for how to populate your User list before re-importing. In short, you're going to:
- Clone the repo
- Install poetry
- Use poetry to run the scripts in the same directory as your output
users.csv
file
The main command you will be using is:
Command | What it does |
---|---|
| Kicks off the process that will prompt you for credentials to automatically fill supported |
4. Re-import your users.csv
file to Sym
users.csv
file to SymFirst, check your users.csv
list to ensure that the IDs you were looking for were correctly fetched.
Then, run the following command to re-import your User list via symflow
:
symflow users update -i users.csv
Finally, you can confirm that everything worked by running symflow users list
.
Updated 6 months ago