Audience: ClassLink Administrator
Events & Actions are actions that are taken when an event occurs. In other words, a specific action is taken when a user triggers a condition based on its properties. You can also select users with other conditions not based on user properties. These include: User is Enabled, User is Disabled, User is Added, From Source, or For All Users.
There are various action types. The following requires no configuration and can be set up within the Events & Actions tab of a destination:
- Assign Property and Value: a user is assigned a value for the specific property
- Move to OU: a user is moved to the specified organizational unit, formatted specifically for the destination type
The remaining actions require additional setup and configuration:
- Execute PowerShell Script: run a PowerShell file of your own design. This action will load all .ps1 files from "C:\ClassLink OneSync\Scripts". Once loaded, you can then enter parameters into the event and action. These parameters can accept mappings and text transformations. In the parameters, you can also specify whether to run the script via Windows PowerShell or PowerShell Core.
- Email: message the designated email address. The email address, the email body, and the email subject can all be templated. That is, they will accept mappings and text transformations. Before you can use this action, you must enter email credentials in the Events & Actions tab of the destination. These credentials include an Email to Send From, Password, Port, and Host. Once you have entered your credentials, you can send a test email to confirm that the action will function correctly. Your email client will often set a secure port for you. Otherwise, you must choose a port yourself. The host is the server name of your email client. For example, for Office 365 email accounts, the port number is 587 and the host is "smtp.office365.com".
Execute ODBC Query: To use this action, you must first set up a Database Connection in OS Settings -> Database Connections. Once a connection has been created, you can use this action in destination Events & Actions. Select type Execute ODBC Query, select a database connection, and then enter a database query in the Query Editor. The query's results will be output to the Export Logs. If there is no results or output, the logs will state so. Otherwise, the logs will detail the first 50 rows. Larger queries will be truncated, but full queries can be listed if Verbose Logging is enabled in OS Settings.
Updated: Jan 2019