Manage 3D layers

You can manage the following for 3D layers:

• Rebuild the layer cache for 3D layers that have associated feature layers.

  Publishing a scene from ArcGIS Pro can create both a 3D layer and an associated feature layer.

• Replace 3D layers that don't have an associated feature layer.

  If the layer does not have an associated feature layer but the layer source is a scene service, you can update the layer's contents by replacing it with another 3D layer that has a scene service source.

  Tip:

  The layer's source is listed on the Overview tab of the layer's item page.

• Enable data export from a 3D layer that has a scene service source.

  When you enable the ability to export data, the 3D layer can be used as input for geoprocessing tools. This setting is not supported for voxel layers or 3D layers published from a cache dataset.

Only the owner of the 3D layer or an organization administrator can rebuild the cache on the layer or replace the layer.

Rebuild the hosted 3D layer cache

The layer owner or an administrator in the organization can rebuild all or part of the 3D layer cache after editors make changes in the associated feature layer.

• For point layers that are edited, rebuilding the cache incorporates all appended features and edits to feature geometry and attributes into the 3D cache.
• For 3D object layers and building layers, rebuilding the cache incorporates attribute updates and appended features into the 3D cache.

For example, if the layer contains points that represent street furniture—such as benches, fountains, and planters—and the locations of some of the benches change, you can rebuild the 3D cache to reflect the new position of those benches. Similarly, if some of the benches are rebuilt with a different material, and the style in the 3D layer varies depending on material type, rebuild the 3D layer cache to include the new attribute and, therefore, the new style.

Tip:

To improve drawing performance, edit the hosted 3D layer in ArcGIS Pro rather than editing the associated feature layer in Map Viewer. See Edit a scene layer with associated feature layer in the ArcGIS Pro help for instructions.

In most cases, updating part of the cache takes less time than rebuilding the entire cache. However, 3D layer performance may degrade over time if you only rebuild parts of the cache. Eventually, you will need to rebuild the entire cache to optimize caching. In general, you should rebuild the entire cache after the cache is partially rebuilt 10 consecutive times. After you rebuild the whole cache, you can again rebuild parts of the cache.

Rebuild the cache

Follow these steps to rebuild the cache to incorporate changes from the point, 3D object, or building features:

1. Sign in to the portal as the layer owner or an organization administrator.
2. Open the item page for the layer, click the Settings tab, and scroll down to the Scene layer section.
3. Click Manage cache.
4. Choose to rebuild the entire cache, or rebuild only the portion of the cache that has changed since the last time the cache was built.
5. Choose what to rebuild:
   • To rebuild the entire cache, choose Full cache. The cache will be rebuilt. If you published the 3D layer with a feature layer that references registered data, and you update the schema of the feature data, you must use this option to incorporate the schema changes into the 3D layer.
   • To rebuild only the portion of the cache that contains geometry or attribute changes (or both) since the last time the cache was built, choose Partial updates with geometry and attribute changes since the last update will be rebuilt.
6. Click Rebuild cache.
7. Click OK to confirm that you want to rebuild the cache.

   The time it takes to rebuild the cache depends on whether you are rebuilding the entire cache or part of the cache; the number of features and attributes in the feature layer; whether the features are points, multipatches, 3D objects, or buildings; and whether the multipatches or 3D objects include textures.

   To monitor the status of the cache, click Job status. If the cache fails to rebuild, click the job ID for information about why it failed.

Schedule the cache to be rebuilt

If the 3D layer is edited frequently, you can create tasks that schedule the layer's cache to be rebuilt at the intervals you specify. Configure tasks sparingly and at time intervals as far apart as possible.

When you configure tasks to rebuild the cache at regular intervals, consider how frequently the data is updated, and balance the resource burden placed on the ArcGIS Enterprise machines to rebuild the cache against your users' tolerance for out-of-date 3D data.

You can schedule up to two tasks: one to rebuild the entire cache and one to rebuild only part of the cache.

Follow these steps to schedule tasks to rebuild the hosted 3D layer cache:

1. Sign in to the portal as the layer owner or an organization administrator.
2. Open the item page for the layer, click the Settings tab, and scroll down to the Scene layer section.
3. Click Schedule cache rebuild.
4. Click Add rebuild task and choose to schedule a task to partially rebuild the cache or rebuild the entire cache.
   • Full rebuild—Choose this option to rebuild the entire cache on the schedule you define.
   • Partial rebuild—Choose this option to create a task that regularly rebuilds only the portion of the cache that contains geometry or attribute changes (or both) since the last time the cache was built.
5. Define the schedule for the task.
   1. Click Beginning on and choose the date on which the task will start running.
   2. To define the unit of time when the task will repeat, choose one of the options in the Repeat type drop-down menu.
   3. Use the Repeat interval drop-down menu to choose how often you want the cache to rebuild.

      Keep in mind that it may take many minutes or hours to rebuild a full 3D layer cache, depending on its size. Do not schedule the rebuild task to run more frequently than each individual rebuild operation can complete.

   4. Use the Ending on drop-down menu to choose when the tasks will stop running. Options are as follows:

      • Never—The task will continue to run at the specified intervals until you edit, pause, or delete the task.
      • Date—When you choose Date, the End date field appears. Choose the date you want the tasks to stop running.
      • Count—To run the task a specific number of times, choose Count and use the up or down arrows to specify the number of times the task will run at the interval you specified.

   5. Click Create task to create the schedule task.

The cache will rebuild on the schedule you specified. If the rebuild operation fails five times in a row, you will receive a notification.

To access notifications, click Notifications at the top of the website.

You can open the task details as described in the next section and examine the log of the results created by the failed jobs. You can also go to the ArcGIS Server logs for the hosting server to understand the causes for failures and correct them. Once you correct the problem and are ready to rerun the task, resume the task as described in the next section.

See the next section for instructions to view the status of the scheduled rebuild operations or to alter the task schedule.

Manage tasks

You can alter the schedule for existing tasks, view the status of each rebuild operation, pause the task to prevent the cache from being rebuilt temporarily, or delete a task.

Follow these steps to manage a task:

1. Sign in to the portal as the layer owner or an organization administrator.
2. Open the item page for the layer, click the Settings tab, and scroll down to the Scene layer section.
3. Click Schedule cache rebuild.
4. Click in the Actions field for the task you want to manage and choose the action to complete.
   • Details—Click Details to view a list of the individual jobs, the status of each, and a log of the results created each time the task ran.

     Tip:

     You can also open the task's details by clicking the link in the task's Name column.

   • Edit—Click Edit to change the schedule for the task. You can change how frequently the task runs and change the end date for the task.

     Tip:

     You can also alter the task's schedule by clicking the link in the Schedule column for the task.

   • Pause—For an active task, click Pause to prevent the task from running until you resume it. Click Pause again to confirm that you want to suspend the task temporarily.
   • Resume—For a paused task, click Resume so that the task will begin running again on the specified schedule. Click Resume again to confirm that you want the task to start running again.
   • Delete—If you no longer need the scheduled task, click Delete to remove it. Click Delete again to confirm that you no longer need the task to rebuild the cache on the schedule you specified.
5. Click Save task to apply the changes you made to the task.

Replace a 3D layer

If the hosted 3D layer does not have an associated feature layer and the 3D layer's source is a scene service, you can update the 3D layer's contents by replacing it with another 3D layer that you published from a scene layer package (SLPK). If the 3D layer references a precreated extracted scene layer package or i3sRest content in a folder or cloud data store, you can replace the 3D layer with another layer that references a precreated extracted scene layer package or i3sRest content. This allows you to update the contents of a 3D layer without deleting it. You must own both the existing and the replacement layer.

Tip:

If the layer has an associated feature layer, you cannot replace the layer. Rebuild the cache instead. You can identify whether the 3D layer has an associated feature layer by checking the Details section of the 3D layer's item page.

Replacing a 3D layer provides the following benefits:

• Because the item ID and URL of the existing layer don't change, the scenes and apps that use the layer do not need to be updated to reference a new layer.
• Replacing the contents of the current layer does not generate new 3D caches. Therefore, no one has to wait for the cache to be rebuilt. Scenes and apps that use the current layer will continue to work after you replace the layer.
• The portal creates an archive of the old content, which allows you to revert to this content if necessary.

Note:

Use the same coordinate system for the replacement layer's package or precreated cache as you used for the current layer. This setting must match. In addition, the replacement and existing layer type must be the same.

Follow these steps to replace an existing 3D layer (scene service source) with a another one:

1. Sign in as the owner of the layer, as an organization administrator, or with an account that has privileges to update all members' items.
2. Open the item page for the layer.
3. On the Overview tab, click Replace layer.
4. Click Select layer.

   In the pane that appears, you can search, browse, filter, and sort available layers to find the replacement layer. You can also view the details for each layer by clicking View details.

   Only 3D layers of the same type will be listed in the Select replacement layer window.

5. When you locate the 3D layer you want to use, click Select.
6. Click Next to proceed to the Archive window, where you can rename the title of the archive layer.
7. To import an updated thumbnail, summary, description, and tags from the replacement layer, scroll down and enable Replace item information.

   The summary page shows the current hosted 3D layer, the layer that will replace the content in the current layer, and information related to the archive layer.

8. To use a different replacement layer, click Select replacement layer and choose a new layer.
9. Once you are satisfied with the layers, click Replace to perform the replacement operation.

Enable data export

Geoprocessing tools allow you to perform analysis and data manipulation on geographic data. To run a geoprocessing tool on a 3D layer, you must enable data export on the layer.

As the layer owner or an organization administrator, you can enable data export on all types of 3D layers that have a scene service source, except voxel layers.

Follow these steps to enable a 3D layer for data export:

1. Sign in to the organization as the item owner or an organization administrator.
2. Open the item page and click the Settings tab.
3. Scroll to the bottom of the settings and enable the Allow others to export to different formats toggle button.
4. Click Save.

Share the layer with those who need to run geoprocessing tools on the layer.