Configure Roadway Management

Roadway Management can be used to inventory public roads and their characteristics, conduct routine pavement condition assessments, and streamline inspection and maintenance activities.

In this topic, you'll learn how to configure the Roadway Management solution to meet specific needs of your organization.

Organize your data

Before an organization can effectively manage and assess the quality of their roadway assets, agencies must create an accurate inventory of the location and characteristics essential to the care and maintenance of those assets. To help organizations with this important task, the Roadway Management solution includes a collection of feature layers to store and visualize roadway asset information:

Feature layerDescription

RoadCharacteristics

A feature layer used to store and display roads, road maintenance activities and agreements, and road characteristics such as speed limit, construction history, and functional road classification

PavementMarkings

A feature layer used to store pavement markings and related inspection and maintenance activities

Guardrails

A feature layer used to store guardrails and related inspection and maintenance activities

TrafficCalmingDevices

A feature layer used to store traffic calming devices

PavementAssessments

A feature layer used to store and display pavement assessment results, distress observations, PCI survey units, and pavement rating history

Configure the service request form

The Roadway Management solution includes the Road Request form that can be used by the general public to submit nonemergency road-related problems or requests for service in their community.

This form can be updated to include different types of road issues that can be reported, the terms of your organization's service levels, and whether you will require public road complaints to be reported within a certain distance of the roads your organization maintains.

Modify request types, descriptions, and service level agreement terms

A well-defined list of road request types makes it easy for the public to report issues to your organization and for your organization to communicate service level agreements (SLA). These SLAs ensure that citizens understand what to expect when they submit a request for service, including how long it will take for the organization to respond to certain types of requests.

To update the types of roadway-related issues that can be reported in your community, complete the following steps:

  1. Sign in to your ArcGIS organization and browse to the Road Request Types.csv file.
  2. From the item page. click Download.
  3. Open the Road Request Types.csv file.
    Tip:

    The source_field column defines whether the values apply to the request type field (feature layer field: reqtype) or to the service level agreement and description fields (feature layer fields: sla and description). For request types, the name column defines the value that is written to the feature, and the label column defines the value shown in the app drop-down menu.

    For service level agreements and descriptions, the name column defines the request category (for example, Road), followed by a hyphen (-) and the name of the request type. The label column defines the values used for the request type's description, and the sla column defines the values for the service level agreement text.

  4. Add, remove, or modify the road request types, descriptions, and service level agreement text.
  5. On the Road Request Types item page, click Upload, browse to your modified .csv file, and click Update Item.

Enable road request constraints

Note:
This workflow is optional and doesn't need to be completed in order to work with the solution.

Using location-based constraints in the Road Request Survey123 form helps ensure that service requests contain accurate location information upon submission, requests are sent to the correct jurisdiction, and responsible agencies can effectively locate and address requests for service.

Organizations can restrict public service requests from being submitted based on a minimum distance the report's location is from the roads the organization maintains. If an attempt is made to report an issue outside the given distance, a helpful message will appear and the requestor will be unable to submit a request until the report's location is updated.

To enable road request constraints, complete the following steps:

  1. Install ArcGIS Survey123 Connect.
  2. Start ArcGIS Survey123 Connect and sign in to your ArcGIS organization.
  3. Click Road Request to download the form.
  4. In the Download window, click Download and click OK.
  5. Click Road Request again to open the form.
  6. At the bottom of the Microsoft Excel spreadsheet, click the survey tab.

    This tab comprises all the questions in the survey.

  7. In the default column for the hidden url question (cell J9), replace the URL with the feature service URL of the RoadCharacteristics_public feature layer deployed with the solution.

    The URL inserted must reference the feature layer index of the Road Segments layer (index 3), and the URL's distance statement must remain intact. By default, the distance used is 200 feet.

  8. Update the distance value to meet the needs of your organization. The following line shows what cell J9 will look like after you have updated it:

    [your URL]/FeatureServer/3?distance=200&units=esriSRUnit_Foot

  9. In the appearance column for the checklocation note, delete the hidden value from the cell (cell F12), so that no value remains.
  10. Save and close the Microsoft Excel spreadsheet and preview your changes in ArcGIS Survey123 Connect.
  11. In ArcGIS Survey123 Connect, in the left toolbar, click Publish to publish your changes.
  12. Click Publish survey to publish your changes, and then click OK.

Administer field assignments

The Roadway Management solution can be used to manage work such as data collection, inspections, and maintenance assigned to mobile workers. Assignment types appear in the Road Assignments ArcGIS Workforce mobile app used by mobile workers as well as the Road Assignments ArcGIS Workforce dispatcher view in the Roadway Management Center app.

The Roadway Management solution includes several assignment types. In some cases, you may want to modify assignment types to meet your organization's needs. Mobile workers and dispatchers also need to be given roles in the Road Assignments ArcGIS Workforce project.

To administer field assignments, complete the following steps:

  1. Verify that you are signed in to your ArcGIS organization and click the Apps button Apps button in the header of the site.
  2. From the app launcher, click Workforce to open the app.
  3. Under Projects, hover over the Road Assignments project and click Configure.
  4. Click the Assignment Types tab.
  5. In the Assignment Type section, review existing types and identify ones that are not applicable and ones that are missing.
  6. In the Enter a new type text box, type a new assignment type, and then click +Type.
  7. Click the Users tab.
  8. From the Organization User drop-down menu, select a user to add to the project.
  9. From the Project Role menu, assign the user either the dispatcher role or mobile worker role.
  10. Click +User.
  11. Click the Advanced tab.

    Each assignment type is integrated into the Roadway Field Map, which allows field staff to access the Roadway Field Map from the ArcGIS Workforce app. As you add new assignment types, you may want to add the Roadway Field Map integration.

  12. In the ArcGIS Field Maps integration list, click Edit on any of the existing Roadway Field Map integrations.
  13. Check the box next to the new assignment type, and click Next.
  14. Click Done.
  15. Optionally, remove the ArcGIS Field Maps integration for assignment types that are not needed in your organization.

    Removing the integration is necessary to remove the assignment type from the Road Assignments ArcGIS Workforce project.

  16. Click the Assignment Types tab.
  17. To remove assignment types, click the X button.

Configure the Quality Roads site

The Roadway Management solution includes the Quality Roads ArcGIS Hub site. This site can be configured with your organization's branding and used to share pavement condition ratings, paving plans, and to solicit requests for service related to issues in the roadway.

Update with organizational information

After deploying the Roadway Management solution, the Quality Roads Hub site layout requires a few updates to fit your local context.

To update the site with your organizational information, complete the following steps:

  1. Verify that you are signed in to your ArcGIS organization and browse to the Quality Roads site.
  2. From the item page, click Configure.
  3. Scroll to any sections that you want to update, hover over the card, and click the edit pencil Edit that appears in the horizontal toolbar, and then edit the content with information specific to your organization.
  4. In the side panel, click Footer.

    A custom footer is provided. In most cases, you will need to update it with your organization's branding, contact information, and social media references.

  5. Click the HTML text box.

    The HTML window appears.

  6. Make the necessary changes and click Apply.
  7. Click Save.
  8. Click the Save drop-down arrow and click Publish Draft.

Share items with the public

Several layer views, maps, and apps included in the Roadway Management solution must be shared with everyone so they can be accessed by the public on the Quality Roads site.

To share these items with the public, complete the following steps:

  1. Verify that you are signed in to your ArcGIS organization and browse to the Roadway Management folder.
  2. Next to each of the following items, check the check box:

    NameItem type
    Road Request

    Form

    Requests_submit

    Feature layer (hosted, view)

    Road Request Types

    CSV

    Current Pavement Ratings

    Dashboard

    Current Pavement Ratings (mobile)

    Dashboard

    Current Pavement Ratings

    Web Map

    LatestRoadRatings

    Feature layer (hosted, view)

    RoadCharacteristics_public

    Feature layer (hosted, view)

    PavementAssessments_public

    Feature layer (hosted, view)

    Quality Roads

    Site Application

    Roadway Management

    Hub Initiative

  3. Click Share.
  4. In the Share window, click Everyone (public) and click Save.

    The Warning: Sharing editable layers publicly message appears notifying you that you are sharing editable layers publicly.

  5. Click Update.

Load pavement condition assessments

Note:
This workflow is optional and doesn't need to be completed in order to work with the solution.

The solution contains a series of info products to help you conduct pavement assessments through the use of the Rapid Pavement Assessment ArcGIS QuickCapture project and the Pavement Condition Inspections ArcGIS Survey123 form. However, your organization may have existing pavement assessment results that they would like to store and display in the solution's info products, such as the Current Pavement Ratings dashboard in the Quality Roads Hub site or the Pavement Assessment Dashboard in the Roadway Management Center.

External pavement assessment results must contain a field containing the same values as the assetid field in the Road Segments layer. The hosted feature layer view used to visualize current pavement ratings, LatestRoadRatings, is the result of a join-view between the Rating History table and the Road Segments layer.

To load external pavement condition assessments, complete the following steps:

  1. Sign in to your ArcGIS organization and browse to the PavementAssessments feature layer.
  2. From the item page, under Tables, click the Rating History table.
  3. From the Overview page, click Append Data to Layer.
  4. Select the file containing the external pavement assessment results.
  5. Click Upload and Continue.
  6. Uncheck Update existing features.
  7. Click Show field matching to map the fields from the file to the fields in the layer.

    Note:
    The field mapped to the roadassetid must match existing values in the Road Segments layer's field assetid.

  8. Click Apply Updates.