Getting Started with BimlExpress
What BimlExpress Is
BimlExpress for Visual Studio Code is the free Biml authoring extension from Varigence. It brings Biml editing, validation and SSIS automation to Visual Studio Code on Windows, macOS and Linux. It adds colorizing and IntelliSense for Biml and for embedded C# and VB code nuggets, live error checking as you type, a preview of the flattened Biml your templates produce, commands that build SSIS packages and projects, and import of existing SSIS projects into Biml.
The earlier BimlExpress add-in for Visual Studio is still offered as a download and is no longer developed. BimlExpress for Visual Studio documents it.
Installation
Install BimlExpress, published by varigence-inc, from the Extensions view of Visual Studio Code by searching for BimlExpress, or from its listing on the Visual Studio Marketplace or Open VSX. BimlExpress for Visual Studio Code lists the requirements.
After you install it, open a folder that holds your .biml files. The BimlExpress container in the activity bar holds the Live Biml Files, Import Packages and BimlExpress Account views.
When your session is not licensed, BimlExpress shows an activation prompt with options to enter or request a product key. Azure Data Factory and Microsoft Fabric output needs the Pro emission entitlement on your license. Account and Licensing describes both.
Menu Locations
BimlExpress puts Build Biml and Validate Biml in four places, each with other BimlExpress commands:
- The Command Palette, where the BimlExpress commands include Build Biml, Validate Biml, Import SSIS Assets and BimlExpress Account.
- The editor title bar of a Biml file, with Build Biml and Validate Biml, the command that shows the flattened Biml your templates produce, and BimlExpress Account.
- The Explorer context menu of a Biml file, with Build Biml, Validate Biml and Reveal in Live Biml Files.
- The title bar of the Live Biml Files view, with Build Biml, Validate Biml and the commands that manage the Live set.
The Live Biml Files view tracks your Live set of .biml files. A Build Biml or Validate Biml run from the Command Palette, the editor title bar or the title bar of the Live Biml Files view includes the Live set, so shared definitions are available to that run.
Code Editor
The editor gives colorizing and IntelliSense for Biml XML and for embedded C# and VB code nuggets. It completes elements, attributes, enum values and boolean values, and shows Quick Info tooltips and signature help for Biml, C# and VB regions. Tags, brackets and BimlScript blocks auto-close and auto-indent. As you type, BimlExpress flags malformed XML, Biml schema violations and BimlScript nugget syntax errors. Editing Biml describes these features and their settings.
Next Steps
After installation, open a folder, create a file with the .biml extension, write a small Biml document, and pick Build Biml from the right click menu of the file in the Explorer to confirm the toolchain is wired up. BimlExpress writes the SSIS packages to the output/ssis folder of your workspace, as Build and Validate describes. From there, the rest of the BimlScript walkthroughs cover code nuggets, metadata driven generation, and reusable patterns.