ProjectWise - Installation Instructions

UNDER CONSTRUCTION

Setup Instructions:

To install this template:

1). Copy Template:

In ProjectWise, create a Bentley root folder location for the Workspaces. For purposes of this document, the location will be pw:Datasource\Documents\Resources\Bentley\

Note: The Resource folder name is not important, however for consistency, it is advised to keep the Bentley name as the root folder for the installation. Any folder under the Bentley cannot be changed without affecting the configuration paths. Once this is created,

copy the template to this location. Where a Dev/Test/Prod process* is used, repeat these steps for additional locations.

2). Create CSB called "Bentley Common Predefined 2.0" with the following syntax, which points to the Common_Predefined.cfg file provided in the template. (see relative location highlighted above).

_DYNAMIC_DATASOURCE_BENTLEYROOT = pw:\\mydatasource\Documents\Resources\Bentley\

%include $(_DYNAMIC_DATASOURCE_BENTLEYROOT)Common_Predefined.cfg

Note: when creating the _DYNAMIC_DATASOURCE_BENTLEYROOT variable, use ADD>ProjectWise Folder and browse to the Bentley folder under Resources (or other location as determined by installation). The %include entry should utilize the "String" option. Repeat steps as needed if Dev/Test/Prod process is used.

3). For V8 workspace: create a named root folder for each workspace to be incorporated. This roughly can represent the _USTN_WORKSPACEROOT folder and can be assigned as such.

4). Default Values (if needed)

Open Common_Predefined_PWSetup.cfg and set default workspace name values (bolded values below) The initial values are set to work with the delivered example workspaces and projects.

###################################################################################################
# DEFAULT VALUES
#--------------------------------------------------------------------------------------------------
# Sets default workspace and folder names used by organization.
# Maintain use of ":" so that this can be pre-established if utilizing this configuration for
# multiple clients/workspaces
###################################################################################################

%if defined (_VERSION_8_11)
_DYNAMIC_V8WORKSPACESROOTNAME : V8Workspaces
##### EDIT: Modify the following line to set organizations default V8 Workspace
_DYNAMIC_V8WORKSPACENAME : V8WorkspaceExample
%elif defined (_VERSION_10_0)
_DYNAMIC_CONFIGURATIONNAME : Configuration
_DYNAMIC_CEORGANIZATIONROOTNAME : Organization
_DYNAMIC_CEWORKSPACESROOTNAME : WorkSpaces
##### EDIT: Modify the following line to set organizations default CE Workspace
_DYNAMIC_CEWORKSPACENAME : CEWorkspaceExample
%endif

_DYNAMIC_MSG_NOT_FOUND : NOT FOUND
_DYNAMIC_MSG_VERIFY_PATH : VERIFY PATH OF VARIABLE.

5) Determine WorkArea Root location.

The following syntax includes the Common_Predefined_FindWorkAreaRoot.cfg file. This file should be reviewed and edited to allow the Dynamic Managed Workspace to find the projects root folder.

###################################################################################################
# WORKAREA ROOT
#--------------------------------------------------------------------------------------------------
# REQUIRED: WorkArea Root must to be found to set base location for related configurations
###################################################################################################

%if exists ($(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_FindWorkAreaRoot.cfg)
%include $(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_FindWorkAreaRoot.cfg
%endif

6) Project Explorer Version Check.

The following syntax includes the Common_Predefined_PWExpVersionCheck.cfg file. This file should be reviewed to check the version of ProjectWise Explorer. This file contains adjusts that may be necessary due to change the the ProjectWise Explorer client.

###################################################################################################
# PW EXPLORER VERSION CHECK with adjustments
#--------------------------------------------------------------------------------------------------
# Enable the following section if receiving file open error
###################################################################################################

%if exists ($(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_PWExpVersionCheck.cfg)
%include $(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_PWExpVersionCheck.cfg
%endif

7) Determine Product Version.

The following syntax includes the Common_Predefined_ProductVersion.cfg file. This file assists in determining the version of the product that is being opened. This file should be reviewed but not edited. This file may also be directly included in a CSB if Option 3 is used to allow for version parameters in the initializing CSB. During the execution of this file _DYNAMIC_PRODUCT_VERSION_PROCESSED is set to 1 and prevents the later duplicate reading of the file (if utilized earlier by a CSB).

###################################################################################################
# PRODUCT VERSION
#--------------------------------------------------------------------------------------------------
# This section allows detection of product version, if not already processed in CSB
###################################################################################################

_DYNAMIC_PRODUCT_VERSION_PROCESSED:0
%if !(_DYNAMIC_PRODUCT_VERSION_PROCESSED)
%if exists ($(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_ProductVersion.cfg)
%include $(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_ProductVersion.cfg
%endif
%endif

8) WorkArea ProjectWise Setup.

###################################################################################################
# WORKAREA PWSETUP INCLUDE (OPTION 2)
# DELETE IF NOT USED
#--------------------------------------------------------------------------------------------------
# Allows the setting of workspace information within a specific Workarea
###################################################################################################

%if defined (_DYNAMIC_WORKAREAROOT)
##### EDIT: Revise _DYNAMIC_WORKAREA_PWSETUP_PATH to match Organizational project folder structure
_DYNAMIC_WORKAREA_PWSETUP_PATH:Design/_PWSetup/
_DYNAMIC_WORKAREA_PWSETUP: $(_DYNAMIC_WORKAREAROOT)$(_DYNAMIC_WORKAREA_PWSETUP_PATH)
%if exists ($(_DYNAMIC_WORKAREA_PWSETUP)WorkAreaPWSetup_Predefined*.cfg)
%include $(_DYNAMIC_WORKAREA_PWSETUP)WorkAreaPWSetup_Predefined*.cfg
##### OPTION: The following section maybe deleted if the default location is not changed.
##### OPTION: However, if the default location is changed, the following allows examples to
##### continue to function.
%elif exists ($(_DYNAMIC_WORKAREAROOT)$(_DYNAMIC_PWSETUP_PATH)WorkAreaPWSetup_Predefined*.cfg)
_DYNAMIC_WORKAREA_PWSETUP_VALIDATION:NOT FOUND: $(_DYNAMIC_WORKAREA_PWSETUP)WorkAreaPWSetup_Predefined*.cfg USING DEFAULT PATH: $(_DYNAMIC_WORKAREAROOT)$(_DYNAMIC_PWSETUP_PATH)WorkAreaPWSetup_Predefined*.cfg
%include $(_DYNAMIC_WORKAREAROOT)$(_DYNAMIC_PWSETUP_PATH)WorkAreaPWSetup_Predefined*.cfg
%else
_DYNAMIC_WORKAREA_PWSETUP_VALIDATION:NOT FOUND: $(_DYNAMIC_WORKAREA_PWSETUP)WorkAreaPWSetup_Predefined*.cfg
#%error $(_DYNAMIC_MSG_NOT_FOUND) _DYNAMIC_WORKAREA_PWSETUP CFG: $(_DYNAMIC_WORKAREA_PWSETUP)WorkAreaPWSetup_Predefined*.cfg. $(_DYNAMIC_MSG_VERIFY_PATH)
%endif
%endif

9) ProjectWise Drive Setup

###################################################################################################
# PWDRIVE SETUP
# DELETE IF NOT USED
#--------------------------------------------------------------------------------------------------
# ProjectWise Drive : Example PWDrive Variables
###################################################################################################

_PROJECTWISE_DRIVE_ENABLED:0
_PROJECTWISE_DRIVE_FOUND:0
_DYNAMIC_PWDRIVE_PROCESSED:0
%if (_PROJECTWISE_DRIVE_ENABLED) && !(_DYNAMIC_PWDRIVE_PROCESSED)
%if exists ($(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_PWDrive.cfg)
%include $(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_PWDrive.cfg
%endif
%endif

10) Workspace Groups

###################################################################################################
# WORKSPACE GROUPS
# DELETE IF NOT USED
#--------------------------------------------------------------------------------------------------
# Workspace Groups allow Workspaces (V8 and CONNECT) to be organized by Groups/Clients
# but still utilize the same common predefined cfg files and CSB
###################################################################################################

%if defined (_DYNAMIC_WORKSPACEGROUPNAME)
%if exists ($(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_WorkspaceGroups.cfg)
%include $(_DYNAMIC_BENTLEY_PWSETUP)Common_Predefined_WorkspaceGroups.cfg
%endif
%endif

11) Set options with WorkArea PWSetup (Option 2) or CSB (Option 3)

12) Set options in Workspace PWSetup

) Copy the _PWSetup folder and files. Working example V8 and CONNECT Edition workspaces are provided. The _PWSetup folder and files can be copied to the respective workspace root folders. Additional example can be found in the "Documentation" folder. Both simple and advanced examples are provided

) Edit the WorksSpacePWSetup_Predefined*.cfg file to define Framework variables as needed. For V8 workspace this will typically involve assigning location for the Projects Root, Project Root, Project Name, and cfg file at a minimum. For CONNECT this will typically involve assigning location for the WorkSets Root, Workset Root, WorkSet Name, and cfg file at a minimum. The .dgnws file may also need to be set. More often than not, addition syntax will be needed to set additional values required by the workspace. As noted in the previous step, example configuration syntax for various scenarios is provided in the template's documentation section.

). Add Ignore workspace reload variable syntax

). Create WorkArea (from a template if available) and Assign CSB. Rename workset cfg/project pcf file in needed. Delete .dgnws if it exists. The .dgnws should be created from the template pointed to by the workspace configuration.

* The Dev/Test/Prod process refers to a standard development process where there is an area for initial development, final testing, and the actual production area. The development area may contain various temporary development files. However, the test area should be a replica of what will be in production.