Learn how to configure the Adopt-A-Catch Basin solution to meet specific needs in your organization.
Publish the Adopt-A-Catch Basin app
The Adopt-A-Catch Basin solution includes an ArcGIS Pro project used to publish the Adopt-A-Catch Basin app. When you are ready to publish the app, a series of tasks is included to help you get started.
Get started
Use the ArcGIS Pro project to familiarize yourself with Adopt-A-Catch Basin.
- Sign in to your ArcGIS organization and browse to the Adopt-A-Catch Basin Project Package.
- Open the item page and click Download.
- Browse to and open the Adopt-A-Catch Basin 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-Catch Basin task.
- In the Tasks pane, expand the Getting to Know Adopt-A-Catch Basin task group.
- Double-click Understanding Adopt-A-Catch Basin task to review it.
Configure Adopt-A-Catch Basin
Use the ArcGIS Pro project to set up Adopt-A-Catch Basin.
- In the Tasks pane, expand the Configure Adopt-A-Catch Basin task group.
- Use the Configure Adopt-A-Catch Basin task group to access several tasks that guide you through:
- Load your catch basins into the CatchBasin 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-Catch Basin app.
Contact participants
Use the ArcGIS Pro project to configure tools necessary for contacting participants in the Adopt-A-Catch Basin program.
- In the Tasks pane, expand the Contact participants task group.
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-Catch Basin site
The Adopt-A-Catch Basin solution includes the Adopt-A-Catch Basin ArcGIS Hub site that your organization can configure with your branding and can use to share information about participating in the Adopt-A-Catch Basin program with the public.
Update with organizational information
After deploying the Adopt-A-Catch Basin solution, the Adopt-A-Catch Basin 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:
- Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Catch Basin site.
- Open the item page and click Configure App.
- Click the edit button
to open the site editor. - Scroll to the Statistics section listed under the title of the website.
The Catch Basins Adopted, Cleaned This Month, and Clogged Catch Basins statistics cards are already linked to the Adopt-A-Catch Basin solution’s CatchBasins_public feature layer. These stats automatically update as participants adopt catch basins and report cleanings and issues using the Adopt-A-Catch Basin app.
- Scroll to the Adopt a Catch Basin section, hover over the card and click edit pencil
. - Click the Adopt Catch Basin button and click Edit.
- Enter the Adopt-A-Catch Basin app published using the Adopt-A-Basin ArcGIS Pro project URL into the Link Destination text box and click Add Link button.
Tip:
Browse to the Adopt-A-Catch Basin app. Open the item page, click View Application, and copy the app URL.
- Scroll to the Frequently Asked Questions section, hover over the card and click the edit pencil, and update the questions and answers.
- Scroll to the Stormwater Data section, hover over the card and click the edit pencil, and in the site editor under Data update the category links using tags, categories, or groups that reference your open data.
- To modify your site’s footer, click Customize Toggle
on the side panel. - Click Footer.
A custom footer is already provided, and in most cases, it needs to be updated 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.
Share items with the public
Several layer views, maps and apps included in the Adopt-A-Catch Basin solution must be shared with everyone so they can be accessed by the public on the Adopt-A-Catch Basin site. To share your adopt-a-catch basin items with everyone, use the guide below and complete the following steps:
- Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Catch Basin folder.
- Check the check box next to each of the items below:
Item Name Feature Layer (hosted, view)
CatchBasins_public
Web Map
Adopt-A-Catch Basin
Web Mapping Application
Adopt-A-Catch Basin
Site Application
Adopt-A-Catch Basin
- 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 related solutions
This site references content from the Citizen Problem Reporter solution. To deploy the Citizen Problem Reporter solution, follow the steps in the Deploy an ArcGIS Solutions section.
Update solution references
This site references a solution deployed in the previous section. To update your site, complete the following steps:
- Verify that you are signed in to your ArcGIS organization and browse to the Adopt-A-Catch Basin site.
- Open the item page and click Configure App.
- Click the edit button to open the site editor.
- Scroll to the Report a Problem section.
- Hover over the Submit Report card and click edit pencil .
- Click on the Submit Report button and click Edit.
- Enter the Citizen Problem Reporter app URL in the Link Destination text box and click Add Link button.
Tip:
Browse to the Citizen Problem Reporter app. Open the item page, click View Application, and copy the app URL.
- Hover over the Contact Call Center card, click the edit pencil and edit the phone numbers in the card or remove if not applicable.
- Click Save.
Share items with the public
Several layer views, maps and apps included in the Citizen Problem Reporter solution must be shared with everyone so they can be accessed by the public on the Adopt-A-Catch Basin site. To share your citizen problem reporter items with everyone, use the guide below and complete the following steps:
- Verify that you are signed in to your ArcGIS organization and browse to the Citizen Problem Reporter folder.
- Check the check box next to each of the items below:
Item Name Feature Layer (hosted, view)
CitizenProblems_health
Feature Layer (hosted, view)
CitizenProblems_utility
Feature Layer (hosted, view)
CitizenProblems_blight
Feature Layer (hosted, view)
CitizenProblems_road
Feature Layer (hosted, view)
CitizenProblems_animal
Feature Layer (hosted, view)
CitizenProblems_parktree
Feature Layer (hosted, view)
CitizenProblems_trash
Feature Layer (hosted, view)
CitizenProblems_landuse
Feature Layer (hosted, view)
CitizenProblems_snowice
Web Map
Health Problems
Web Map
Water / Sewer Problems
Web Map
Blight Problems
Web Map
Road Problems
Web Map
Animal Problems
Web Map
Park / Tree Problems
Web Map
Trash Problems
Web Map
Land Use Problems
Web Map
Snow / Ice Problems
Web Mapping Application
Citizen Problem Reporter
- 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.
Adopta widget settings
The Adopt-A-Catch Basin 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 catch basin's nickname. |
Login screen message | Message that appears when signing 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 the reverse geocoded address of a catch basin in the details view. |
Asset highlight color | Color of selection symbol displayed around the catch basin symbol when it is selected on the map. |
Tolerance setting | New catch basins are created if no asset is found within the tolerance. |
My asset symbol | Choose a symbol and set the size of user-adopted catch basins. |
Actions
The primary actions used for the Adopt-A-Catch Basin 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, a damaged catch basins. |
Primary Status | Displays text and status buttons in the Adopta application—for example, Is the catch basin 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-Catch Basin app displays messages based on user interaction—for example, Thank you for adopting catch basin name. You can modify 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 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 in to the application. |
Cursor tooltip before login | Message displayed when the user hovers over the map with their pointer before signing in to the application. |
Cursor tooltip after login | Message displayed when the user hovers over the map with their pointer after signing in to the application. |
Nickname hint | The text displayed in the nickname hint text box. |