Web Resource Manager — User Guide
Overview
Web Resource Manager lets you browse, edit, upload, publish, and sync Dataverse web resources directly from MSDC Toolbox. It replaces navigating the Maker Portal for common web resource tasks and supports bulk publish operations.
Prerequisites
- An active connection to a Dataverse environment
- For write operations:
prvWriteWebResourceandprvPublishWebResourceprivileges
Getting Started
- Select Web Resource Manager from the sidebar
- The plugin connects and loads all web resources from the current environment
- The total resource count appears in the header
Interface Layout
| Area | Description |
|---|---|
| Filter bar | Search by name and type chips (JS, CSS, HTML, XML, etc.) |
| Resource list | Virtualised list of all web resources — fast even with thousands of files |
| Editor panel | Code editor for the selected resource (opens on the right) |
| Batch toolbar | Publish and other actions for selected resources |
Workflow
Browsing Web Resources
- All web resources load automatically on startup
- Use the search box to filter by file name or path
- Click a type chip (e.g.
JS,CSS,HTML) to filter by file type — multiple chips can be active at once - Pending (unsaved) resources are shown with an amber indicator
Editing a Web Resource
- Click any web resource in the list to open it in the editor panel
- Edit the content directly in the editor
- The resource is marked as pending (amber chip in the filter bar) until published
Changes are staged locally within the session — nothing is written to Dataverse until you publish.
Publishing Resources
Publish a single resource:
- With the resource open in the editor, click Publish in the editor toolbar
- The resource is saved and published to Dataverse immediately
Bulk publish:
- Select multiple resources using the checkboxes in the list
- Click Publish Selected in the batch toolbar
- All selected resources are published in sequence
Uploading a New File
- Click + New in the header
- In the Create dialog, enter:
- Name — The web resource logical name (e.g.
new_myscript.js) - Display name — The friendly label shown in Dynamics 365
- Type — File type (JavaScript, CSS, HTML, XML, PNG, etc.)
- Name — The web resource logical name (e.g.
- Paste or type the content in the editor field
- Click Create — the resource is created and published immediately
Downloading a Resource
Click the download icon on any resource row to save the file locally in its native format.
Understanding Pending State
When you edit a resource, it enters a pending state:
- The resource row shows an amber border
- The Pending chip in the filter bar counts how many resources are awaiting publish
- Pending changes are not saved to Dataverse until you publish
- Navigating away from the plugin without publishing will discard staged changes
Tips
| Tip | Detail |
|---|---|
| Use type chips for targeted edits | Filter to JS or CSS to find the file quickly in large environments |
| Bulk publish after deployment | Select all modified resources and publish in one click rather than one at a time |
| Download before editing | Download the current version as a local backup before making changes |
| Naming conventions | Follow the publisher_prefix_filename.ext convention (e.g. contoso_orderform.js) to keep the namespace clean |
Troubleshooting
| Problem | Resolution |
|---|---|
| Resource list is empty | Ensure the environment has web resources and your account has prvReadWebResource |
| Publish fails with 403 | Your account lacks prvWriteWebResource or prvPublishWebResource |
| Editor shows garbled content | The file may be binary (image, SVG) — use Download instead of editing in text mode |
| New resource not appearing after create | Click Refresh in the header to reload the resource list |