Configuring Candidate Queries for Static Organizations

This procedure describes how to configure candidate queries for static organizations, that is, organizations that are not dynamically generated.

Prerequisites

You must have an LDAP container defined from which the resource candidates can be obtained.

Procedure

  1. From the Organization Browser, click one of the following:
    • Groups button to configure a candidate query for a group.
    • Organizations button to configure a candidate query for a position.
  2. From either the groups or organizations list, select the desired group or position, then click Candidate Query.
    • If a candidate query exists for the group or position, its configuration is displayed on the Candidate Query dialog. You can edit the configuration using the information in Step 3, or you can delete the existing candidate query by clicking the Delete Query () button.
    • If a candidate query does not exist for the group or position, click Add Candidate Query, then use the information in Step 3 to configure the candidate query.
  3. Configure the candidate query using the fields on the Candidate Query dialog, as follows:
    Field Description
    Ldap Container Select the LDAP container from which the resource candidates are to be obtained to populate the group or position.
    • If you select an LDAP container that was created using a query source, you can use the remainder of the fields on the Candidate Query dialog to configure the candidate query.
    • If you select an LDAP container that was created using a group source, the remainder of the fields on the Candidate Query dialog are disabled. In this case, the candidate query will take all the entries identified by the LDAP container (that is, the LDAP group) as its candidate list.
    Base DN The LDAP branch to which the query (see below) will be restricted. This is optional and is relative to any Base-DN already configured on the primary LDAP source of the identified LDAP container. For example:

    ou=London

    If a Base-DN was configured on the primary LDAP source, it is shown below the Base DN field.

    Query This expression will locate entries that identify candidate resources. The expression is combined with that of the primary LDAP source of the identified LDAP container. The query expression must be enclosed in parentheses. For example:

    (employeetype=Permanent)

    The LDAP query that was specified on the primary LDAP source of the container is shown below the Query field.

    Search Scope Determines the depth to which the search will be performed, as follows:
    • One Level - Only the elements directly within the Base-DN level are searched.
    • SubTree - Elements directly within, and below, the Base-DN level are searched.

    The candidate query cannot be more inclusive in its Search Scope than the LDAP container's primary LDAP source. Therefore, if the primary LDAP source has a search scope of One Level, then the candidate query must also use One Level. However, if the primary source is SubTree, then the candidate query may be either.

  4. Click Save to save the edited or new candidate query.

Candidate Query Configuration for a Static Organization Example

Assumptions:
  • Your LDAP source looks like this:

  • The LDAP source contains the following attributes for each of the resources:

    The query in this example assigns candidate resources whose employeetype attribute = "Permanent".

  • Your organization model contains a "Customer Service Representative" position to which you want the candidate query to assign candidate resources:

To configure a candidate query to populate the Customer Service Representative position with resources from the London office (ou=London), who are permanent employees (employeetype=Permanent), follow the procedure above and fill in the fields of the Candidate Query dialog as follows:

After the candidate query is invoked by the properties in the DE.Properties file (for more information, see Candidate Queries), the organization model looks like this:

Notice that the (?) to the right of the check box indicates that the position has a candidate query defined.

And if you view the resources in the Customer Service Representative position, they appear as follows: