Manage Feature Cache

For web feature layers, a feature cache is used to improve performance and common tasks by storing features in a temporary folder. The cache is automatically managed and as features are cached, the number of queries needed to retrieve data is reduced and drawing time is improved. This can be useful when working with large or complex datasets, in a specific map extent, or when numerous users are using the same service. This also reduces strain on the server as it reduces the number of service requests.

By default, the feature cache is filled automatically by the application; this is the recommended setting. The cache is filled each time the map has finished drawing and the following criteria are met:

  • The layer is visible in the Contents pane
  • The layer is displaying based on the visible scale range
  • The total number of features drawn is less than five times the maxRecordCount parameter value on the service layer
  • The caching option on the layer properties dialog box is set to Clear cache when the session ends
  • The estimated number of features in the visible extent is less than five times the maxRecordCount parameter value on the service layer when filters are present

In scenarios where the application determines not to fill the feature cache for a layer (in other words, the five criteria listed above are not satisfied), you can manage the cache manually to take advantage of the performance benefits provided by the cache.

Access controls to manage the cache on the Map tab in the Feature Cache group. Use these controls to fill the cache, empty the cache, cancel a current cache fill, or set the cache to automatically fill. These controls are applied to each map in a project. If the Feature Cache group is not enabled, the application will automatically cache features as described above.

For more information on caching, see How caching works.

Show the Feature Cache group

By default, the Feature Cache group is hidden on the ribbon. Follow these steps to access the controls in this group.

  1. Click the Project tab and click Options.
  2. On the Options dialog box, under the Application heading, click the Map and Scene tab.
  3. Expand Feature Cache and check Manage feature cache from the Map tab.
  4. Click OK to save your settings and close the dialog box.

Auto Cache

When the Feature Cache group has been enabled, Auto Cache will be turned on for each new map. Turn off this option to manage the cache manually. This setting can be changed independently for each map in a project. This allows you to manage the Auto Cache setting as your workflow requires. As noted below, if layers share the same data source across multiple maps, Fill Enable Feature Cache and Empty Clear Feature Cache may affect Auto Cache.

Note:

While a fill that has been initiated from Fill Enable Feature Cache is in progress, auto caching is paused for the entire project until the current fill is complete.

Fill the feature cache for the current map

The feature cache must be filled before it can be used.

On the Map tab in the Feature Cache group, click Fill Enable Feature Cache to fill the cache for all layers that are visible in the map.

Caution:

If you don't see the Feature Cache group on the Map tab, follow the steps in the previous section to access these controls.

The cache fills based on the current extent of the map. Unlike Auto Cache, which uses criteria to determine which layers are filled, with Fill Enable Feature Cache, all layers that are visible in the Contents pane will be cached. Only one fill process may occur per project at a time. While the cache is filling, the Fill button Enable Feature Cache is unavailable for all maps in the project until the fill is complete or is cancelled. While the cache is filling, you may pan and zoom around the map or view other maps without affecting the in fill in progress. Filling the feature cache at multiple extents is supported. Auto cache is paused for the entire project until the fill has been completed.

If a layer's data source is shared across multiple maps in the same project, the cached features are shared across the maps.

A notification alerts you when the cache begins to fill, when the fill is complete, or if an error occurs.

Note:

  • Building a cache for a large area or for an area with many features may take some time. To cancel filling the cache, click Cancel Disable Feature Cache.
  • If there are no visible web feature layers in the map, or if the layers are set to not cache within the layer's properties, a fill is not supported and you will receive a notification.

Caution:

When using Fill Enable Feature Cache in conjunction with Auto Cache, the Fill button Enable Feature Cache will cancel any automated fills in progress. In this workflow, it is recommended that you wait 15 seconds after the map has finished drawing to allow the automated fill procedure to complete before using Fill Enable Feature Cache.

Empty the feature cache for the current map

Emptying the feature cache can be done periodically if there are edits made to the underlying layer from other sources.

On the Map tab in the Feature Cache group, click Empty Clear Feature Cache to empty the feature cache for all layers in the current map.

Caution:

If you don't see the Feature Cache group on the Map tab, follow the steps in a previous section in this topic to access these controls.

The Empty button Clear Feature Cache is always enabled and does not become inactive. The empty operation does not occur if there are pending edits. Edits must be saved or discarded before emptying the feature cache.

If a layer's data source is shared across multiple maps in the same project, the cache for these layers in other maps is affected during the empty operation.

A notification alerts you when the cache is emptied, when an error occurs, or if there are pending edits.

Cancel filling the feature cache

If you have clicked the Fill button Enable Feature Cache and the fill is taking longer than expected, or if you clicked it by accident, you can cancel the process. This button is available only when a cache is being filled.

On the Map tab in the Feature Cache group, click Cancel Disable Feature Cache to cancel fill requests in progress.

Caution:

If you don't see the Feature Cache group on the Map tab, follow the steps in a previous section in this topic to access these controls.

A notification alerts you when a cache fill has been cancelled.

Related topics