Back to Top

Configure Adopt-A-Stop

In this topic

  1. Load data
  2. Configure the Adopt-A-Stop site
  3. Schedule Stop Volunteer Notebook
  4. Update approved volunteer email message
  5. Add team question to volunteer application

Adopt-A-Stop can be used to operate stop adoption programs that allow volunteers to adopt transit stops and clean them for the community.

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

Tip:
As you configure the solution, record the configurations or alterations you make with each version in a change log. This information will be valuable if you upgrade to a new version and need to evaluate the effort required.

Load data

The Adopt-A-Stop solution includes the AdoptAStop feature layer used to store your used to store stops, volunteers, and cleaning activities. Before using the solution you must load your transit stops into the AdoptAStop feature layer and update each stop's adoption status and public view settings for stops that are meant to be adopted by the public.

Load stops from a shapefile or file geodatabase

To load stops 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 AdoptAStop feature layer.
  3. From the item page, click Update data.
    Tip:

    You may need to click the Show more button Show more to see all options.

  4. Follow the steps in the Update data wizard to load your data.
    5. Tip:

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

Update stop attributes

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

To update the Adoption Status and Publicly Visible fields, complete the following steps:

  1. Verify that you are signed in to your ArcGIS organization and browse to the AdoptAStop feature layer.
  2. From the item page, click the Data tab.
  3. Scroll to the Adoption Status column.
    Note:

    The Adoption Status field may be hidden. To show attribute fields, click the Column Visibility button at the top of the table. Check boxes to show attribute columns.

  4. Click the Options button Options in the header of the column and click Calculate.

    Calculated values will be written to the rows in this field.

  5. For Select Language, choose SQL.
  6. Optionally, click Add new in the Define filter panel to filter which values will be updated in the field when you run the calculation.

    Filters allow you to restrict which rows are updated when you calculate. The filter can be based on values in another field or values in the field to update. You can apply more than one filter.

  7. Click Next to proceed with defining an expression.
  8. Enter the following expression: 'Available'
  9. Click Run calculation.
  10. Click Do another calculation.
  11. Scroll to the Publicly Visible column.
  12. Click the Options button Options in the header of the column and click Calculate.

    Calculated values will be written to the rows in this field.

  13. For Select Language, choose SQL.
  14. Optionally, click Add new in the Define filter panel to filter which values will be updated in the field when you run the calculation.
  15. Click Next to proceed with defining an expression.
  16. Enter the following expression: 'Yes'
  17. Click Run calculation.

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 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-Stop site.
  2. From the item page, click Edit in Hub.
    Note:

    If you see the Welcome to workspaces splash screen, click Use workspaces. Then, if necessary, click Edit layout.

  3. Scroll to any sections that you want to update, hover over the card, and click the edit button 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 box.

    The HTML window appears.

  6. Make the necessary changes and click Apply.
  7. Click Save layout.
  8. Click Publish layout.

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:

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

    NameItem type

    AdoptAStop_public

    Feature layer (hosted, view)

    TransitRiderReports_public

    Feature layer (hosted, view)

    Stop Viewer

    Web Map

    Stop Viewer

    Instant App

    Transit Rider Reporter

    Form

    Adopt-A-Stop

    Hub Site Application
  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-Stop solution is used to cultivate a volunteer workforce to clean adopted stops in your community.

To apply to the Adopt-A-Stop volunteer program, a user must have a community user account and be signed in to the Adopt-A-Stop site. To grant access to the Stop Volunteer Application form, share the form and the AdoptAStop_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 Stop Volunteer Application form.

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

    NameItem type

    Stop Volunteer Application

    Form

    AdoptAStop_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.
    6. 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 Apply and click Save.

Schedule Stop Volunteer Notebook

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

Follow the steps below to schedule the Stop 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 Stop Volunteer Notebook item.
  2. Open the item page and click Open Notebook.
  3. Click Tasks.
  4. Click Create Task.
  5. For Title, type Adopta-A-Stop Task and click Next.
  6. 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.
  7. Select a Time value for the task to run at 3 a.m.
  8. Click Create Task to finish scheduling the notebook.

Update approved volunteer email message

Newly approved volunteers will receive an email with instructions on how to adopt stops in their community as well as general guidance about the activities they can perform when cleaning a stop. 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 Stop 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

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

Follow the steps below to configure theStop 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 Stop Volunteer Application to download the survey.
  4. In the Download window, click Download and click OK.
  5. Click Stop 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 AdoptAStop_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/1?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 Stop Volunteer 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.

Feedback on this topic?

In this topic
  1. Load data
  2. Configure the Adopt-A-Stop site
  3. Schedule Stop Volunteer Notebook
  4. Update approved volunteer email message
  5. Add team question to volunteer application