2.1 Web Console
The Web Console is a Web-based user interface that provides quick and easy access to many user account, group, computer, resource, and Microsoft Exchange mailbox tasks. You can customize object properties to increase efficiency of routine tasks. You can also manage general properties of your own user account, such as the street address or cell phone number.
The Web Console displays a task only if you have the power to perform that task.
2.1.3 Customizing the Web Console
In the Web Console, you can customize object properties and the user interface branding. When implemented correctly, property customizations will help to automate tasks with object management.
Customizing Property Pages
You can customize the object property forms that you use in your Active Directory management role by object type. This includes creating and customizing new object pages that are based on object types that are built into DRA. You can also modify properties for the built-in object types.
Property objects are clearly defined in the Property Pages list in the Web Console so you can easily identify which object pages are built-in, which built-in pages are customized, and which pages are not built-in and were created by an administrator.
Customizing an Object Property Page
You can customize object property forms by adding or removing pages, by modifying existing pages and fields, and by creating custom handlers for property attributes. When you create custom handlers, they automatically execute when a property field changes or when an administrator responds to a prompt to run a query, depending on how the custom handler is configured.
The object list in Property Pages provides two operation types for each object type, Create Object and Edit Properties. These are the principal operations that you perform in the Web Client, and your customizations can improve your efficiency and experience when managing Active Directory objects in DRA.
To customize an object property page in the Web Console:
-
Navigate to > .
-
Select an object and operation type (create or edit) in the Property Pages list.
-
Click the button
.
-
Customize the object property form by doing one or more of the following, and then applying your changes:
-
Add a new property page:
-
Select a property page and customize the page:
-
Reorder configuration fields in the page:
-
Edit fields or subfields:
-
Add one or more fields:
or
-
Remove one or more fields:
-
-
Create custom handlers for properties by using scripts, message boxes, or queries (LDAP, DRA, or REST)
For more information about using custom handlers, see Adding Custom Handlers.
-
Adding Custom Handlers
Custom handlers are used in DRA for property attributes to interact with each other to accomplish a workflow task. A few examples of property custom handlers, include querying the value of other fields, updating values, toggling a field’s read-only state, and showing or hiding fields based on configured variables
DRA also simplifies the creation of custom handlers with several selectable JavaScript (JS) macros that you can choose from in the custom handler creation and validation process.
Basic steps for creating a custom handler:
The steps below begin from a pre-selected custom handler page. To get to that point, you access object property custom handlers via the edit button on a property field.
-
Click the Custom Handlers tab and enable the page
.
-
Choose a custom handler from the drop-down menu, and select an execution time. Normally, you would use the second or third options for Execution Time.
NOTE:Typically you may only require one custom handler, but you can use more than one handler by configuring flow controls in the script to link handlers together.
-
You will need to configure
each custom handler that you add to the page. Configuration options vary by handler type, but all of the handlers execute from JavaScript.
You can create your own Vanilla JavaScript entries or use the built-in macros.
-
LDAP or REST Query handlers:
-
If you want your query to be based on static values, define and .
If you want your query to be dynamic, enter placeholder text in the mandatory fields. This is required in order for the script to execute. The script will override the fake values.
NOTE:You can also configure Headers and Cookies for the REST Query.
-
In Pre-Query Action, select a macro type: , , or .
-
Choose a macro from the drop-down list, and insert the macro ().
-
Insert other macros as needed, and then provide the desired values to complete the script.
As an example, in the Pre-Query Action we’ll use a script to validate that a group name entered by a user does not already exist in Active Directory when the form is submitted.
We need to create an LDAP query using the name entered by the user. We use the Field() macro to access the value of the Name field and build the query string which we then set as the query filter using the Filter() macro.
Filter() = '(&(objectCategory=group)(objectClass=group)(name=' + Field(name) + '))';
-
Following through with the example above, in the Post-Query Action we'll check the results returned by the query. The results are returned as an array of objects that matched the query, so we just need to check if the length of the array is greater than 0.
When a matching group is found, we use the Cancel() macro to cancel the form submission, passing the macro an optional message to display to the user.
if (QueryResults().length > 0) { Cancel('A group with that name already exists, please enter a unique name.');}
-
-
Script: Insert custom JavaScript code or use the macros to build the script.
-
DRA Query: For the Query Parameters, define a payload in JSON format. Then use macros in similar fashion as described above for LDAP and REST queries.
-
Message Box handlers: After defining the properties of the message box itself, use macros in similar fashion as described above for LDAP and REST queries, but instead of Pre-Query and Post-Query actions, you compose the macro scripts for Before-Show and After-Close actions.
-
-
Click to validate your script before saving the form.
This will generate a Test Result Summary where you can view the execution results.
NOTE:If the handler depends on the current state of the form (for example, the field has a value), it will not execute successfully, since no data is loaded when editing a form. In those cases the handler will needs to be tested outside the form editor by saving the customization, navigating to the appropriate form, and filling in the required data.
Creating a New Object Property Page
To create a new object property page:
-
Login to the Web Console and navigate to > .
-
Under Tasks, click .
-
Create the initial object properties form by defining its name, icon, object type, and operation configuration.
-
Customize the new form as required. See Customizing an Object Property Page.
Customizing User Interface Branding
You can customize the title bar of the DRA Web Console with a your own title and logo image. The placement is directly to the right of the DRA product name. Since this location is also used for top-level navigation, it is hidden by the top-level DRA navigation links after logging in. However, the browser tab continues to display the customized title.
To customize the title branding in DRA:
-
Login to the Web Console and navigate to > .
-
If you are adding a company logo, save the logo image in components\lib\img on the Web Server.
-
Add the required information, as applicable, for the three fields on the branding customization page and save your changes.
2.1.4 Managing Objects in the Web Console
You manage objects in the Web Console by navigating to the Management masthead. From here, you can search by object type for objects in domains, containers, and the Recycle Bin. In the Tasks pane you can create new objects, add and remove members from groups, and move objects.
If you select an object in the search results list, all applicable actions that you can take on that object are displayed in icon tiles above the grid. The options available are based on the object type selected, the components currently configured for DRA, and your assigned administrator privileges.
To edit an object’s properties, select the object and click the tile 
. From here, you can access all the object’s property pages in the left navigation pane.
IMPORTANT:If you want to , scroll to the bottom of the Properties page, select the check box to enable this feature, and the changes.
For more information about actions you can take on objects, see the following topics: