+ All Categories
Home > Documents > ProjectWise Managed Workspace - Bentley · 9 ProjectWise managed workspace support for building...

ProjectWise Managed Workspace - Bentley · 9 ProjectWise managed workspace support for building...

Date post: 19-Oct-2020
Category:
Upload: others
View: 6 times
Download: 0 times
Share this document with a friend
38
Bentley Building Deployment Guide ProjectWise Managed Workspace Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote 1 Bentley Building Application Deployment Guide: ProjectWise Managed Workspaces 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 ProjectWise Managed Workspaces (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: 9 ProjectWise managed workspace support for building applications was introduced in 08.11.07.xx (SELECTseries 1) and integrated with ProjectWise 08.11.07.xx (SELECTseries 1) and is not supported in previous version. 9 PW managed workspace does not support an offline or briefcase mode, PW manage workspace require an active connection to a PW server. 9 PW managed workspace is a thick client solution and is not support with the ProjectWise Web Client (SharePoint Web parts) 9 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.
Transcript
  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  1  

     

    Bentley Building Application Deployment Guide: ProjectWise Managed Workspaces   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 ProjectWise Managed Workspaces (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 08.11.07.xx (SELECTseries 1) and integrated with ProjectWise 08.11.07.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. 

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 ProjectWise Managed Workspace Configuration.  

         

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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) 

               

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 

      

         

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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.  

         

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 

       

          

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 

     

            

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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  

      

          

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 

      

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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. 

      

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  12  

     

          

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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) 

      

            

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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.

      

          

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:\\:\Documents\Building Workspace. 

      

       

      Tip: Since Workspaces can be version specific, rename the WorkspaceRoot CSB to include the major version number, such as WorkspaceRoot_081107.    

       Tip: Use the CSB description to organize and manage collection of CSB. For example, change the description of WorkspaceRoot_081107 CSB to "08.11.07 Workspace Root", this will allow us to sort 08.11.07 CSB by description. 

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:  

          

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:\\:\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   

      

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:\\:\Documents\Building Workspace. 

      Before: 

       

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  19  

     

    After: 

       

    5. Select OK, to close Edit Value dialog, select OK, to close the _USTN_WORKSPACEROOT dialog and proceed to Task 2. 

        

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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. 

     

        

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:  

      

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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: 

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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) 

      

      

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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/ 

      

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:  

        

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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)) 

      

          

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 

      

            

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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) 

      

     

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 08.11.07 (SELECTseries 1) release of building applications, a registry based program class definitions to support Building applications was introduced. The corresponding v8i 8.11.7 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 ProjectWise Managed Workspace.   

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:   

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  31  

     

        

    The following tables list the Building application and their corresponding Program Class name for v8i 08.11.07:  

      

    Bentley Architecture   Bentley.Architecture.Application.081107 

    Structural Modeler (Bentley Structural)  Bentley.Structural.Application.081107 

    Bentley Building Mechanical Systems  Bentley.Mechanical.Application.081107 

    Bentley Building Electrical Systems (DE)  Bentley.Electrical.DE.Application.081107 

    Bentley Building Electrical Systems (US)  Bentley.Electrical.US.Application.081107 

    Bentley Building Electrical Systems (UK)  Bentley.Electrical.UK.Application.081107 

      

    Bentley Building Suite  Bentley.Building.Suite.Application.081107 

      

    Bentley SpacePlanner  Bentley.MicroStation.Application Add command line Argument: ‐ws_SPACEPLANNER=1 

    Bentley Architecture w/ SpacePlanner  Bentley.Architecture.Application.081107 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. 

      

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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. 

           

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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 

      

          

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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' 

         

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  35  

     

    Step 6  Link CSBs to the Project 

     In the ProjectWise Explorer locate the project directory. (For example:  pw:\\:\Documents\Building Workspace\ArchProjectTemplateNcsUS), right‐click 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) 

      

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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:\\:\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. 

       

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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.

  • Bentley Building Deployment Guide  ProjectWise Managed Workspace 

     

    Copyright © 2009 Bentley Systems, Incorporated| Bentley Building Technote  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. 

     


Recommended