Right Click Tools Builder

Right Click Tools Builder is an automation engine that lets you create strings of Right Click Tools actions, including all of the different Right Click Tools, PowerShell scripts, Registry Edits, WMI Calls, and more. These customized tools can then be saved and shared with role-based permissions. 

Navigation

Right Click Tools Builder is available in a number of console locations. To open it, right click in the console and navigate to Recast Right Click Tools > Right Click Tools Builder:

Right Click Tools Builder Navigation

Overview

Right Click Tools Builder Manage Overview ScreenShot

Creating a New Builder Action

First, select the "New Action" Button:

Right Click Tools Builder New Action

  • This will create a new saved tool under the "My Right Click Tools" list.

Configuring Action Properties

Next, select the Start Node in the Tool Creator to populate the Action Properties box. The options in the Actions Properties section help with the design and configuration on the new tool.

Right Click Tools Builder Action Properties

View

The "View" field is used to determine how the results of a Right Click Tools Builder tool will be displayed. The options available are Single Grid Results, Two Grid Results, and Tabbed Results.

  • Different result displays may be more desirable from a user experience perspective than others.
    • Tabbed Results: shows a result for each step of the tool.
  • View options do not have an effect on the successful or unsuccessful technical operation of Right Click Tools Builder tools; they only affect the way in which results are displayed.

Right Click Tools Builder Action View

Name

The "Name" field determines the name of the Right Click Tools Builder tool. The save button in the upper left will populate newly named tools in the My Right Click Tools list.

Right Click Tools Builder Name

Display

The "Display" field option is used to identify the ConfigMgr object that the Right Click Tools Builder tool is being run against. Options change based on the selected Action Type.

  • For a tool run against a device, the "Computer Name" option would be an appropriate display option.

Right Click Tools Builder Display

Action Type

The "Action" field option is used to specify what properties the tool will take action upon.

  • Generic: for all Right Click Tools Builder Tools acting on functions not related to users or devices.
  • Device (with or without resource ID): for tools acting on devices. These tools will be available anywhere Right Click Tools device tools are available. The Resource ID is ConfigMgr's unique identifier for a computer object.
  • User (with or without Resource ID): for tools acting on users. These tools will be available anywhere Right Click Tools user tools are available. The Resource ID is ConfigMgr's unique identifier for a user object.

Right Click Tools Builder Action Type

Custom Input Parameters

Input Parameters can be used to provide users with options prior to tool execution time.

Examples:

  • Choosing a collection to which a device will be added.
  • Choosing whether or not to force a full inventory cycle upon completion.
  • Having an admin input a PowerShell script.

First, select an input parameter type by choosing from the dropdown and clicking "Add". Options include:

  • Boolean
  • DateTime
  • Integer
  • String
  • TimeSpan

Right Click Tools Builder Input Parameters

Boolean

  • The Boolean input parameter will prompt the user running the action with an option to check or uncheck the parameter mapped to the Boolean. 

Right Click Tools Builder Boolean

DateTime

  • The DateTime input parameter will prompt the user running the action with an option to select the date and time.

Right Click Tools Builder DateTime

Integer

  • The Integer input parameter will prompt the user running the action with an option to set an integer value. You also have the option to set a default, minimum, and maximum value. 

Right Click Tools Builder Integer

String

  • The String input parameter gives you two options - List or Textbox. This will prompt the user running the action to select or input a string. 

List:

Right Click Tools Builder String List

Textbox:

Right Click Tools Builder String Textbox

TimeSpan

  • The TimeSpan input parameter will prompt the user running the action with an option to set a length of time. A default value can be set if needed.  

Right Click Tools Builder TimeSpan

Designing/Configuring Tools

Adding Recast Actions

Use the Recast Actions search box or drill-down menu to find relevant tool actions. Drag actions from the Recast Actions menu into the tool creator to add them to an existing tool.

Next, direct the flow of actions from the Start node to the first action step by selecting the circle edge and dragging it to the first box:

Right Click Tools Builder flow

Right Click Tools Builder will auto-select the edge arrow in blue and populate the item properties field below. Configuring and setting parameters will tell ConfigMgr what properties to change on the targeted object:

Right Click Tools Builder arrow

Mapping Target Input Parameters

Parameters can be mapped to a constant value or a specific property or step. Constant values must be specified, whereas Parameter Mapped values can be pulled from any step of the existing tool to any property of the action being taken:

>1)

Right Click Tools Builder target input parameters

2)

Right Click Tools Builder target input parameters2

3)

Right Click Tools Builder target input parameters3

  • This should be done for every parameter appropriate for the actions you are trying to take. A good rule of thumb here is to map parameters for actions where you need to pull input from the user or the properties of the object should change. Use constant values to hard code a value.

Conditional Responses

Right Click Tools Builder has the ability to set and work with conditional responses. Right Click Tools Builder can be configured to skip certain actions based on the results from previous actions. There are several logical term choices:

Right Click Tools Builder Conditions

Once a logical condition has been added, input values can be associated. For example, an "Equal To" condition has been set from the Computer Name to a name of device "XYZ":

Right Click Tools Builder Conditions2

  • If the conditions are true, Right Click Tools Runner will execute the next step according to the specified workflow. If not, the next step (and any subsequent step in the chain) will be skipped.

Saving and Sharing Tools

Once complete, be sure to save newly created tools. With the Right Click Tools Enterprise Server, Right Click Tools Builder tools are automatically saved and can be configured with Role-Based Permissions.