iRecruitment Vacancy Approval Transaction Type

The following sections describe the attributes, rules, and conditions supplied with the iRecruitment Vacancy Approval transaction type.

Attributes

The following attributes are supplied with iRecruitment. These are in addition to the mandatory attributes supplied with AME. You can use these attributes to create your own conditions, or as examples for creating your own attributes.

POSTING_ADDITIONAL_DETAILS_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Additional Details field in the Job Posting page.

Note: A boolean attribute type returns either True or False

POSTING_BRIEF_DESCRIPTION_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Brief Description field in the Job Posting page.

POSTING_DEPARTMENT_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Organization Name field in the Job Posting page.

POSTING_DEPARTMENT_DESCRIPTION_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Department Description field in the Job Posting page.

POSTING_DETAILED_DESCRIPTION_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Department Description field in the Job Posting page.

POSTING_GRAPHIC_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Graphic field in the Job Posting page. This field contains a URL for any graphic associated with a job posting.

POSTING_HOW_TO_APPLY_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the How To Apply field in the Job Posting page.

POSTING_JOB_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Job Title field in the Job Posting page.

POSTING_JOB_REQUIREMENTS_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Job Requirements field in the Job Posting page.

POSTING_TITLE_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Job Posting Title field in the Job Posting page.

VACANCY_BUDGET_MEASUREMENT_TYPE

This is a string attribute type that returns the budget measurement type for a vacancy. Note that this field is not displayed in iRecruitment by default.

VACANCY_BUDGET_MEASUREMENT_TYPE_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the budget measurement type for a vacancy. Note that this field is not displayed in iRecruitment by default.

VACANCY_BUDGET_MEASUREMENT_VALUE

This is a string attribute type that returns the value in the Number of Openings field in the Primary Details page.

VACANCY_BUDGET_MEASUREMENT_VALUE_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Number of Openings field in the Primary Details page.

VACANCY_BUSINESS_GROUP_ID

This is a number attribute type that returns the ID of a business group for a vacancy.

VACANCY_EMPLOYMENT_CATEGORY

This is a string attribute type that returns value in the Employee Status field in the Primary Details page.

VACANCY_FOR_CONTRACTOR

This is a string attribute type that indicates whether a vacancy has been marked as being for a contractor in the Primary Details page.

VACANCY_FOR_EMPLOYEE

This is a string attribute type that indicates whether a vacancy has been marked as being for an employee in the Primary Details page.

VACANCY_GRADE_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Grade field in the Primary Details page.

VACANCY_GRADE_ID

This is a number attribute type that returns the ID of a grade for a vacancy.

VACANCY_INSERT_OR_UPDATE

This is a string attribute type that indicates whether a vacancy has just been created (INSERT) or modified (UPDATE).

VACANCY_JOB_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Job field in the Primary Details page.

VACANCY_JOB_ID

This is a number attribute type that returns the ID of a job for a vacancy.

VACANCY_LOCATION_ID

This is a number attribute type that returns the ID of a location for a vacancy.

VACANCY_MAXIMUM_SALARY

This is a currency attribute type that returns the maximum salary for a vacancy.

VACANCY_MINIMUM_SALARY

This is a currency attribute type that returns the minimum salary for a vacancy.

VACANCY_ORGANIZATION_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Organization field in the Primary Details page.

VACANCY_ORGANIZATION_ID

This is a number attribute type that returns the ID of an organization for a vacancy.

VACANCY_POSITION_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Position field in the Primary Details page.

VACANCY_PROFESSIONAL_AREA

This is a string attribute type that returns value in the Professional Area field in the Primary Details page.

VACANCY_STATUS

This is a string attribute type that returns value in the Status field in the Primary Details page.

VACANCY_STATUS_CHANGED

This is a boolean attribute type that indicates whether any changes have been made to the Status field in the Primary Details page.

VACANCY_WORK_FROM_HOME

This is a string attribute type that indicates whether a vacancy has been marked as allowing working from home in the Primary Details page.

VACANCY_RULE_TYPE

This is a string attribute type that identifies which rule applies either SEEDED or CUSTOM.

Conditions

The following conditions are supplied with iRecruitment to support some of the supplied attributes. These conditions can be used in rules to invoke particular approvals processes, or can be used as examples upon which to base your own conditions.

Rules

The following table describes the rules that are supplied with iRecruitment. They link one or two of the supplied conditions to an approval type and a rule. For all of the rules supplied the approval type is based on the supervisor hierarchy, and the approval rule is always to require approval up to the first superior at most. All of the supplied rules are of the List Creation type.

AME Rules supplied with iRecruitment

Rule Name Conditions Approval Rule
iRecruitment Create Vacancy VACANCY_INSERT_OR_UPDATE in [INSERT}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Posting Additional Info POSTING_ADDITIONAL_DETAILS_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Posting Brief Description POSTING_BRIEF_DESCRIPTION_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Posting Detailed Description POSTING_DETAILED DESCRIPTION_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Posting Job Requirements POSTING_JOB_REQUIREMENTS_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Posting Job Title POSTING_JOB_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Vacancy VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_STATUS_CHANGED is True
Require approval up to the first superior, at most.
iRecruitment Update Vacancy Budget Type VACANCY_BUDGET_MEASUREMENT_TYPE_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Vacancy Budget Value VACANCY_BUDGET_MEASUREMENT_VALUE_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Vacancy Grade VACANCY_GRADE_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Vacancy Job VACANCY_JOB_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Vacancy Organization VACANCY_ORGANIZATION_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Vacancy Position VACANCY_POSITION_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.
iRecruitment Update Vacancy Status VACANCY_STATUS_CHANGED is true
VACANCY_INSERT_OR_UPDATE in [UPDATE}
VACANCY_RULE_TYPE in {SEEDED}
Require approval up to the first superior, at most.

Example - Using the VACANCY_RULE_TYPE Attribute

To enable you to add rules to the predefined transaction type, iRecruitment provides an attribute VACANCY_RULE_TYPE that you can customize to create a new condition for your rule.

This example shows how to customize the iRecruitment Vacancy Approval transaction type to use different set of rules.

The predefined rule - iRecruitment Create Vacancy has the following conditions:

VACANCY_RULE_TYPE in {SEEDED_RULE}

VACANCY_INSERT_OR_UPDATE in {CREATE_VACANCY}

To customize the transaction to enable a different approval process based on the number of openings (Budget Measurement Value), follow these steps:

  1. Create a new condition: VACANCY_RULE_TYPE in {CUSTOM_RULE}.

  2. Create new rules with your condition as given in the example:

  3. Change the value of the attribute VACANCY_RULE_TYPE to the static text CUSTOM_RULE.

  4. Save your changes and bounce the Apache listener.

After these changes, users would require 3 levels of approval when creating vacancies with 10 or more openings, and would require only 1 level of approval when the number of openings is less than 10. Note that after you change the VACANCY_RULE attribute, none of the supplied rules apply any more. In this example, only create transactions will require approval.