Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Map document name - we recommend using the same name as the feature (e.g., Cruise_Data_Model_v2). This is helpful when overwriting a Feature Service, as ArcMap will know which Feature Service you are attempting to overwrite.

  • Map Layer - set projection to Web Mercator (Auxiliary Sphere)

  • Map Document Properties

    • Required properties - you must supply the following attributes prior to publishing

      • Title - We recommend using the same name as the MXD and Feature Service name

      • Tags - We recommend using ‘MobileMap’ and optionally ‘InventoryManager’ (if relevant)

    • Optional properties -

      • Summary - Use as appropriate to clarify the intended use of this service

      • Description - MobileMap settings can be copied into the description field of the map metadata, see MobileMap Settings section below

ArcMap

WSG encourages our clients to publish feature services from ArcGIS Pro.

ArcGIS Pro

Map Properties

Use the map Properties to provide a Title, Tags, Summary and Description

...

Publish

...

Layer

...

  • On the Configuration Tab

  • Check the box to enable editing (Add, Delete, Update) of Attributes and Geometry

  • Optionally enable Sync (for compatibility with Esri Field Maps) and Export Data (to enabled export of full database as FGDB for backup, etc.)

...

MobileMap Settings - Saving to Feature Service

MobileMap settings can optionally be saved in the ‘description’ field of a Feature Service. This allows MobileMap to import optimized settings directly from the Feature Service itself when setting up a new device or changing to a new service. This approach is in contrast to manually configuring settings, or importing settings from a settings file.

To save MobileMap settings to a feature service, copy existing settings into the Map Properties ‘Description’ field. When the service is published (or republished) the settings can be imported into MobileMap by using Actions > Import Settings.

While adding MobileMap seetings to the Feature Service is not required, it is recommended in order to provide efficient and consistent configuration of MobileMap devices. Note that there are some situations where this may not be desired (e.g., cases where MobileMap settings will be imported from settings files, rather than the feature service due to the use of different settings under different scenarios).

Follow the steps below to configure MobileMap settings, copy them to your PC, apply them to your Map and finally add them to the Feature Service. The This can be done before publishing the service, or before updating (overwriting) a service.

When copying MobileMap settings into your Map properties, follow these steps:

  • Configure one MobileMap device with all appropriate settings. Typically this is done by

    • Publishing the Feature Service without settings

    • Connecting to the service with MobileMap and manually updating settings until standard workflows can be completed. The most commonly changed settings include hidden fields, read only fields, tree and log fields to ignore, etc.

  • Export settings from MobileMap to a text file (Actions > Export Settings) and open up text file on your PC

  • Optionally edit the settings file to reduce the list of setting to just those that are non-default settings (only the settings you updated when configuring MobileMap)

  • Use a text editing tool to remove unnecessary whitespaces including line breaks, tabs and spaces (e.g., https://www.browserling.com/tools/remove-all-whitespace)

  • Paste the condensed settings into the map ‘Description’ field in Map properties

    • ArcMap: Map Document Properties > Description

    • ArcGIS Pro: Map Properties > Metadata > Settings

  • Example of settings in ArcGIS Pro:

  • Image Removed
  • Publish or republish your feature service

    • If republishing in ArcGIS Pro, you will be asked if you want to use the existing description or the description from your Map document. Choose the ‘Use the item description from the map or layer’ option:

    • Image Removed

Layer Order

The typical layer order is as follows:

...

  • Required

    • Simple Feature Symbols - Use Esri’s Simple Feature Symbols (esriSMS, esriSLS, esriSFS) instead of more complex Picture Marker Symbols. This is especially important for points. Simple Marker Symbols (esriSMS) use JSON instructions to define the size, color, outline color, outline width, etc. for the symbol, instead of using an encoded image as the symbol. The image below shows how to ensure that a point symbol is a Simple Marker Symbol. Note that this format has a limited number of options, including only the following shapes: Circle, Square, Cross, X, Diamond (square rotated 45 degrees).

    • Example of setting simple marker symbol symbology in ArcMap

    • Example of setting simple marker symbology in ArcPro (note the use of ‘Shape Marker’ and the selection of the circle shape that is access from the shape dropdown. This is not the same as using the gallery and selecting Circle 1 or other symbol, which will use Picture Marker Symbols).

    • Example of setting simple fill symbol symbology for polygons in ArcPro (note the need to select a ‘hollow’ shape from the gallery first, then modify the outline width and color properties). When a no-color or transparent fill is selected instead, InventoryManager will display a faint blue fill color rather than a hollow polygon.

    • Even with the ‘Extent Hollow’ shape selected from the gallery, the resulting service will show a semi-transparent fill in some environments, including WSG web apps such as InventoryManager. Therefore, further configurations are needed when a truly hollow polygon is needed (typical symbology for Stands). For each symbol (including all unique value entries), use the properties tab, then the wrench icon to show the ‘effects’. For truly transparent fill, click the X next to the outline ‘Offset effect’ and ‘Dash effect’ as well as the unlabeled fill effect below (see orange arrows below). That should remove those effects and the symbology will look like the right side of the image below. Click ‘Apply’ and repeat for all relevant symbols.

    • Unique Value Renderer

      • If using a Unique Value Renderer (e.g., a different color for each Plot according to it’s Status value), only use a single field to determine the symbol (not 2 or more fields). In ArcMap, use the option for ‘Unique values’ not ‘Unique values, many fields’.

      • Default values - use a default value with Unique Value Renderers to ensure that features that have a null for the category field will still have a symbol on the map. This unique value is what will be displayed in MobileMap when selecting this layer for query or edit.

  • Suggested

    • Points

      • Size greater than or equal to 10

      • No outline - while outlines can be helpful for seeing points with low contrast to background (e.g., a green point on a forested stand using imagery background, they can also make things visually cluttered and can obscure the fill color when points are too small. Instead, try to use colors that have high contrast and avoid using outlines. We have found that bright green is generally sufficiently high contrast to vegetation in most scenarios.

    • Lines

      • Line width of 2

      • If lines might overlap, consider use of dashed lines for layers that will be above, or increased thickness for layers that will be below

    • Polygons

      • Hollow (no fill) allows for viewing of imagery within the polygon. This is especially true for forestry applications where users want to see the distribution of vegetation cover in forest stands

      • Line width of 2

Symbology Layer Files

The attached Zipfile below can be used to import symbology into ArcMap or ArcGIS Pro.

View file
nameMobileMap_Symbology_Layer_Files.zip

...

ArcMap - Settings and Publishing

Once the symbology, projection, data model and Editor Tracking (see MobileMap: Data Model / Data Modeling Process for more information on data modeling and Editor Tracking) have been set and saved, follow the steps below to publish the map document as a feature service in ArcGIS Online / Portal. 

...

  • Make sure to zoom out to an extent that covers all of the area for the relevant data to be published. For example, if you have data which consists of all counties in California, zoom out on the map to show California, Oregon and Mexico.

  • Once zoomed out, save the map document and do not zoom back in before publishing.

  • Ensure that you are logged in to your ArcGIS Account in ArcMap / ArcPro. To sign in from ArcMap, go to File -> Sign In.

  • Publish the service using the ‘Share’ option in ArcMap (File -> Share As -> Service).  Select ‘Publish a service’ and name the service. We recommend using the same naming convention as field names - title case with underscores, and include a version number if helpful (e.g., Title_Case_With_Underscores_v2). Note that the feature service names will be displayed alphabetically in the ‘Select Feature Service’ dialog, and Android sorting is case sensitive - this means that ‘a' will be sorted below 'Z’ because capitol letters are sorted before (above) lower case letters. As described above, we recommend naming the ArcMap document (MXD) with that will be used for the feature service. This helps when overwriting a service after changes are made to the data model or symbology. Complete the following information during the publication process:

    • Capabilities - check Feature Access and uncheck Tiled Mapping.  

    • Feature Access - check the boxes next to Create, Delete, Query, Sync, and Update.  (Figure 11)

    • Item Description - add text in the Summary and Tags. If these were set in the Map Document Properties as suggested above, these will already be populated. Review them to make sure they are correct. 

    • Sharing - choose the level of Sharing.  

      • Selecting Everyone makes the feature service a ‘public’ service, meaning anyone could potentially find the service if they know what to search for on ArcGIS Online.  This is NOT recommended.

      • Selecting your organization limits the sharing to just your group. (If you select your organization, you will need to put your ArcGIS Online user name and password in the settings of WSG MobileMap).

      • For MobileMap to find the service and display it in the ‘Select Feature Service’ dialog, the service must be shared with at least one group that the user is a member of. Sharing via ‘Everyone’ or ‘Your Organization’ is not sufficient for MobileMap to find the service.

      • See section below on Managing ArcGIS Online Groups and Users for more information on this topic

  • Finally, select Publish in the upper right corner.

...

Your feature service is now published.  Log in to ArcGIS Online to review and confirm it is as expected.

ArcGIS Pro - Settings and Publishing

Map Properties

Use the map Properties to provide a Title, Tags, Summary and Description

...

Publishing

  • Publishing a Feature Service from ArcGIS Pro is implemented under the Share tab using the Publish Web Layer option. This terminology is a bit confusing, because you will actually be publishing a Feature Service, and it will have multiple layers, but that is the generic term that is used in ArcGIS Pro. Go to Share > Web Layer > Publish Web Layer

...

  • On the Configuration Tab

  • Check the box to enable editing (Add, Delete, Update) of Attributes and Geometry

  • Optionally enable Sync (for compatibility with Esri Field Maps) and Export Data (to enabled export of full database as FGDB for backup, etc.)

...

MobileMap Settings - Saving to Feature Service

MobileMap settings can optionally be saved in the ‘description’ field of a Feature Service. This allows MobileMap to import optimized settings directly from the Feature Service itself when setting up a new device or changing to a new service. This approach is in contrast to manually configuring settings, or importing settings from a settings file.

To save MobileMap settings to a feature service, copy existing settings into the Map Properties ‘Description’ field. When the service is published (or republished) the settings can be imported into MobileMap by using Actions > Import Settings.

While adding MobileMap settings to the Feature Service is not required, it is recommended in order to provide efficient and consistent configuration of MobileMap devices. Note that there are some situations where this may not be desired (e.g., cases where MobileMap settings will be imported from settings files, rather than the feature service due to the use of different settings under different scenarios).

Follow the steps below to configure MobileMap settings, copy them to your PC, apply them to your Map and finally add them to the Feature Service. The This can be done before publishing the service, or before updating (overwriting) a service.

When copying MobileMap settings into your Map properties, follow these steps:

  • Configure one MobileMap device with all appropriate settings. Typically this is done by

    • Publishing the Feature Service without settings

    • Connecting to the service with MobileMap and manually updating settings until standard workflows can be completed. The most commonly changed settings include hidden fields, read only fields, tree and log fields to ignore, etc.

  • Export settings from MobileMap to a text file (Actions > Export Settings) and open up text file on your PC

  • Optionally edit the settings file to reduce the list of setting to just those that are non-default settings (only the settings you updated when configuring MobileMap)

  • Use a text editing tool to remove unnecessary whitespaces including line breaks, tabs and spaces (e.g., https://www.browserling.com/tools/remove-all-whitespace)

  • Paste the condensed settings into the map ‘Description’ field in Map properties

    • ArcMap: Map Document Properties > Description

    • ArcGIS Pro: Map Properties > Metadata > Settings

  • Example of settings in ArcGIS Pro:

  • Image Added
  • Publish or republish your feature service

    • If republishing in ArcGIS Pro, you will be asked if you want to use the existing description or the description from your Map document. Choose the ‘Use the item description from the map or layer’ option:

    • Image Added

Managing ArcGIS Online Groups and Users

...