3Setting Up GIS

Setting Up Map Profiles

Use map profiles to configure specific instances of map functionality in the system. Profiles set the default extent of the map (the area shown by default) as well as controlling the availability of certain map options.

A profile can be linked to multiple maps. All of a profile’s maps share the same map service URL, default map extent, and default base map, but the maps have individual configuration options to control end-user options for the map.

Every map must be associated with at least one map profile. If a map has multiple profiles, a Switch Map Profile button appears on the map toolbar, and end users can choose which profile to use.

This example illustrates the Map Profile list page. Each row includes a thumbnail map, lists up to three maps that are associated with the profile, and states how many additional maps (if any) are associated with the profile.

Prerequisite

Mapping capabilities depend on integration with a map service such as Esri’s Geographic Information Systems (GIS). Before you set up map profiles, publish your map service so that it can be referenced from within the Oracle system.

Delivered Maps

The following tables describe the delivered maps in the Oracle Public Sector system.

Note: Make sure that every map you use is associated with a profile.

This table lists the main maps that display the agency’s permits, planning applications, and projects. There are separate maps for different users. For more information, see Using the Main Map and Explore Your City Map.

Map Name	Description
Agency main map	The main map that appears when an agency staff member clicks the Main Map icon in the page header.
Guest/anonymous user map	The main map that appears when an anonymous user clicks the Explore Your City tile on the landing page.
Registered public user map	The main map that appears when a public user who is signed in clicks the Explore Your City tile on the landing page. Registered users and anonymous users see different maps because registered users have additional options for starting permit and planning applications and for limiting searches to just the user’s own applications. These options are not configured on the map profile, but the existence of separate maps for public users and anonymous users means that you must configure them separately.

This table lists additional maps that support permits and planing applications:

Map Name	Description
Application intake	The property picker map. This map appears in a modal window that is accessed from an application intake form or, for submitted applications, from the application details Property Information page. See Working with Property Information.
Mobile inspection	The map that inspectors see when using mobile inspection functionality for permits and planning applications. See Oracle Inspector Overview for Permits.
Permit list	The map that appears on the application list pages when they are in map view. The list page for agency staff is the Transactions page. This page includes lists for both permits and planning applications. The same map is used for both. The list page for registered public users is the Applications page. These list pages all include List View and Map View buttons for toggling between views. See Managing Transactions.
Public notification	The map that appears on the Public Notification page. Agency staff uses this page to define a notification area. See Creating Map-Based Public Notification Lists.

This table lists additional maps that support code enforcement:

Map Name	Description
Agency - code enforcement	The map that code enforcement technicians can view from certain tabs on the Worklist page. This map shows the location of issues that appear on the selected worklist tab. See Using the Worklist.
Code enforcement issue intake	The map that appears on the page where public users who are reporting a code enforcement issue identify the location of the issue. See Reporting Issues.
Mobile code enforcement inspections	The map that inspectors see when using mobile inspection functionality for code enforcement. See Oracle Municipal Code Officer Overview.
Public - code enforcement	The map where public users can view recent code enforcement issues. See Viewing Recent Issues.

This table describes the map that appears in transaction headers:

Map Name	Description
Transaction header	The map that appears at the top of various detail pages. For example, this map appears in the detail pages for permits, planning applications, incidents, cases, parcels, addresses, and owners. Note: Link this map to exactly one map profile. Profile switching is not allowed for this map.

Note: If your agency defines a new map page, the new map must be added to the Map Page lookup (ORA_PSC_COM_SYS_MAP_PROFILE) so that it is available to be associated with a map profile.

Adding a Map Profile

1. Select GIS Setup > Map Profile.

   If no profiles exist, the Map Profile Details page opens so that you can create the first profile. If at least one profile exists, the Map Profile list page appears.

2. If the Map Profile list page appears, click Add Map Profile.

   The Map Profile Details page appears.

3. Enter the following basic profile information:

   Page Element	Description
   Profile ID	Enter a unique identifier for the map profile.
   Profile Name	Enter a descriptive name for the map profile. This identifies the profile on the Map Profile list page. When end users view a map with multiple profiles, they can switch profiles by choosing from a list that displays this name along with a map thumbnail.
   Description	Enter a more detailed description of the map profile. This also appears on the Map Profile list page to help identify the profile.

4. Enter the URL for your map service in the Map Service URL field.

   The URL to the profile provides default values for the map extent, which you will confirm or change later in this procedure.

5. If the Base Map field is editable, choose the type of map to display.

   The Esri server settings control whether this field is editable.

   The options are Dark gray canvas, Light gray canvas, Imagery with labels, National Geographic, Topographic, Open Street Map, Imagery, Streets, Terrain with labels, and Oceans.

   When you link specific maps to the profile, you will configure whether users can change the map type.

6. Set the map extent.

   The map extent defines the geographical area that the map initially displays. When you create a new map profile, a generic map illustration appears above the Choose Map Extent option. After you choose the map extent, a preview thumbnail of your actual map extent replaces the generic illustration.

   Although the map service URL provides a default map extent, you still need to click Choose Map Extent to load the default extent into the profile and optionally modify it.

   Note: Maps in transaction headers are initially centered on the transaction location. Therefore, the transaction header map uses the default extent from the map profile only if the transaction is not associated with a specific location.

   1. Click Choose Map Extent.

      The Choose Map Extent page appears. The map service URL that you previously provided sets the default map extent, and the page displays a map with that default extent.

   2. If necessary, modify the default map extent supplied by the map service URL.

      Oracle provides the ability to easily set a new map extent without making any changes to the GIS service. To change the extent, pan and zoom until you can see the desired extent, then use the Choose Map Extent toolbar button to draw a selection rectangle. This sets the new extent.

      The following fields describe the map extent by identifying a coordinate system and listing the minimum and maximum X and Y values on the coordinate system.

      Page Element	Description
      X-Min of Default Map View	The top-left X-coordinate of the initial map extent.
      X-Max of Default Map View	The bottom-right X-coordinate of the initial map extent.
      Y-Min of Default Map View	The bottom-left Y-coordinate of the initial map extent.
      Y-Max of Default Map View	The top-right Y-coordinate of the initial map extent.
      Spatial Reference	The geographic coordinate system or map projection used by the mapping service to display the map. The map service URL that you previously supplied sets this value.

   3. Click OK to close the Choose Map Extent window.

      The thumbnail map on the Map Profile Details page is updated to match your map extent.

7. Link maps to the profile and define settings for each map:

   1. Click Add Map Page.

   2. In the Map Page field, select a map to link to the profile.

      The maps are Agency main map, Application intake, Agency - code enforcement, Code enforcement issue intake, Mobile code enforcement inspections, Public notification, Transaction header, Guest/anonymous map, Mobile inspection, Permit list, Registered public user map, and Public - code enforcement.

      These maps are described in detail above.

   3. Configure map-specific options.

      Depending on the map that you are configuring, some map options might not be available to enable or disable. For example, you cannot enable selection tools or window docking on the maps for mobile devices, and zoom tools are the only widgets available in the transaction header map.

      If you create any custom maps, there are no restrictions on which widgets you can enable, so take extra care when configuring those maps.

      Use these fields to configure map options:

      Page Element	Description
      Enable Zoom	Indicate whether the map toolbar includes Zoom In and Zoom Out tools.
      Enable Default Map View	Indicate whether the map toolbar includes the Show Default Map View tool. This tool restores the map to its initial extent after a user zooms or pans to change the display area.
      Enable Base Map Gallery	Indicate whether the map toolbar includes the Select Base Map tool. This tool lets users change the base map from the one specified in the profile. For example, if the profile’s base map is topographic, users can change to a map with satellite imagery.
      Enable Map Layers	Indicate whether the map toolbar includes the Select Layers tool and, depending on your GIS configuration, the Identify GIS Information tool. The Select Layers tool lets users see the list of layers and switch layer visibility on and off. Examples of layers include environmental, zoning, or infrastructure information provided by the map service. The Identify GIS Information icon gives users the ability to click map objects such as parcels to display a pop-up window with object information. This option is available if the GIS administrator has configured the GIS service to provide this information.
      Enable Selection Tools	Indicate whether the map toolbar includes the Show/Hide Selection Tools icon. Clicking this icon opens a separate toolbar with tools for selecting and deselecting parcels on a map. The ability to select parcels on the agency main map, the registered public user map, and the guest/anonymous user map enables users to view associated transactions. Registered users and agency staff can additionally start an application for selected parcels. The ability to select parcels on the public notification map enables users to create a notification area around the selected parcels.
      Enable Detail Window Docking	Indicate whether the map detail window is docked to the side of the view. The detail window is the pop-up window that appears when a user clicks a map marker or other GIS feature such as a parcel.
      Detail Window Dock Position	Specify the position where the map detail window is initially docked: Auto, Bottom left, Bottom center, Bottom right, Top left, Top center, or Top right. This field is relevant only if you enable detail window docking. This field does not apply to mobile devices, where the detail window always appears at the bottom of the screen.

   4. Click Save to close the Add Map Page window.

8. If necessary, click a linked map to re-open the Add Map page.

   • To edit settings, make your changes and then click Done.

   • To remove the map from the profile, click the Delete button.

9. Click Save to save the map profile.

Modifying a Map Profile

1. Select GIS Setup > Map Profile.

2. On the Map Profile list page, click the row for the profile that you want to modify.

3. Update the settings as needed.

4. Click Save.

Deleting Map Profiles

To delete a map profile:

1. Select GIS Setup > Map Profile.

2. On the Map Profile list page, click the row for the profile that you want to delete.

3. On the Map Profile Details page, click Delete.

Setting Up GIS Attribute Mapping

Use Global Information Systems (GIS) attribute mapping to specify information about your map service parcel layer.

Prerequisites

Before you enter the information about your map service layers, you must:

• Publish the map service, which must have parcel, address, and owner layers.

  When you save the URL for a map service layer, an error message appears if the layer is not available.

• Ensure that the parcel layer has a field with parcel IDs that match the parcel IDs in the Oracle system.

  Parcel IDs must match exactly, with no formatting differences.

Setting Up the Service Layer URLs

To set up the layer service URLs:

1. Select GIS Setup > Attribute Mapping.

   The GIS Attribute Mapping page appears.

2. Enter parcel layer information:

   Page Element	Description
   Parcel Layer Service URL	Enter the URL for your parcel layer feature service. The URLs for the different layers of an Esri map service have numeric identifiers. The URL that you enter here ends with the number for the parcel layer as in the example https://servername/arcgis/rest/services/Your_City/MapServer/4 You must publish your parcel layer feature service before you enter the URL here.
   Parcel Number	Select the parcel layer GIS attribute that provides the unique identifier for each parcel. The values in the drop-down list come from the parcel layer that you specify. Select the GIS attribute that provides the same identifiers that are used in the parcel table in the Oracle system. For information about setting up the parcel table, see Setting Up Parcels. On maps used as property pickers, clicking a parcel on a map retrieves the parcel identifier from the map service. This value is used as criteria for searching the Parcel table, and the search results appear in a modal window. As long as the same parcel number exists in the Parcel table, the search results include just one value, representing the selected parcel.

3. Enter address layer information:

   Page Element	Description
   Address Layer Service URL	Enter the URL for your address layer feature service. The URL ends with the number for the address layer. You must publish your address layer feature service before you enter the URL here.
   Parcel Number	Select the address layer GIS attribute that provides the unique identifier for each parcel.

4. Enter owner layer information:

   Page Element	Description
   Owner Layer Service URL	Enter the URL for your owner layer feature service. The URL ends with the number for the owner layer. You must publish your owner layer feature service before you enter the URL here.
   Parcel Number	Select the owner layer GIS attribute that provides the unique identifier for each parcel.

5. Enter boundary layer information:

   Page Element

   Description

   Boundary Service Layer URL

   Enter the URL for your boundary layer feature service. The URL ends with the number for the boundary layer. This layer identifies the agency’s boundaries so that the system can check whether a location on a map is within those boundaries. For example, in the code enforcement system, issue locations must be within the agency’s boundaries. Your GIS administrator must create and publish your boundary layer feature service before you enter the URL here.

6. Click Save.

Setting Up Access to Secure Map Services

This topic discusses how to set up access to the agency’s secure private maps.

Overview of Secure Map Access

Giving users access to non-public maps (maps that can’t be accessed directly through a browser) involves setup in both the Esri and Oracle systems:

1. In the Esri system, set up proxy users with access to the maps.

   You can set up proxy users with access to one or multiple secure map services.

2. In Oracle, create a secure access definition that includes the user ID and password for the proxy.

   The secure access definition also includes a URL for the map service to be accessed and a URL for the web service that generates an authentication token for accessing the map services.

On the Oracle side, create separate secure access definitions for each of the map service URLs that you need to access. You can create definitions for specific map services, such as https://portal.city.net/arcgis/rest/services/TaxParcels/MapServer, or for generic services such as https://portal.city.net/arcgis/rest/services.

When an Oracle user attempts to access a secured map, the authentication process checks first for access information for the specific map service, then for access information for the generic service.

Prerequisites

To enable access to secure map services, you must:

1. Set up proxy users in the Esri system.

2. Give these proxy users appropriate access to the secure maps services that will be accessed from the Oracle system.

Setting Up Secure Map Access

To set up secure map access:

1. Select GIS Setup > Secure Map Access.

   The GIS Secure Map Access page appears.

2. Click the Add button to create a new secure access ID.

3. Enter the following information:

   Page Element	Description
   Secure Access ID	Enter an identifier for this configuration.
   Description	Enter a description for this configuration
   GIS Service URL	Enter the URL to the secured map service that will be accessed with this configuration.
   Token Service URL	Enter the URL to the web service that generates an authentication token for accessing secure map services.
   User Name	Enter the user name for the proxy user that is used to access secure map services.
   Password	Enter the password that the proxy user uses to access secure map services.
   Confirm Password	Re-enter the password. The re-entered password is compared to the originally entered password to help catch data entry errors.

4. Click Save.

   Saving tests the access information that you provided. If the test fails, you aren’t able to save.

Modifying a Map Profile

1. Select GIS Setup > Secure Map Access.

   The GIS Secure Map Access page appears.

2. On the GIS Secure Map Access list page, click the row for the profile that you want to modify.

3. Update the settings as needed.

4. Click Save.

Deleting Map Profiles

To delete a map profile:

1. Select GIS Setup > Secure Map Access.

   The GIS Secure Map Access page appears.

2. On the GIS Secure Map Access list page, click the row for the profile that you want to delete.

3. On the GIS Secure Map Access detail page, click Delete.