Update README.md

Decoupled from VS documentation
This commit is contained in:
Christian Wade 2023-09-29 15:13:45 -07:00 committed by GitHub
parent cdae6b5603
commit 8a44f8cc50
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,42 +1,17 @@
### General Usage For a detailed list of features, see the ALM Toolkit and BISM Normalizer [documentation](https://github.com/microsoft/Analysis-Services/blob/master/AlmToolkit/Model%20Comparison%20and%20Merging%20for%20Analysis%20Services.pdf).
Download from the BISM Normalizer [Visual Studio Marketplace page](https://marketplace.visualstudio.com/items?itemName=ChristianWade.BISMNormalizer3). New releases will be uploaded to this page. ### History & use cases
This video covers BISM Normalizer 3 use cases and demo. The ALM Toolkit codebase started out as the BISM Normalizer Visual Studio extension. ALM Toolkit is decoupled from Visual Studio.
This video covers BISM Normalizer 3 use cases and demo. The use cases still apply to ALM Toolkit.
[![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/LZdOwfJqFrM/0.jpg)](http://www.youtube.com/watch?v=LZdOwfJqFrM) [![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/LZdOwfJqFrM/0.jpg)](http://www.youtube.com/watch?v=LZdOwfJqFrM)
### Object Model & Build Process
This video shows the internals of BISM Normalizer 3. Everything still applies except obfuscation, which has been removed. ### Internal code/object model
This video shows the internals and object model of BISM Normalizer/ALM Toolkit. Most of it is still relevant today.
[![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/r3eGK-dSYuw/0.jpg)](http://www.youtube.com/watch?v=r3eGK-dSYuw) [![IMAGE ALT TEXT HERE](http://img.youtube.com/vi/r3eGK-dSYuw/0.jpg)](http://www.youtube.com/watch?v=r3eGK-dSYuw)
### Command to Perform a Release Build
Output goes to bin\ReleaseObfusc
`msbuild BismNormalizer.csproj /verbosity:m /target:Rebuild /property:Configuration=Release`
### Set Up New Development Machine
VS 2019 Workloads installed must include .NET desktop development and VS extension development.
Requires VS Installer Projects [extension](https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2017InstallerProjects).
May need to temporarily comment out following at bottom of BismNormalizer.csproj to load project into VS for 1st time. After 1st successful load, add it back.
`Import Project="..\packages\MSBuild.Extension.Pack.1.8.0\build\net40\MSBuild.Extension.Pack.targets"`
Update: 4/23/2018: AMO libraries are now accessed through NuGet references, so no longer necessary to install AMO client libraries from the [MSI](https://docs.microsoft.com/en-us/azure/analysis-services/analysis-services-data-providers).
Do a Release build from the command-line to set up cross project references for the 1st time (see command above) - and then close and reopen VS.
Set AlmToolkit or BismNormalizer as startup project
In BismNormalizer project properities > Debug tab, set
* Start External Program (assuming Enterprise edition): C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\devenv.exe
* Command Line Arguments: /rootsuffix Exp
The automated tests refer to a localhost SSAS tabular server.