How To: Configure Portal for ArcGIS with custom symbology

Summary

The Portal for ArcGIS map viewer comes with a series of default Esri symbol sets that meet the needs of most organizations. If custom symbology is required, the steps below describe a method to configure the map viewer settings to use custom symbol sets.

Procedure

Custom symbol sets are stored as items in a group. The map viewer searches for the group and then uses the symbol set items within it to populate the sets available.

1. Check the prerequisites for this workflow

1. Administrator privileges to the portal are required.
2. The portal must be federated with an ArcGIS Server site and include a hosting server. For instructions, see Federate an ArcGIS Server site with your portal and Configure a hosting server.
3. A web server in the organization must be configured with HTTPS. Permissions to create a virtual directory on the web server and read/write to the directory are required. The directory must be accessible by Portal for ArcGIS.

2. Create a group to contain the symbol sets

1. Log in to the Portal for ArcGIS website as an administrator of the organization.
2. Create a group to contain the custom symbology, for example 'Custom Symbols'. This must be be accessible to everyone that uses the map viewer. Record the name of the group, as this is needed later. For details, see Create groups.
3. Log in to the ArcGIS Portal Directory as an administrator of the organization. The URL is formatted as follows:

 https://webadaptor.domain.com/arcgis/sharing/rest

4. In the upper-right corner of the page, click the account name.
5. In the User Groups section, click the name of the group created above and record the ID of the group for later use.

3. Configure the symbol set items

4. Create the 'by value' item

1. In the upper-right corner of the page, click the account name.
2. At the bottom of the page, click User Content.
3. In the User Content page, click Add Item.
4. In the Add Item page, specify a title for the item using the Title field. This is meaningful, as it is displayed in the map viewer.
5. Specify the following information exactly as noted below:
   • Tags: Symbol Set
   • Type Keywords: marker, Symbol Set
   • Type: Symbol Set
6. If you want to display this symbol set as the default, add 'default' to the Type Keywords field.
7. Click Add Item.
8. Click Share Item.
9. Share the item with everyone. In the group field, enter the ID of the group created above.

5. Create the URL item

1. In the upper-right corner of the page, click the account name.
2. At the bottom of the page, click User Content.
3. In the User Content page, click Add Item.
4. In the Add Item page, enter the same title specified for the 'by value' item. The title must match the by value item exactly.
5. Specify the following information exactly as noted below:
   • Type: Symbol Set
   • Type Keywords: by value, marker, Symbol Set
   • Tags: Symbol Set
6. If this is the default symbol set for the portal, add 'default' to the Type Keywords field.
7. Click Add Item.
8. Click Share Item.
9. Share the item with everyone. In the group field, enter the ID of the group created above.

6. Create and publish custom symbols

1. In ArcMap, create a map that contains the custom symbology to be added to the symbol set. For more information, see What are symbols and styles?
2. Publish the map as a feature layer to the portal. For details, see Publish features (Publish from ArcMap).

7. Host the custom symbols

1. Create a virtual directory on the web server to contain the symbols. Verify read/write access to this directory and that it can be accessed by Portal for ArcGIS.
2. Verify that the directory can be accessed via HTTPS.
3. Log in to the ArcGIS Server Services Directory as an administrator of the organization. The URL is formatted

https://gisserver.arcgis.com:6443/arcgis/rest/services

4. Click the Hosted folder and then click the name of the service published as a feature layer.
5. Under Layers, click the first layer.
6. Under Drawing Info, right-click each symbol and save to the virtual directory created on the web server.
7. Repeat steps e and f for any additional layers.

8. Insert symbols into the symbol set

• JSONLint
• JSON.minify()

1. Log in to the ArcGIS Server Services Directory as an administrator of the organization. The URL is formatted.

https://gisserver.arcgis.com:6443/arcgis/rest/services

2. Click the Hosted folder and then click the name of the service published as a feature layer.
3. Under Layers, click the first layer.
4. In the upper-left corner, click JSON. A raw view of the feature layer JSON is displayed.
5. Search for the 'uniqueValueInfos' property.
6. Beginning at the first open bracket after the property, copy all of the JSON info up to the closing bracket of the property. For example:

"uniqueValueInfos": [
   {
      Symbol0
      ...
   },
   {
      Symbol1
      ...
   },
]

7. Paste the content into a JSON validator.
8. Remove the following properties from each symbol definition JSON:
   • value
   • label
   • description
   • symbol
9. Repeat steps a through h for any additional layers.
10. Validate the JSON. Correct any errors. The validated JSON should look like this:

[
    {
        "type": "esriPMS",
        "url": " d06b3aed-db09-4d17-b485-48596e3c925d",
        "imageData": "iVBORw0KGgoAAAANSUhEUgAAABwAAAAc...",
        "contentType": "image/png",
        "width": 21,
        "height": 21,
        "angle": 0,
        "xoffset": 0,
        "yoffset": 0
    }
]

11. Copy and paste the validated JSON into a text editor.
12. Update the JSON URL property to match the URL of the symbols hosted on the web server, for example:

"url": "https://webserver.domain.com/custom/hydrant.png",

13. Validate the JSON and correct any errors.
14. Minimize the JSON. Copy this content.

9. Add validated JSON to symbol sets

1. Log in to the ArcGIS Portal Directory as an administrator of the organization. The URL is formatted,.

 https://webadaptor.domain.com/arcgis/sharing/rest

2. In the upper-right corner of the page, click the account name.
3. At the bottom of the page, click User Content.
4. In the items list, click the name of a symbol set item.
5. Click Update Item.
6. In the Text field, paste the minimized JSON.
7. Click Update Item.
8. Repeat these steps for the second symbol set item. Repeat these steps for any additional custom symbol sets created for the portal. Each symbol set requires the validated JSON and each symbol set item must be updated.

10. Expose custom symbols

1. Log in to the ArcGIS Portal Directory as an administrator of the organization. The URL is formatted:

https://webadaptor.domain.com/arcgis/sharing/rest

2. Click the organization ID.
3. At the bottom of the page, click Update.
4. Locate the Symbol Sets Group Query field and update to the following:

title: "<name of custom symbols group>" AND owner: <group owner user name>

title: "Custom Symbols" AND owner: "admin"

5. Click Update Organization.

Note:
If it is necessary to revert back to the default Esri symbol sets, repeat the steps above and update the Symbol Sets Group Query field with title: "Esri Symbols" AND owner: "esri_en".