This Client Server article is republished in its entirety from 2002 for reference purposes.
By Bentley Technical Support Group, Technical Support Analyst, Exton Corporate Office 30 May 2002
Moving your dataset and design files from MicroStation TriForma for MicroStation/J to MicroStation TriForma V8 is a relatively simple process. This article explains the relevant files and methods required. Your dataset includes parts, compound parts, components, frame settings, cells, seed files and border files. The design files are the model file and any references attached, the drawing extraction files (*.d, *.all and so on) and the drawing definition files (*.bxs) and group files (*.g**).
The library files (Parts, Compound Parts, Components and Frame Builder Settings) are now stored in XML file format. The old *.pa, *.co, *.cpa, and *.frs files are automatically upgraded the first time MicroStation TriForma V8 is started. They are found in the search paths defined by the config variables:
When starting up MicroStation TriForma or redirecting the above variables, or the TFDIR variable, an alert box will display asking to upgrade the dataset files. Clicking OK will begin the process of upgrading any library files found in the listed directory paths. The old style dataset library files will be moved to a backup directory. Make sure you do not have your library files or directories set to read only, since this will cause the old style files to not be moved and for MicroStation TriForma to continually try to upgrade your dataset.
Figure 1. Upgrade part files dialog.
Upgrade all your Compound Cells using the following method:
Choose Element > Cells. Choose File > Upgrade to V8. Choose the appropriate path and set Files: to *.bxc to filter out all but the Compound Cell libraries by typing in the Files field "*.bxc" and press Enter. Then all the *.bxc files in the selected directory will be displayed. Choose the Cell libraries to upgrade, click Add, choose Done. A list of files appears, along with a backup option, choose OK to continue. You will now see a dialog to set the conversion units. Choose OK. The default values are 304800 per foot for imperial and 1000 per mm for Metric (si). For example, if the dialog indicates 304800 per foot, that equates to 25400 pos(itional) units per inch (sub units). See Figure 2.
Figure 2. Upgrade .bxc files. Standard MicroStation cells can be upgraded in exactly the same way compound cells are, as shown above. Simply search for the *.cel file extension when upgrading to MicroStation V8.
Note: It is recommended that your design files and cell libraries maintain the same working units, but, if you do use cell libraries with different units, cells can be placed correctly with a True Scale setting. The cells will place at the proper size but have a scale factor applied.
Upgrade your seed files for both modeling and drawing extraction. If you don't, MicroStation TriForma will work correctly, but you'll be upgrading your models and extractions each time you open your work.
The keynote border files are the *.tab files used by the Attach Border Title tool in MicroStation TriForma for MicroStation/J. Borders attached to sheet files are found through the TMA_DATA variable. You should define this variable as described below.
Upgrade all Model files. This can be done from MicroStation Manager. Go to the File or Directory menu and choose either Upgrade Files to V8 or Upgrade to V8 respectively. Both essentially do the same thing, but, through File, you can choose files from different directories; through Directory, all DGNs in the current directory will be upgraded to MicroStation V8 format. Batch upgrading can also be done using Utilities > Batch Convert inside MicroStation. This tool will upgrade a selected list of files and place them in a specific directory.
Figure 3. Using Batch Convert in MicroStation V8. Note: It is recommended that your design files and cell libraries maintain the same working units, but, if you do use design files with different units, they can be referenced correctly with a true scale setting. The references will be inserted at the proper size but have a scale factor applied.
We recommend re-extracting all drawings to ensure a clean slate. We also recommend deleting any drawing extraction log files (*.log), and starting a new log file to help isolate any MicroStation V8 extraction problems. You may also wish to set logging to Append in DEM>Settings>Logging, so a running history is maintained. Drawing extraction files will be ignored if they are not upgraded to MicroStation V8 format. If you do not wish to re-extract, you can simply upgrade all drawing extraction files using the methods listed above.
Upgrade all Group files, using the method for batch upgrading inside MicroStation mentioned for model files above, but set the file name to *.g*; all group files will now be listed, and you can select and upgrade them all at once.
The *.bxs files, which contain the drawing definitions, are automatically upgraded when you first load the corresponding model file.
Preconversion setup involves changing some of the variables you might use during your conversion/upgrade. These changes are optional and are not necessary for the conversion to work; they will help streamline the process. They are as follows, with accompanying purpose:
MS_DGNOUT = $(TFDIR)dgn/v8/ # Used by Batch Convert for the Default Destination path
_USTN_OUT = $(TFDIR)dgn/v8/ # Used by Upgrade to V8 dialog for the backup path
TMA_DATA = $(TFDIR)keynote/data/ # Used by the Keynote tool Place Border
TFDIR_MACRO = $(MS_MACRO) # Used for TriForma's Dataset
The variable MS_DGNOUT is used by Batch Convert, found under the Utilities menu for the default destination path. The variable _USTN_OUT is used by the Upgrade Files to V8 dialog in MicroStation Manager for the backup path, and is found under File > Upgrade Files to V8 or Directory > Upgrade to V8 in the MicroStation Manager dialog. The variable TMA_DATA is used by the Keynote tool Place Border and should point to where the TAB files are found for your project, so all your border files can be found if they have been used to create any construction files in your MicroStation/J version of MicroStation TriForma. If your dataset directory does not include a Macro directory, you will need to add one. When switching your TFDIR variable Macro directory, in MicroStation/J, the TFDIR_MACRO variable was TFHOME based and not found under the delivered datasets; in MicroStation V8, it is now TFDIR based. Once you have organized your workspace, you are ready to begin upgrading your dataset and Model/Drawing files as described above.
Aside from the above changes to the MicroStation TriForma dataset and design files, other areas of MicroStation TriForma have also changed. In MicroStation TriForma V8, functionality has increased with the removal of the 63-level limitation, the use of models in drawing extractions and the increase in size of the Compound Cells. The new workspace configurations for MicroStation TriForma free administrators to use user- and project-specific configuration files without having to integrate with MicroStation TriForma's default configurations. All changes within MicroStation TriForma and MicroStation V8 are improvements that will benefit users in the design process. More information can be found on MicroStation TriForma V8 in the "What's New in MicroStation TriForma V8?" guide found under Bentley/Program/Triforma/TFV8_WhatsNew.pdf.
Client Server Archive
Building Product TechNotes And FAQs