This repo is an open-source project that provides a code for a Dataverse DevTools VS Code Extension that helps you connect to a Dataverse environment, generate TypeScript definitions for entities, create different type of Dataverse-specific projects, upload web-resources right from VS Code and much more.

Do check-out the planned features list. We need your help to complete these planned features.

Table of contents

• ⚙ Features
  • Connect to your Dataverse environment
  • Remembers the connected environment per workspace
  • See connection and entity details (with copy feature)
  • Initialize TypeScript project & add TS File
  • Generate Typings
  • Intellisense for type generated
  • Upload Web Resources
  • Filter by solution
    • Entities
    • Web Resources
  • Smart Match Web Resources
• 🔥 Using Typings
• ⌨ Keyboard Shortcuts
• 🎁 Early-Access Preview
• 🧪 Alpha-Testing
  • ⌚ Features available for alpha-test
• 💭 Planned Features
• ✨ Contributing
• 🔉 Discussions
• 📃 License
• ✍ Credits

There are 3 ways you can connect to your Dataverse Environment.

Below is one of the way you can create the connection.

Once you connect to your preferred Dataverse Environment; the tool will rememeber the connection for that workspace/folder.

This provides an ability for you to quikly check the details of the connection and also copy certain important information.

You can instantiate a TypeScript project for Dataverse that automatically installs all the prerequisites needed:

• @types/xrm
• WebPack
• ESLint
• Prettier

Below procecss shows how you can create a TypeScript project for Dataverse with one of the available options and also how you can add a TypeScript file that loads the code-snippet.

Typings help you write early-bound code. And with the help of @types/xrm you can provide types to all of your variables/methods.

Typings are also integrated with @types/xrm

When you generate typings for entities you are provided with an intellisense; provided you have casted the FormContext into proper Entity type.

Once you build your project you can upload your script directly from the VS Code with the help of Dataverse DevTools.

1. Go to Dataverse DevTools from the Activity Side Bar.
2. From the list of entities, right-click the entity for which you want to create a typing and choose Generate Typings option. You can also filter the list of entities by clicking the filter button on the Entities panel as shown here.
3. Create a onLoad function in your TypeScript file with parameter as executionContext: Xrm.Events.EventContext.
4. Initialize your FormContext global variable casting it with Xrm.<entity name>.

For example: If you wanted to use Accounts entity typings in your TypeScript file then after the typings are generated the code in your TypeScript file will look as shown below:

export function onLoad(executionContext: Xrm.Events.EventContext) {
    const formContext: Xrm.Account = executionContext.getFormContext();
    formContext.getAttribute("accountnumber").getValue();
}

In the above code snippet, Xrm.Account is a typing generated by Dataverse DevTools to provide intellisense specific to the Account entity.

This list showcases the features that are build and ready but not fully tested to be released. You can enable these features by navigating to File > Preferences > Settings and search for Dataverse DevTools and make sure Enable Early Access Preview is checked.

There are different ways in which you can contribute to this open-source project. One of the way is to be part of alpha-testing. In order to perform alpha-testing follow the below steps:

• Fork this project and clone it on your local machine
• Identify the changes in alpha-test mode (list is mentioned below)
• Open the project in VS Code
• Navigate to Run and Debug from Activity Bar
• Make sure Run Extension is selected; click on ▶️ icon.
• This will open another VS Code instance, this instance will have Extention Development Host on it's title
• You are ready to perform your tests

1. Ability for users to select their default TS template: From the settings option you can now select your default TS Project Template. Selecting the default template will skip the question when you initiate a TS Project.
2. Improvement to Smart Match: Smart Match has got a new look-and-feel. It is more robust, shows all the available local files with a status of linked, recommended link or not linked. Recommended link will have a confidence score that will help you link the local files with server files.

Report any issues or feedback on GitHub.

• Integrate with Dataverse-ify.
• Initiate plugin project.
• Ability to create JavaScript project and snippets smiliar to TypeScript version.

We encourage you to pitch in, join the team and showcase your name on this repo. If you are unsure how you can contribute, please reach out to Power Maverick.

Different ways to contribute:

• Improve the code or fix a bug by creating a Pull Request.
• Get involved in Alpha & Beta tests.
• Provide suggestions, feedback or feature request on GitHub.
• Report issues & bugs on GitHub.
• Answer any open questions on the Discussion Board.
• Join Power Platform LevelUP community on Discord to answer any of the questions that may rise w.r.t. this tool.

Before creating the pull request for contributing, please read the Contributing Guidelines.

Thanks goes to these wonderful people (emoji key):

Danish Naglekar 💬 💻 🖋 🎨 📖 🚇 🛡️ ⚠️ 🔧 ✅	mohsinonxrm 💬 🐛 💻 💡 🤔 🔌 🔬 📓	Josh Smith 🐛 🚧 📓	P-focT 🐛 🚧 📓	Benedikt Bergmann 💡 🤔	Phil Cole 🐛 🤔	Jeff Dodds 🧑‍🏫
MattB 🧑‍🏫	Thomas Sandsør 🐛 🤔 ⚠️ 📓	glemis 🐛 💻 ⚠️ 📓	Eric Regnier 🐛	Guido Preite 🐛 💻 🚇 ⚠️ 🚧 📓	SatkunamSuganthar 🐛

This project follows the all-contributors specification. Contributions of any kind welcome!

If you want to have any discussions on any feature, please use the Discussion Board.

This software is released under MIT License

Icons sourced from - https://icon-sets.iconify.design

JSON to TypeScript conversions - https://quicktype.io/typescript