SCOPE Studio for VSCode - an extension for developing SCOPE jobs in VSCode. You can author, compile and submit SCOPE job to Cosmos VC and ADLA account as well.
Prerequisites:
Please keep only one VS Code instance before installation. Required SCOPE packages(~261M) will be downloaded and installed after activation (need users' confirmation). Downloading needs to take a while and you should not close VS Code during the installation.Video demo
If your Azure authentication library is "ADAL", you need to switch it to "MSAL" in Settings(Ctrl+,) ("Extensions" > "Azure configuration" > "Azure: Authentication Library"). You must click the "Sign Out and Reload Window" button after modifying this setting for it to take effect.Video demo
If your SCOPE project in VS referenced C# projects, you need to install .NET Framework and MSBuild so that the C# projects can be built by SCOPE Studio on VS Code correctly during the compilation or submission. By installing the "Build Tools for Visual Studio 2022" here, you can have these two components installed automatically.
Feature highlights:
SCOPE Copilot
Users can now use SCOPE Copilot to get answers to questions about SCOPE and Cosmos from within VS Code.
Manage Cosmos VCs
Support adding VC to your favorite VC list in VC Selector.
Authoring
Support creating SCOPE script.
Support creating C# code behind files for SCOPE scripts and adding built-in C# snippets.
Support creating Python code behind files and adding built-in Python snippets.
Support basic SCOPE language service including syntax highlight, auto complete, auto format and code snippets.
Support "go to references" and "go to definition" for SCOPE script.
Compile, debug and submit script
Support compiling SCOPE script.
Support running SCOPE script locally by "Run Without Debugging".
Users can enable/disable local run in parallel in "SCOPE.localRunner.runStepsInParallel" in Settings.
Support debugging SCOPE script locally.
Support submitting SCOPE script to Cosmos VC as well as ADLA account.
Support "Parameter Sets" feature which enables users to create multiple parameter sets.
Support auto token when submitting SCOPE job.
Job view
Support opening job view from job link.
Support opening job list from VC Path or ADLA account.
Support instant job browsing in job list.
Support auto-refreshing job view before job completes.
Support job graph in job view.
Support checking node information for each stage.
Support searching by stage name.
Support zooming in and out.
Support stage dragging.
Support checking job progress.
Users can set the highest stage number in the 'SCOPE.jobgraph.simplified' section in Settings. If the stage number goes beyond this limit, the system will automatically create a more efficient job graph to prevent any slowdown in the rendering process.
Support checking job detail information including error, state history, inputs/outputs and compilation diagnostics in job view.
Support migrating and loading project configurations by opening an existing Visual Studio project folder directly.
Support synchronizing settings back to VS project.
Commands:
SCOPE: Create SCOPE Script - Create a new SCOPE script.
SCOPE: Compile Script - Compile the current SCOPE script locally.
SCOPE: Cancel Build – Cancel build in progress.
SCOPE: Clean Workspace – Remove bin folder in the root path of the workspace.
SCOPE: Generate CSharp Code Behind File - Add a new C# code behind file for the SCOPE script.
SCOPE: Generate Python Code Behind File - Add a new Python code behind file for the SCOPE script.
SCOPE: Login - Login to your account.
SCOPE: Logout - Logout from your account.
SCOPE: Open Job List from Azure Data Lake Analytics Account – Open job list by filling in an Azure Data Lake Analytics account.
SCOPE: Open Job View from Job Link - Open a Cosmos job by filling in a job link.
SCOPE: Open Job List from VC Path – Open the job list by filling in a VC Path.
SCOPE: Run Without Debugging - SCOPE job local run without debugging
SCOPE: Set Default Context - Set default submission Cosmos VC or ADLA account for the working folder.
SCOPE: Set Parameters - Configure parameter sets for the current SCOPE script
SCOPE: Submit Job - Submit the current SCOPE script to Cosmos VC or ADLA account.
SCOPE: Sync Settings Back to VS – Sync all changed settings back to VS project.
Current Limitations:
SCOPE Studio for VSCode on macOS and Linux operating systems is not fully supported.
UDO\UDF\UDT intellisense not fully supported.
Key features demo:
In SCOPE Copilot, Users can use SCOPE Copilot to get answers to questions about SCOPE and Cosmos.
Basic SCOPE language service includes syntax highlight, auto complete, auto format and code snippets.
Cosmos VC Selector - Show VC list and add your favorite VC to the list. You can add selected VC or custom VC
Create a new SCOPE script
The "Parameter Sets" feature can enable users to create multiple parameter sets.
Create C# code behind files for SCOPE scripts and input C# code snippet.
Set default Cosmos VC (ADLA account) for the current working folder for your scripts.
Compile the current SCOPE script locally.
Submit SCOPE script to Cosmos VC.
Show job graph in job view.
Open job list from VC Selector or VC path, open job view from job list or job link. In job view you can check errors, state history, inputs/outputs and compilation diagnostics.
Set default VC, compile script, submit job and generate C# file in right-click menu. Create a SCOPE script in file menu.
