Document Explorer widget

The Document Explorer widget allows you to explore files and folders from Autodesk Forma (formerly Autodesk Construction Cloud) projects. The widget functions as a file navigation tool and lists documents in a drop-down folder structure. You can select a document with the Document Explorer widget and view its content with the Document Viewer widget.

Examples

Use this widget to support app design requirements such as the following:

• You want users to explore documents from Forma projects in an ArcGIS Experience Builder app.

• You want users to view supporting documents in projects.

Usage notes

This widget requires connection to a Map widget. The Map widget must contain a web map or web scene from an ArcGIS GeoBIM project. The Document Explorer widget uses information from the Accounts table in GeoBIM to identify the linked Forma hub and projects. It can also be connected to a Document Viewer widget.

To use the Document Explorer widget, you must sign in to an Autodesk Forma account.

The following are the two ways to use the Document Explorer widget:

• Link the Document Explorer widget to a Map widget to display projects, folders, and documents from the linked Forma projects.

• Link the Document Explorer widget to a Document Viewer widget to display documents.

When you include this widget in an app, the widget panel provides users with the following interaction options:

• Expand Autodesk Hub in the widget to navigate through project documents.

• Search for a specific document.

• Zoom to a document in the Map widget if the document is available in the map.

• Click a document, issue, or BIM project feature in the Map widget to filter the Document Explorer widget to only show content from the same Forma project as the selected feature.

• Display a document from the Document Explorer widget in a connected Document Viewer widget.

• Filter Forma project folders based on folder selections made in ArcGIS GeoBIM.

Connect an Autodesk Platform Services application

To use the Document Explorer widget in ArcGIS Enterprise, you must connect your enterprise portal to an Autodesk Platform Services (APS) application.

• If you have an APS application you are using for ArcGIS GeoBIM, add the following URL to the callback URL list:

  Use dark colors for code blocksCopy

  1
  https://webadaptorhost.domain.com/webadaptorname/apps/geobim/aps-auth/

• If you do not have an APS application, create an APS application for ArcGIS GeoBIM, and add the above URL to the callback URL list. After you create the application, you must authorize it for your Autodesk Forma account.

Use the Document Explorer widget in apps deployed to custom web servers

If you host an experience on a custom web server, you must complete the following additional steps to connect an Autodesk Platform Services (APS) application.

1. Prepare an APS application.

   • You can use an existing APS application or create a new one.

2. Configure a callback URL.

   • In your APS application, add a callback URL using your server information. The following is an example callback URL that shows the required format:

     Use dark colors for code blocksCopy

     1
     https://domain.com/cdn/buildNumber/widgets/shared-code/lib/geobim/assets/aps-auth/index.html

   • In the above URL, replace <domain.com> with your web server domain and replace <buildNumber> with the number located in the cdn folder of your downloaded Experience Builder app.

3. Authorize the APS app.

   • Authorize the APS application for the Autodesk hub with custom integration.

Settings

The Document Explorer widget includes the following settings:

• Select a Map widget—Select a Map widget.

• Select a Document Viewer widget to display documents—Select a Document Viewer widget.