Bentley Building Application Deployment Guide:

Transcription

1 Bentley Building Application Deployment Guide: s Version 1.0 November 2009, v8i (SELECTseries 1) release Version 1.1 Revisions for November 2009, v8i (SELECTseries 1) release Installing Building Applications into a s (Typical Configuration) This document: is intended to provide recommendations and implementation guidance to provide the best integration of the Bentley Building applications into a ProjectWise Environment. The Bentley Building suite of applications include; Bentley Architecture (BA), Bentley SpacePlanner (BSP), Structural Modeler (formally Bentley Structural (BS)), Bentley Building Mechanical Systems (BBMS), and *Bentley Building Electrical Systems (BBES) is a supplemental document to the "ProjectWise Implementation Guide" and the help documentation provided by ProjectWise Administrator and ProjectWise Client and shares common concepts and instructions. However, this document is intended to provide the best path of ProjectWise integration for the Building Applications. will focus on topics concerning ProjectWise application definition, workspace integration and Project association, please refer to ProjectWise documentation for topic not addressed. *Note: This document will provide recommendations and implementation guidance that can be applied to the integration of Bentley Building Electrical Systems application into a ProjectWise environment, but does not provide a complete guide to fully integrate the Bentley Building Electrical Systems supporting database. Restriction and Limitations of integrating Building Application in a ProjectWise Managed workspace: ProjectWise managed workspace support for building applications was introduced in xx (SELECTseries 1) and integrated with ProjectWise xx (SELECTseries 1) and is not supported in previous version. PW managed workspace does not support an offline or briefcase mode, PW manage workspace require an active connection to a PW server. PW managed workspace is a thick client solution and is not support with the ProjectWise Web Client (SharePoint Web parts) When working with ProjectWise managed workspaces, users should be encouraged to access and open files through the ProjectWise Explorer and not through application shortcuts in the start menu, quick launch toolbar or desktop. These application shortcuts will open the application in an unmanaged mode and require the application to restart when opening a managed file. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 1

2 It is encouraged that the ProjectWise environment be configured for a "Captive" environment. (When working in integrated applications, the term captive environment refers to the state of integration when the user cannot save documents to or open documents from the local file system. They are captive to working in the ProjectWise environment. ) Please consult your ProjectWise implementation team and/or administrators before ProjectWise is configured for a "Captive" environment. The "idesktop integration for Bentley MicroStation" is required to be installed to support MicroStation's integration with ProjectWise. To disable ProjectWise Integration when MicroStation is launched from the desktop, edit the pw.cfg (..\Program Files\Bentley\MicroStation (SELECTseries 1)\config\appl), uncomment (remove the # from the beginning of the line) the following lines: %if!defined (_PWEXPLORER) PW_DISABLE_INTEGRATION=1 %endif For ProjectWise Manage Workspaces, ProjectWise administrators / users are encouraged to set the user option to "Leave Local Copy on check in". This will increase operational performance with large projects. If changes in files are detected, ProjectWise will synchronize as required. The following building application sub systems can run as external standalone applications, independently of the primary building applications. These building application sub systems can also be launch internally from within the building applications. When the building applications are integrated with ProjectWise Managed workspaces, these subsystems are only supported when launched internally. ProjectWise Managed workspace integration is NOT available for these subsystems when launched as an external standalone application. Datagroup Catalog Editor Datagroup Definition Editor JSpace Interference Detection Engine Parametric Cell Studio (PCS) The Trane Ductulator installed with Bentley Building Mechanical Systems, the RAM Viewer, installed with Structural Modeler (formally Bentley Structural), MicroStation Triforma Backup utility and the JSpace Class editor have not been integrated and/or may not benefit from integration with ProjectWise Managed Workspaces. Configurations file located in either the local workspace\standards directory or a centralized "Shared" workspace\standards directory are automatically processed and are incorporated as part of the ProjectWise Managed workspace. Diligence is required to insure the configuration files contained within either of these directories does not contaminate the Configuration. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 2

3 Before You Begin A fully operational and configured ProjectWise Server and a defined datasource must be available. Access to ProjectWise Administrator and the ProjectWise Client applications with corresponding administrator privileges are required. Please consult your ProjectWise implementation team and/or administrators before initiating ProjectWise Manage workspaces. Install and configure all the Bentley Building and other Bentley application onto a client workstation. This will ensure the \Documents and Settings\All Users\Application Data\Bentley\MicroStation\Workspace has all the require components for you application prior to importing it into ProjectWise. Use this client to complete the instruction in this document. Overview of Steps: 1. Import Workspace files into PW in a folder called Building Workspace (Using Manage Workspace Wizard) (approx. 30+ Min) 2. Import MicroStation Configuration File to ProjectWise Configuration Setting Blocks (Using Manage Workspace Wizard) (approx. 10 min) 3. Add/Edit ProjectWise CSBs (approx.5 Min) 4. Add exclusions (approx.5 Min) 5. Add v8i Application shortcuts & Link Applications to Manage CSBs (approx. 5 min ) 6. Link CSBs to the Projects (approx.5 Min) 7. Test/Validate (Troubleshoot) Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 3

4 * Time estimates are approximated based on out of the box configuration and based on a remote connection to the PW server. Individual result will vary Step 1: Import Workspace & Dataset files into PW (Using Manage Workspace Wizard) 30+ minutes Use the Import Managed Workspace wizard; Import Data to ProjectWise from the File System 1. In ProjectWise Administrator, under Workspace Profiles>Managed (Right Click), this will open the Import Managed Workspace Wizard. In the Welcome dialog, Select Next Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 4

5 2. On the Choose Desired Action page, from the actions options, select the second option to "Import Data ProjectWise from File System", Then select Next 3. On the Import and Validate ProjectWise Folder Structure and Documents page, select the workspace to import in the Local File System list (default locations..\documents and Settings\All Users\Application Data\Bentley\MicroStation\WorkSpace). Then in the ProjectWise list, select the folder to import the workspace into. If the folder does not exist yet, you can right click in the list and select New Folder to create one. In your ProjectWise repository, create a folder that will contain the workspaces to manage. For the purpose of this document define a directory called "Building Workspace" Once you have selected a folder on both sides of the lists, click the Map button that is between the two lists, Then Finish to process. 4. Click Validate. During the validation process, the wizard is compares the content of the local workspace with the Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 5

6 contents stored in ProjectWise. Since this is a fresh install, there shouldn t be any files to compare against and this process should be rather quick. In the future, you can use this utility to update a workspace and/or dataset, It will perform a compare of the two directories and identify whether files exist or not, it does not compare the content of the file, only whether the files exist or not. Once the validation is complete the Validation of File System Structure against ProjectWise dialog opens. Select an item in the list on the left to see what the status of the item is in ProjectWise. Since this is a fresh install, the entire workspace can be imported, verify all directories are selected and select Resolve. ( The Users directory is really not necessary for Building application integration and can be unselected) 5. When ready to import to ProjectWise, click Resolve. When finished resolving, click Next, and then Continue to return to the first page of the wizard to begin Step 2. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 6

7 Step 2: MicroStation Configuration File to ProjectWise Configuration Setting Blocks (Using manage Workspace wizard) Use the Import Managed Workspace wizard; import MicroStation Configuration File to ProjectWise Configuration Setting Blocks (CSB). If you are continuing from Step 1, skip to task 2, bypassing task 1 (opening the "Import Managed Workspaces " wizard.) 1. Open the "Import Managed Workspaces " wizard. In ProjectWise Administrator, under Workspace Profiles>Managed (Right Click). Then select "Import Managed Workspaces " this will open the Managed Workspace Wizard. In the Welcome dialog, Select Next Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 7

8 2. On the Choose Desired Action page, from the actions options, select the first option to "Import MicroStation Configuration File to ProjectWise Configuration Setting Blocks", Then select Next 3. Choose a MicroStation Installation and Workspace Root: Locate the MicroStation Installation by browsing and locating the ustation.exe executable. Default installation..\program Files\Bentley\MicroStation\ustation.exe Locate the Workspace Root Directory Default installation..\documents and Settings\All Users\Application Data\Bentley\MicroStation\WorkSpace Verify that the option to "Create configuration block for workspace root variable" is selected Select Next Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 8

9 4. Scan Workspace, In the Workspace Configuration Files dialog, select the Scan Workspace, this will initiate a Scanning Workspace process 5. When the text, Scanning for Workspace Configuration Files completed successfully, appears, Select Next Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 9

10 6. The Workspace configuration scan will result in a list of Site, Project and User configuration files that will be imported. For this Building application integration, not all the configuration files are required to be converted into CSB., It is acceptable to import all configurations file found, but for ease of management, you want to be more selective and exclude: all the Users Level files all the MicroStation delivered example files (Building.pcf, Civil.pcf, General.pcf, Geospatial.pcf, Plant.pcf and untitled.pcf). all the DatasetUnitSystem.cfg(s) the intmgr_imperial.cfg and the intmgr_si.cfg at the Site Level Selecting the "Level label in the table header will sort the configuration files, making the task easier. Select the configuration files you do not want to process and select Remove, and then select Next to process. 7. This scans the entire workspace that you selected to import on the previous page. Once this is done you can also add or remove individual files. Upon successful completion of the processing of the configuration files, Select Next again Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 10

11 8. On the Configuration Settings Blocks page, review the ProjectWise Configuration Settings Blocks that will be created. Configuration Settings Block names can be changed and/or reassigned to different ProjectWise levels, or they can be removed if unwanted. Locate and select arch_roles, change the ProjectWise level from Site to Project When finished, click Next 9. Please review the configuration file setting, if any errors or changes are noted, please use the back button to step backward in the Workspace Import Wizard, however if satisfied select Import, this will begin the process to convert your configuration files into ProjectWise Configuration Setting Blocks also referred to by the acronym CSB or CSBs (plural). Select the Import button to import the configurations. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 11

12 Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 12

13 10. When the import is finished (*** IMPORT SUCCESSFUL ***), click Next. 11. After this you have the option to either close the wizard or go back to the first page of the wizard to select another action. For this exercise, we are done with the Workspace Import Wizard, therefore select Close. Proceed to the ProjectWise Administrator to review the newly created configuration blocks in ProjectWise Administrator to verify the import. (Datasource>Workspace Profiles>Managed) Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 13

14 Step 3: Add/Edit ProjectWise CSBs In ProjectWise Administrator, under Workspace Profiles>Managed In this step, you are going to complete the following tasks: Create New Global CSB Edit Site CSB for WorkspaceRoot (_USTN_WORKSPACEROOT) Create New Site CSB for the Building WorkspaceRoot (_TF_WORKSPACEROOT) Edit Project CSB File to support Project Data (_USTN_PROJECTDATA) Global: Create New Global Level CSB called "Global_Variables (Recommended for Administration, Certification and debugging) Add Variable to the Global_Variables CSB Name: _USTN_DISPLAYALLCFGVARS Description: Display All Configuration Variables Add Value: Operation Type: '=' Assignment Value Type: Numeric Value: 1 Note: _USTN_DISPLAYALLCFGVARS displays all system level configuration variable and is useful for Administrators during certification and debugging. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 14

15 Site: Edit the Site Level CSB called "WorkspaceRoot" This is a critical task Assign the _USTN_WORKSPACEROOT to the appropriate ProjectWise Folder. This is the root directory of the ProjectWise workspace defined and imported in Step 1. Edit Variable to the WorkspaceRoot CSB Name: _USTN_WORKSPACEROOT Description: _USTN_WORKSPACEROOT Edit Value: Operation Type: '=' Assignment Value Type: Change 'String' to 'ProjectWise Folder' Value: Change value to point to ProjectWise Workspace, browse to pw:\\<server name>:<datasource name>\documents\building Workspace. Tip: Since Workspaces can be version specific, rename the WorkspaceRoot CSB to include the major version number, such as WorkspaceRoot_ Tip: Use the CSB description to organize and manage collection of CSB. For example, change the description of WorkspaceRoot_ CSB to " Workspace Root", this will allow us to sort CSB by description. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 15

16 Add Directive to the WorkspaceRoot CSB Directive: %include Description: MicroStation Standards Add Value: Value type: Configuration Setting Block Value: standards: Site Configuration File Block The final WorkspaceRoot CSB should look like the following: Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 16

17 Step by Step Guide to edit WorkspaceRoot CSB: Task 1 of 2: Edit the Site Level CSB called "WorkspaceRoot" This is a critical task Assign the _USTN_WORKSPACEROOT to the appropriate ProjectWise Folder. This is the root directory of the ProjectWise workspace defined and imported in Step 1. Edit Variable to the WorkspaceRoot CSB Name: _USTN_WORKSPACEROOT Description: _USTN_WORKSPACEROOT Edit Value: Operation Type: '=' Assignment Value Type: Change 'String' to 'ProjectWise Folder' Value: Change value to point to ProjectWise Workspace, browse to pw:\\<server name>:<datasource name>\documents\building Workspace 1. In ProjectWise Administrator, under Workspace Profiles>Managed>Site, open the WorkspaceRoot CSB for editing by double clicking or right clicking and selecting properties from the right click menu. 2. Select the Configuration tab in the WorkspaceRoot Properties dialog. Select the pencil icon to edit the _USTN_WORKSPACEROOT variable Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 17

18 3. Select the row in the values table and select modify 4. This will initiate the "Edit Value" Dialog. In this dialog, this is where we reassign the workspace to point to the ProjectWise workspace. Change the Value type: from String to ProjectWise Folder, this will enable the browse button, next to the Value: entry box, select the browse button and locate the ProjectWise workspace. For this example, we are looking for pw:\\<server name>:<datasource name>\documents\building Workspace. Before: Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 18

19 After: 5. Select OK, to close Edit Value dialog, select OK, to close the _USTN_WORKSPACEROOT dialog and proceed to Task 2. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 19

20 Task 2 of 2: Add Directive to the WorkspaceRoot CSB Directive: %include Description: MicroStation Standards Add Value: Value type: Configuration Setting Block Value: standards: Predefined Configuration File Block 1. Select the plus icon and select Add Directive 2. This will open the Modify directives dialog. Verify the directive is set to %include, then select the Add button to define the value to be included. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 20

21 3. The Add Button will open the Edit Value dialog box. From the value type pull down, select the Configuration Setting Block. Then select the button, by value to browse for the Configuration Setting Block. 4. Select the Standards Site configuration file block, and select OK 5. The results in the Edit Value dialog should be as follows: Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 21

22 6. Select OK, to return to the Modify Directive Dialog. 7. Select OK, to return to the Workspace Properties dialog. The results of the WorkspaceRoot properties CSB should be as follows: END Step by Step Guide to edit WorkspaceRoot CSB: Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 22

23 Site: (Continued) Create New Site Level CSB called "Building_WorkspaceRoot Add Variable to the Building_WorkspaceRoot CSB Name: _TF_WORKSPACEROOT Description: Default Building_WorkSpace (_TF_WORKSPACEROOT) Add Value: Operation Type: '=' Assignment Value Type: String Value: $(_USTN_WORKSPACEROOT) Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 23

24 Site: (Continued) Add Variable to the Building_WorkspaceRoot CSB Name: HVACDIR_WORKSPACE Description: BBMS Building Workspace Root Add Value: Operation Type: '=' Assignment Value Type: String Value: $(_TF_WORKSPACEROOT)hvac/ Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 24

25 Site: (Continued) Add Directive to the Building_WorkspaceRoot CSB Directive: %include Description: Default MicroStation Workspace Add Value: Value type: Configuration Setting Block Value: WorkspaceRoot: Site Configuration File Block The final Building_WorkspaceRoot CSB should look like the following: Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 25

26 Project: Perform the following configuration options depending on the method of Project integration with ProjectWise: (Please consult your ProjectWise implementation team as to the appropriate method for project integration) Preferred method: Project Support for ProjectWise Projects If your projects folders have been promoted to PW projects, then the _USTN_PROJECTDATA can be automatically extracted by defining the following Project level CSB. The _USTN_PROJECTNAME is no longer necessary. Folders that have been promoted to a ProjectWise Project have the ProjectWise icon associated with the Folder icon as displayed in the diagram above. Create New Project Level CSB called "Dynamic_Project" Add Variable to the Dynamic_Project CSB Name: _USTN_PROJECTDATA Description: ProjectWise Project Name Add Value: Operation Type: '=' Assignment Value Type: String Value: $(dms_project(_dgndir)) Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 26

27 Project: (Continued) Please note: Since the _USTN_PROJECTNAME is automatically populated by the MicroStation Manager, and ProjectWise bypasses the MicroStation Manager, the information about the project name displayed from MicroStation file menu, Workspace>About Workspace, may not display the correct information. _USTN_PROJECTNAME remains undefined. Edit Project Level CSB identify the Project CSB that was created from a project configuration file (i.e. ArchProjectTemplateNcsUS, Structural_Imperial, Triforma_Imperial, etc ) Locate the _USTN_PROJECTDESCR in the CSB file and add the following directive. Add Directive to the project configuration CSB (i.e. ArchProjectTemplateNcsUS project CSB) Directive: %include Description: Dynamic Project Name Add Value: Value type: Configuration Setting Block Value: Dynamic_Project: Project Configuration File Block Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 27

28 Project: (Continued) Alternate Method: Project support for the standard ProjectWise Folders (works with ProjectWise Projects also) In order to support.pcf files converted into a ProjectWise CSBs as they are supported in MicroStation, a new variable in the Project CSBs needs to be defined. The _USTN_PROJECTNAME is required to properly resolve the definition of _USTN_PROJECTDATA which is equal to $(_USTN_PROJECT)$(_USTN_PROJECTNAME). The _USTN_PROJECTNAME configuration variable will need to be defined for each project CSB in order to properly support project content and datasets. Add Variable to the project configuration CSB (i.e. ArchProjectTemplateNcsUS project CSB) Name: _USTN_PROJECTNAME Description: Project Directory Name Add Value: Operation Type: '=' Assignment Value Type: String Value: ArchProjectTemplateNcsUS (Value should correspond to the directory (folder) name in the PW repository) Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 28

29 Step 4: Add exclusions (variables to be exclude from copy out) By default there are certain configuration variables that ProjectWise may not use when managed workspaces are in use. You can remove any of these variables so that ProjectWise will use them, or you can add to the list of excluded variables In ProjectWise Administrator, under Workspace Profiles>Managed>Variables to exclude from copy out Add the following additional Variables to exclude from copy out MS_BUMP (Supports Visualization) MS_ROSEDB (Supports STEP import/export in MicroStation) MS_ROSEDB_STRUCTURAL (Supports STEP import/export in Structural Modeler) These files, defined by these configuration variables, will be excluded during the download of the workspace Step 5 ProjectWise Application Support ProjectWise Application Associations for Building Applications using the Program Class Name Program Class Name A Program Class Name defines and stores, in the Windows registry both, the executable and any command line arguments as defined during the installation on the local machine. This is the most reliable and universal application definition since ProjectWise does not store any hard coded directory path information. Registry supports relies on the clients registry to provide ProjectWise with the proper drive/directory location of application to launch. This allows an organization to have the applications installed in varying directories and drive locations on the local machines and reduce the requirement of installation consistency across an organization. All other customizations can be accommodated through strategic definitions of CSB files. In the v8i (SELECTseries 1) release of building applications, a registry based program class definitions to support Building applications was introduced. The corresponding v8i release of ProjectWise will deliver the default building application definitions using these registry program class definitions. The program class name is the preferred method to define ProjectWise application support because it uses the Window registry to locate the designated executables. This is the recommended and most reliable method for building application initiation in a. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 29

30 In ProjectWise Administrator, under Applications: 1. Select on one of the building application and either double click or right click and select properties from the right click options menu. 2. Select, the Actions Tab, Select the default Open Action (indicated by the Open), then select the modify button 3. In the Modify Properties dialog, verify the Program Class name: Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 30

31 The following tables list the Building application and their corresponding Program Class name for v8i : Bentley Architecture Structural Modeler (Bentley Structural) Bentley Building Mechanical Systems Bentley Building Electrical Systems (DE) Bentley Building Electrical Systems (US) Bentley Building Electrical Systems (UK) Bentley.Architecture.Application Bentley.Structural.Application Bentley.Mechanical.Application Bentley.Electrical.DE.Application Bentley.Electrical.US.Application Bentley.Electrical.UK.Application Bentley Building Suite Bentley.Building.Suite.Application Bentley SpacePlanner Bentley Architecture w/ SpacePlanner Bentley.MicroStation.Application Add command line Argument: ws_spaceplanner=1 Bentley.Architecture.Application Add command line Argument: ws_spaceplannerdg=1 4. If you need to edit or create a new program class association, select the browse button adjacent to the program class entry field to open the 'Select Associated Programs' dialog. Select the Advance tab, and edit or enter the program class name. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 31

32 Unfortunately, to date, there is no program class browser. These program classes will need to be populated manually during the Select Associated Programs. Once the program class is entered, Select the option designating the "Enter text is a program class name" and Select OK to save your changes and close the "Select Associated Programs" dialog. 5. Select OK to close "Modify Properties.." dialog. 6. Select OK to close the application properties dialog. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 32

33 FOR BENTLEY ARCHITECTURE ONLY: Bentley Architecture requires the inclusion and assignment of the arch_roles CSB to either the Project or the Application to successfully initiate the Bentley Architecture Application. Please select the best method based on your environment and requirements. The preferred method is to attach the arch_roles via the Bentley Architecture definition in ProjectWise. Please note, If an arch_roles CSB is attached at both the application and Project, the arch_roles at the project will override those defined in the application Option 1: Attaching the archroles per the Projector Project Configuration (Preferred Method) Add the following Directive to all valid Bentley Architecture Projects (i.e. ArchitectureTemplateNcsUS & BentleyBuildingSuiteUS) Add Directive Directive: %include Description: Arch_roles Support Add Value: Value type: Configuration Setting Block Value: Arch_roles : Application Configuration File Block Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 33

34 Option 2: Attaching the arch_roles to the Bentley Architecture definition in ProjectWise With this method, you may experience the following message switching between file that are not associated with the application "Bentley Architecture", because architecture is linked to the arch_roles CSB. It is not necessary to restart unless the file you are accessing is outside your project or other CSB are defined. In ProjectWise Administrator, under Applications: 1. Select on 'Bentley Architecture' application definition and either double click or right click and select properties from the right click options menu. 2. Select the Managed Workspace tab and Add the arch_roles CSB to the Application level to the application definition The arch_roles CSB should also be attached to the ProjectWise application definition for 'Bentley Architecture / SpacePlanner' Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 34

35 Step 6 Link CSBs to the Project In the ProjectWise Explorer locate the project directory. (For example: pw:\\<server name>:<datasource name>\documents\building Workspace\ArchProjectTemplateNcsUS), rightclick and get the properties of this folder. Select the Workspace Tab Associate to the project directories with the Global CSB called Global_Variables. Associate to the project directories with Site CSB called "Building_WorkspaceRoot". Associate to the project directories with the appropriate Project CSB. For example: the Project CSB called "ArchProjectTemplateNcsUS" The result should be similar to the image below, (with/without Personal Workspace) Personal workspace settings allows user specific workspace configuration for managed workspaces. By default, you may not have Personal workspace associated if there is nothing defined in your personal workspace, once something is defined in the personal workspace it is automatically associated. (To review the contents of your personal workspace CSB, in ProjectWise Explorer file menu select Tool>Options, select the Personal Workspace tab. Note: The option, not to display the compatibility warning when building applications are initiated, is stored in your Personal Workspace. Step 7 Test/Validate (Troubleshoot) Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 35

36 To test or Validate you Integration, in the ProjectWise Explorer, locate the project directory the delivered file empty.dgn in the project ArchProjectTemplateNcsUS (pw:\\<server name>:<datasource name>\documents\building Workspace\ArchProjectTemplateNcsUS). Associate the empty.dgn with the Bentley Architecture application by selecting the properties option from the right click menu. Then open the file and validate it is in a managed workspace, if it is properly configured you should see Manage Workspace Export Progress Dialog, which successfully completes all tasks Note: Errors in the first three tasks usually are the result of an error in the application definition or association. Please validate the application definition in the ProjectWise Administrator. Note: Opening a managed project or application the first time will require ProjectWise to download the workspace and datasets locally, this can 5 minutes and up the first time depending on your connection speed. Please be patient, subsequent loads will have more acceptable load times. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 36

37 From with the Building application, Select Workspace>About Workspace from the file menu. Troubleshooting If you are presented with the following message to restart your MicroStation Session, then there is something different in the managed configuration that requires a change in your manage workspace. This dialog is common and to be expected if you are opening files from another project. However, this dialog does not typically appear if you are opening different files from within the same project but from different subdirectories. If it does occur: Verify that the files contain the same ProjectWise manage Workspace assignments. They should all be inherited from the Project Folder. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 37

38 Verify that there is no ProjectWise Manage Workspace CSB assignments on the ProjectWise Application associated to the document. This alert will appear if you switch to a file that does not share the same application association as the original file opened and the application has a CSB assigned to the application definition. Inspect your configuration files, any configuration variable defined to equal _DGNDIR or _DGNFILE will need to be add the exclusion list defined by PW_MWP_COMPARISON_IGNORE_LIST in the ProjectWise mcm.cfg file. Copyright 2009 Bentley Systems, Incorporated Bentley Building Technote 38