This discussion has been locked.

You can no longer post new replies to this discussion. If you have a question you can start a new discussion

MicroStation CONNECT Edition SDK Update 17.2

March 7, 2023

The MicroStation SDK team is pleased to announce the release of MicroStation CONNECT Edition SDK Update 10.17.02.09.
The current release provides several enhancements in the following areas:

Executive Summary
Keep Current
Release Notes
Requirements
Changes > Updates and Enhancements
Resources

Executive Summary

Microsoft Visual Studio 2019 Professional (or better) is the default toolset requirement.
Recompile MDL applications when toolset requirements have changed.
Incremental updates: APIs, Documentation, Examples, eula.pdf

Keep Current

MicroStation SDK (Announcements, Downloads, Migrating to CONNECT, Roadmap, ChangeLogs)
- Announcements (Chinese, English, German)
- Blogs (Chinese, English, German)
- Wikis (Chinese, English, German)
- Forums (Chinese, English, German)
Documentation
- Local CHM Files (Incremental API Updates)
- Optional: SDK Previews > Docs
Learn
- Developer Training
- LEARN, Medium, YouTube
Bentley
- developer.bentley.com, bdn.bentley.com, bentley.com

Requirements

MicroStation CONNECT Edition SDK native (C/C++) and managed code (.NET add ins) development requires:

Microsoft Visual Studio 2019 Professional (latest patches)
Microsoft .NET Framework 4.6.2 runtime (required for Windows 2012 and prior)
Microsoft 8DOT3NAME support is required for source code project paths with spaces

Bentley Visual Studio Templates

SDKPreviews > Visual Studio Extensions

Microsoft Visual Studio Configuration Recommendations

Visual Studio - Workload Dependencies

Desktop development with C++ (Microsoft.VisualStudio.Workload.NativeDesktop)
- Provides Debugging (DIA SDK, or GitHub) via part of the VC++ Toolset
.NET Desktop Development (Microsoft.VisualStudio.Workload.ManagedDesktop)
- Microsoft .NET Framework 4.6.2 runtime (Microsoft.Net.Component.4.6.2.TargetingPack)
SDKs, Libraries and Frameworks
- Universal Windows Platform development (Microsoft.VisualStudio.Workload.Universal)
- Windows 10 SDK (Microsoft.VisualStudio.Component.Windows10SDK. Alt Download)

Visual Studio - Installing and Configuring

Install: Get set up, or
Configure: Workloads and Components, or
Modify: Using Command-line parameters and Workload and Component IDs

Visual Studio - Toolset location Changes

Note: Microsoft recommends binding 1 Toolset (version) per 1 Development Shell (environment instance)

Release Notes

General
- Some CHM files are Missing in this release of the SDK and can be obtained and manually installed from here.
- Modify the Desktop and/or Start Charm/Menu shortcut properties to enable: "Run as Administrator"
- MicroStation CONNECT Edition SDK releases are generally available within 2 weeks of a respective closely paired MicroStation product release.
- To ensure maximum compatibility and stability of your applications:
  - Recompile custom applications when Microsoft Visual Studio version changes, or Breaking Changes are mentioned.
Bug Fixes - Review Resolved Defects: MicroStation CONNECT Edition - Resolved Issues
Breaking Changes - N/A

Changes

MicroStation Developer Shell

Incremental Updates and Enhancements

SDK Root	N/A
Bin	SDKCommonEnv.bat (BLI 1090328 - Add VerifyRequirements) SDKMacros.bat (BLI 1090325 - Add SDKMacros) SDKPrefs.bat (BLI 1090328 - Add VerifyRequirements)
Documentation	Incremental API Updates. See: Include* section (below) and ChangeLogs*
Examples	Added DgnEC\DgnECManagedPropertyPaneExample (BLI 1018729 - Add SDK Example Show Properties of DgnEC Instance in Property Pane) Updated examples\Elements\SteelMaster (Bug 1090301 - Fix Steel build dependency issues) examples\Miscellaneous\steel (Bug 1090301 - Fix Steel build dependency issues)
Include	Constraint2d\Constraint2dCoreAPI.h Add Enum VertexType (Centroid) Add Enum Constraint2dType (EqualAngle) DgnPlatform\CustomItemType.h Add GetAccessStringFromContext, GetInstanceClassFromContext, IsContextAvailable DgnPlatform\DgnECTypes.h Add DgnECExtendedType::DirectionAngle DgnPlatform\DgnPlatform.h Add MAX_MATRIX_DATA_DOUBLE, MAX_MATRIX_DATA_INT DgnPlatform\DgnPlatform.r.h Add hideTextFieldBkgrnd DgnPlatform\DgnPlatformErrors.r.h, Add: DGNMODEL_STATUS_TNodeMaxLengthError DGNMODEL_STATUS_InvalidPixelsFormat DGNMODEL_STATUS_OversizedMatrixData DGNMODEL_STATUS_InvalidNumValueData DGNMODEL_STATUS_InvalidBSPLINECURVE DGNMODEL_STATUS_InvalidBSPLINESURFACE DgnPlatform\DisplayFilter.h Add ViewFlag_TextFieldBkgrnd DgnPlatform\MaterialSettings.h. Add: MAPTYPE_PBRClearcoatFlatten MAPTYPE_PBRClearcoatIntensity MAPTYPE_PBRClearcoatNormal MAPTYPE_PBRClearcoatRoughness MAPTYPE_PBRClearcoatTint GetClearcoatColor GetClearcoatColorR GetClearcoatFlatten GetClearcoatIntensity GetClearcoatNormalMapScale GetClearcoatRefract GetClearcoatRoughness GetPBRClearcoatColor GetPBRClearcoatColorR GetPBRClearcoatFlatten GetPBRClearcoatIntensity GetPBRClearcoatNormalMapScale GetPBRClearcoatRefract GetPBRClearcoatRoughness SetClearcoatColor SetClearcoatFlatten SetClearcoatIntensity SetClearcoatNormalMapScale SetClearcoatRefract SetClearcoatRoughness SetPBRClearcoatColor SetPBRClearcoatFlatten SetPBRClearcoatIntensity SetPBRClearcoatNormalMapScale SetPBRClearcoatRefract SetPBRClearcoatRoughness DgnPlatform\TextTableHandler.h Add: TableMinorId DgnPlatform\TextTableStyle.h Add SortTableStyles Geom\DPoint3dOps.h Add ConvexHullXY, AreaPerpendicularToUpVector Geom\Polyface.h. Add: CreateTrianglesInHoles ExtractBoundaryStrings ExtractTopologicalBoundaryStrings HoleFillingOptions IsIncludeOriginalFacets IsPlanarWithinSuperfacets IsValidEdgeCount IsValidPerimeter NormalizedUpVector TryGetMaxSingleFacetLocalXYLength TryGetMaxSingleFacetParamLength Mstn\Constraint2dElement\ConstraintHandlerBase.h Add _DoModifyAgendaEntries Mstn\MdlApi\dlogids.r.h Add TOGGLEID_OpenWithoutRef, MENUSEARCHID_ImportSub_KML, ICONCMDID_KmlImport Mstn\MdlApi\helpids.r.h Add HELPID_PULLDOWN_InpSub_KML Mstn\MdlApi\rmdlgids.r.h. Add: ERROR_NotXAMIS ERROR_NotXWCS ICONCMDID_attachAMIS ICONCMDID_newAMIS ICONID_attachAMIS_16x16 ICONID_newAMIS_16x16 MENUSEARCHID_RMDlgAttachAMIS MENUSEARCHID_RMDlgAttachWCS MENUSEARCHID_RMDlgEditXAMIS MENUSEARCHID_RMDlgEditXWCS MENUSEARCHID_RMDlgNewAMIS MENUSEARCHID_RMDlgNewWCS MENUSEARCHID_RMDlgPopupEditAMIS MENUSEARCHID_RMDlgPopupEditWCS MISCID_AMISATTACHBALLOONSTRFORGA MISCID_AMISFileFilter MISCID_AMISFileSInvalidGCS MISCID_AMISNEWBALLOONSTRFORGA MISCID_ATTACH_WCS MISCID_EDITAMIS MISCID_EDITWCS MISCID_NEW_WCS MISCID_WCSFileFilter Mstn\cmdlist.r.h Add CMD_SET_PLACEMENTPOINTNAME, CMD_REFERENCE_LOADREFERENCE Mstn\MicroStation.r.h Add quickLoadRef
Library	N/A
Migration Tools	N/A
MKI	Various make files (*.mki) mki\CaptureCommandEnv.py (Updated Visual Studio version numbers and build ids)

Updates and Enhancements

Bugs	Bug 946864 - VBA File properties documentation- Update Design File Property Descriptions (typical) ActiveDesignFile.Author ActiveDesignFile.Comments ActiveDesignFile.Client ActiveDesignFile.Company ActiveDesignFile.DateLastPlotted ActiveDesignFile.Title ActiveDesignFile.Manager ActiveDesignFile.Subject Bug 974065 - Update Constraint2ddemo.cpp to call BeFileName--GetDirectoryName vs GetSystemDirectoryW Bug 1086590 - Fix Copyrights for Audit Bug 1090301 - Fix Steel build dependency issues
Backlog Items	BLI 1090325 - Add SDKMACROS InstallLogs - list and navigate to Bentley installer log location FILEDETAILS - list files: long names, short names, MD5, last modified time FILEMODS - Arg1: list file (types) modified in past Arg2: (or future) X number of days optionally ordered by Attribute FILETYPES - quantify file types under current folder FILEVERSIONS - list library file version metadata SHORTFILE - list 8DOT3NAME for all files under current folder SHORTFOLDER - list 9DOT3NAME for all folders under current folder BLI 1090328 - Add SDK Requirements
Resolved Issues (Product)	MicroStation CONNECT Edition - Resolved Issues

Resources

MicroStation CONNECT
- MicroStation CONNECT Edition SDK Downloads
- MicroStation CONNECT Edition (Product) Releases
- New to MicroStation CONNECT? (New/Experienced Developers)
Bentley CONNECTION Center Bentley online services portal
Developers and Programming - Search and Ask (general) Bentley API/SDK Programming questions
Bentley Developer Network - Visit to learn more about: the BDN Program, Search and Ask questions and more!
Bentley Developer Network Inquiry/Contact Us Form - SDK access or download SDK issues
Security - Common Vulnerability Exposure Program (bentley.com)
Support Lifecycle Policy, Privacy, Terms of Use, EULA (Legal and Privacy)
Terminology

Available Languages: Chinese, English, German