Configure Adopt-A-Stop—ArcGIS Solutions

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.

Get started

Use the ArcGIS Pro project to familiarize yourself with Adopt-A-Stop.

Sign in to your ArcGIS organization and browse to the Adopt-A-Stop Project Package.
Open the item page and click Download.
Browse to and open the Adopt-A-Stop project.
On the View tab, in the Windows group, click Catalog Pane.
In the Catalog pane, expand the Tasks folder, and double-click the Adopt-A-Stop task.
In the Tasks pane, expand the Getting to Know Adopt-A-Stop task group.
Double-click Understanding Adopt-A-Stop task to review it.

Configure Adopt-A-Stop

Use the ArcGIS Pro project to set up Adopt-A-Stop.

In the Tasks pane, expand the Configure Adopt-A-Stop task group.
Use the Configure Adopt-A-Stop task group to access several tasks that guide you through:
- Load your transit stops into the AdoptAStops feature layer deployed with the solution.
- Set up a user table in ArcGIS Enterprise to store program participants.
- Publish the authentication geoprocessing webtool.
- Configure the Adopt-A-Stop app.

Contact participants

Use the ArcGIS Pro project to configure tools necessary for contacting participants in the Adopt-A-Stop program.

In the Tasks pane, expand the Contact participants task group.
The Contact participants task group contains tasks to 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. This site can be configured with your organization's branding and used to share information about the Adopt-A-Stop program with the public.

Update with organizational information

After deploying the Adopt-A-Stop solution, the Adopt-A-Stop Hub site layout only requires a few updates to fit your local context.

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

Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Stop site.
From the item page, click Configure.
Scroll to the statistics section under the Hub site title.
The Stops Adopted and Cleaned This Month summary statistic cards are already linked to the Adopt-A-Stop solution’s AdoptAStops_public feature layer. These statistics automatically update as participants adopt stops and report cleanings using the Adopt-A-Stop app.
The Volunteers statistic is provided in a text card styled to resemble the summary statistic cards, but you can manually enter a statistic of your choice, independent of the solution data. You can update the Volunteers text card with the number of program participants, a metric of your choice, or you can 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 statistics cards.
To update the Volunteers card, hover over the card, click the edit pencil , and update the text.
Note:
To add a summary statistics card to the existing row, see Display key metrics. Then, after the card has been added to the row, hover over the existing Volunteers card and click the delete button .
Scroll to the Adopt a Stop section, hover over the card, and click the edit pencil.
Click the Adopt Stop button and click the Edit button.
Type 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.
Tip:
Browse to the Adopt-A-Stop app. Open the item page, click View Application, and copy the app URL.
Scroll to any additional sections that you want to update, hover over the card, and click the edit pencil that appears in the horizontal toolbar, and then edit the content with information specific to your organization.
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.
Click the HTML text box.
The HTML window appears.
Make the necessary changes and click Apply.
Click Save.
Click the Save drop-down arrow and click Publish Draft.

Share items with the public

Several layer views, maps and apps included in the Adopt-A-Stop solution must be shared with everyone so they can be accessed by the public on the Adopt-A-Stop site.

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

Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Stop folder.

Next to each of the following items, check the check box:


Name	Item type
AdoptAStops_public	Feature layer (hosted, view)
Adopt-A-Stop	Web Map
Adopt-A-Stop	Web Mapping Application
Adopt-A-Stop	Site Application

Click Share.
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.
Click Update.

Deploy a related solution

This site references content from the Transit Outreach solution. To deploy the Transit Outreach solution, follow the steps in the Deploy an ArcGIS solution section.

Update solution references

After you have deployed the Transit Outreach solution, you can access Transit Outreach items from the Adopt-A-Stop site.

To update your site with an item from Transit Outreach, complete the following steps:

Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Stop site.
From the item page, click Configure.
Scroll to the Report a Problem section, hover over the Submit a Report card, and click the edit pencil .
Click Submit Report and click the Edit button.
In a separate browser tab or window opened to your ArcGIS organization, browse to the Transit Outreach folder and open the Transit Rider Reporter form item page.
Click Open in Survey123 and choose Open in browser, and then copy the URL.
In the Adopt-A-Stop site, paste the Transit Rider Reporter form URL into the Link Destination text box and click Add Link.
Hover over the Contact Call Center text card and click the edit pencil.
Edit the text with information applicable to your organization.
Click Save.
Click the Save drop-down arrow and click Publish Draft.

Share other solution items with the public

Several layer views, maps and apps included in the Transit Outreach solution must be shared with everyone so they can be accessed by the public on the Adopt-A-Stop site.

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

Verify that you are signed in to your ArcGIS organization and browse to the Transit Outreach folder.
Next to each of the following items, check the check box:
Name Item

TransitRiderReports_public

Feature layer (hosted, view)

Transit Rider Reporter

Form
Click Share.
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.
Click Update.

Name	Item
TransitRiderReports_public	Feature layer (hosted, view)
Transit Rider Reporter	Form

Adopta widget settings

The Adopt-A-Stop app uses the Adopta widget with preconfigured settings and actions. Optionally, you can modify and expand the Adopta widget’s settings to meet your organization's needs. Use the tables below 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.


Setting	Description
Asset nickname field	Field that stores the stop's nickname.
Login screen message	Message that appears when signing in to 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 the reverse geocoded address of a stop in the details view.
Asset highlight color	Color of selection symbol displayed around the stop symbol when it is selected on the map.
Tolerance setting	New stops are created if no asset is found within the 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). You can configure additional actions as needed.


Setting	Description
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 adopters to 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 is displayed before performing an action.
After action image	Image that is 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. You can modify the messages or create additional messages according to your organization’s needs.


Setting	Description
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 an 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 pointer before logging in to the application.
Cursor tooltip after login	Message displayed when the user hovers over the map with their pointer after logging in to the application.
Nickname hint	The text displayed in the nickname hint text box.

Feedback on this topic?