Configure Adopt-A-Stop

In this topic, you will learn how to configure the Adopt-A-Stop solution to meet specific needs in your organization.

Publish the Adopt-A-Stop app

The Adopt-A-Stop solution includes an ArcGIS Pro project used to publish the Adopt-A-Stop app. When you are ready to publish the app, a series of tasks are included to help you get started.

Getting started

  1. Start the ArcGIS Pro application and open the Adopt-A-Stop project.
  2. On the View tab, in the Windows group, click Catalog Pane.
  3. In the Catalog pane, expand the Tasks folder, and double-click on the Adopt-A-Stop task item.
  4. In the Tasks pane, expand the Getting to Know Adopt-A-Stop task group.
  5. Review the Understanding Adopt-A-Stop task.

Configure Adopt-A-Stop

  1. In the Tasks pane, expand the Configure Adopt-A-Stop task group.
  2. The Configure Adopt-A-Stop task group contains several tasks that guide you through:
    • Loading your transit stops into the AdoptAStops feature layer deployed with the solution
    • Setting up a user table in ArcGIS Enterprise to store program participants
    • Publishing the authentication geoprocessing webtool
    • Configuring the Adopt-A-Stop app

Contact participants

  1. In the Tasks pane, expand the Contact participants task group.
  2. The Contact participants task group contains tasks help you contact program participants by sending bulk emails or contacting a selection of participants by local or attribute. Follow the task instructions to configure the bulk email model with your SMTP server and contact participants.

Configure the Adopt-A-Stop site

The Adopt-A-Stop solution includes the Adopt-A-Stop ArcGIS Hub site that your organization can configure with your own branding and share information on participating in the adopt-a-stop program with the public.

Update with organizational information

After deploying the Adopt-A-Stop solution, the Adopt-A-Stop site layout only requires a few updates to fit your local context. Consider what information you already have and what you can most easily find. This information can include the following:

  1. Sign in to your ArcGIS organization and browse to the Adopt-A-Stop site.
  2. Open the item page, click Configure App.
  3. Click the edit button edit to open the site editor.
  4. Scroll to the Statistics section listed under the title of the website. The Stops Adopted and Cleaned This Month statistics cards are already linked to the Adopt-A-Stop solution’s AdoptAStops_public feature layer. These stats will automatically update as participants adopt stops and report cleanings using the Adopt-A-Stop app.

    The Volunteers stat is provided in a text card but styled to resemble the Summary Statistics card; this allows you the option to manually enter a statistic of your choice, independent of the solution data. Update the Volunteers stat card with the number of program participants, a metric of your choice, or replace the text card with a Summary Statistics card and connect it to the AdoptAStops_public feature layer in a similar fashion to the other dynamic stat cards.

  5. Update the Volunteers card, hover over the card and click the settings button settings, and then update the text. To add a Summary Statistics card onto the existing row, see Display key metrics section in the Insert charts, tables and metrics topic. Once the card has been added to the row, hover over the existing Volunteers card and click the delete button delete.
  6. Scroll to the Adopt a Stop section, hover over the card and click the settings button settings.
  7. Click the Adopt Stop button and click Edit.
  8. Enter the Adopt-A-Stop app URL published using the Adopt-A-Stop ArcGIS Pro project into the Link Destination text box and click Add Link.
  9. Scroll to the Frequently Asked Questions section, hover over the card and click the settings button settings, and update the questions and answers.
  10. Modify your site’s Footer, on the side panel, click Customize Toggle customize toggle.
  11. Click Footer. A custom footer is already provided, and in most cases needs to be updated with just your Organizations branding, contact information and social media references.
  12. Click the HTML text box.

    HTML window opens.

  13. Make the necessary changes and click Apply.
  14. Click Save.

Deploy related solutions

This site references content from the Transit Outreach solution. To deploy the Transit Outreach solution, click the link below and follow the steps under Deploy now:

Update solution references

This site references to solution deployed in the previous section. To update your site, complete the following steps:

  1. If necessary, sign into your ArcGIS organization and browse to the Adopt-A-Stop site.
  2. Open the item page, click Configure App.
  3. Click the edit button edit to open the site editor.
  4. Scroll to the Report a Problem section, hover over the card and click the settings button settings.
  5. Click on the Submit Report button and click Edit.
  6. Enter the Transit Rider Reporter app URL deployed in the Transit Outreach solution into the Link Destination text box and click Add Link.
  7. Edit phone numbers in the Contact Call Center section or remove if not applicable.
  8. Click Save.

Adopta widget settings

The Adopt-A-Stop app utilizes the Adopta widget with preconfigured settings and actions. Optionally, the Adopta widget’s settings can be modified and expanded to meet your organization's needs. Use the below tables to understand the Adopta widget's configuration settings and capabilities.

Layer and Authentication settings

The Layer and Authentication settings allow you to configure behaviors as well as the look and feel of the user interface.

SettingDescription

Asset nickname field

Field that stores the stop's a nickname.

Login screen message

Message that appears when logging into the application.

Additional signup field

Fields in the UserTable to be displayed in the sign up form in addition to email, for example add first and last name, address, and phone number.

Show asset address

Display reverse geocoded address of stop in details view.

Asset highlight color

Color of selection symbol displayed around the stop symbol when is selected on the map.

Tolerance setting

New stops are created if no asset is found within tolerance.

My asset symbol

Choose a symbol and set the size of user adopted stops.

Actions

The primary actions used for the Adopt-A-Stop app are assign (Adopt) and unassign (Opt out). Additional actions can be configured as needed.

SettingDescription

Assign status settings

Allows you to label the button (Adopt) in the asset detail view and specify additional actions that occur after clicking the assign status button.

Unassigned status settings

Allows you to configure the unassigned label (Abandoned) in the asset detail view and specify additional actions that occur after clicking the unassigned label.

Additional status settings

Allows you add additional actions you want adopter's report on, for example damaged stops.

Primary Status

Displays text and status buttons in the Adopta application, for example Is the stop cleaned?

Before action image

Image that will be displayed before performing an action.

After action image

Image that will be displayed after performing an action.

Messages

The Adopt-A-Stop app displays messages based on user interaction. For example, Thank you for adopting stop name. Messages can be modified or additional messages created according to your organization’s needs.

SettingDescription

Assign

Message displayed when an asset is successfully assigned. Use '${assetTitle}' for example, to display the title of asset in message.

Unassign

Message displayed when an asset is successfully unassigned.

Action

Message displayed when action is successfully completed. Use '${actionName}' for example, to display the name of action in message.

Asset not found

Message displayed when asset is not found.

Asset already assigned

Message displayed when asset is already assigned. Use '${assetTitle}' for example, to display the title of asset in message.

Unable to perform action

Message displayed when action is not successful. Use ${actionName} for example, to display the name of the action message.

Asset creation

Message displayed when creating a new asset. Use ${layerName} for example, to display the name of the layer in message.

Create asset failed

Message displayed when asset creating fails.

User token expired

Message displayed when user token is expired and generated.

Signup/Login success

Message displayed after successful sign up or log in.

Home screen (when logged in)

Message displayed in widgets home screen after user logs into the application.

Cursor tooltip before login

Message displayed when the user hovers over the map with their cursor before logging into the application.

Cursor tooltip after login

Message displayed when the user hovers over the map with their cursor after logging into the application.

Nickname hint

The text displayed in the nickname hint text box.