Adaxes Web Interface HelpShow AllHide All

Configuring 'Create Object' Action

You can minimize the steps necessary for creation of objects via the corresponding action on Home page. For this purpose, you need to configure the action parameters to specify default of pre-set values for them. For example, you can add 'Create Sales User' command, and pre-set the Organizational Unit, where new users will be created, customize the user creation form for this command, and define the default values for some user properties. In such a way, when users click the 'Create Sales User' link, they will not be offered to select the target Organizational Unit (and thus will never create a user in a wrong OU), and will be able to fill in only the fields you defined for the creation form. The rest of the fields will be set automatically as you have specified them.

To configure the 'Create Object' action on the Home page:

  1. Launch the Adaxes Web Interface Configuration Tool on the computer, where the Web Interface is installed.

    How:

    Windows 7 and earlier:

    • Open the Windows Start menu.
    • Click All Programs > Softerra Adaxes 2017.1 > Web Interface > Web Interface Customization.

    Windows 8 and 8.1:

    • Open the Start screen.
    • Start typing Web Interface Customization.
    • Press Enter.

    Windows 10:

    • Open the Windows Start menu.
    • Click All apps > Softerra Adaxes 2017.1 > Web Interface Customization.
  2. In Interface type drop-down list, select the type of the Web Interface you want to customize and click the General tab.

  3. Select the Actions pane check-box and click the Configure Home Page Actions button.

  4. In the Home Page Actions dialog that opens, click the Add button below to create a new action.

    The actions contained in the Actions pane can be organized into groups. To create a new action under a specific group, select this group before adding the action. To add a new group, click the Add Group button below, type group's name, and press Enter.
  5. In the Add Home Page Action wizard that opens, click Create New and select the type of objects to be created using the new action. Click Next.

  6. Provide the name, brief description, and confirmation text for the new action. Click Next.

    If you don't want any confirmation to be displayed, leave the Confirmation field blank.
  7. When the action is initiated, users will need to choose where in Active Directory the new object will be created. You can configure options for choosing the location (Organizational Unit or other container) for new objects.

    • To allow users to select only OUs or containers located under a specific OU/container, enable the Allow selecting only OUs/containers located under option. In the Container DN edit box, specify the DN (Distinguished Name) of the OU or container you need.

      To get the DN of an AD objects, right-click the object you need in the Adaxes Administration Console. In the context menu, open the submenu of the Copy item, and click Copy DN. The DN of the selected Active Directory object will be copied to the clipboard.
      Container DN can be composed using value references. For example, you can specify the following value here: OU=%department%,DC=company,DC=com. In this case, the %department% value reference will be replaced with the Department property of the user, who performs the action. So, when a user, whose department is Sales, performs the action, the Container DN will be set to OU=Sales,DC=company,DC=com.

      If you want to allow users to select only child OUs/containers of the OU/container specified in the Container DN edit box, but not this OU/container itself, enable the Disallow selecting this OU/container option.

    • To specify an Organizational Unit or container that will be set as a default location for object creation, enable the Select specific AD container or OU by default option. In the Container DN edit box, specify the DN (Distinguished Name) of the OU or container that you want to be set by default.

      To get the DN of an AD objects, right-click the object you need in the Adaxes Administration Console. In the context menu, open the submenu of the Copy item, and click Copy DN. The DN of the selected Active Directory object will be copied to the clipboard.
      Container DN can be composed using value references. For example, you can specify the following value here: OU=%department%,DC=company,DC=com. In this case, the %department% value reference will be replaced with the Department property of the user, who performs the action. So, when a user, whose department is Sales, performs the action, the Container DN will be set to OU=Sales,DC=company,DC=com.

      If you don't want users to be able to select the location for new objects, enable the Always use this OU/container option. In this case, the container or Organizational Unit specified in the Container DN edit box will be always set automatically, and users won't be able to specify another one.

    • To allow users to select only Organizational Units as location for new objects, enable the Allow selecting only OUs option. In this case, other Active Directory containers will not be displayed, when users select a location for creation of a new object.

    • To allow users to choose only Organizational Units or containers that match a specific LDAP filter, enable the When selecting the target OU or container, display only objects that match the specified LDAP filter option.

      For example, if you want new objects to be created only in Organizational Units that contain the word 'Department' in their names, you can use the following LDAP filter: (&(objectCategory=organizationalUnit)(name=*Department*)).

      To construct an LDAP filter, you can use the LDAP Filter Builder. To access it, click Find on the toolbar in the Adaxes Administration Console, activate the LDAP Search tab, and click the embedded button in the Enter LDAP filter field.

    Click Next.

  8. To customize the form used to create objects with the help of the new action:

    • To customize the form that will be used to create new objects, select the Use customized form option and click the Customize Form button.

      For details on how to customize forms, see Customizing Forms for Object Creation and Editing (steps 3 to 8).
    • To specify default property values for the new object, click the Add button located in the Predefined Fields group box. Choose the property, for which you want to define the default value, enter the desired value, and click OK.

      You can use value references to generate default property values for new objects. Value references will be replaced with the property values of the user, who performs the operation. For example, you can set the default value for the Description property as follows: Created by %name%. When a new object is created, the %name% value reference will be replaced with the name of the user, who creates this object, and new object's description will be set as 'Created by John Doe'.
      If you specify the default value for a property and there is a Property Pattern that also defines the default value for this very property, the value defined by the Property Pattern will be ignored.

    Click Finish.

  9. Click Apply two times.

There is no need to restart IIS to apply the changes, as the changes are applied automatically.

See Also