10.4.7.3 Editing a Custom Map Background

Edit a custom map background on the Map Backgrounds page in Shared Components.

To edit a custom map background:

1. Navigate to the Shared Components page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

   Tip:

   You can also access Shared Components from Page Designer by clicking Shared Components () on the Page Designer toolbar.
2. Under User Interface, click Map Backgrounds.
3. On Map Backgrounds, click a background Name.

   The Map Background appears.

4. Edit the appropriate attibutes.

   The attibutes that appear differ depending upon the map background type. For example, Raster XYZ or OGC WMS map tile layers, include an Attribution setting. You can use this setting to include text, such as a copyright notice, on the lower right corner of map.

5. To add an API key that is sourced from a Web Credential:
   1. Settings, API Key - Choose Web Credential.

      Oracle APEX replaces the {api-key} placeholder in the URL with the value specified here.

   2. Settings, Web Credential - Choose a Web Credential from the list.

      For the selected Web Credential, the Valid for URLs attribute of the chosen credential must have two entries:

      • One entry of the browser:// type must allow credential usage for the application and page which contains the map using that map background. For example:

        browser://{application-id}/{page-id}/

        Where application-id and page-id reference the application page of the map region which uses the map background and the credential.

      • One entry of the http:// or https:// type which allows using the API key for the Map Server URL of this map background. For example:

        https://mapserver.example.com/map/

      To learn more, see Managing Web Credentials.

6. Edit any additional attributes. To learn more about an attribute, see field level Help.
7. Click Apply Changes.