Share

Set up Web Based Tools

Configure Web Based Tools so users can access Forma-integrated tools from Workflow Advisory. Setup covers service account creation, Forma custom integration, and project indexing.

Before you begin

  • Assign the Workflow Advisory subscription to users in Autodesk Manage. See Assign the Workflow Advisory subscription to users.
  • Confirm subscription is active for those users. See Troubleshooting Subscription Access.
  • You must be a Forma hub admin (or equivalent) to add custom integrations and members.
  • Web Based Tools require a Forma Data Management subscription.

Open Web Based Tools and start configuration

  1. Sign in to Workflow Advisory.
  2. Select the Web Based Tools tab, or locate a Web Based Tool on the All tab.
  3. Select Launch on the tool card. The Web Based Tools experience opens in a new browser tab.

Launch a Web Based Tool from Workflow Advisory

  1. Select Folder Permission Auditor for Forma Data Management or Cross-Hub Search for Forma Data Management.
  2. Select Settings.

Web Based Tools Settings

Create the service account

  1. In the Settings tab, select Edit.
  2. Next to the Service Account, select Create.

Service account creation in Configure workflow

  1. View the Service Account generated.
  2. Select the text between DNuw.....PgS and copy it. This is your Client ID.

Client ID for Forma integration

Important: Keep the Client ID available for the next step.

Add a custom integration in Forma

  1. Sign in to your Forma hub with Admin privileges.
  2. Open Hub Admin.
  3. Select Custom Integrations.
  4. Select Add custom integration.
  5. In Autodesk Platform Services Client ID, paste the Client ID from the Settings tab.

Paste Client ID in Forma custom integration

  1. Enter a name (for example, Workflow Advisory) and description.
  2. Select ADD.

See also: Forma Data Management | Custom integrations

Configure project indexing

  1. Return to the Web Based Tools portal by selecting Launch on a Web Based Tool in Workflow Advisory or open https://tools.advisor.autodesk.com.
  2. Open Settings.

Web Based Tools Settings

  1. Select Edit.

Select Edit in Settings

  1. Select Add to add hubs or accounts for which you have Account Admin access.

Settings Add hubs or accounts

  1. Open the Index tab. Projects where the service account is a member appear in the list.

Settings Index tab

  1. Index individual projects, or select multiple projects and select Index.

Index projects

  1. Wait for indexing to complete. Hover over the status column to view current status. Files and folders re-index on a 24-hour cycle.

Project indexing status

Troubleshooting

  • Projects not appearing — Verify the service account has been added to target Forma projects with appropriate permissions.
  • Search or permissions tools empty — Confirm indexing completed; trigger Index manually if needed.
  • Integration errors — Verify the Client ID in Forma matches the Client ID from the Settings workflow.

Expected result

Web Based Tools can be launched from Workflow Advisory and use indexed Forma project data. For day-to-day use, see Launch a Web Based Tool.

Was this information helpful?