Setting Up Action Scripts to Run on
Action-enabled Reports

Using Reporter, you can run object and attribute action scripts on data collected in action-enabled reports.

Reporter includes a number of predefined action scripts. These scripts are already associated with the seven different categories of object types: users, groups, computers, domains, OUs, User Personalities (QAS), and Group Personalities (QAS). Using the Configure utility, you can add scripts to objects and/or attributes, or copy the predefined scripts and use them as a basis to create your own action scripts.

When using action-enabled scripts, you must consider whether you want to perform the action against the object itself or modify an attribute of that object. Keep in mind the following differences:

•	An action-enabled script associated to an object performs an action against the object itself like move, delete, reset password, and so forth.

•	An action-enabled script associated to an attribute is specifically targeted against an object's attribute such as modifying the home directory or enabling/disabling the user account.

You cannot use action-enabled reporting to modify primary groups.

Using the Configure utility, you can review the attributes and associated action scripts. You can also

•	Add action scripts

•	Modify action scripts

•	Remove action scripts

To create an action script

1.	Select Start | All Programs | Quest Software | Quest Management Suite | Reporter | Configure.

2.	Click the Action Enabled tab.

3.	Select an object type from the Category list.

4.	Select Object Scripts.

– OR – 

Select Attribute Scripts.

5.	Right-click in the Script pane and select Add.

6.	Select from one of the following methods:

TO	DO THIS
Create a new script	1. Select New Script. A default script template displays in an editing window. 2. Modify the script content as needed. 3. Click OK. Note: This new script will be associated with the object type you have selected in step 4.
Use an existing script as the basis for a new script	1. Select Pre-existing Script. 2. Select a script from the list that appears. 3. Right-click the script you added and select Modify. 4. Select the entire script and press CTRL+C to copy. 5. Click Cancel to close the editing window. 6. Right-click in the Scripts window and select Add | New Script. 7. Select the entire script in the editing window and press CTRL+V to replace it with the script you copied. 8. Locate the line that starts with "displayname" and replace "displayname" with the script name you want. 9. Change the script as required. 10. Click OK.

7.	Click OK to exit the Configure utility.

– OR – 

Click Apply to save the new script and continue.

To modify an action script

1.	Select Start | All Programs | Quest Software | Quest Management Suite | Reporter | Configure.

2.	Click the Action Enabled tab.

3.	Select an object type from the Category list.

4.	Select Object Scripts.

– OR – 

Select Attribute Scripts.

5.	Select a script from the list.

6.	Right-click the script in the Script pane and select Modify.

7.	Change the script as required and click OK.

If you modify a script that is associated with more than one attribute/object (for example, AD MultiPurpose), the changes you make appear in all instances of that script. It is recommended that you create a copy of the script which you can then modify.

To remove an action script

1.	Select Start | All Programs | Quest Software | Quest Management Suite | Reporter | Configure.

2.	Click the Action Enabled tab.

3.	Select an object type from the Category list.

4.	Select either Object Scripts or Attribute Scripts.

5.	Select a script from the list.

6.	Right-click Remove and select one of the following:

option	description
Remove From This Attribute	The script no longer runs against the selected attribute.
Remove From All Attributes and Delete	The script no longer runs against any of the attributes with which it is associated, and is deleted from the scripts directory.

7.

Click OK.