Gate Advance Reminder Agent

The Gate Advance Reminder Agent sends out reminder Inbox and email notifications when all of a gate's Conditions have been met and the gate is ready to be advanced. Users subscribed to the "Gate is ready to be advanced" Alert Subscription on a Gated Project will receive a notification whenever this agent runs.

This can be found under the "Gate approvers" category on the Alert Subscriptions page.

Note: Alert Subscriptions under the "Gate approvers" category will only appear on Gated Projects.

Note: Administrators can set Alert Notifications by Role or users can select their own Alert Subscriptions on specific work items.

When this agent runs, it will search for Gated Projects with "Active" work statuses that have completed Conditions on the current gate. Users who are subscribed to the "Gate is ready to be advanced" Alert Subscription on these Gated Projects will receive a reminder alert stating that the gate is ready to be advanced.

Tip: See the Work Status Names page to see which work statuses are considered "Active".

Tip: Users can configure the alert to be sent by email as well by enabling "Notify by email" on the Alert Subscriptions page.

Example: Erin is in charge of creating Project Reports for each gate of a specific Gated Project. Once the gate is ready to be advanced, she runs a report to show the management team. If the management team is happy with the results, they will advance the gate.
Erin is not a gate approver, so without this agent, she would never know when a gate was ready to be advanced. The management team would often have to reach out to her in order to request the report before they could determine whether the gate could be advanced or not.
Thankfully, Erin can subscribe to the "Gate is ready to be advanced" Alert Subscription on the Gated Project. If an administrator has enabled the "Gate Advance Reminder" agent to send notifications, Erin will be notified when the Conditions of the current gate are met. She can then create her report without having to be reminded by the management team.

Note: This page covers how to edit the Gate Advance Reminder Agent's settings. For information on enabling or disabling the agent (or any other agent), see Activate / Deactivate an Agent. For information on manually running an agent, see Manually Run an Agent.

 

To edit the Gate Advance Reminder Agent's details:

Before You Start: Only PowerSteering administrators can edit PowerSteering agents.

1. Select Admin → Configuration → Agents from the Navigation Menu.

   

2. Select Gate Advance Reminder Agent from the list of agents.

   

3. (Optional) Review any of the agent's details and / or run logs.

   

   

   Tip: From this page, administrators can run the agent immediately by selecting the Run Agent button next to the title.
   

4. Select the Edit button in the top right-hand corner of the page.

   

5. Configure the agent's parameters.

   

   • Title: Select the title field to change the name of the agent task.

     Note: This will only change the name of the agent task, not the agent itself.

   • Is Active: Determine whether the agent is active or not. Inactive agents will not run.

   • Interval (Mins): Determine the time interval (in minutes) between runs. This means that whenever the agent runs, its next run will automatically occur again after the indicated interval.

     Note: A reminder will not necessarily be sent for the same Gated Project every time the agent runs. After sending an initial reminder for a Gated Project with completed Conditions on the current gate, the agent will not automatically send another if the gate has still not been advanced by the time the agent runs again. See "Days until follow-up reminder is sent" and "Maximum number of reminders" below for information on sending additional reminders for the same Gated Project.

     Tip: The recommended interval is 1,440 minutes (24 hours).

   • Oldest Log Age (Days): Enter the number of days that the oldest logs will be saved. Runs that occurred after the indicated number of days will be removed from PowerSteering.

     Tip: Try to enter the lowest number of days possible in order to ensure that PowerSteering runs efficiently.

   • Next Run Time: Click on the field to select a date and time for the agent's next run. The currently-scheduled next run will auto-populate the field.

   • Expiration Date: Click on the field to select a date and time for the agent to automatically expire (turn off).

   • Days until follow-up reminder is sent: Enter the number of days that will serve as an interval between the initial reminder and each follow-up reminder.

     After the initial reminder is sent when the agent first identifies a gate that is ready to advance, follow-up reminders can be sent afterward if the gate has still not been advanced and the Conditions are still satisfied. Follow-up reminders will continue to be sent until the gate is advanced or the maximum number of reminders is reached (see below).

     Note: If the "Interval (mins)" is a longer time period than this value, it will not result in multiple follow-ups being sent at once. Each run will only send one reminder per Gated Project.

   • Maximum number of reminders: Determine how many reminders should be sent when a gate has still not been advanced. This includes both the initial reminder and any follow-up reminders.

     Tip: Enter "1" if you would not like follow-up reminders to be sent after the initial reminder.

6. Select the Save button in the top right-hand corner of the page.

   

After selecting Save, your changes will be saved to the agent.