Configure Electric Joint Use

Electric Joint Use can be used to manage utility pole joint use and streamline the joint use permitting process.

In this topic, you'll learn how to configure the Electric Joint Use solution to meet specific needs of your organization.

Load data

This solution deploys with the ElectricDistributionSystem feature layer from the Electric Distribution Data Management solution. If you are utilizing the Electric Joint Use solution independently from the Electric Distribution Data Management solution, load data into the Pole (Medium Voltage) layer.

Use Data Loading Tools

The Data Loading toolbox can be used in ArcGIS Pro to streamline loading data from a source to a target dataset and provide the ability to perform in-process data transformation. Setup the Data Loading toolbox before getting started with the steps below.

1. Start ArcGIS Pro and click Settings .
2. In the list of tabs on the left, click Package Manager.
3. In the upper right corner, click the Environment Manager button.
4. Click the Clone environment button on the row representing the environment you want to clone. Alternatively, click the Clone arcgispro-py3 button to clone the default environment.

   The Clone Environment dialog box appears.

5. Select your newly cloned environment and click OK.

   Cloning an environment may take several minutes. You can close the Clone Environment dialog box while you wait. You can monitor progress in the Tasks section of the Package Manager page.

6. In the Python Package Manager, click Add Packages to see the Python packages available for installation.
7. In the Search box, type dltsolutions to find the Data Loading toolbox.
8. Select the dltsolutions package and click the drop-down arrow to update the version.
9. Click Install to open the Install Package dialog box.
10. Review the terms and conditions and check the check box to agree.
11. Click Install to install the package.
12. Once complete, close ArcGIS Pro.

    The Data Loading toolbox is now installed. The next time you start ArcGIS Pro, you can access it from the list of geoprocessing toolboxes.

13. Review An overview of the Data Loading toolbox to learn more about the tools and how to use them to load data into the ElectricDistributionSystem layers.

Clone hub site for each attaching company

Create an ArcGIS Hub page for each attaching company to respond to joint use issues and submit joint use requests.

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 and complete the following steps.

To create an ArcGIS Hub site page for each attaching company, complete the following steps:

1. Verify that you are signed in to your ArcGIS organization and browse to the Create Joint Use Owner Content notebook.
2. Click Open Notebook.
3. Click Cell and select Run All from the drop-down list.
4. Click the Import Domain button.
5. In the Company Name drop-down list, select an attaching company. For example, select AT&T.

   Note:

   If you need more attaching company names added, browse to the Owner field in the Joint Use table of the ElectricDistributionSystem feature layer from the Electric Distribution Data Management solution. This is being used to create content for each owner in this domain.

6. Click the Create Content button.
7. Repeat step 5-6 for all other companies in the Company Name domain.

Add utility employees to groups

Add named users to the four groups included with the Electric Joint Use solution. The groups are designed to help utilities provide secure access to applications based on staff role.

To add utility employees to the appropriate solution groups, complete the following steps:

1. In a browser, sign in to your ArcGIS organization.
   Verify that you have privileges to manage member groups before continuing.
2. At the top of the site, click Groups.
3. Click the name of the group to open the group details pages.
4. On the Settings tab, edit and update the properties of the group, including access, sharing properties, and group ownership.
5. Click the Overview tab and click Invite members.
6. Select the members you want to add and click Add to group.
7. Repeat these steps for each group that you need to add members to.

The provided groups are intended to be utilized by members with a minimum of the following user types in order to fully use the provided maps and apps:

Group name	Description	User type
Electric Joint Use Editors	These users will be using ArcGIS Hub and editing records in the joint use Issue and permit applications.	Editor
Electric Joint Use Field Users	These users will be usingField Maps applications.	Mobile Worker
Joint Use Permit Utility Notification	Users added to this group will be notified of new and updated permits.	Viewer
Joint Use Issue Utility Notification	Users added to this group will be notified of new and updated issues.	Viewer

Add permitting coordinators to Electric Joint Use hub site

The Electric Joint Use solution includes the Electric Joint Use Hub site that permitting coordinators need access to before they can submit joint use requests.

Share Electric Joint Use site

To share the Hub site with your organization, complete the following steps:

1. Verify that you are signed in to your ArcGIS organization and browse to the Electric Joint Use site.
2. Click Share; in the Share window, select Organization; and click Save.

Add users to ArcGIS Hub Basic

To add users to the Electric Joint Use site with Hub Basic, complete the following steps:

1. Verify that you are signed in to your ArcGIS organization.
2. At the top of the site, click Organization and click the Members tab.
3. Click Invite Members.
4. Select Add members and notify them via email and click Next.
5. To add member information, click New member.
   1. Fill in the following fields: First name, Last name, Email Address, and Username.
   2. Click the User Type drop-down list and select the Data Editor user type.
   3. Click the Role drop-down list and select the Editor user type.
   4. Click Next. Or, to add more members, click Next, add another and repeat.
6. In the Groups section, add users to the Joint Use <Attaching Company> Group.

   Note:

   For example, if the attaching company is AT&T, the group is Joint Use AT&T Group.

7. Click Save.
8. Click Next, and click Add members when you are finished.

Add users to ArcGIS Hub Premium

Note:

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

To add users to the Electric Joint Use site with Hub Premium, complete the following steps:

1. Sign in to your ArcGIS organization with the Hub admin credentials.
2. At the top of the site, click Organization and click the Members tab.
3. Click Invite Members.
4. Select Add members and notify them via email and click Next.
5. To add member information, click New member.
   1. Fill in the following fields: First name, Last name, Email Address, and Username.
   2. Click the User Type drop-down list and select the Creator user type.
   3. Click the Role drop-down list and select the Publisher user type.
   4. Click Next. Or, to add more members, click Next, add another and repeat.
6. Click Add members.
7. Sign in to the organization that deployed the solution.
8. Click Groups, and search for the group by typing Joint Use <Attaching Company> Group.

   Note:

   For example, if the attaching company is AT&T the group is Joint Use AT&T Group.

9. Click Settings, scroll down to the Group membership settings, and for the Who can be in this group? setting, check Partnered collaboration and my organization's members only.
10. Click the Overview tab, and click Invite users.
11. Turn the Include this and partnered organizations' members setting on.
12. Turn the Collaboration coordinators only setting off.
13. Select the users to add and click the Invite users button.

Configure Electric Joint Use site

The Electric Joint Use solution includes the Electric Joint Use ArcGIS Hub site that your organization can configure with your branding and can use to share information about participating in a Joint Use program. Then add the attaching organizations pages to your site.

To configure the Electric Joint Use site, complete the following steps:

1. Verify that you are signed in to your ArcGIS organization and browse to the Electric Joint Use Hub site.
2. From the item page, click Configure.
3. If necessary, click the Edit button to open the site editor.
4. Scroll to the Joint Use Applications section, hover over the image card, and click the edit button to add your image.
5. Scroll to the Frequently Asked Questions section, hover over the card, click the edit pencil, and update the questions and answers.
6. 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.

7. Click the HTML box.

   The HTML window appears.

8. Make the necessary changes and click Apply.
9. On the top left of the side panel, click the number of associated pages button.
10. Click the Link Page button and select company name page.

    Repeat for all other company pages to add.

11. Click Save.
12. On the top right of the side panel, click Customize.
13. Click Header, and under the Menu section, click Add Link and select To existing content.
14. In the dialog box, use the filters under the Collection section, click Site & Pages, and search by the company name.

    Repeat for all other company pages to add.

15. Select the company name page and click Save.
16. In the upper right of the Electric Joint Use site, click Save.
17. Click the Save drop-down arrow and select Publish Draft.

Configure email notifications

Configure your joint use permit or issues to send notifications to the responsible party via email.

Modify email message

To update the format and text of the email, complete the following steps:

1. Verify that you are signed in to your ArcGIS organization and browse to the PermitEmailTemplates .csv file.
2. Click the Download button.
3. Open in Microsoft Excel and change the rows in the Subject and Body columns to meet your organization's needs.
4. To include a field from the JointUsePermit layer, use the name field with braces around the field name.
   For example: New Permit Request {permit_number} has been submitted.
5. Save the updated .csv file.
6. In your ArcGIS organization, on the template item page, click the Update button, and click Choose File.
7. Select the newly updated email template and then click the Update Item button to save the updates to the template.
8. Repeat steps 1-8 for the IssueEmailTemplates .csv file.

Schedule the email notification notebook

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 and complete the following steps.

To schedule the email notification notebook to run as a scheduled task at a repeated interval, complete the following steps:

1. Verify that you are signed in to your ArcGIS organization and browse to the Joint Use Permit Email notebook item.
2. Open the item page and click Open Notebook.
3. Click Tasks.
4. Click Create Task.
5. For Title, type Joint Use Permit Task and click Next.
6. Configure the task to run nightly by selecting Minute from the Repeat Type drop-down menu and selecting 15 - Every Fifteen Minutes from the Repeat Interval drop-down menu.
7. Turn the Update Notebook on Completion toggle button off.
8. Click Create Task to finish scheduling the notebook.
9. Repeat steps for the Joint Use Issue Email notebook.

Add contact information

If your organization is not using National Joint Utilities Notification System (NJUNS) or a similar system, you must add contact information for every user who needs to be notified. To add contact information into the JointUserOwner .csv file included with the solution, complete the steps below:

Note:

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

1. Verify that you are signed in to your ArcGIS organization and browse to the JointUseOwnerInfo .csv file.
2. Click the Download button.
3. Open in Microsoft Excel and add the following details for each user:

   Label	Type full name of the user.
   Name	Type the named user from your organization.
   Owner	Type the coded value of the company the user belongs to.
   Email	Type the email address associated with the named user.

Archive joint use

To archive completed permits to the joint use table in the Electric Distribution Data Management solution, complete the following steps:

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 and complete the following steps.

1. Verify that you are signed in to your ArcGIS organization and browse to the Archive Joint Use notebook item.
2. Open the item page and click Open Notebook.
3. Click Tasks.
4. Click Create Task.
5. For Title, type Archive Joint Use 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 and select your preferred time.
7. Turn the Update Notebook on Completion toggle button off.
8. Click Create Task to finish scheduling the notebook.