Configure Adopt-A-Hydrant

Adopt-A-Hydrant can be used to operate hydrant adoption programs that allow volunteers to adopt hydrants and keep them free from obstructions like snow or vegetation.

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

Load data

To start using the solution you will first need load your hydrant data. The Adopt-A-Hydrant solution is built on the same foundational feature layer, WaterDistributionSystem, as the Water Distribution Data Management solution. If you have also deployed the Water Distribution Data Management solution, you can use that solution to manage hydrants and other water distribution assets. As a shared service between the two solutions, the Fire Hydrant layer within the WaterDistributionSystem feature service is used by the Adopt-A-Hydrant solution for public asset adoption.

If you are using another system for managing hydrant assets and want to use the Adopt-A-Hydrant solution for public asset adoption, you must load hydrant assets into the WaterDistributionSystem feature layer. You must also update every hydrant's adoption status and public view settings for assets that are meant to be adopted by the public.

Load data from a shapefile or file geodatabase

To load data from a shapefile or file geodatabase, complete the following steps:

1. Create a .zip file of your shapefile or file geodatabase.
2. Sign in to your ArcGIS organization and browse to the WaterDistributionSystem feature layer.
3. From the item page, select the Fire Hydrant sublayer.
4. From the item page, click Update Data.
5. Follow the steps in the Update data wizard to load your data.

   Tip:

   For more information about uploading data, see Manage hosted feature layers—Append data to layers.

Update hydrant attributes

The WaterDistributionSystem feature layer contains three feature layer views used by various apps in the solution to display different hydrants based on their adoption status, public visibility, the identity of the adoptee, and any recent activity completed by volunteers on adopted hydrants. The following steps describe how to set initial, default values for adoption status and public visibility for all of your hydrants prior to sharing the solution with the public.

To update the Adoption Status and Public View fields, complete the following steps:

1. Verify that you are signed in to your ArcGIS organization and browse to the WaterDistributionSystem feature layer.
2. From the item page, select the FireHydrant sublayer.
3. Open the item page and click the Data tab.
4. Click the Adoption Status column.
5. Click Calculate.
6. On the Calculate Field dialog box, choose SQL.
7. Enter the following expression: 'Available'.
8. Click Calculate.
9. Click Close.

   Note:

   Refresh the page to see the updated values in the table.

10. Click the Public View column.
11. Click Calculate.
12. On the Calculate Field dialog box, choose SQL.
13. Enter the following expression: 'Yes'.
14. Click Calculate.
15. Click Close.

    Note:

    Refresh the page to see the updated values in the table.

Configure the Adopt-A-Hydrant site

The Adopt-A-Hydrant solution includes the Adopt-A-Hydrant ArcGIS Hub site. This site can be configured with your organization's branding and used to share information about the Adopt-A-Hydrant program with the public.

Update with organizational information

After deploying the Adopt-A-Hydrant solution, the Adopt-A-Hydrant 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 Adopt-A-Hydrant 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 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 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 Adopt-A-Hydrant solution must be shared with everyone so they can be accessed by the public on the Adopt-A-Hydrant site.

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

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

   Name	Item type
   Hydrants_public	Feature layer (hosted, view)
   HydrantsVolunteers_public	Feature layer (hosted, view)
   Fire Hydrant Viewer	Web Map
   Fire Hydrant Viewer	Instant App
   Adopt-A-Hydrant	Hub Site Application
   Adopt-A-Hydrant	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.

Share the volunteer application form with the Hub community group

The Adopt-A-Hydrant solution is used to cultivate a volunteer workforce to clear adopted hydrants in your community.

To apply to the Adopt-A-Hydrant volunteer program, a user must have a community user account and be signed in to the Adopt-A-Hydrant site. To grant access to the Fire Hydrant Volunteer Application form, share the form and the HydrantVolunteers_submit feature layer to the Hub Community Members group. This group is automatically created during Hub Premium activation and contains all members of your community organization. As new community members join, they will be automatically added to this group and will have access to the Fire Hydrant Volunteer Application form.

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

   Name	Item type
   Fire Hydrant Volunteer Application	Form
   HydrantVolunteers_submit	Feature layer (hosted, view)

3. Click Share.
4. In the Share window, click Edit group sharing.
5. Check the Hub Community Members group check box.

Note:

The Hub Community Members group will only be available to users who were administrators of the organization when Hub Premium was activated. If you don’t see this group, work with the Hub Community organization administrator to get access to this group.

6. Click OK and click Save.

Schedule Fire Hydrant Volunteer Notebook

Volunteer coordinators use the Adopt-A-Hydrant site's Manage Program page to approve volunteers. The Fire Hydrant Volunteer Notebook grants volunteers access to the program and sends an email welcoming volunteers to the program.

Follow the steps below to schedule the Fire Hydrant Volunteer Notebook to run as a scheduled task.

Note:

You must be assigned a role of Administrator or custom role that includes the privilege to create, edit, and schedule notebooks to run and schedule ArcGIS Notebooks notebooks and complete the following steps.

1. Verify that you are signed in to your ArcGIS organization and browse to the Fire Hydrant Volunteer Notebook item.
2. Click the Tasks tab.
3. Click Create Task.
4. For Title, type Adopt-A-Hydrant Task and click Next.
5. Configure the task to run nightly by selecting Day from the Repeat Type drop-down menu and selecting 1 - Every Day from the Repeat Interval drop-down menu.
6. Select a Time value for the task to run at 3 a.m.
7. Click Create to finish scheduling the notebook.

Update approved volunteer email message

Note:

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

Newly approved volunteers will receive an email with instructions on how to adopt hydrants in their community as well as general guidance about the activities they can perform when clearing a hydrant. Your organization may want to update this message to include contact information or other links related to your organization.

Optionally, complete the following steps to update the message your volunteers will receive when they are approved for the program.

1. Verify that you are signed in to your ArcGIS organization and browse to the Approved Hydrant Volunteers group.
2. On the Overview tab, the group Description section contains a message sent to newly approved volunteers.
3. Optionally, click Edit in the Description section to modify the message to your organization's needs. When you are finished, click Save.

Add team question to volunteer application

Note:

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

The Adopt-A-Hydrant Dashboard solution can be configured to support teams of volunteers, enabling volunteers to track their collective efforts through their team.

Optionally, complete the following steps to below to configure the Fire Hydrant Volunteer Application form to allow approved volunteers to join a team.

1. Install ArcGIS Survey123 Connect.
2. Start ArcGIS Survey123 Connect and sign in to your ArcGIS organization.
3. Click Fire Hydrant Volunteer Application to download the survey.
4. In the Download window, click Download and click OK.
5. Click Fire Hydrant Volunteer Application to open the survey.
6. On the left, from the side toolbar, click the XLSForm button.
7. In the Microsoft Excel spreadsheet, click the survey tab if not already active.
8. In the appearance column for the team_existing question (cell F17), replace the URL with the feature service URL of the HydrantsVolunteers_public feature layer, Volunteers layer, that was deployed with the solution.

   Ensure the URL inserted references the feature layer index of the Volunteers layer, and the URL's WHERE statement remains intact. The below demonstrates what cell F17 will look like after updating:

   search ("volunteers?url=[your URL]/FeatureServer/0?where=status%3D%27Approved%27")

9. Delete rows 14 and 19 from the spreadsheet.

   These rows referenced a hidden group in the form. By removing these rows, the Hydrant Application form will now display the fields necessary to allow volunteers to join an existing team or create a team.

10. Save and close the Microsoft Excel spreadsheet and preview your changes in ArcGIS Survey123 Connect.
11. Click Publish survey to publish your changes, and then click OK.