Team Structure Import FAQ
What's the difference between the Team Sync Connector and Team Structure Import?
The Team Sync Connector and Team Structure Import both offer the same functionality, however the Team Sync Connector leverages the Workday EIB (Enterprise Interface Builder), while the Team Structure Import can be used with an HTTP request.
I have a security review for the integration. How can you help with that?
a) To ensure additional secure transfer of files, Pluralsight supports PGP encryption and can provide you a PGP public key to encrypt the files sent over. Pluralsight retains and securely stores the private key that is then used to decrypt the files sent over via the connector.
b) We use Basic Auth, however we are actually using the Basic Auth like Bearer. The API Key that you will use as the password is actually a Bearer Token that is a well encrypted string. When the Basic Auth is sent over it is treated as a Bearer Auth and the Username is actually ignored.
I want only my IT org (or any specific org) to sync to Pluralsight. Does the connector allow for such customization?
Yes. Read the “Syncing Only a Part of Your Organization/Retain Manually Created Teams” section from the URL Parameters and Responses page for more information.
I do not want certain employees such as contract workers in my org to be given Pluralsight access. How do I make sure of this?
The connector only syncs users who already have licenses in Pluralsight. If the contract workers don’t have licenses in your organization, their information sent via CSV files will be ignored during the sync. You can also filter out contracted workers when you create the reports.
How do I ensure that the Team Structure Import is syncing the teams from Workday correctly?
Below are the options:
- By default, a "dry run" feature is turned on and you can view the generated org changes before applying them. Manager email invites will not be sent by default during the dry run phase. Read the “Dry Run” section on the URL Parameters and Responses page for more information.
- During the testing phase, after you are confident in the dry run you can choose not to send manager email invites to new managers not already in the system. Read the “Turning off Manager Invites” section on the URL Parameters and Responses page for more information.
- If there are unassigned users after the sync, (If you are an admin or a manager, you can view the unassigned tab by clicking on people in the left navigation menu) that means you have users that didn’t match. Refer to the Troubleshooting page to know how to resolve this.
- We have an Team Import Results Tool that allows you to view all relevant information pertaining to your upload including: status, operations generated, warnings and error messages.
Who gets the Pluralsight licenses?
The phase 1 functionality of the Workday connector doesn’t provision Pluralsight licenses to users.
I have created some teams manually. Will they get deleted when sync happens?
By default, yes. Read the “Syncing Only a Part of Your Organization/Retain Manually Created Teams” section from the URL Parameters and Responses page for more information.
Is there a staging environment/testing environment/sandbox for me to test the connector?
No. Syncs can only be done in your live/production Pluralsight account, we provide the “dry run” feature to mitigate this.
The dry run feature will use data from your Pluralsight plan to generate the necessary operations to be done without executing those operations or making any changes to the existing structure. Check the "Dry Run" section of the URL Parameters and Responses page for more information.
I’m interested in participating in early access testing of the Team Structure Import. What should I do next?
Please talk to your CSM to connect with the PaaS team.
What’s coming in the future (roadmap) ?
Below are features in the roadmap:
- A new Integration to sync Pluralsight content library to an LMS.
- A new Integration to sync Pluralsight content progress data into an LMS.
Is the Team Strcuture Import a full file dump in each sync or delta?
Team Strcuture Import is a full file dump. This identifies the delta team structure changes automatically and applies them.
Are there any size restrictions to the CSV file?
No.
In the future when there are Team Strcuture Import enhancements what are my options to test it? What does the upgrade process looks like?
For all breaking changes the connector version found in the URL number will be bumped up. Backwards compatibility will be maintained as much as possible. You will be able to utilize the “dry run” feature to test the new version before updating the connector. New enhancements may also become available as part of a parameter in the url that you can choose to enable.
Please refer to the Versioning Integrations page for more information.
What security measures are in place?
We utilize HTTP/SSL to secure the data in transit.
There is also an optional PGP Encryption piece that can be enabled in the integration. If you would like to utilize this feature, let your CSM and the PaaS Team know.
What happens when a team member is terminated?
This integration does not deprovision licenses. Please view our License Deprovisioning connector. Currently, the terminated user will be removed from the team structure and will be found in the unassigned users section within Pluralsight.
An error was returned when running the Team Strcuture Import. How do I troubleshoot this error?
Please utilize our Team Import Results Tool to view the status and/or errors that occurred during the Validation and Sync Run processes. Any answers to questions about this tool can be found in the Troubleshooting page.
Will users that are added as managers get an email when a team is added?
Yes, they get an email inviting them to view their teams' analytics.
What team structures/analytics will managers see? Will a manager see learners on teams nested under their team?
Here’s the link to a Help Center Page to learn more about permission levels for a manager.
What team structures/analytics will a plan admin see?
Here’s the link to a Help Center Page to learn more about the analytics that a plan admin can see.
Is there any limit to number of values in rootTeamId?
There is currently no limit on the number of rootTeamIds that can be sent over. However, we recommend that if you find you are sending quite a few to consider using a team id that is higher up in your structure that includes the child teams you want synced.
Note: Because we are not creating users or allocating licenses via this connector, it is safe to send us more of your org than necessary as the connector will only sync the users as they exist in Pluralsight at the time of the import.
Should the url parameters such as dryRun, sendManagerInvites, and rootTeamIds be sent via both the files?
Yes, the recommendation is to have the parameters in the urls for both files.
If users are on manually created teams, and they are on different teams in the structure coming in through the import, will they be on both teams?
Yes, as long as you are utilizing the rootTeamIds url parameter as found in the “Syncing Only a Part of Your Organization/Retain Manually Created Teams” section from the URL Parameters and Responses page.
If you do not use the rootTeamIds, the manually created teams will be removed (or moved to match the new team structure sent in the teams.csv file) and the users will only exist on the teams coming from the import.
Can I turn off email invites to managers during testing?
Yes, please refer to the “Turning Off Manager Invites” section from the URL Parameters and Responses page.