180 likes | 371 Views
MicroStation Workspaces for LADPW. Archway Systems, Inc. Mike Lazear. Plugging in to the Bentley world. Profile SELECTservices Learning ( LEARNserver ) Communities ( BeCommunities ) Video ( BeConnected ) Events Bentley Student Center (YouTube channel)
E N D
MicroStation Workspacesfor LADPW Archway Systems, Inc. Mike Lazear
Plugging in to the Bentley world • Profile • SELECTservices • Learning (LEARNserver) • Communities (BeCommunities) • Video (BeConnected) • Events • Bentley Student Center (YouTube channel) • Bentley LEARNing Conference free on-demand recordings • How to learn Bentley Products – YouTube video
Configuration Tools • Bentley Configuration Explorer • Shows all configuration variables and their values • Free from Bentley’s web site – iWare app for PC • http://www.bentley.com/en-US/Free+Software/Bentley+Configuration+Explorer.htm • Notepad++ • Free Notepad type editor that has many excellent features • http://notepad-plus-plus.org/ • Use Settings > Style Configurator to add ucf, pcf, cfg to ini file entry • Windows Explorer (part of Windows, Windows-E to launch) • Add path to Workspace and to MicroStation V8i to Favorites
Configuration Files • MicroStation uses Configuration files to control how it runs • Configuration files contain configuration variables • The configuration files are searched for in a specific order • Examples: • .ucf – User Configuration file • Typically located in …\WorkSpace\Users • Editable text. • .pcf – Project Configuration file • Typically located in …\WorkSpace\Projects • Editable text. • .cfg – General Configuration file • Editable text. • .upf – User Preferences file. • Binary file. Edit by changing settings in Workspace > Preferences. • Storage depends on Windows release but stored within User’s folder (see MS_USERPREF) See Workspace > About Workspace for location of current config files being used
Configuration Variable Types • Program configuration path variables • Tells MicroStation where to find .exe, .dll as well as other file types • Typically will start with a c:\Program Files or c:\Program Files (x86) • Workspace (i.e. Data) configuration path variables • Tells MicroStation where to find resource files like dgnlib, rsc, mvba • Typically will start with a c:\ProgramData path • Value Configuration variables • Actual values used to tell MicroStation • Ex. 0, 1, 08.11.09.357, FALSE, markup
Configuration Levels • 0) System Level • 1) Application Level • 2) Site Level • 3) Project Level • 4) User Level Processed in the above order, Application overrides System, Site overrides Application, Project overrides Site and User overrides Projects. Thus User Level takes priority over all other levels unless locked at an earlier level.
Who sets these Config variables? • 0) System Level • Set by Bentley Developers – avoid changing • 1) Application Level • Set by Add-on Application Developers – avoid changing • 2) Site Level • Set on behalf of corporate/site management by System/IT Manager • 3) Project Level • Set by, or on behalf of, the Project Manager • 4) User Level • Set by, or on behalf of, the User These are typical guidelines and not hard & fast rules
Configuration Levels – System Level • 0) System Level • …\Program Files\Bentley\Microstation V8i (SELECTseries)\MicroStation\config • mslocal.cfg – location of MicroStation and includes the next two • msdir.cfg– location of WorkSpace • Msconfig.cfg – controls the reading of all other config files and levels • 1) Application Level • 2) Site Level • 3) Project Level • 4) User Level
Configuration Levels – Application Level • 0) System Level • 1) Application Level • …\config\appl (this is one folder below the System Level config files) • Set by add-on applications (ex. clashDetection, ProjectWise) • File names ex.: ClashDetection.cfg, PW.cfg, ComponentView.cfg • Could redefine system level config variables but more likely to add new config variables or add additional paths to existing • 2) Site Level • 3) Project Level • 4) User Level
Configuration Levels – Site Level • 0) System Level • 1) Application Level • 2) Site Level • …\Workspace\Standards • Contains config customization for the company or site • By default all .cfg (any name) in the Standards folder will be read • See use of _USTN_SITE in MSCONFIG.CFG • Many folders with Standards that include dgnlib, cells, macros (.mvba), plot configuration files (pltcfg), seeds, and more • 3) Project Level • 4) User Level
Configuration Levels – Project Level • 0) System Level • 1) Application Level • 2) Site Level • 3) Project Level • …\Workspace\Projects • Read AFTER User Level but processed BEFORE User Level • Contains config customization for the project in .pcf file • Many folders within the named project folder with Projects that include dgnlib, cells, macros (.mvba), plot configuration files (pltcfg), seeds, and more • Ex. …\Projects\Building\dgnlib\Levels.dgnlib • 4) User Level
Configuration Levels – User Level • 0) System Level • 1) Application Level • 2) Site Level • 3) Project Level • 4) User Level • …\Workspace\Users • Is read BEFORE Project Level but processed AFTER Project Level • Determines which Project configuration file is processed, which is the reason it is read before the Project Level. • Contains config customization for the user in .ucf file
Key root configuration variablesUse Bentley Configuration Explorer to view values • _ROOTDIR • C:\Program Files (x86)\Bentley\MicroStation V8i (SELECTseries)\MicroStation\ • MSDIR • ${MS} or ${_ROOTDIR}/ • C:\Program Files (x86)\Bentley\MicroStation V8i (SELECTseries)\MicroStation\ • _USTN_BENTLEYROOT • ${parentdevdir {MSDIR}} • C:\Program Files (x86)\Bentley\MicroStation V8i (SELECTseries)\ • __USTN_WORKSPACEROOT • _USTN_WORKSPACEROOT : ${_USTN_INSTALLED_WORKSPACEROOT} • C:\ProgramData\Bentley\MicroStation V8i (SELECTseries)\WorkSpace\ • _USTN_HOMEROOT
Variable definition references • $(VARIABLEREF) = Expand VARIABLEREF when this variable is used. • ${VARIABLEREF} = Expand to current value of VARIABLEREF and does not change. • Configuration variables use / instead of \ internally changed to \ when needed • All Path variables (should) end with /
Variable references examples • MS_DIR = “C:/Stuff/” • MS_DEF = $(MS_DIR) • MS_SEEDFILES = ${MS_DIR} • > All variables if accessed at this point equal “C:/Stuff/” • If later we set MS_DIR = “D:/Stuff/” • If variables accessed at this point what would the values be? • MS_DIR = “D:/Stuff/” • MS_DEF = “D:/Stuff/” • MS_SEEDFILES = “C:/Stuff/
Workspace Operators • = Assign “new_value” to “VARIABLENAME” • : Assign “new_value” to “VARIABLENAME” only if that variable does not already exist (not already set) • > Append directory or file lists defined by “new_value” to a variable definition that defines a path. • < Prepend directory or file list defined by “new_value” to the beginning of a variable defintion that defines a path. • + Append “new_value” to current value of “VARIABLENAME”. Uses a space as a separator. (rarely used)
Preprocessor directives • %include <filename> Includes another config file • %if <expression> Execute following lines if expression is true • %else Execute following lines if original expression on %if was false • %endif End of conditional block • %error <string> Print “string” and exit MicroStation • %lock <varName> Locks the configuration variable • %level Set the level of processing
Configuration Variable List • To get a listing of all MicroStation’s Configuration Variables • load the cfgvars.ma (mdl app) • Utilities > MDL Applications. Click the Browse button and open the “asneeded” folder. Load cfgvars.ma. • Utilities > key-in type the following: • mdl load cfgvarsprintCfgVarResource (case sensitive) • In the MicroStation root directory (within Program Files) search for cfgvars.txt and cfglong.txt. These files list the configuration variables. • Setting _USTN_DISPLAYALLCFGVARS to 1 Workspace > Configuration will show the hidden system Configuration variables. • https://communities.bentley.com/products/microstation/w/microstation__wiki/microstation-v8i-variables.aspx