You are currently reviewing an older revision of this page.
Document Type: TechNote Product(s): GEOPAK, MicroStation Version(s): v08.11.07.494 Creating Associations to GEOPAK and InRoads in ProjectWise Overview Accessing GEOPAK and/or InRoads products via ProjectWise in the SELECTseries 2 refresh requires associating the appropriate civil product with the program that is initiated by opening a DGN file. This is due to the change in the startup of both InRoads and GEOPAK via product specific Icons. Although the configuration files for both products still reside in the MS config\appl folder, the products don’t start unless a specific variable is defined. This variable is passed via the product icons. This change was made to alleviate the integration problem of the civil products with other Bentley products when multiple products are installed. By default the Civil configurations are only defined and initiated if the Civil products are started via the new icons. The same action can be accomplished by setting an environment variable or passing a command line argument at startup. This change in the startup of GEOPAK and InRoads, also allows the user to decide when they want to use a GEOPAK or Inroads license. How This Is Configured The initial configuration files for both InRoads and GEOPAK begins with an ‘if’ statement that looks to see if a variable is defined. If that variable is defined then the rest of the configuration file is read. If not, the file is exited and MicroStation proceeds to the next configuration file in the appl folder. The new icons define these variables from the configuration file: InRoads’ products - %if defined (Load_InRoads_SS2) GEOPAK products - %if defined (Load_GEOPAK_SS2) Target entry in icons: "C:\Program Files (x86)\Bentley\InRoads Group V8.11\bin\InrSuite.exe" -wsLoad_InRoads_SS2=1 "C:\Program Files (x86)\Bentley\MicroStation V8i (SELECTseries)\MicroStation\ustation.exe" -wsLoad_GEOPAK_SS2=1 Configuring ProjectWise to Define These Variables This can be accomplished multiple ways but there are two recommended methods as described below: 1. Passing a command line argument to the application initiated when a design file is opened, this can be done by a user. For GEOPAK this would be added to the Microstation application program association. For InRoads it would be added to the InRoads application. 2. Updating the program associations in ProjectWise for the civil products. Default program associations for the datasource are set by an administrator, in ProjectWise Administrator. To Add a Command Line Argument to a Program in ProjectWise 1. Start ProjectWise 2. Select the appropriate datasource 2 3. Open the Program Associations dialog (Tools > Associations > Programs). 4. Set the association view to User associations. 5. In the Applications list, expand an application. 6. Expand the action (Open, Viewer, or Markup) containing the program you want to configure. 7. If the action does not yet have a program associated to it, add the appropriate command line argument. a. For GEOPAK the command line argument is: -wsLoad_GEOPAK_SS2=1 and is applied to the MicroStation Open command line argument since GEOPAK does not have a startup executable defined in the currently released version of ProjectWise. 3 b. For the InRoads’ products the command line argument is: -wsLoad_InRoads_SS2=1 This would be added as a command line argument for all InRoads’ startup applications. 8. Expand the program so that the options Command Line Arguments, Enable Legacy Integration, and Replace Default Arguments display. 9. Double-click Command Line Arguments or right-click Command Line Arguments and choose Modify Command Line Arguments then specify the appropriate argument that will be used to start the program. 10. Click OK to save changes and close the Program Associations dialog. To Update Program Associations Via ProjectWise Administrator for All Users 1. Copy the file CivilApps appinfo.xml to the machine where the ProjectWiser server is installed. 2. Open a command window and navigate to the "...\ProjectWise\bin" directory. 3. Enter the command: dmsconv.exe -d ODBCDataSourceName -u DatabaseUserName.Password -appfile "PathToThisFile" (This operation should be done by ProjectWise administrator). 4. When prompted to update MIME type select no. MIME type update is not necessary for this update. Once this process is completed, the program association should now have a GEOPAK association listed and the InRoads program associations should be updated to include a command line argument. 4 To revert to previous startup behaviors If it is desired in your environment to always start the Civil products when MicroStation is activated, as it previously functioned, there are 3 ways to achieve this functionality. Options: Remove if statement from configuration file. Remove lines: o GEOPAK %if defined (Load_GEOPAK_SS2) %endif o InRoads %if defined (Load_GEOPAK_SS2) %endif Set Operating System environment variable so the required variable is always defined. Define the variable in a custom workspace.
Document Type: TechNote
Product(s): GEOPAK, MicroStation
Version(s): v08.11.07.494
Creating Associations to GEOPAK and InRoads in ProjectWise
Overview
Accessing GEOPAK and/or InRoads products via ProjectWise in the SELECTseries 2 refresh requires associating the appropriate civil product with the program that is initiated by opening a DGN file. This is due to the change in the startup of both InRoads and GEOPAK via product specific Icons. Although the configuration files for both products still reside in the MS config\appl folder, the products don’t start unless a specific variable is defined. This variable is passed via the product icons. This change was made to alleviate the integration problem of the civil products with other Bentley products when multiple products are installed. By default the Civil configurations are only defined and initiated if the Civil products are started via the new icons. The same action can be accomplished by setting an environment variable or passing a command line argument at startup. This change in the startup of GEOPAK and InRoads, also allows the user to decide when they want to use a GEOPAK or Inroads license.
How This Is Configured
The initial configuration files for both InRoads and GEOPAK begins with an ‘if’ statement that looks to see if a variable is defined. If that variable is defined then the rest of the configuration file is read. If not, the file is exited and MicroStation proceeds to the next configuration file in the appl folder.
The new icons define these variables from the configuration file:
InRoads’ products - %if defined (Load_InRoads_SS2)
GEOPAK products - %if defined (Load_GEOPAK_SS2)
Target entry in icons:
"C:\Program Files (x86)\Bentley\InRoads Group V8.11\bin\InrSuite.exe" -wsLoad_InRoads_SS2=1
"C:\Program Files (x86)\Bentley\MicroStation V8i (SELECTseries)\MicroStation\ustation.exe" -wsLoad_GEOPAK_SS2=1
Configuring ProjectWise to Define These Variables
This can be accomplished multiple ways but there are two recommended methods as described below:
1. Passing a command line argument to the application initiated when a design file is opened, this can be done by a user. For GEOPAK this would be added to the Microstation application program association. For InRoads it would be added to the InRoads application.
2. Updating the program associations in ProjectWise for the civil products. Default program associations for the datasource are set by an administrator, in ProjectWise Administrator.
To Add a Command Line Argument to a Program in ProjectWise
1. Start ProjectWise
2. Select the appropriate datasource
2
3. Open the Program Associations dialog (Tools > Associations > Programs).
4. Set the association view to User associations.
5. In the Applications list, expand an application.
6. Expand the action (Open, Viewer, or Markup) containing the program you want to configure.
7. If the action does not yet have a program associated to it, add the appropriate command line argument.
a. For GEOPAK the command line argument is: -wsLoad_GEOPAK_SS2=1 and is applied to the MicroStation Open command line argument since GEOPAK does not have a startup executable defined in the currently released version of ProjectWise.
3
b. For the InRoads’ products the command line argument is: -wsLoad_InRoads_SS2=1
This would be added as a command line argument for all InRoads’ startup applications.
8. Expand the program so that the options Command Line Arguments, Enable Legacy Integration, and Replace Default Arguments display.
9. Double-click Command Line Arguments or right-click Command Line Arguments and choose Modify Command Line Arguments then specify the appropriate argument that will be used to start the program.
10. Click OK to save changes and close the Program Associations dialog.
To Update Program Associations Via ProjectWise Administrator for All Users
1. Copy the file CivilApps appinfo.xml to the machine where the ProjectWiser server is installed.
2. Open a command window and navigate to the "...\ProjectWise\bin" directory.
3. Enter the command:
dmsconv.exe -d ODBCDataSourceName -u DatabaseUserName.Password -appfile "PathToThisFile"
(This operation should be done by ProjectWise administrator).
4. When prompted to update MIME type select no. MIME type update is not necessary for this update.
Once this process is completed, the program association should now have a GEOPAK association listed and the InRoads program associations should be updated to include a command line argument. 4
To revert to previous startup behaviors
If it is desired in your environment to always start the Civil products when MicroStation is activated, as it previously functioned, there are 3 ways to achieve this functionality.
Options:
Remove if statement from configuration file. Remove lines:
o
GEOPAK
%if defined (Load_GEOPAK_SS2)
%endif
InRoads
Set Operating System environment variable so the required variable is always defined.
Define the variable in a custom workspace.