Tampa Creating Service Alerts - Hillsborough-Transit-Authority/onebusaway-application-modules GitHub Wiki

If you're an admin user for the Tampa OBA instance, you can create "service alerts" via the OBA admin page that users of the OBA website and mobile apps will see when they access a page related to an affected route/stop.

Go to the .41 machine home page, then to "Settings->Admin 'Your powers'->Service Alerts->HART". You'll be prompted to login (use your ADMIN account) if you're not currently logged in.

You should now see options to:

  • Create a Service Alert
  • Remove ALL Service Alerts

To create a Service Alert - Click on "Create a Service Alert", and you'll be shown several fields where you can enter various information about the alerts, such as:

  • Summary - (e.g., "Route 5 detour")
  • Description - (e.g., "Route 5 is currently being detoured due to emergency construction")
  • Reasons - List of a variety of reasons to pick from
  • Severity - List of a variety of severity options to pick from

Enter the information you wish, and then click on the "Create" button.

Next, you'll need to specific what is affected by this alert. OBA Tampa currently supports entering two types of alerts:

  1. System-wide alerts - this will be shown to all users, no matter what route/stop they are searching for transit information for
  2. Stop-specific alerts - this will be shown to users of the affected stop, when they search for information about that stop

To specify what is affected, click on the "Add Affects Clause" link.

  • To specify a system-wide alert - Enter the text Hillsborough Area Regional Transit in the "Agency Id" box, and click the "Update Affects Clause" button.
  • To specify a stop-specific alerts - Enter the text Hillsborough Area Regional Transit in the "Stop Id" box, followed by an underscore (_) and the stop ID. For example, to specify a service alert for stop 3105, enter the text Hillsborough Area Regional Transit_3105 in the "Stop Id" box. Then, click the "Update Affects Clause" button.

To remove the alert, click the "Delete" link at the bottom of the service alert page. To remove all alerts, return to the main Service Alerts management page and click the "Remove ALL Service Alerts" link.

Note that you'll have to repeat the above process for the .42 and .43 machines.

KNOWN ISSUES - For some reason, route-specific alerts are not working (see this discussion on the OBA dev list). Additionally, if you return to the "Service Alerts" main management page after creating a stop-specific alert, it will not appear in the list of current service alerts. Also, do not enter text in more than one "Affects Clause" field, or no alert will be created.