URL: https://github.com/phuocle/Dynamics-Crm-DevKit/wiki/cli/webresources

The webresources task uploads web resources (HTML, CSS, JavaScript, images, etc.) to Dynamics 365 / Dataverse.

DynamicsCrm.DevKit.Cli.exe /conn:"YourConnectionString" /json:"DynamicsCrm.DevKit.Cli.json" /type:webresources /profile:"ProfileName"

Add a webresources section in your DynamicsCrm.DevKit.Cli.json:

{
  "webresources": [
    {
      "profile": "DEBUG",
      "solution": "YourSolution",
      "prefix": "new",
      "folder": "WebResources",
      "includefiles": [
"*.js",
        "*.html",
        "*.css",
        "*.png",
        "*.jpg",
        "*.gif",
     "*.ico",
   "*.xml",
        "*.xsl",
        "*.xslt",
     "*.svg"
    ],
      "excludefiles": [
        "*.map",
        "*.ts"
      ]
    }
  ]
}

Web resources are automatically named following Dynamics 365 conventions:

{prefix}_{relativepath}_{filename}

Examples:

• WebResources/scripts/account.form.js ? new_/scripts/account.form.js
• WebResources/css/styles.css ? new_/css/styles.css
• WebResources/images/logo.png ? new_/images/logo.png

• Only uploads changed files (compares file content)
• Creates new web resources automatically
• Updates existing web resources
• Preserves web resource metadata

• Maintains folder hierarchy in web resource names
• Uses / as path separator in web resource names

• Scripts (JS)
• Styles (CSS)
• Pages (HTML)
• Data (XML, RESX)
• Images (PNG, JPG, GIF, SVG, ICO)

DynamicsCrm.DevKit.Cli.exe ^
  /conn:"AuthType=Office365;Url=https://contoso.crm.dynamics.com;[email protected];Password=pass" ^
  /json:"DynamicsCrm.DevKit.Cli.json" ^
  /type:webresources ^
  /profile:"DEBUG"

{
  "webresources": [
    {
      "profile": "SCRIPTS",
      "solution": "MyProject",
      "prefix": "myproj",
      "folder": "WebResources",
      "includefiles": ["*.js"],
      "excludefiles": ["*.map", "*.min.js"]
    }
  ]
}

DynamicsCrm.DevKit.Cli.exe ^
  /sdklogin:"yes" ^
  /json:"DynamicsCrm.DevKit.Cli.json" ^
  /type:webresources ^
  /profile:"DEBUG"

{
  "webresources": [
    {
    "profile": "ALL",
   "solution": "MyProject",
  "prefix": "myproj",
      "folder": "WebResources",
      "includefiles": [
        "*.js",
  "*.html",
    "*.css",
        "*.png",
        "*.svg"
      ],
"excludefiles": [
        "*.map",
        "*.ts",
        "*.scss"
      ]
    }
  ]
}

The task outputs:

• ? CREATED - New web resources created
• ? UPDATED - Existing web resources updated
• ?? DO_NOTHING - No changes needed

Sample output:

| ? CREATED new_/scripts/account.form.js
| ? UPDATED new_/css/styles.css
| ?? DO_NOTHING new_/images/logo.png

WebResources/
??? scripts/
?   ??? entities/
?   ?   ??? account.form.js
?   ?   ??? contact.form.js
?   ??? common/
?       ??? utilities.js
??? css/
?   ??? styles.css
??? images/
    ??? logo.png
??? icons/
        ??? custom.svg

Results in:

• new_/scripts/entities/account.form.js
• new_/scripts/entities/contact.form.js
• new_/scripts/common/utilities.js
• new_/css/styles.css
• new_/images/logo.png
• new_/images/icons/custom.svg

Note: Web resources are uploaded but NOT automatically published. To publish:

1. Manual Publishing: Use Dynamics 365 UI to publish web resources
2. PowerShell: Use Publish-AllXml command
3. SDK: Call PublishAllXml or PublishXml messages

Solution: Publish the web resources in Dynamics 365

Solution: Check file extension is in includefiles list and not in excludefiles

Solution: Verify prefix matches your publisher prefix

Solution: Ensure user has privileges to create/update web resources

1. Use descriptive prefixes that match your publisher prefix
2. Organize files in logical folder structures
3. Exclude source files like .ts, .scss, .map
4. Version control your web resources
5. Test locally before deploying
6. Publish after upload to make changes visible

1. Use specific file patterns instead of uploading everything
2. Separate profiles for different resource types
3. Exclude build artifacts and source maps

• downloadwebresources - Download web resources from Dynamics 365

• DynamicsCrm.DevKit.Cli
• Connection Strings
• Web Resource Project Template