aecosim v8i (selectseries 4) deployment guide: v8i managed ... · this document: is intended to...

74
AECOsim Building Designer V8i Deployment Guide ProjectWise Managed Workspace Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote 1 AECOsim Building Designer V8i (SELECTseries 4) Deployment Guide: ProjectWise V8i Managed Workspaces Version 2.2 – May 2013 AECOsim Building Designer V8i (SELECTseries 4) with ProjectWise V8i (SELECTseries 4) or later: Deployment Guide Intro: This document: is intended to provide recommendations and implementation guidance for integration of the AECOsim Building Designer V8i (SELECTseries 4) into a ProjectWise Environment. is a supplemental document to the "ProjectWise Implementation Guide” and the help documentation provided by ProjectWise Administrator and ProjectWise Client and while it shares common concepts and instructions with those documents, this document is intended to provide the best path to integrate AECOsim Building Designer V8i with ProjectWise. will focus on topics concerning ProjectWise application definition, workspace integration and Project association. Please refer to ProjectWise documentation for topics not addressed. should not be used to configure legacy building applications such as Bentley Architecture (BA), Bentley SpacePlanner (BSP), Structural Modeler (formally Bentley Structural (BS)), Bentley Building Mechanical Systems (BBMS), and Bentley Building Electrical Systems (BBES). For information on integrating those applications into ProjectWise, please refer to “Bentley Building Application Deployment Guide: ProjectWise Managed Workspaces”, Version 1.7. Restriction and Limitations of integrating Building Application in a ProjectWise Managed workspace AECOsim Building Designer V8i (SELECTseries 4) is compatible with a ProjectWise Integration Server V8i (SELECTseries 3) or (SELECTseries 4) and requires a ProjectWise Explorer Client (SELECTseries 4) If you have an existing ProjectWise Manage workspace deployment of AECOsim Building Designer V8i (SELECTseries 3) , Please note: The AECOsim Building Designer V8i, (SELECTseries 4) datasets are not backwards compatible with AECOsim Building Designer V8i (SELECTseries 3). Therefore, we encourage user to create a new and separate workspace and dataset dedicated for use with AECOsim Building Designer V8i (SELECTseries 4) The Trane Ductulator and the RAM Viewer have not been ProjectWise integrated and may not benefit from ProjectWise Managed Workspaces. The Electrical portion of AECOsim Building Designer will have the following limitation in a ProjectWise fully managed workspace. o Only one symbol library can be used in a project (specified by the BBES_MWS_SYMLIBNO variable). If additional libraries are stored in the database they will not be visible. o Selected symbol library is available in read only mode. o No additional symbols or symbol subtypes can be created or existing ones modified. o Bidirectional Interface with Visual will not be able to update subtype definitions when lights are imported from Visual Professional. o No additional cable types can be defined o No additional tag styles can be defined or existing ones changed

Upload: others

Post on 05-Apr-2020

25 views

Category:

Documents


0 download

TRANSCRIPT

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  1 

 

AECOsim Building Designer V8i (SELECTseries 4) Deployment Guide: ProjectWise V8i Managed Workspaces   Version 2.2 – May 2013 AECOsim Building Designer V8i (SELECTseries 4) with ProjectWise V8i (SELECTseries 4) or later: 

Deployment Guide Intro: 

This document:  is intended to provide recommendations and implementation guidance for integration of the AECOsim 

Building Designer V8i (SELECTseries 4) into a ProjectWise Environment.   

is a supplemental document to the "ProjectWise Implementation Guide” and the help documentation provided by ProjectWise Administrator and ProjectWise Client  and while it shares common concepts and instructions with those documents, this document is intended to provide the best path to integrate AECOsim Building Designer V8i with ProjectWise. 

will focus on topics concerning ProjectWise application definition, workspace integration and Project association. Please refer to ProjectWise documentation for topics not addressed. 

should not be used to configure legacy building applications such as Bentley Architecture (BA), Bentley SpacePlanner (BSP), Structural Modeler (formally Bentley Structural (BS)), Bentley Building Mechanical Systems (BBMS), and Bentley Building Electrical Systems (BBES). For information on integrating those applications into ProjectWise, please refer to “Bentley Building Application Deployment Guide: ProjectWise Managed Workspaces”, Version 1.7. 

Restriction and Limitations of integrating Building Application in a ProjectWise Managed workspace   

AECOsim Building Designer V8i (SELECTseries 4) is compatible with a ProjectWise Integration Server V8i (SELECTseries 3) or  (SELECTseries 4) and requires a ProjectWise Explorer Client (SELECTseries 4)   

 

If you have an existing ProjectWise Manage workspace deployment of AECOsim Building Designer V8i (SELECTseries 3) , Please note: The AECOsim Building Designer V8i, (SELECTseries 4)  datasets are not backwards compatible with AECOsim Building Designer V8i (SELECTseries 3).  Therefore, we encourage user to create a new and separate workspace and dataset dedicated for use with AECOsim Building Designer V8i (SELECTseries 4)  

The Trane Ductulator and the RAM Viewer have not been ProjectWise integrated and may not benefit from ProjectWise Managed Workspaces.  

The Electrical portion of AECOsim Building Designer will have the following limitation in a ProjectWise 

fully managed workspace.  o Only one symbol library can be used in a project (specified by the BBES_MWS_SYMLIBNO 

variable).  If additional libraries are stored in the database they will not be visible.  o Selected symbol library is available in read only mode. o No additional symbols or symbol subtypes can be created or existing ones modified. o Bidirectional Interface with Visual will not be able to update subtype definitions when lights are 

imported from Visual Professional. o No additional cable types can be defined o No additional tag styles can be defined or existing ones changed 

 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  2 

 

 The Electrical portion of AECOsim Building Designer can be configured in a “hybrid” managed workspace if more flexible configuration is required. However, “hybrid”  managed workspaces are not covered in this general deployment document and it is recommend that users consult with the Bentley’s Building Professional Service Group for assistance. 

 

Some AECOsim Building Designer Utilities (Utilities> Building Designer Utilities) have not been ProjectWise integrated and may not be beneficial in a ProjectWise Managed Workspaces session. Those AECOsim Building Designer utilities will be automatically disabled in a ProjectWise integrated session of AECOSIM Building Designer.  

ProjectWise V8i (SELECTseries 4) currently does not offer integration support for the 64‐bit version of Microsoft Office 2010 and is not supported with AECOsim Building Designer V8i  using a managed workspace.  

ProjectWise 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 supported with the ProjectWise Web Client (SharePoint Web parts)  

When working with ProjectWise managed workspaces, it is recommended that users access 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.  

The ProjectWise environment is encouraged to 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 configuring ProjectWise for a "Captive" environment.  

For ProjectWise Managed Workspaces, ProjectWise administrators and users are encouraged to set the user option to "Leave Local Copy on check in". This will improve operational performance for large projects. If changes in files are detected, ProjectWise will synchronize as required. 

 

Configuration files 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 ensure the configuration files contained within either of these directories does not contaminate the ProjectWise Managed Workspace Configuration.  

 

   

   ProjectWise and MicroStation are registered trademarks or trademarks of Bentley Systems, Inc., in the USA and other countries. All other brand names, product names, or trademarks belong to their respective holders.  

AEC

 

 

  

 

COsim Buildin

Before Yo

A4)(Scoim PBin 

  InapP D Inafinpr Thdnco 

ng Designer V

Copyrig

ou Begin 

 fully operatio) server and aSELECTseries orrespondingmplementatio

rojectWise Exentley Applicantegration for

nstall and conpplication worojectWise. U

esktop integrThe AE

ntegration witfter the instanstallation unrogram.   

he ProjectWiialog when Aot required foonsult your P

V8i Deployme

ht © 2012 Be

onal and confa defined data4) and the Prg administratoon team and/

xplorer V8i (Sation base Inr  ProjectWise

nfigure AECOsorkspace has Use this client

ration: ECOsim Buildthin the “Cusllation by initder the Wind

se Desktop InECOsim Buildor a successfurojectWise im

 

nt Guide  P

entley System

figured Projeasource mustojectWise Exor privileges a/or administra

SELECTseries 4tegration, in e Managed W

sim Building Dall the requirt to complete

ing Designertom” optionstiating the “Chdows Control 

ntegration opding Designerul ProjectWismplementatio

ProjectWise 

ms, Incorporat

ctWise integrt be availableplorer V8i Cliare also requiators before i

4) Client mustorder to fully

Workspaces. 

Designer V8i oed componen the instructi

V8i installer os during instahange” optioPanel>Progra

ens the Projeis initiated vie managed won team and/

Managed W

ted| AECOsim

ration Servere.  Access to Pent (SELECTsired. Please cinitiating Proj

t be installedy support AEC

onto a client nts for your aons in this do

offers the optllation. The ons for active ams>Program

ectWise reposia an applicatworkspace wit/or administra

Workspace 

m Building Des

V8i (SELECTsProjectWise Aeries 4) appliconsult your PjectWise Man

d to include thCOsim Buildin

workstation. application procument. 

tion to includoption can alsAECOsim Buims and Featur

sitory verses tion shortcut.th AECOsim Bators. 

signer Techno

series 3) or (SAdministratorcations with ProjectWise nage workspa

he iDesktop Inng Designer V

 

This will ensurior to import

de ProjectWisso be applied lding Designeres>Uninstall 

the standard. This step is oBuilding Desig

ote  3 

ELECTseries r V8i 

aces. 

ntegration fo8i application

ure that the ting it into 

se Desktop at any point er V8i or change 

 manager optional and gner ‐ Please 

r n 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  4 

 

Local Disk Space:   In a ProjectWise Managed workspace, documents from the ProjectWise Server are downloaded to the local machine and made available to the intended applications. The local machine may require a significant amount of available disk space to accommodate several projects, dataset and other supporting documents.   Once project documents are local, the exchange between the ProjectWise Server and the local machine are conducted using Delta file transfer.  Delta file transfer is a ProjectWise technology that improves performance when sending large files over networks by only sending the changes needed to update the file, rather than the entire file. This local repository can easily be managed by the Local Document Organizer, found in Project Explorer (Tools> Local Document Organizer…). 

   

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  5 

 

Overview of Steps:  

1. Import Workspace & Dataset files into PW, using Manage Workspace Wizard. (approx. 30+ Min) 2. Import Project Configuration File(s) 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. ProjectWise Application Definition (approx. 5 min ) 6. Link CSBs to Projects / Groups (approx.5 Min) 7. Test/Validate (Troubleshoot)  Addendum:  Step by Step Guide to create Predefined CSBs * Time estimates are approximate based on 

out‐of‐the‐box configuration and a remote connection to the PW server. Individual results may vary. 

 

  

 

AEC

 

 

Step

  

 

COsim Buildin

p 1:   I(a

1. In ProWork

2. On thThen  

3. On thimpor  D

ng Designer V

Copyrig

mport Woapprox. 30+ Min)

ojectWise Admspace”.  This 

 e Choose Desclick  Next 

   

e Import andrt in the Locaefault worksp

o

o

V8i Deployme

ht © 2012 Be

orkspace &) 

ministrator, uwill open the  

sired  Action 

 

d Validate Projl File System pace paths:  Windows XPData\BentleWindows 7 ‐

nt Guide  P

entley System

& Dataset f

under Workspe Import Man

page, select t

ojectWise Foldlist  

P ‐  …\Documeny\AECOsimBui‐ …\ProgramDa

ProjectWise 

ms, Incorporat

files into P

pace Profiles>aged Worksp

the second op

der Structure 

nts and SettingildingDesignerata\Bentley\AE

Managed W

ted| AECOsim

PW, using M

>Managed (Ripace Wizard. 

ption "Import

and Docume

gs\All Users\Ap V8i Ss4\WorkECOsimBuildin

Workspace 

m Building Des

Manage W

ight‐Click) anIn the Welco

 

t Data Projec

 

ents page, sele

pplication kSpace ngDesigner V8i 

signer Techno

Workspace 

d select “Impme dialog, Cl

tWise from F

ect the works

 Ss4\WorkSpa

ote  6 

Wizard.  

port Managedick  Next 

File System", 

space to 

ace  

AEC

 

 

 

  

 

COsim Buildin

Then you ca

Once this w

4. Click V DurinstoredproceIt willof the   Once The foan iteProjec

The trin thereposon theworks 

Wsetd

ng Designer V

Copyrig

in the Projectan right‐click 

In youthe puunder 

you have selewill enable the

   

Validate. 

g the validatid in ProjectWess should be  compare thee file, only wh

the validatioollowing dialoem to view itsctWise repos

ree structure e ProjectWisesitory, while te left to see wspace will be 

While it is accstreamline thexchange bettimes and gredirectories; th

V8i Deployme

ht © 2012 Be

tWise list, selin the list and

r ProjectWiseurpose of this that create a

 ected a foldee Validate opt

on process, tWise. Since thirather quick.e two directorhether the file

n is completeog compares s status. Itemsitory, while th

in the left ha repository. Ithe green chewhat the statmarked as no

ceptable to ime workspace tween the Proeater performhe “BuildingD

nt Guide  P

entley System

lect the folded select New 

e repository, cdocument de

another direct

r on both sidtion.  

the wizard cos is a fresh in In the futureries and identes exist or not

e, the Validatithe Local Files with a red ‘Xhe green che

and panel willtems with a rck indicates ius of the itemot present.  

mport the worby managingojectWise datmance to your Datasets”, “Pr

ProjectWise 

ms, Incorporat

er to import thFolder to cre

create a foldeefine a directtory called “M

es of the lists

mpares the cstall, there she, you can usetify whether ft. 

ion of File Syse System to thX’ indicates thck indicates it

l display the sred ‘X’ indicatt is present inm is in Project

rkspace in its g only what istasource and lr users. We rerojects” and “S

Managed W

ted| AECOsim

he workspaceeate one.   

er that will cotory called " AManaged Wo

s, click the Ma

content of thehouldn’t be ae this utility tfiles exist or n

stem Structurhe ProjectWishe file/foldert is present in

status of eachtes the file/fon ProjectWisetWise.  Since 

entirety, it iss necessary. Rlocal machineeally only need“Standards” d

Workspace 

m Building Des

e into. If the f

ontain the woAECOsim Buildrkspace”

ap button tha

 

e local workspny files with wo update a wnot. It does n

re against Prose Mappings yr is not presenn the mapped

h item as eitholder is not pre repository  this is a fresh

s somewhat uReducing the ne translates ind to be concedirectories.  

signer Techno

folder does n

orkspaces to mding Designe

at is between

pace with thewhich to com

workspace andnot compare t

ojectWise diayou have selent in the mapd ProjectWise

her present orresent in the Select an itemh install, the e

unnecessary. Wnumber files bnto shorter derned about th

 

ote  7 

ot exist yet, 

manage. For r Ss4" and 

 the two lists

e contents mpare and thid/or dataset.the contents 

log opens.   ected. Select pped e repository.

r not present ProjectWise m in the list entire 

We can being ownloads hree 

AEC

 

 

  

  

  

COsim Buildin

Once 

5. When6. When7. Verify

page 

ng Designer V

Copyrig

you have onl

    

n ready, click n finished, clicy that the optof the wizard

     Note: To mLinksets… fand linkset 

V8i Deployme

ht © 2012 Be

ly selected th

Resolve to upck Next. tion to “Returd to begin Ste

make further from the Projts. Please con

nt Guide  P

entley System

e “BuildingDa

pload all miss

rn to Introducp 2.  

use of SampljectWise Expnsult the Proj

 

ProjectWise 

ms, Incorporat

atasets”, “Pro

ing items to P

ction” is selec

e Project Datlorer Client toectWise help

Managed W

ted| AECOsim

ojects” and “S

ProjectWise. 

cted, and the

ta, you will neo reconnect ap documentat

Workspace 

m Building Des

Standards” di

 

 

n click Contin

 

eed to run Toand resolve ation for more 

signer Techno

irectories, clic

nue to return 

ols>Scan Refel the project information.

ote  8 

ck Resolve.  

to the first 

ferences and references . 

AEC

 

 

 Ste

  If youwizar  

COsim Buildin

ep 2: Imporu

u are continurd.)  

1. Open2. In Pro

Work3. In the

   

  

4. On thProjec  

    

ng Designer V

Copyrig

rt Project Cusing Mana

ing from Step

the "Import ojectWise Admspaces…" thise Welcome di

 

e Choose DesctWise Config

 

V8i Deployme

ht © 2012 Be

Configuratage Works

p 1, skip to #3

Managed Woministrator, us will open thalog, click Ne

sired  Action guration Setti

nt Guide  P

entley System

tion File(s)space Wiza

3 on next pag

orkspaces…" wunder Worksphe Managed Wext 

page,  select ing Blocks", T

 

ProjectWise 

ms, Incorporat

) to Projectard. (approx. 1

e, bypassing 

wizard.   pace Profiles>Workspace W

the first optiohen click Nex

Managed W

ted| AECOsim

tWise Con10 min)     

#1 (opening t

>Managed (RiWizard.  

on "Import Mxt 

Workspace 

m Building Des

nfiguration

the "Import M

ight‐Click). Th

 

MicroStation C

 

signer Techno

n Setting B

Managed Wo

hen click "Imp

Configuration

ote  9 

locks, 

rkspaces…" 

port Managed

n File to 

AEC

 

 

COsim Buildin

5. Choos

   

ng Designer V

Copyrig

se a MicroSta

Locateexecut

Defaulo

o

Locate

Defaulo

o Verify 

selecte

Click N 

 

V8i Deployme

ht © 2012 Be

ation Installat

e the MicroStatable. 

lt installationWindows XPSs4\AECOsimWindows 7 ‐Ss4\AECOsim

e the Workspa

lt installationWindows XPData\BentleWindows 7 ‐

that the optied. (checked 

Next 

nt Guide  P

entley System

tion and Work

ation Installa

 –  P ‐  …\ProgrammBuildingDesig‐ …\Program FmBuildingDesig

ace Root Dire

 –  P ‐ …\Documeny\AECOsimBui‐  …\ProgramD

on to "Createby default) 

 

ProjectWise 

ms, Incorporat

kspace Root:

tion by brows

 Files\Bentley\gner\AECOsimiles (x86)\Bentgner\AECOsim

ectory

nts and SettingildingDesigner Data\Bentley\A

e configuratio

Managed W

ted| AECOsim

sing and loca

\AECOsimBuildBuildingDesigntley\AECOsimBBuildingDesign

gs\All Users\Ap V8i Ss4\WorkAECOsimBuildin

on block for w

Workspace 

m Building Des

ting the AECO

dingDesigner Vner.exe BuildingDesignner.exe  

pplication kSpace ngDesigner V8

workspace roo

 

signer Techno

OsimBuilding

V8i 

er V8i 

i Ss4\WorkSpa

ot variable" is

ote  10 

Designer.exe

ace 

s NOT 

 

AEC

 

 

COsim Buildin

6. Add cthat cprojecnavigaconfig 

  Tireusa Projec

WindSs4\W

WindSs4\W   

  

ng Designer V

Copyrig

configuration could be eligibct .pcf files. Inate to your loguration file. 

ip: The goal isble across mu

cts directorie

ows XP ‐ …\DWorkSpace\Pr

ows 7 ‐  …\PrWorkSpace\Pr

 

V8i Deployme

ht © 2012 Be

files: At this pble to be impn the Workspocal projects dOnce the pro

s to have a goultiple project

s: 

Documents anrojects\Buildi

rogramData\Brojects\Buildi

nt Guide  P

entley System

point you havorted into Prpace Configurdirectory andoject .pcf file i

ood standardts or is suited

nd Settings\AlngExamples\

Bentley\AECOngExamples\

 

ProjectWise 

ms, Incorporat

ve the optionojectWise, buation Files diad select the Buis added into 

d project.pcf fid for a specific

ll Users\Appli\ 

OsimBuildingD\ 

Managed W

ted| AECOsim

 to scan the eut a scan is unalog, click AduildingTemplthe Workspa

files to converc project type

ication Data\

Designer V8i 

Workspace 

m Building Des

entire workspnnecessary bedd. This will inate_US.pcf oace Import dia

rt into a projee. 

\Bentley\AECO

 

signer Techno

pace for confiecause we aritiate a windor other valid alog, click Nex

ect CSB that is

OsimBuilding

ote  11 

iguration filesre only after ows browser;project xt. 

s scalable and

gDesigner V8i

AEC

 

 

COsim Buildin

7. When  

  

8. On thcreatethey chas decreateremovstatem   

  

Pldocum

  

ng Designer V

Copyrig

n the text, “Sc

 

e Configuratied. Configuracan be removetected an ine a link to theve it. First wement” 

 

lease note, we ment.  

V8i Deployme

ht © 2012 Be

canning for W

ion Settings Bation Settings ved if unwantclude stateme CSB nor do we must unche

will be making

nt Guide  P

entley System

Workspace Co

Blocks page, rBlock namested from withment within thwe want this ck the option

g a more reusa

 

ProjectWise 

ms, Incorporat

nfiguration F

eview the Pros can be chanhin in this dialhe project coninclude state

n to “Link Con

able connection

Managed W

ted| AECOsim

iles complete

ojectWise Coged, reassignog.  As you canfiguration. Inement to beconfiguration Se

n to the datase

Workspace 

m Building Des

ed successfull

 

onfiguration Sned to differean see, the wn this situatioome a CSB, thetting Blocks b

 

et.cfg, called D

signer Techno

ly”, appears c

Settings Blocknt ProjectWis

workspace impon, we do notherefore we wbased on incl

Dynamic_Datas

ote  12 

click Next  

ks that will bese levels, or port wizard t want it to will need to ude 

set, later in thiss 

AEC

 

 

COsim Buildin

9. UncheRemo 

 10. Ackno

 

 11. In ord

 

   

ng Designer V

Copyrig

ecking this diove the CSB d

owledge the d

der to procee

V8i Deployme

ht © 2012 Be

alog, will chaerived from t

deletion of th

d with the im

nt Guide  P

entley System

nge the layouthe include st

he CSB by clic

mporting, click

 

ProjectWise 

ms, Incorporat

ut of the dialotatement. 

king ‘Yes’ 

k Next 

Managed W

ted| AECOsim

og, allowing y

 

Workspace 

m Building Des

you the oppo

 

 

signer Techno

rtunity to Sel

ote  13 

ect and 

AEC

 

 

COsim Buildin

 12. Please

backwconveacron 

  

13. When

 

ng Designer V

Copyrig

e review the ward throughert your confinym CSB or CS

 

n the import i

V8i Deployme

ht © 2012 Be

configuration the Workspaguration filesSBs (plural).  

s finished (** 

nt Guide  P

entley System

n file setting. ace Import Ws into ProjectW

** IMPORT SU

 

ProjectWise 

ms, Incorporat

If any errors oWizard. If satisfWise Configu

UCCESSFUL **

Managed W

ted| AECOsim

or changes arfied, click Impration Setting

**), click Nex

Workspace 

m Building Des

re noted, useport. This willg Blocks also 

 

xt. 

 

signer Techno

e the back butl begin the prreferred to b

ote  14 

tton to step rocess to by the 

AEC

 

 

COsim Buildin

 14. For th15. Proce

Admin  

      

ng Designer V

Copyrig

his exercise, weed to the Pronistrator to v

 

V8i Deployme

ht © 2012 Be

we are done wojectWise Admerify the imp

nt Guide  P

entley System

with the Workministrator toort. (Datasou

 

ProjectWise 

ms, Incorporat

kspace Imporo review the nurce>Workspa

Managed W

ted| AECOsim

rt Wizard.   Clnewly‐createace Profiles>M

Workspace 

m Building Des

lick Close.  d configuratioManaged) 

 

signer Techno

on blocks in P

ote  15 

ProjectWise 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  16 

 

 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 a new ‘Predefined’ level CSB for AECOsim Building Designer Electrical 

Create a new ‘Predefined’ level CSB for AECOsim Building Designer called ABD_Workspace_Ss4 

Create a new ‘Global’ level CSB called Global_Variables 

Create a new ‘Project’ level CSB called Dynamic_Project 

Create a new ‘Project’ level CSB called Dynamic_Dataset   

Create a new ‘Project’ level CSB  to support IFC Dataset Extensions (New is Ss4) 

Edit ‘Project’ CSB File to support Project Data  

  If you are not familiar with creating/editing CSB files, please refer to the Addendum at the end of this document for a step by step guide that will walk you through the process of creating one. 

 

Create a new ‘Predefined’ level CSB for AECOsim Building Designer Electrical (This CSB will define how the Electrical portion of AECOsim Building Designer to work with ProjectWise.)     The Electrical portion of AECOsim Building Designer can be configured in several ways depending on the requirement for Electrical in your workflow. Regardless which method is utilized, it must be configured “correctly” as it is an integrated discipline within AECOsim Building Designer. We have included two integrations methods; Integrated or Local Electrical. Please implement only one option.   

1. Integrated Electrical ‐ If your organization requires use of the electrical discipline within AECOsim Building Designer  

2. Local Electrical – If your organization does NOT utilize the electrical discipline within AECOsim Building Designer, this configuration uses local resources versus ProjectWise resources, providing the minimum footprint and overhead for a ProjectWise manage workspace integration. 

  Method 1: Integrated Electrical  

1. In ProjectWise Administrator , under Workspace Profiles>Managed>Predefined, right mouse click over the ‘Predefined’ Level and select New> Configuration Block 

 

  

    

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  17 

 

2. In the New Configuration Block Properties, enter the name ABD_Electrical_Ss4  and the description: 

ABD Electrical (SELECTseries 4).  Once complete click Apply. The dialog title will change to 

ABD_Electrical_Ss4 Properties.   

 

        

   

AEC

 

 

 

COsim Buildin

3

 

ng Designer V

Copyrig

. Add the fo

AddV

  Note: Projecexplici

 Any ofElectrielectri

V8i Deployme

ht © 2012 Be

ollowing varia

Variabletot

Name 

Description 

Add Value 

Locked 

 

BBES_DETAILctWise Managt directory de#‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐# Electrical De#‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐%if defined (BBBES_MWS_SBBES_MWS_MBBES_MWS_IBBES_MWS_RBBES_MWS_SBBES_MWS_SBBES_MWS_CBBES_MWS_VBBES_MWS_WMS_LIGHTINGBBES_SYMBO%lock BBES_S%endif 

f the above cocal portion iscal dataset a

nt Guide  P

entley System

bles and/or d

heABD_Elec

BBES_DE

Enable B

OperatioValue TyValue:  1

YES 

LED_CFG enaged Workspacefinition as se‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐etailed Path Con‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐BBES_DETAILED_SYMLIBNO : 080METADATA : $(BES : $(BBES_MWRES : $(BBESDIR)SYMLIBS : $(BBESYMLIB : $(BBESCSS : $(BBES_MWVIS : $(BBES_MWWIRING : $(BBESG < $(BBES_MWOLMANAGER_RESYMBOLMANAG

onfiguration vs configured inre external of

ProjectWise 

ms, Incorporat

directives: 

ctrical_Ss4C

ETAILED_CFG

BBES Detailed

on Type: '='‐ Aype:  String 1 

bles BBES Detce Support. Teen in the exc‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐nfiguration for Pr‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐_CFG)  BBESDIR)/METADWS_METADATA))/RES/ SDIR)/SYMLIBS/_MWS_SYMLIBSWS_SYMLIBS)CSWS_SYMLIBS)VISS_MWS_SYMLIBS_IES) DIRPATH = 1ER_REDIRPATH

variables can n a “Hybrid” f ProjectWise

Managed W

ted| AECOsim

CSB

 

d Configuratio

Assignment 

tailed configuThe detailed ccerpt from th‐‐‐‐‐‐‐‐‐‐‐‐‐ rojectWise Integ‐‐‐‐‐‐‐‐‐‐‐‐‐ 

DATA/ /IES/ 

/ S)$(BBES_MWS_SS/ S/ BS)WIRING/ 

 

 be further reManage worke, then it is no

Workspace 

m Building Des

on 

 

uration optioconfiguration he BuildingDis

gration 

_SYMLIBNO)/ 

edefined in a kspace, wherot necessary t

signer Techno

n which is reqoption allowsciplines.cfg b

project CSB. re the compoto define this

ote  18 

quired for ws for more below:   

If the nents of s variable.  

AEC

 

 

COsim Buildin

 

ng Designer V

Copyrig

AddV

 

 

V8i Deployme

ht © 2012 Be

Variabletot

Name 

Descript

Add Valu

Locked 

   

Note: BBES

BBES_DBDI

This locatio

cannot be p

structure, r

Using a UN

the greates

value is res

will need to

ProjectWis

To troublesthe bbes.inV8i\AECOsi

nt Guide  P

entley System

heABD_Elec

BBE

ion  Elec

ue  OpeValuValu

YES

S_DBDIR defin

IR should poin

on is user defi

properly man

room spaces, 

C (Universal N

st availability 

solved from th

o be manually

e cannot man

shoot configuni file located imBuildingDe

ProjectWise 

ms, Incorporat

ctrical_Ss4C

S_DBDIR 

ctrical Central

eration Type: ue Type:  Direue:  \\<Server

nes the electr

nt to the proj

inable. This fo

naged by Proj

elements cou

Naming Conv

and access to

he ProjectWis

y created for 

nage director

uration issuesat C:\Programesigner\Serve

Managed W

ted| AECOsim

CSB

lized Project 

'='‐ Assignmeectory rName>\<Sha

rical centraliz

ject specific _

older contain

ectWise at th

unt and mou

vention) to de

o a centralize

se Project; ho

each project 

ries outside o

s with a Projecm Files (x86)\erApp\bin. 

Workspace 

m Building Des

Database Loc

ent 

areFolder>\$(

ed project da

_bbes folder o

s project spe

his point. Info

nting heights

efine the dire

ed location. Th

owever the co

in the centra

f ProjectWise

ctWise mana\Bentley\AEC

signer Techno

cation 

(_USTN_PROJ

  

atabase locati

outside of Pro

cific database

ormation abou

s is stored in _

ctory destina

he _USTN_PR

orresponding

alized location

e. 

ged workspaOsimBuilding

ote  19 

JECTNAME)\_

ion. 

ojectWise. 

e files that 

ut building 

_bbes folder.

ation allow fo

ROJECTNAME

g directory 

n since 

ce, refer to gDesigner 

_bbes 

 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  20 

 

The Final ABD_Electrical_Ss4 CSB:  

          

 

Method 2: Integrated Electrical  

1. In ProjectWise Administrator , under Workspace Profiles>Managed>Predefined, right mouse click over the ‘Predefined’ Level and select New> Configuration Block 

 

  

    

AEC

 

 

COsim Buildin

2.

 

ng Designer V

Copyrig

. In the New

description

ABD_Elect

 

    

V8i Deployme

ht © 2012 Be

w Configuratio

n: ABD Electr

trical_Local Pr

 

 

nt Guide  P

entley System

on Block Prop

rical Local.  O

roperties.   

ProjectWise 

ms, Incorporat

perties, enter 

nce complete

Managed W

ted| AECOsim

r the name AB

e click Apply. 

Workspace 

m Building Des

BD_Electrical_

The dialog tit

 

signer Techno

l_Local and th

tle will chang

ote  21 

he 

ge to 

AEC

 

 

 

COsim Buildin

3

 

ng Designer V

Copyrig

. Add the fo

AddV

  Note: $(_UST

V8i Deployme

ht © 2012 Be

ollowing varia

Variabletot

Name 

Description 

Add Value 

Locked 

 

Please note tTN_INSTALLE

nt Guide  P

entley System

bles and/or d

heABD_Elec

BBES_W

BBES Wo

OperatioValue TyValue:  $

YES 

the use of () inED_WORKSPA

ProjectWise 

ms, Incorporat

directives: 

ctrical_Loca

WORKSPACERO

orkspace Roo

on Type: '='‐ Aype:  String $(_USTN_INST

nstead of the ACEROOT), thi

Managed W

ted| AECOsim

alCSB

OOT 

ot 

Assignment 

TALLED_WOR

traditional {}is is critical. 

Workspace 

m Building Des

RKSPACEROO

 

} in defining 

signer Techno

OT) 

ote  22 

AEC

 

 

 

COsim Buildin

 

ng Designer V

Copyrig

AddV

 

  

V8i Deployme

ht © 2012 Be

Variabletot

Name 

Description

Add Value 

Locked 

 

Note: The d

“Dataset_U

Building De

German, et

dataset nam

since the El

AECOsim B

nt Guide  P

entley System

heABD_Elec

BBES_

n  Electric

OperatValue TValue: 

YES 

dataset name

US”, as it is th

esigner. If a lo

tc..) is installe

me is differen

lectrical disci

uilding Desig

ProjectWise 

ms, Incorporat

ctrical_Loca

DATASETNAM

cal Local Data

tion Type: '='‐Type:  Directo Dataset_US

e must point t

e default deli

ocalized versio

ed, please adj

nt from the da

pline is not in

ner still requi

Managed W

ted| AECOsim

alCSB

ME 

aset Name 

‐ Assignmentory 

to a valid loca

ivered datase

on of AECOsi

just the datas

ataset used b

ntended to be

ires a valid re

Workspace 

m Building Des

  

al dataset. In 

et with most v

m Building De

set name acco

by ProjectWis

e used in this 

esolution of it

signer Techno

this case, it is

versions of A

esigner (ie Ch

ordingly. It is 

se or even the

configuration

ts configuratio

ote  23 

s defaulted to

ECOsim 

hinese, 

Ok, if the 

e project, 

n; however 

on variables.

AEC

 

 

COsim Buildin

 

ng Designer V

Copyrig

AddV

 

 

V8i Deployme

ht © 2012 Be

Variabletot

Name 

Description

Add Value 

Locked 

 

nt Guide  P

entley System

heABD_Elec

BBES_

n  BBES D

OperatValue TValue: 

YES 

ProjectWise 

ms, Incorporat

ctrical_Loca

DATASETS 

Datasets 

tion Type: '='‐Type:  Directo $(BBES_WO

Managed W

ted| AECOsim

alCSB

‐ Assignmentory ORKSPACEROO

Workspace 

m Building Des

OT)/BuildingD

signer Techno

Datasets/ 

ote  24 

AEC

 

 

COsim Buildin

   

 

ng Designer V

Copyrig

The Fi

 

V8i Deployme

ht © 2012 Be

nal ABD_Elec 

   

nt Guide  P

entley System

ctrical_Local C

ProjectWise 

ms, Incorporat

CSB: 

Managed W

ted| AECOsim

Workspace 

m Building Des

 

signer Technoote  25 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  26 

 

Create a new ‘Predefined’ level CSB for AECOsim Building Designer called  ABD_Workspace_Ss4  ‐ THIS IS A CRITICAL TASK! 

(This CSB will make the vital connection between the CSBs and the ProjectWise datasource.)   

1. In ProjectWise Administrator , under Workspace Profiles>Managed>Predefined, right mouse click over the ‘Predefined’ Level and select New> Configuration Block 

 

  

 2. In the New Configuration Block Properties, enter the name ABD_Workspace_Ss4 and the description ABD 

Workspace (SELECTseries 4).  Once complete, click Apply. The dialog title will change to 

ABD_Workspace_Ss4 Properties.   

 

      

3. Add the following variables and/or directives: 

 

AEC

 

 

 

 

COsim Buildin

A

 Nby

  

ng Designer V

Copyrig

AddVariable

 

Note: _TF_WOy AECOsim Bu

 

  Tip: SinSs4 SEYou comonik

   Tip: Yoexamp08.11.monik 

V8i Deployme

ht © 2012 Be

etotheABD_

Name 

Description 

Add Value 

Locked 

 

ORKSPACEROOuilding Design

nce WorkspaELECTseries mould also use ter. 

ou can use theple, change th09.5xx Workser or applicat

 

nt Guide  P

entley System

_Workspace

_TF_WO

ABD PW

OperatiValue TValue:  pw:\\<sBuilding 

YES 

OT defines thner.

ces can be veoniker to desthe minor fam

e CSB descriphe descriptionspace Root, thtion versions.

ProjectWise 

ms, Incorporat

e_Ss4CSB

ORKSPACERO

W Workspace 

on Type: '='‐ype:  ProjectWChange valueserver name>g Designer Ss

he root works

ersion specificsignate and dimily version 0f

ption to organn of Workspachis will allow  

Managed W

ted| AECOsim

OOT 

(_TF_WORKS

AssignmentWise Foldere to point to P>:<datasourcs4\Managed 

space director

c, the ABD_Wifferentiate b0f 08.11.09.5x

nize and manaceRoot_Ss4 Cus to sort CSB

Workspace 

m Building Des

SPACEROOT) 

ProjectWise Wce name>\ DoWorkspace\

 

ry containing

Workspace_Ss4between workxx instead of t

age collectionCSB to "Ss4 WB description

signer Techno

Workspace, bocuments\AE 

 all workspac

4 CSB includekspace versionthe SELECTse

n of CSB. For Workspace Roo by SELECTser

ote  27 

browse to ECOsim 

ce files used 

es the ns. ries 

ot" or ries 

AEC

 

 

 

 

COsim Buildin

A

 

 Nw

ng Designer V

Copyrig

AddVariable

Name 

Descri

Add V

Locked

 

Note: _USTN_workspace “sta

V8i Deployme

ht © 2012 Be

etotheABD_

_U

ption  A

alue  OVV

d  YE

SITE defines tandards”.

 

 

nt Guide  P

entley System

_Workspace

USTN_SITE 

BD PW Stand

peration Typalue Type: Stalue:  $(_TF_W

ES 

the directory 

ProjectWise 

ms, Incorporat

e_Ss4CSB

dards (_USTN_

e: '='‐ Assignmring WORKSPACE

containing si

Managed W

ted| AECOsim

_SITE) 

ment 

ROOT)standa

ite configurat

Workspace 

m Building Des

ards/ 

 

tion files, oth

signer Techno

erwise known

ote  28 

n as 

AEC

 

 

    

COsim Buildin

A

ng Designer V

Copyrig

AddDirectiv

V8i Deployme

ht © 2012 Be

etotheABD

Directive 

Descriptio

Add Value

  

 Note: This dprevious ste

nt Guide  P

entley System

D_Workspace

%inclu

on  ABD E 

e  ValueValueOR Value

directive is deep 

ProjectWise 

ms, Incorporat

e_Ss4CSB

ude 

Electrical 

e type: Confige: ABD_Electr

e: ABD_Electr

ependent on t

Managed W

ted| AECOsim

guration Settinical_Ss4: ABD

ical_Ss4: ABD

the Electrical 

Workspace 

m Building Des

ng Block D_Electrical (S

D_Electrical_L

integration m

signer Techno

SELECTseries 

Local 

 

method select

ote  29 

4) 

ted in a 

AEC

 

 

 

COsim Buildin

T

   

 

ng Designer V

Copyrig

TheFinalABD

 

V8i Deployme

ht © 2012 Be

D_Workspac 

 

 

nt Guide  P

entley System

ce_Ss4CSB:

ProjectWise 

ms, Incorporat

Managed W

ted| AECOsim

Workspace 

m Building Des

  

signer Technoote  30 

AEC

 

 

 

 

COsim Buildin

Create n 

1

2.

3.

 

ng Designer V

Copyrig

ew ‘Global’ 

. In ProjectWthe ‘Globa

. In the New

Global Var

Properties

 

    

. Add the fo

V8i Deployme

ht © 2012 Be

level CSB ca

Wise Adminisl’ Level and s 

w Configuratio

riables. Once

.   

 

ollowing varia

 

 

nt Guide  P

entley System

alled Global_

strator , undeselect New> C

on Block Prop

 complete cli

bles and/or d

ProjectWise 

ms, Incorporat

_Variables

r Workspace Configuration 

perties, enter 

ck Apply. The

directives: 

Managed W

ted| AECOsim

Profiles>Man Block 

r the name Gl

e dialog title w

Workspace 

m Building Des

naged>Globa

lobal_Variabl

will change to

 

signer Techno

al, right mous

 

les and the de

o Global_Vari

ote  31 

e click over 

escription 

iables 

AEC

 

 

 

  

  

COsim Buildin

AddVari   

T

ng Designer V

Copyrig

iabletothe

 

Note: for Ad

TheFinalGlo

V8i Deployme

ht © 2012 Be

Global_Vari

Name 

Descript

Add Val

Locked 

 

_USTN_DISPLministrators 

obal_Variabl 

 

nt Guide  P

entley System

ablesCSB‐

_US

tion  Dis

ue  OpeValVal

YES

LAYALLCFGVAduring certifi

lesCSB:

ProjectWise 

ms, Incorporat

STN_DISPLAY

play All Confi

eration Type:ue Type: Strinue:  1 

ARS displays acation and de

Managed W

ted| AECOsim

YALLCFGVARS

iguration Var

: '='‐ Assignmng 

all system levebugging. 

Workspace 

m Building Des

iables 

ment 

vel configurat

  

signer Techno

 

tion variable a

ote  32 

and is useful 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  33 

 

Create a new ‘Project’ level CSB called Dynamic_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) 

Preferredmethod:ProjectSupportwithProjectWiseProjectsIf your projects folders have been promoted to PW projects, then the _USTN_PROJECTDATA can be automatically extracted by defining the following dynamic Project level CSB.   

  Folders that have been promoted to a ProjectWise Project have the ProjectWise icon associated with the Folder icon as displayed in the diagram above.  

  

   

AEC

 

 

 

 

COsim Buildin

Create a 

  

ng Designer V

Copyrig

new ‘Projec(Thpr

1. In cli

2. In 

de

Dy

 

  

3. Ad

V8i Deployme

ht © 2012 Be

ct’ level CSBhis CSB will moject.) 

ProjectWise ck over the ‘P

 

 the New Con

escription Dyn

ynamic_Proje

 

dd the followi

nt Guide  P

entley System

B called "Dynmake the vital

AdministratoPredefined’ L

nfiguration Blo

namic Project

ect Properties

ing variables 

ProjectWise 

ms, Incorporat

namic_Proje connection b

or , under Woevel and sele

ock Propertie

t.  Once comp

.   

and/or direct

Managed W

ted| AECOsim

ect “  between the 

orkspace Profiect New> Conf

es, enter the n

plete click Ap

tives: 

Workspace 

m Building Des

project CSBs 

iles>Managedfiguration Blo

name Dynam

pply. The dialo

 

signer Techno

and the Proje

d>Project, rigock 

mic_Project an

og title will ch

ote  34 

ectWise 

ght mouse 

 

nd the 

hange to 

AEC

 

 

  

 

COsim Buildin

A

ng Designer V

Copyrig

AddVariable

  

  Tip:  ThProThcopa

V8i Deployme

ht © 2012 Be

etotheDyna

Name 

Description 

Add Value 

Locked 

he configuratioojectWise Projis could resolvnfiguration vararent ProjectW

 

nt Guide  P

entley System

amic_Projec

_USTN_

ProjectW

OperatioValue TyValue:  $

YES 

on variable dmsect definition ie to a single pariable dms_pa

Wise Project . 

ProjectWise 

ms, Incorporat

ctCSB

_PROJECTDAT

Wise Project

on Type: '='‐Aype: String $(dms_projec

s_project(_DGit encounters aarent Project (wrentproject(_D

Managed W

ted| AECOsim

TA 

Assignment 

ct(_DGNDIR))

GNDIR) resolvesas it traverses bwith no subproDGNDIR) resolv

Workspace 

m Building Des

 

s the directory backwards throojects) or a Subves the director

signer Techno

path to the firough the direcbproject. The ry path to only

ote  35 

rst tories. 

y the 

AEC

 

 

  

 

COsim Buildin

A

ng Designer V

Copyrig

AddVariable

  

  Tip:  Tnaenbe

V8i Deployme

ht © 2012 Be

etotheDyna

Name 

Description

Add Value 

Locked 

 

The configuratame based onncounters as ie required or u

nt Guide  P

entley System

amic_Projec

_USTN_

  Project

OperatValue TValue: 

YES 

tion variable Ln the directoryit traverses baused in other

ProjectWise 

ms, Incorporat

ctCSB

_PROJECTNA

tWise Project

tion Type: '='‐Type: String  $(LastDirPiec

LastDirPiece(y path to the fackwards throCSB. 

Managed W

ted| AECOsim

AME 

t Name 

‐ Assignment

ce (dms_proj

(dms_project(first ProjectWough the dire

Workspace 

m Building Des

ject(_DGNDIR

  

(_DGNDIR)) rWise Project dectories. This p

signer Techno

R))) 

resolves the pdefinition it project name

ote  36 

roject 

e may 

AEC

 

 

   

COsim Buildin

T

ng Designer V

Copyrig

TheFinalDy

V8i Deployme

ht © 2012 Be

namic_Proje 

  

 

nt Guide  P

entley System

ectCSB:

ProjectWise 

ms, Incorporat

Managed W

ted| AECOsim

Workspace 

m Building Des

  

signer Technoote  37 

AEC

 

 

 

 

COsim Buildin

C

  

ng Designer V

Copyrig

reate a new(Thda

1. In cli

2. In 

de

Dy

 

  

3. Ad

V8i Deployme

ht © 2012 Be

w ‘Project’ lehis CSB will mataset.) 

ProjectWise ck over the ‘P

 

 the New Con

escription: Dy

ynamic_Datas

 

dd the followi

 

nt Guide  P

entley System

evel CSB callemake the vital

AdministratoPredefined’ L

nfiguration Blo

ynamic Datas

set Properties

ing variables 

ProjectWise 

ms, Incorporat

ed "Dynami connection b

or , under Woevel and sele

ock Propertie

set.  Once com

s.   

and/or direct

Managed W

ted| AECOsim

ic_Dataset “between the 

orkspace Profiect New> Conf

es, enter the n

mplete click A

tives: 

Workspace 

m Building Des

“  project CSBs 

iles>Managedfiguration Blo

name Dynam

Apply. The dia

 

signer Techno

and the appr

d>Project, rigock 

mic_Dataset a

alog title will c

ote  38 

ropriate 

ght mouse 

 

and the 

change to 

AEC

 

 

 

 

 

COsim Buildin

A

  

T

ng Designer V

Copyrig

AddDirectiv

 

Note: Thisfrom proje

TheFinalDy

 

V8i Deployme

ht © 2012 Be

etotheDyn

Directive 

Description

Add Value 

 CSB include tect to projects

namic_Data

 

nt Guide  P

entley System

namic_Datas

%inclu

n  Includ

Value Value:

the configuras, this CSB wi

asetCSB:

ProjectWise 

ms, Incorporat

setCSB

ude 

e Dataset Co

type: String: $(TFDIR)dat

ation file assoll ensure the 

Managed W

ted| AECOsim

nfiguration F

aset.cfg 

ociated with ecorrect supp

Workspace 

m Building Des

File 

 

each datasetsporting config

  

signer Techno

s, If the dataseuration file w

ote  39 

et changes will be loaded. 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  40 

 

Create a new ‘Project’ level CSB  to support IFC Dataset Extensions (New is Ss4)  

In this step, you are going to complete the following tasks: 

Create a new ‘Project’ CSB  called IFC2x3 Extension 

Create a new ‘Project’ CSB  called IFC2x3 + FM Handover Extension  The goal of the IFC2x3 dataset extension is to allow users to quickly and easily extend their projects with properly constructed and DataGroup compatible IFC 2x3 schema and property sets. Currently there are three options for this dataset extensions, all controlled by the configuration value IFC_PROJECT.    

IFC_PROJECT = 0 (default ) or Undefined– The dataset is NOT extended with any IFC2x3 Property sets and maintains the original delivered schema. 

IFC_PROJECT = 1 – The dataset is extended with the common IFC 2x3 Property Set, an extended version of the IFC ‘Coordination View’ model view definition. 

IFC_PROJECT = 2 ‐ The dataset is extended with the common IFC 2x3 Property Set, plus additional property sets as defined by the  IFC 'Facility Management Handover' model view definition and additional considerations for the COBIE (Construction Operation Business information Exchange) specification 

 

   Tip:  To learn more about COBie, Please see our “COBie User Guide” posted on BE Communities. 

 

 

Create a new ‘Project’ Level CSB called "IFC2x3 Extension“  (This CSB will make the vital connection between to the dataset extensions.) 

  1. In ProjectWise Administrator , under Workspace Profiles>Managed>Project, right mouse 

click over the ‘Project’ Level and select New> Configuration Block  

   

   

AEC

 

 

 

COsim Buildinng Designer V

Copyrig

2. In 

de

ch

 

  

V8i Deployme

ht © 2012 Be

the New Con

escription IFC2

ange to IFC2x

nt Guide  P

entley System

nfiguration Blo

2x3 Dataset E

x3_Extension

ProjectWise 

ms, Incorporat

ock Propertie

Extension.  O

n Properties.  

Managed W

ted| AECOsim

es, enter the n

Once complete

 

Workspace 

m Building Des

name IFC2x3 

e click Apply.

 

signer Techno

Extension an

 The dialog ti

ote  41 

nd the 

tle will 

AEC

 

 

 

  

 

COsim Buildin

A

ng Designer V

Copyrig

AddVariable

3. SwVa

4. Ad 

V8i Deployme

ht © 2012 Be

etotheIFC2

witch to the Cariable. dd the followi

Name 

Description 

Add Value 

Locked 

 

nt Guide  P

entley System

2x3Extension

Configuration 

ing Variable

IFC_PRO

Enable I

OperatioValue TyValue:  1

YES 

ProjectWise 

ms, Incorporat

nCSB

tab, Select th

OJECT 

FC2x3 Datase

on Type: '='‐Aype: String 1 

Managed W

ted| AECOsim

he ‘+’ (plus) ic

et Extension

Assignment 

Workspace 

m Building Des

con and selec

  

signer Techno

ct the option t

ote  42 

to Add 

AEC

 

 

 

 

 

 

COsim Buildin

A

 

ng Designer V

Copyrig

AddDirectiv

5. In 6. Ad

7. Se8. Se

V8i Deployme

ht © 2012 Be

etotheIFC2

the Configurdd the followi

Directive 

Description 

Add Value 

elect  OK on thelect  OK on th

 

nt Guide  P

entley System

2x3Extensio

ation tab, Seling Directive.

%includ

Include 

Value tyValue: $

he Modify Dirhe Project CS

ProjectWise 

ms, Incorporat

onCSB

lect the ‘+’ (p  

Dataset Conf

ype: String $(IFCDIR)data

rective dialogB’s propertie

Managed W

ted| AECOsim

lus) icon and 

figuration File

set.cfg 

g accept the des dialog to sa

Workspace 

m Building Des

 select the op

 

directive assigave changes 

signer Techno

ption to Add D

gnment 

ote  43 

Directive. 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  44 

 

Create a new ‘Project’ Level CSB called " IFC2x3 + FM Handover Extension “  (This CSB will make the vital connection between to the dataset extensions.) 

  1. In ProjectWise Administrator , under Workspace Profiles>Managed>Project, right mouse 

click over the ‘Project’ Level and select New> Configuration Block  

  

 2. In the New Configuration Block Properties, enter the name IFC2x3 + FM Handover Extension 

and the description IFC2x3 + FM Handover Dataset Extension.  Once complete click Apply. 

The dialog title will change to IFC2x3 + FM Handover Extension Properties.   

 

      

 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  45 

 

AddVariabletotheIFC2x3ExtensionCSB 

3. Switch to the Configuration tab, Select the ‘+’ (plus) icon and select the option to Add Variable. 

4. Add the following Variable.   

Name  IFC_PROJECT 

Description  Enable IFC2x3 + FM Handover Dataset Extension 

Add Value  Operation Type: '='‐Assignment Value Type: String Value:  2 

Locked  YES 

  

     

AEC

 

 

 

 

 

 

 

COsim Buildin

A

ng Designer V

Copyrig

AddDirectiv

5. In 6. Ad

 7. Se8. Se

V8i Deployme

ht © 2012 Be

etotheIFC2

the Configurdd the followi

Directive 

Description 

Add Value 

elect  OK on thelect  OK on th

 

nt Guide  P

entley System

2x3Extensi

ation tab, Seling Directive.

%includ

Include 

Value tyValue: $

he Modify Dirhe Project CS

ProjectWise 

ms, Incorporat

onCSB

lect the ‘+’ (p  

Dataset Conf

ype: String $(IFCDIR)data

rective dialogB’s propertie

Managed W

ted| AECOsim

lus) icon and 

figuration File

set.cfg 

g accept the des dialog to sa

Workspace 

m Building Des

 select the op

directive assigave changes 

signer Techno

ption to Add D

gnment 

ote  46 

Directive. 

AEC

 

 

  

 

COsim Buildin

Edit ‘Proj 

In

 Inwit 

Inthp

In

ng Designer V

Copyrig

ject’ CSB Fil

n this step, yo

Ap

Ap

Ap 

n ProjectWisewas imported to open it fo

n the Configurhe “_USTN_Panel or highli

 

n this Project 

V8i Deployme

ht © 2012 Be

e to support

ou are going t

ppend  ‘Projec

ppend  ‘Projec

pply Dataset E

e Administratofrom the pror editing. 

ration tab, loROJECTDESCRght this sectio

 CSB file, click

nt Guide  P

entley System

t Project Da

o complete t

ct’ CSB  to inc

ct’ CSB  to inc

Extensions to

or , under Woject configura

cate and inseR” text.  This on as displaye

k the plus icon

ProjectWise 

ms, Incorporat

ta (New in Ss

he following 

clude Dynami

clude Dynami

 a Project (Ne

orkspace Profation file ( .pc

ert you cursorwill either insed below, eit

n “+” and add

Managed W

ted| AECOsim

s4)  

tasks: 

ic_Project CS

ic_Dataset C

ew in Ss4) 

files>Managecf) in Step 2 (

r at the top ofsert your cursther is accept

d the followin

Workspace 

m Building Des

SB 

SB 

ed>Project, loBuildingTemp

f the text presor at the begable. 

    

ng directive: 

signer Techno

ocate the Projplate_US) and

eview panel, jginning of the

ote  47 

ject CSB that d double click

ust before e text preview

AEC

 

 

   

 

 

COsim Buildin

A

 

  B 

  In

ng Designer V

Copyrig

AddDirectiv

 

 

  Th

ack in the Con

  

n this Project 

V8i Deployme

ht © 2012 Be

etothepro

Directive 

Description

Add Value 

his include sta

nfiguration ta

CSB file, click

nt Guide  P

entley System

jectconfigu

%inclu

n  Dynam

Value tValue:

atement shou

ab, insert you

k the plus icon

ProjectWise 

ms, Incorporat

urationCSB

ude 

mic Project 

type: Configu Dynamic_Pro

uld be inserte

u cursor towa

n “+” and add

Managed W

ted| AECOsim

(i.e.Buildin

uration Settinoject: Dynam

d at the top o

rds the botto

d the followin

Workspace 

m Building Des

ngTemplate_

ng Block mic Project  

 

of project CSB

om of the text

    

ng directive: 

signer Techno

_USprojectC

t preview pan

ote  48 

CSB)

nel.   

AEC

 

 

  

 

COsim Buildin

A

 

ng Designer V

Copyrig

AddDirectiv

 

 

  This includ

V8i Deployme

ht © 2012 Be

etothepro

Directive 

Description

Add Value 

de statement 

 

nt Guide  P

entley System

jectconfigu

%inclu

n  Dynam

Value Value: 

needs to be i

ProjectWise 

ms, Incorporat

urationCSB

ude 

mic Dataset 

type: Configu: Dynamic_Da

inserted at th

Managed W

ted| AECOsim

uration Settinataset: Dynam

he bottom of 

Workspace 

m Building Des

ng Block mic Dataset 

  

project CSB 

signer Technoote  49 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  50 

 

Apply Dataset Extensions to a Project (New in Ss4)  Before you can extend a project with a dataset extension in ProjectWise, you MUST first remove the configuration variable definition for IFC_PROJECT which is automatically included from importing the project configuration files into Project CSBs 

 Back in the Configuration tab, locate the variable IFC_PROJECT, it can be found towards the bottom of the text preview panel.  Insert you cursor over the IFC_PROJECT variable. This will highlight the entire variable definition, as indicated in the image below. Then, click the “X” icon to delete this variable from the Project CSB and select ‘Apply’ to save these changes.  

       There are two methods in ProjectWise in which a project can be extended with the Dataset Extension. (Pick one) 

1. Add Directive to source Project CSB  ‐ Add either the IFC2x3 Extension or the IFC2x3 + FM Handover Extension CSB to the source Project CSB that represents the project configuration file (pcf) 

2. Add CSB to ProjectWise Project Workspace Properties (Recommend Method) ‐  Add either the IFC2x3 Extension or the IFC2x3 + FM Handover Extension CSB to ProjectWise Project workspace properties.  

 

AEC

 

 

 

COsim Buildin

M

ng Designer V

Copyrig

Method1:Ad

1. In thco

2. In 3. Ad

 

  

4. Se5. Se

  

Note: 

Datase

V8i Deployme

ht © 2012 Be

ddDirective

ProjectWise e properties fonfiguration fithe Configurdd the followi

Directive 

Description 

Add Value 

elect  OK on thelect  OK on th

Any ProjectW

et Extension.

nt Guide  P

entley System

etosourceP

Administratofor the Projecile (pcf) that wation tab, Seling Directive.

%includ

Include 

Value tyValue: IF

he Modify Dirhe Project CS

Wise project a

ProjectWise 

ms, Incorporat

ProjectCSB:

or , under Wocts CSB that rwill be extendlect the ‘+’ (p  

IFC2x3 Exten

ype: ConfiguraFC2x3 Extens

rective dialogB’s propertie

associated to 

Managed W

ted| AECOsim

orkspace Profirepresent theded with onelus) icon and 

sion 

ation Setting sion: IFC2x3 D

g accept the des dialog to sa

this Project C

Workspace 

m Building Des

iles>Managede Project defin the IFC2x3 D select the op

Block Dataset Exten

  

directive assigave changes 

CSB, will inclu

signer Techno

d>Project, locnition or projDataset Extenption to Add D

sion 

gnment 

ude the define

ote  51 

cate and openect sions. Directive. 

ed IFC2x3 

AEC

 

 

 

 

 

COsim Buildin

M

ng Designer V

Copyrig

Method2:Ad

1. In Sw

2. Se

V8i Deployme

ht © 2012 Be

ddCSBtoPr

ProjectWise witch to the Welect the Proje

 

nt Guide  P

entley System

rojectWiseP

Explorer, locaWorkspace tabect container 

ProjectWise 

ms, Incorporat

ProjectWork

ate and openb. from the wo

Managed W

ted| AECOsim

kspaceProp

n the properti

orkspace hiera

Workspace 

m Building Des

perties(Rec

ies for the pa

archy and  

signer Techno

commendM

rent ProjectW

ote  52 

Method):

Wise Project. 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  53 

 

 Step 4: Add exclusions (variables to be excluded from copy‐out) 

 In certain scenarios, there are configuration variables that you may not want ProjectWise to use in managed workspaces. You can define and “exclude” ProjectWise from using these configuration variables by adding them to the list of excluded variables. 

  

In ProjectWise Administrator, under Workspace Profiles>Managed>Variables to exclude from copy out 

Below are some optional variables that may be excluded from copy out, depending on the AECOsim Building Designer workflows:  

MS_BUMP  (supports Visualization ‐ optional)  If you are not using project explorer the following can be excluded:  

MS_DESIGNDIR ( supports Project Explorer harvesting of Dynamic Views‐ optional) 

MS_DRAWINGDIR (supports for Project Explorer harvesting of Dynamic Views ‐ optional) 

MS_SHEETDIR (supports for Project Explorer harvesting of Dynamic Views ‐ optional) 

TF_DRAWINGS  (supports for Project Explorer harvesting of Drawing Extractions (DEM)‐ optional) 

 The files defined by these configuration variables, will be excluded during the download of the workspace 

 Step 5: ProjectWise Application Definition 

ProjectWise Application definition 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 because ProjectWise does not store any hard coded directory path information. Registry support relies on the client 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 files.   ProjectWise V8i (SELECTseries 4) is delivered with predefined application definitions for AECOsim Building Designer 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.  In the event the applications definitions are not predefined or you are working on a version previous to ProjectWise (SELECTseries 4), please review the following information to create the application definitions for AECOsim Building Designer (SELECTseries 4)   

AEC

 

 

  

COsim Buildin

Applicati 

ng Designer V

Copyrig

ion Definitio

In ProjBuildinpredef 

  

If the pbe impapplicadmsco

V8i Deployme

ht © 2012 Be

ons in Projec

jectWise Admng Designer infined applicat

predefined apported using tation definitioonv.exe, are in

 

nt Guide  P

entley System

ctWise Adm

ministrator, unn the right pation definition

pplications arthe administron file (ABD_nclude within

ProjectWise 

ms, Incorporat

ministrator:

nder Applicatanel.  ProjectWns for AECOsi

re not availabrative dmsconappdef.xml). n the XML file

Managed W

ted| AECOsim

tions, locate tWise V8i (SELim Building D

ble, the applicnv.exe utility,Instructions

e. 

Workspace 

m Building Des

the applicatioLECTseries 4) Designer. 

cations can be, using the coon how to ap

signer Techno

on definitionsis delivered w

 

e created maorresponding pply the XML,

ote  54 

s for AECOsimwith five (5) 

nually or canXML , using the 

AEC

 

 

 

COsim Buildin

M

 

ng Designer V

Copyrig

Manually Crea 

 

1. In Projopen t  

  

V8i Deployme

ht © 2012 Be

ting AECOsim

Copying anthan creatisince the somodified. Aavailable ap

jectWise Admthe New Appl

 

nt Guide  P

entley System

m Building De

nd editing a prng a new appome other AcAlso, some orgpplication to 

ministrator, riglication Prope

ProjectWise 

ms, Incorporat

signer Applic

rogram definplication. Coptions (View, Mganization mause with Proj

ght‐click overerties dialog.

Managed W

ted| AECOsim

ation Definiti

ition, such aspying a previoMarkup and Pay find MicrojectWise’s “op

r Applications

Workspace 

m Building Des

ions: 

s MicroStationous applicatioPrint) are alreoStation an atpen with” op

s and select N

signer Techno

n, might be mon offer some eady defined attractive optiotion. 

New>Applicat

 

ote  55 

more efficient benefits and easily on as an 

tion, this will 

AEC

 

 

 

COsim Buildinng Designer V

Copyrig

2. In the Buildinlocatindirecto 

3. Click th 

  

V8i Deployme

ht © 2012 Be

New Applicatng Designer”.ng either the Aory. 

 he Actions ta

 

 

nt Guide  P

entley System

tion Propertie You also havAECOsimBuil

b and click th

ProjectWise 

ms, Incorporat

es dialog, withve the opportdingDesigner

he Create butt

Managed W

ted| AECOsim

hin the Genertunity to set tr.exe or any o

ton to create

Workspace 

m Building Des

ral tab , entethe icon, by seof the .ico file

 

e a new applic

 

signer Techno

r the name “Aelecting Set ics located wit

cation associa

ote  56 

AECOsim con, and hin the same

ation. 

AEC

 

 

 

  

 

COsim Buildinng Designer V

Copyrig

4. In the  

 

5. Once aproper 

V8i Deployme

ht © 2012 Be

Create Assoc

Act

Pro

Pro

Com

Ena

Rep

  

 

The Programapplication iAECOsimBuilocally, then‘Enter text isapplication slocally. 

all the applicarties dialog an

 

nt Guide  P

entley System

ciation dialog,

tion 

ogram descrip

ogram class n

mmand line a

able legacy in

place default 

m class can bein the ProgramildingDesigne the class nams a program cshould be res

ation associatnd click Apply

ProjectWise 

ms, Incorporat

, fill out the a

ption 

ame 

arguments 

ntegration 

arguments 

e defined for bms list in the er.exe in the Eme can be fillclass name” oolved in the C

tion option ary to save the 

Managed W

ted| AECOsim

application as

Open 

AECOsim Bu

Bentley.AEC

<leave blank

<unchecked>

<unchecked>

browsing for Programs tabExecutables taled out manuaoption. If the cCommand line

re completedapplication d

Workspace 

m Building Des

ssociation crit

uilding Design

COsimBuilding

k> 

d> 

d> 

 

the AECOsimb, or browsinab, or if the aally in the Adclass is definee preview, un

d click OK, to rdefinition. 

signer Techno

teria 

ner 

gDesigner.Ap

m Building Desg for the application isnvanced tab, wed properly, tnless it is not i

return to the 

ote  57 

plication 

signer 

n’t loaded with the he installed 

applications 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  58 

 

6. Since AECOsim Building Designer is a multi‐disciplinary application, we will want to create addition application actions, so we can take advantage of the ProjectWise’s “open with” options to open files in a more discipline specific environments. We will want to repeat steps 3 and 4, filling out the application association criteria for the following four (4) addition application definitions.    The only change (highlighted in red) from one definition to another is the program description and the command line arguments. 

 

Create application association for Open Action with AECOsim Building Designer ‐ Architectural 

Action  Open 

Program description  AECOsim Building Designer‐ Architectural 

Program class name  Bentley.AECOsimBuildingDesigner.Application 

Command line arguments  wsBB_DISCIPLINE=Architectural 

Enable legacy integration  <unchecked> 

Replace default arguments  <unchecked> 

 Create application association for Open Action with AECOsim Building Designer – Structural 

Action  Open 

Program description  AECOsim Building Designer ‐ Structural 

Program class name  Bentley.AECOsimBuildingDesigner.Application 

Command line arguments  ‐wsBB_DISCIPLINE= Structural 

Enable legacy integration  <unchecked> 

Replace default arguments  <unchecked>  

Create application association for Open Action with AECOsim Building Designer – Mechanical 

Action  Open 

Program description  AECOsim Building Designer ‐ Mechanical 

Program class name  Bentley.AECOsimBuildingDesigner.Application 

Command line arguments  ‐wsBB_DISCIPLINE=Architectural 

Enable legacy integration  <unchecked> 

Replace default arguments  <unchecked> 

 Create application association for Open Action with AECOsim Building Designer – Electrical 

Action  Open 

Program description  AECOsim Building Designer ‐ Electrical 

Program class name  Bentley.AECOsimBuildingDesigner.Application 

Command line arguments  ‐wsBB_DISCIPLINE=Architectural 

Enable legacy integration  <unchecked> 

Replace default arguments  <unchecked> 

    

AEC

 

 

 

COsim Buildinng Designer V

Copyrig

7. Returnapplicain line desirereassigselectiassociadefine 

8. Additioaction Create 

 Create 

  

V8i Deployme

ht © 2012 Be

ning to the Acation.  The “dwith the Assod associationgned to the seion. Note, eacations defineed, the user w

  

onal Applicats for View, M

e application a

Action 

Program

Program

Comma

Enable 

Replace

e application a

Action 

Program

Program

Comma

Enable 

Replace

 

nt Guide  P

entley System

ctions tab, vedefault” appliociation desc and then clicelected assocch action has d for that act

will be asked t

ion associatioMarkup, and P

association fo

m description

m class name

and line argu

legacy integr

e default argu

association fo

m description

m class name

and line argu

legacy integr

e default argu

ProjectWise 

ms, Incorporat

rify that the ccation is denocription.  If theck the “Set Deciation and thits own defation. If no defo decide. 

on will need trint. 

or View Actio

Ope

n  Ben

e  B B

ments  <lea

ration  <un

uments  <un

or View Actio

Ope

n  Ben

e  Ben

ments  <lea

ration  <un

uments  <un

Managed W

ted| AECOsim

correct applicoted by a blae desired assefault” buttohe “Set Defauult associatiofault is define

to be defined

on with Bentle

en 

ntley View 

Bentley.View.A

ave blank> 

nchecked> 

nchecked> 

on with Bentle

en 

ntley Navigato

ntley.Navigat

ave blank> 

nchecked> 

nchecked> 

Workspace 

m Building Des

cation is assocck diamond iociation is non. The black dlt” button wion, when thered, and there 

 

d to support t

ey View  

Application 

ey Navigator 

or 

or.Applicatio

signer Techno

ciated as the con next to tot the “defaudiamond iconll become disre are multiplare multiple 

he other Proj

ote  59 

“default” he Action andlt”, select then will be sabled for thisle associations 

jectWise 

d e 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  60 

 

Create application association for Markup Action with Bentley Navigator  

Action  Open 

Program description  Bentley Navigator 

Program class name  Bentley.Navigator.Application 

Command line arguments  <leave blank> 

Enable legacy integration  <unchecked> 

Replace default arguments  <unchecked> 

 Create application association for Print Action with AECOsim Building Designer  

Action  Open 

Program description  AECOsim Building Designer 

Program class name  Bentley.AECOsimBuildingDesigner.Application 

Command line arguments  <leave blank> 

Enable legacy integration  <unchecked> 

Replace default arguments  <unchecked> 

    

   

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  61 

 

Step 6: Link CSBs to Projects / Groups 

 

Link CSBs to Projects   

In the ProjectWise Explorer, locate the project directory. (For example:  pw:\\<server name>:<datasource name> \AECOsim Building Designer Ss4\Managed Workspace\Projects\BuildingExamples\BuildingTemplate_US\), right‐click, and get the properties of this folder. Select the Workspace Tab. 

  

Associate the Predefined Workspace with Predefined CSB called "ABD_Workspace_Ss4". 

*(Optional) ‐Associate the Global Workspace with the Global CSB called “Global_Variables”.  Associate the Project Workspace with the appropriate Project CSB. 

For example: the Project CSB called "BuildingTemplate_US"  

*   Note: Since the Global_Variable  CSB contains _USTN_DISPLAYALLCFGVAR, which is often considered an administrative configuration, this CSB could be added to the Administrative User Group instead of the 

Project. This would make it applicable to only administrative users. See ‘Link CSBs to Groups’  below.   

 The result should be similar to the image below. (with/without Global_Variables or Personal Workspace)  

        

AEC

 

 

    

 

COsim Buildin

PedwreTo

  

 Link CSB ProjectWi_USTN_Dto the Adusers. To following  

1

23

Th 

ng Designer V

Copyrig

ersonal workefault, you m

workspace, oneview the conool>Options, 

Note: Tyour Pe

Bs to Groups

ise CSB can bISPLAYALLCFGministrative Uimplement thsteps in the P

.  In ProjectAdministra

. Select the 

. Associate t 

he result sho

V8i Deployme

ht © 2012 Be

space settingmay not have Pnce somethingntents of yourselect the Pe

The option to hersonal Worksp

e linked to GGVAR, which User Group inhis option, beProjectWise u

Wise Adminisator PropertieManage Worthe Global W

uld be similar

 

nt Guide  P

entley System

gs allow user‐Personal worg is defined inr personal woersonal Works

hide the compapace. 

roups. For exis often consnstead of the e sure NOT touser group. 

strator, undees. rkspace tab 

Workspace wit

r to the image

ProjectWise 

ms, Incorporat

specific workkspace assocn the personaorkspace CSB,space tab. 

atibility warnin

ample, since sidered an adProject. This  link the Glob

r Groups, sele

h the Global 

e below. 

Managed W

ted| AECOsim

kspace configciated if thereal workspace , in ProjectW

ng when buildin

the Global_Vministrative cwould make bal_Variable  

ect the Admin

CSB called “G

Workspace 

m Building Des

uration for me is nothing deit is automat

Wise Explorer f

ng applications

Variable CSB cconfigurationit applicable CSB to the pr

nistrator grou

Global_Variab

 

signer Techno

managed workefined in youically associafile menu sele

s are initiated 

contains n, this CSB couto only admiroject and co

up, right‐click

bles” 

ote  62 

kspaces. By r personal ted. (To ect 

is stored in 

uld be added inistrative mplete the 

k and get the 

AEC

 

 

Step

 To teBuildWork Set temptdocuthe a 

 DoubProgr  

 

COsim Buildin

p 7: Test/V

est or ValidatedingTemplatekspace\Projec

he file to be aty.dgn file in ument dialog, association. 

ble click on thress dialog, in

Note: To from the consult th

ng Designer V

Copyrig

Validate (T

e your Integra_US (pw:\\<scts\BuildingEx

associated to ProjectWise Eselect AECOs

 

he empty.dgnndicating the 

make furtherProjectWise Ehe ProjectWis

V8i Deployme

ht © 2012 Be

Troublesho

ation, in the Pserver name>xamples\Buil

the AECOsimExplorer, thensim Building D

 file to open initial worksp

r use of SampExplorer Cliense help docum

 

nt Guide  P

entley System

oot) 

ProjectWise E:<datasourceldingTemplate

m Building Desn selecting thDesigner from

it. If it is proppace downloa

ple Project Dant to reconnementation for

ProjectWise 

ms, Incorporat

Explorer, locae name\AECOe_US\empty.

signer applicahe Modify optm the drop do

perly configurad. 

ta, you will nect and resolvr more inform

Managed W

ted| AECOsim

ate the deliveOsim Building dgn).  

ation.  This cation from theown list unde

red, you shou

eed to run Tove al the projemation. 

Workspace 

m Building Des

red file emptDesigner Ss4

an be achievee right‐click mr “Application

 

uld see the Ma

ools>Scan Refect reference

signer Techno

ty.dgn in the p\Managed 

ed by selectinmenu. In the Mn:” Select OK

anage Works

ferences ands and linksets

ote  63 

project 

g the Modify to complete 

space Export 

Linksets… s. Please 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  64 

 

Manage Workspace Export Progress Dialog, which shows successful completion of 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, which can take 5 minutes or more the first time, depending on your connection speed and size of your workspace and dataset. Please be patient, subsequent loads will have much faster load times. In many cases you will experience performance better than that of loading the same design file from a typical LAN server or shared network drive.  From within the AECOsim Building application, you can verify you are successfully using a ProjectWise Manage Workspace by selecting Workspace>About Workspace from the File menu. You should be presented with a ProjectWise Manage Workspace Dialog, similar to what is displayed below.  

           

AEC

 

 

Trou

  

COsim Buildin

ubleshoot

 If you are different   

  This dialoProjectWiProjectWisame proj

Vin

VAthth

Innm

ng Designer V

Copyrig

ing 

presented win the manag

 

g is common ise desktop Inise). Howeveject. If it does

erify that thenherited from

erify that thepplication asshe same applhe application

nspect your coeed to be add

mcm.cfg file. 

V8i Deployme

ht © 2012 Be

with the followged configurat

and is to be entegration (lar, this dialog ds occur: 

e files containm the Project F

ere are no Prosociated to thication associn definition. 

onfiguration fd the exclusio

 

nt Guide  P

entley System

wing messagetion that requ

expected if yoaunching AECOdoes not typi

 the same ProFolder. ojectWise Mahe documentiation as the 

files, any conon list defined

ProjectWise 

ms, Incorporat

e to restart youires a chang

ou are openinOsim Buildingcally appear 

ojectWise ma

nage Worksp. This alert woriginal file o

figuration vad by PW_MW

Managed W

ted| AECOsim

our MicroState in your man

ng files from ag Designer froif you are ope

anage Worksp

pace CSB assigill appear if yopened and th

riable definedWP_COMPARIS

Workspace 

m Building Des

tion Session, tnage workspa

 

another projeom the desktening differen

pace assignm

gnments on tou switch to he application

d to equal _DSON_IGNORE

signer Techno

then there is ace.   

ect or if you aop and connent files from w

ments. They sh

the ProjectWia file that don has a CSB as

DGNDIR or  _DE_LIST  in the 

ote  65 

something 

are using ecting to within the 

hould all be 

ise es not share ssigned to 

DGNFILE will ProjectWise 

AEC

 

 

 Add

 

 

 

COsim Buildin

dendum: S

Creating (T

   1

2.

ng Designer V

Copyrig

Step by Ste

a new ‘PredThis CSB will m

. In ProjectWover the ‘P

   

  

. In the New

ABD Work

ABD_Work

 

V8i Deployme

ht © 2012 Be

ep Guide t

defined’ Levmake the vita

Wise AdminisPredefined’ Le

 

w Configuratio

kspace (SELEC

kspace_Ss4 P

 

 

nt Guide  P

entley System

o create P

vel CSB calleal connection 

strator , undeevel and sele

on Block Prop

CTseries 4). On

roperties. 

ProjectWise 

ms, Incorporat

Predefined

d " ABD_Wobetween the

r Workspace ct New> Conf

perties, enter 

nce complete

Managed W

ted| AECOsim

 CSBs 

orkspace_Sse CSBs and the

Profiles>Manfiguration Blo

r the name AB

e, click Apply. 

Workspace 

m Building Des

s4 “ ‐ This is e ProjectWise

naged>Predefock 

BD_Workspac

The dialog tit

 

signer Techno

a critical tase datasource

fined, right m

 

ce_SS4 and d

tle will chang

ote  66 

sk .) 

mouse click 

escription 

ge to 

AEC

 

 

 

COsim Buildin

3

4

ng Designer V

Copyrig

. Switch to t 

. Click the p

V8i Deployme

ht © 2012 Be

the Configura

  

plus icon and t 

 

nt Guide  P

entley System

ation tab at th

to select Add 

ProjectWise 

ms, Incorporat

he top of the 

d Variable to c

 

Managed W

ted| AECOsim

dialog. 

create a new 

Workspace 

m Building Des

 

variable. 

 

signer Technoote  67 

AEC

 

 

 

 

COsim Buildin

5

ng Designer V

Copyrig

. In the new 

 

Click th 

V8i Deployme

ht © 2012 Be

w variable dial

Name 

Description 

Locked 

 

he Add butto

Oper

Value

 

 

nt Guide  P

entley System

log box popu

_TF_WO

ABD PW

YES 

n to enter th

ation Type 

e Type 

ProjectWise 

ms, Incorporat

late the follow

ORKSPACERO

W Workspace

e following va

'='‐ Assign

Change 'StValue:  Chabrowse to DocumentWorkspac 

Managed W

ted| AECOsim

wing fields:

OOT 

e (_TF_WORKS

alues: 

ment 

tring' to 'Projeange value to pw:\\<servets\AECOsim Bce\ 

 

Workspace 

m Building Des

SPACEROOT)

ectWise Foldo point to Proer name>:<daBuilding Desig

signer Techno

  

 

er' ojectWise Woatasource namgner Ss4\Ma

ote  68 

orkspace, me>\ anaged 

AECOsim Building Designer V8i Deployment Guide  ProjectWise Managed Workspace 

 

Copyright © 2012 Bentley Systems, Incorporated| AECOsim Building Designer Technote  69 

 

Click OK to close the Edit Value dialog, returning to the <New variable> dialog.  

    

Click OK to accept the variable definition. The results of the WorkspaceRoot properties CSB should be as follows:  

 

  

6. Click  Apply to accept the variable definition 

 

   

AEC

 

 

 

 

COsim Buildin

7

ng Designer V

Copyrig

. Click  the p

. In the new 

V8i Deployme

ht © 2012 Be

plus icon and 

 

 

w variable dial

Name 

Description

Locked 

 

 

nt Guide  P

entley System

add another 

log box popu

_USTN_

n  ABD PW

YES 

ProjectWise 

ms, Incorporat

variable to th

late the follow

_SITE 

W Standards (_

Managed W

ted| AECOsim

he ABD Work

wing fields: 

_USTN_SITE)

Workspace 

m Building Des

kspaceRoot CS

 

 

signer Techno

SB 

 

ote  70 

AEC

 

 

 

 

COsim Buildin

9

ng Designer V

Copyrig

Click th

. Click OK to

V8i Deployme

ht © 2012 Be

he Add butto

Operation T

Value Type

Value 

 

o close the Ed 

  

nt Guide  P

entley System

n to enter th

Type  '='‐

  Str

$(_

dit Value dialo

ProjectWise 

ms, Incorporat

e following va

‐ Assignment

ring 

_TF_WORKSP

og, returning 

Managed W

ted| AECOsim

alues: 

PACEROOT )st

 

to the <New 

Workspace 

m Building Des

tandards/ 

variable> dia

signer Techno

alog. 

 

ote  71 

AEC

 

 

 

COsim Buildin

10

1

ng Designer V

Copyrig

0. Click OK, to

be as follo

1. Click the p

V8i Deployme

ht © 2012 Be

o accept the v

ws: 

plus icon but t

 

 

nt Guide  P

entley System

variable defin

this time, sele

ProjectWise 

ms, Incorporat

nition. The re

ect Add Direct

Managed W

ted| AECOsim

esults of the W

tive 

Workspace 

m Building Des

WorkspaceRo

 

 

signer Techno

ot properties

ote  72 

s CSB should 

AEC

 

 

 

  

 

COsim Buildin

12

   

ng Designer V

Copyrig

2. In the Mod 

 Click th

V8i Deployme

ht © 2012 Be

dify Directive 

Directiv

Descrip

he Add butto

Value typ

Value 

 

 

 

nt Guide  P

entley System

dialog box, p

ve  %i

ption  AB

n and enter t

pe  Config

ABD_

ProjectWise 

ms, Incorporat

populate the f

nclude 

BD Electrical S

the following 

guration Sett

_Electrical_Ss4

Managed W

ted| AECOsim

following fiel

Ss4 

values: 

ting Block 

4: ABD Electr

 

Workspace 

m Building Des

ds: 

ical (SELECTs

signer Techno

 

eries 4) 

ote  73 

AEC

 

 

 

END 

COsim Buildin

13

14

15

– Step by Ste

ng Designer V

Copyrig

3. Click OK to

4. Click OK to

as follows:

5. Click Applysuccessful

ep Guide to cr

V8i Deployme

ht © 2012 Be

o close the Ed

 o accept the d

y to accept thly completed 

reate Predefi

nt Guide  P

entley System

dit Value dialo

directive defin

he variable de creating a Pr

ined CSBs. 

ProjectWise 

ms, Incorporat

og, returning 

nition. The re

efinition and tredefined CSB

Managed W

ted| AECOsim

to the <New 

esults of the a

then OK to cloB. 

Workspace 

m Building Des

variable> dia

adding the dir

 

ose the dialog

signer Techno

alog. 

 

rect to the CS

g. At any poin

ote  74 

SB should be 

nt you have