The Revisions tab displays all the pending changes that have been included in a STIP Revision. To edit the available fields and update statuses, users must have the System Administrator role or Revisions permission assigned; otherwise, these fields will be view-only.
Projects
All projects listed here will be in the typical format (Project Header and Project Change Table) as outlined in the Project Listing article. Below the Project Change Table will be an additional field: Select Comment. This field allows the user to enter a Revision Comment that will be included in Revision Summary reports, notifications, and public-facing information. These comments are stored at the project level, so there is a single comment for all changes related to the project on the Revisions tab. To ensure these comments are consistent, a picklist of pre-defined Revision Comments, as defined in the Standard Comment code list, can be selected. This list includes a free-form, custom option as well (see red box below).
Once an option is selected in the picklist, a pop-up will appear with an editable input field. Here, the user can enter relevant values to finish a Revision Comment or construct one from scratch. The "Save" button in the pop-up solidifies these values. If the user wishes to edit the Revision Comment at any point, the edit icon () can be selected to open the pop-up once more. The delete icon (
) can be used to remove the comment and set the field into a blank state.
To filter the displayed projects, the user can utilize the "Filter By" picklist in the upper lefthand corner of the tab. The available filters here are Show All, Project ID, County, District, or MPO. The user can also select the revision they wish to view through the "Select Revision" picklist. By default, the oldest unapproved revision is initially displayed in this window.
Other Controls
Beyond the listed projects, there are some other controls listed on the Revisions tab which help the user submit the changes to FHWA/FTA for approval. The table below describes these controls.
| Control | Location | Description |
| Bulk Action (picklist) | Top Right of Tab | Bulk-updates the "Action" picklist for all displayed projects where its Action selection is currently blank. This picklist will only update the pending changes that correspond to the Action selected. |
| Save (button) | Bottom Center of Tab | Save/processes any updates made on the Staging tab. |
| Cancel (button) | Bottom Center of Tab | Discard any updates made to the Staging tab. |
Actions in Revisions Tab
In the Revisions tab, the user must process pending changes through the workflow using the "Bulk Action" picklist since all amendments within the revision will be processed in unison. The revision approval process, as dictated by the "Bulk Action" picklist, is defined below.
| Action/Status | Description |
| Pending Public Comment (Status) | Initial status of the revision; additional project amendments can still be added from the Pre-Approved tab to the revision. |
| Post for Public Comment (Action) | Changes in the revision are posted to STIP Viewer for public comment; during this period, no updates can be made to individual amendments within the revision, nor can any other amendments be added to the revision. |
| End Public Comment (Action) | Stops the public comment period. |
| Pending DOT Approval (Status) |
Indicates that the revision is waiting for DOT approval. There are two actions that can be taken during this period:
While in this state, further amendments can be added to the revision. However, if new amendments are added, the revision status automatically returns to "Pending Public Comment" and the approval process starts over for the entire revision. Once the revision has been DOT approved, no further changes can be made. |
| Pending FHWA/FTA Submittal (Status) | Indicates that the revision is pending submittal to FHWA/FTA for their approval. In this state, the "Submit for Approval" button leads the user to a pop-up to configure the information being sent to FHWA/FTA for approval. Once "Submit" is selected in the pop-up, the revision is locked from further changes from users other than FHWA/FTA. |
| Pending FHWA/FTA Approval (Status) |
Indicates that the revision is pending approval by FHWA and/or FTA. There are two actions that can be taken during this period:
|
| FHWA/FTA Approved (Status) | Indicates that the revision has been fully approved by FHWA and FTA. Then, the privileged user (System Admin. security role or Revisions permission) can select the "Close Revision" button to close the revision and move it to the History tab. Technical Corrections and Administrative Modifications will also be included in this revision for reporting purposes. |
Individual items can be withdrawn in the "Action" picklist at any point in the process. When an amendment is withdrawn, it is removed from the Revisions tab and placed back on the Pre-Approved tab.
Submit to FHWA/FTA
When the revision has a status of "Pending FHWA/FTA Submittal" and the "Submit for Approval" button is selected, a pop-up mirroring the format of an email will appear on the user's screen. This tool is used to configure the information being sent to FHWA/FTA for approval. There are five available fields and two available buttons on this pop-up; the editability of the controls are indicated in the table below.
| Field/Control | Description |
| Send Message To | A read-only list of the email addresses of FHWA/FTA personnel responsible for approving the request. The values listed here are configurable in Configuration Settings, Config Values ("FHWA Email" and "FTA Email"); multiple email addresses can be added in a comma-separated list. |
| CC | Editable text field that can be used to enter one or more email addresses to which the report will be sent for reference only. Multiple email addresses must be separated by commas. Once a comma is used, the formerly entered email will be solidified in a pill shape, and more email addresses can be entered. |
| Subject | Message subject that is automatically populated based on the STIP Window and Revision Number; read-only in the pop-up. |
| Message | A pre-populated but editable text field that contains the email message to be sent. Template can be edited in Configuration Settings, Config Values ("Federal Email Template"). |
| Attachments | Section contains a "Select Files" button which opens the user's File Explorer for them to locate and add relevant attachments to the message. |
| Preview Message (button) | Button navigates the user to a PDF that hosts the Revision Summary and Fiscal Constraint Analysis related to the revision. If the Revision contains changes initiating from a TIP Manager instance, the MPO certification letters will also be included here. |
| Submit (button) | Button sends the configured email message to the distribution list provided on the form. Includes a PDF attachment (Revision Summary, Fiscal Constraint Analysis, and MPO certification letters (if applicable)) and any additional PDF files appended after. |
The user can then select the "Submit" button to send the message to the specified recipients ("Send Message To" and "CC" fields). Then, the revision will be locked from further changes from users other than FHWA/FTA.
Comments
0 comments
Please sign in to leave a comment.