This is an archive related to a previous version of Esri Maps for SharePoint. If you need the current version go to http://doc.arcgis.com/en/maps-for-sharepoint/.

Configure symbols

Esri Maps for SharePoint comes with a document library, named Esri Maps Symbols, that uses ArcGIS JavaScript Object Notation (JSON) to define symbol sets that are used to populate the Map Web Part symbol gallery. You can edit, add, and remove documents in this library.

The Esri Maps Symbols library supports the following two content types:

  • Symbols Document—This content type is for files stored within the document library that contain JSON symbols.
  • Link to Symbols Document—This content type is for linking to JSON files that are hosted outside the document library. This type is convenient for sharing one symbols file across multiple site collections.

Browsing to the Esri Maps Symbols document library

As with other Esri Maps for SharePoint configuration lists and libraries, you can easily browse to the Esri Maps Symbols library using the Esri Maps for SharePoint Administration links on the Site Settings page as shown in the following steps:

  1. Browse to the Site Settings page of your site collection.
  2. Under the Esri Maps for SharePoint Administration heading, click the Legacy ArcGIS Mapping Settings link and click the Symbols link.
    Administration links

Adding a symbols document

To add a symbol, complete the following steps:

  1. Using the text editor of your choice, create a JSON symbol set.
  2. In the Esri Maps Symbols document library, click Add document.

    The Upload Document dialog box appears.

  3. Click Browse to select the new symbol set and click OK.
  4. On the properties dialog box, choose the content type, type the display name, choose the desired geometry type, and click Save when you're finished.
    Esri Maps Symbols document Save dialog box
    The new document is added to the Esri Maps Symbols library. Now, when using ArcGIS Map Web Parts that are within the same site collection, the new symbol gallery is available to use for symbolizing layers.
    New symbol gallery available in drop-down list

Adding a link to a symbols document

To add a link to a symbols document, complete the following steps:

  1. Browse to the Esri Maps Symbols library and click the Documents tab.
  2. Click the New Document button and choose Link To Symbols Document.
    New Document drop-down list

    The Document Link page appears.

  3. Specify a name and the uniform resource locator (URL) to the symbols document and click OK.
    Document Link page

    The Edit form dialog box appears.

  4. Specify the display name, choose the correct geometry type, and click Save.
    Edit form dialog box
    The link is added to the Esri Maps Symbols library. Now, when using ArcGIS Map Web Parts that are within the same site collection, the linked symbols document is available to use for symbolizing layers.
    SharePoint Fill symbols document available for symbolizing layers

Removing a symbols document

To remove a symbols document, complete the following steps:

  1. Browse to the Esri Maps Symbols library and choose the document to be removed by checking the check box next to its name.
  2. Click Delete Document on the Documents tab of the ribbon. A confirmation message appears.
  3. Click OK. The file or link is removed from the document library. This removes the symbols document from the symbol gallery in ArcGIS Map Web Parts that are within the same site collection.

    If you used symbols from the deleted symbol gallery for layers in saved Map Web Parts, the web parts will continue to use those symbols. Different symbols can be specified for these layers by editing the Map Web Part.

Creating a symbol set

All the files used by the ArcGIS Map Web Part symbol gallery are JSON files containing sets of symbols. When you create a JSON symbol set for use in the symbol gallery, it is important to keep in mind that each JSON file can only contain symbology for one type of symbol: marker symbols, fill symbols, or line symbols. A description of each type of symbol follows:

  • Marker symbol—Used to draw points and multipoints on the graphics layer. Use the Simple Marker Symbol or Picture Marker Symbol type to create marker symbols.
  • Fill symbol—Used to draw polygon features on the graphics layer. Fills can be specified as solid, hatched, or pictures. In addition, the symbol can have an optional outline, which is defined by a line symbol. Use the Simple Fill Symbol or Picture Fill Symbol type to create fill symbols.
  • Line symbol—Used to draw linear features on the graphics layer. Use the Simple Line Symbol type to create line symbols.

For additional information on JSON symbols, see the ArcGIS Server REST API and the symbol section of the ArcGIS API for JavaScript.

The simplest way to get started is to use one of the out-of-the-box symbol sets as a template.

Marker symbols

Marker symbols are used to draw point features on the map. Marker symbols can be specified using the following samples as guidelines. For more information on Marker symbols, see the ArcGIS Server REST API documentation.

  • Simple Marker Symbol—Simple Marker Symbols are used to display points as a simple shape, for example, a circle. In addition, the symbol can have an optional outline, which is defined by a line symbol. To create a Simple Marker Symbol, set the type to esriSMS and specify the ID, style, color, and size properties. The style property constants for a Simple Marker Symbol include esriSMSCircle, esriSMSCross, esriSMSDiamond, esriSMSSquare, and esriSMSX (diagonal cross).
    {
     "id":"Square","symbol":
      {
       "type": "esriSMS",
       "style": "esriSMSSquare",
       "color": [76,115,0,255],
       "size": 8,
       "angle": 0,
       "xoffset": 0,
       "yoffset": 0,
       "outline": 
        {
         "color": [152,230,0,255], "width": 1
        } 
      }
    }
    
  • Picture Marker Symbol—Picture Marker Symbols can be used to symbolize point features using an image. For a Picture Marker Symbol, set the type to esriPMS and specify the ID, URL, width, and height properties.
    {
     "id":"Hiking","symbol":
      {
      	"type" : "esriPMS",
       "url" : "/_layouts/ESRI.ArcGIS.Mapping.SharePoint/Images/MarkerSymbols/OutdoorRecreation/Hiking.png",
       "contentType" : "image/png",
       "color" : null,
       "width" : 19.5,
       "height" : 19.5,
       "angle" : 0,
       "xoffset" : 0,
       "yoffset" : 0
      }
    }
    

Fill symbols

Fill symbols are used to draw polygon features on the map. Fills can be specified as solid, hatched, or pictures. In addition, the symbol can have an optional outline, which is defined by a line symbol. Fill symbols can be specified using the following samples as guidelines. For more information on Fill symbols, see the ArcGIS Server REST API documentation.

  • Simple Fill Symbol—The Simple Fill Symbol can be used to display polygons as solid, transparent, or with one of several crosshatch patterns. In addition, the symbol can have an outline, which is defined by a line symbol. For a Simple Fill Symbol, set the type to esriSFS and specify the ID, style, and color properties.
    {
     "id":"SolidFill","symbol":
      {
       "type": "esriSFS",
       "style": "esriSFSSolid",
       "color": [115,76,0,255],
       "outline": 
        {
         "type": "esriSLS",
         "style": "esriSLSSolid",
         "color": [110,110,110,255],
         "width": 1
        }
      }
    }
    
  • Picture Fill Symbol—The Picture Fill Symbol can be used to display polygon features filled with an image in a repeating pattern. In addition, the symbol can have an outline, which is defined by a line symbol. For a Picture Fill Symbol, set the type to esriPFS and specify the ID, URL, outline, width, and height properties.
    {
     "id":"PictureFill","symbol":
      {
       "type" : "esriPFS",
       "url" : "images/sand.png",
       "contentType" : "image/png",
       "color" : null,
       "outline" :
        {
         "type" : "esriSLS",
         "style" : "esriSLSSolid",
         "color" : [110,110,110,255],
         "width" : 1
        },
       "width" : 63,
       "height" : 63,
       "angle" : 0,
       "xoffset" : 0,
       "yoffset" : 0,
       "xscale" : 1,
       "yscale" : 1
      }
    }
    

Line symbols

Line symbols can be used to display line features on the map or to specify outlines for polygon symbols. Line symbols can be specified using the following sample as a guideline. For more information on Line symbols, see the ArcGIS Server REST API documentation.

  • Simple Line Symbol—A Simple Line Symbol can specify either a solid line or a predefined pattern of dashes and dots. For a Simple Line Symbol, set the type to esriSLS and specify the ID, style, color, and width properties. The style property constants for a Simple Line Symbol include esriSLSDash, esriSLSDashDotDot, esriSLSDot, esriSLSNull, and esriSLSSolid.
    {
     "id" : "BasicLineSymbol_Green_5", "symbol" : 
      { 
       "type" : "esriSLS", 
       "style" : "esriSLSSolid", 
       "color" : [0,128,0,255], 
       "width": 5 
      } 
    }