Promotion Routine
Promote individuals from one group to another with the Promotion Routine.
Promote By Age
The daily promotion routine automatically moves individuals from one group to another as they age out of a specific group. This routine promotes those between the Age in Months to Promote field in the Group record and that value plus 11 (to measure one year), so it only promotes those within that range. This is primarily for young children in age-based groups, but you can use it for any Group Type. To configure your groups to use this routine, see Promotion for Age Groups.
Requirements
The Group record must be defined as follows:
- Age in Months to Promote must be configured.
- Promote Weekly must be Yes.
- Promote to Group must be set to a Group.
- Promotion Date must be left blank.
The Group Participant record must be defined as follows:
- Auto Promote must be set to Yes.
- You must have the correct Group Role Type.
- The Start Date is current or in the past. Those with future Start Dates are not promoted.
- The Date is blank or in the future.
- The associated Contact record has a Date of Birth and meets the age in months to promote. Those without a date of birth will not be promoted.
Video: Promote by Age
Promote By Date
The daily promotion routine automatically moves individuals from one Group to another when the Group reaches its Promotion Date. This is primarily for children in grade-based Groups, but you can use it for any Group Type. To learn how to configure your Groups to use this routine, see Promotion for Grades.
Requirements
The Group record must be configured as follows:
- Promotion Date must be configured for a specific future date. See "How Promotion Routines Work" for additional details.
- Promote to Group must be defined.
- Promote Weekly must be undefined or No.
The Group Participant record must be configured as follows:
- Auto Promote is set to Yes.
- You must have the correct Group Role Type.
- The Start Date is current or in the past; those with a future Start Date are not promoted.
- The End Date is blank or in the future.
Video: Promote by Date
New vs. Updated Group Participant Records
You can set the promotion to end date the current Group Participant record and create a new Group Participant record. Alternatively, you can set it to change the Group Participant record from one Group to the next.
This choice is governed by the SERVICES, WeeklyPromotionsByUpdate Configuration Setting. Set the value to Yes to move the group participant from one group to another. Set the value to No to ensure their Group Participant record is end dated, and a new Group Participant record is created for the group promoted into. The newly created Group Participant record uses the same Start Date as their Group Participant record in the prior group. This is to prevent people who are no longer attending your children's ministry (but have not been end dated) from appearing to have restarted their attendance because of promotion.
This setting also impacts the Selected Group Attendance report on the Groups page.
How Promotion Routines Work
You do not have to space out groups by date and do one grade at a time, like you would do manually. The routine first builds a temporary table of all group participants that are promoting with their current and promote to groups. It then steps through each person one-by-one and promotes them so no one gets left out and no one gets promoted more than once.
The routines also Audit Log each change so you can undo an action if needed. Audits show as "Mass Updates by SVC MGR".
I want my Groups to promote when the nightly routine runs tonight. Should I set the Promotion Date to today, or tomorrow? The answer depends on what time the routine runs on your system. To determine this value, reference Q1 on the Routines FAQ, or ask Support. If the routine runs before midnight, set the date to today. If the routine runs midnight or after, set the date to tomorrow. The routine promotes groups whose Promotion Date matches the date at the time the routine runs.
Exceptions
Exceptions to the Promotion routine include Auto Promote and Group Role Types.
Auto Promote
The Auto Promote field in the Group Participant record determines whether the routine promotes a Group Participant. When Auto Promote is set to No, the Group Participant is not promoted when they reach the Age in Months to Promote value on the Group OR when the Group reaches its Promotion Date.
When Auto Promote is set to Yes, the routine promotes based on the Age in Months to Promote value OR the when the Group reaches its Promotion Date. If both values are set, the first value reached causes the routine to promote the Group Participant. If Auto Promote is set to No, the routine does not promote the child. This is usually used in cases such as a child with special needs.
Group Role Types
If Group Participants with Group Role Types of Servants and Leaders in the Group shouldn't be promoted, go to the Group record and set Promote Participants Only to Yes.