Upgrade Custom Environment

If your company is using a custom fitted environment, adopt it in Vertex BD 2020 (26.0) version and upgrade the software version changes to it as instructed below.

Adopt the Custom Fitted Environment

  1. Install the BD 2020 (26.0) standard version according to instructions.
     
  2. Copy the customer fitted "custom" and "shared" folders from the BD 2019 (25.0) version over the BD 2020 (26.0) standard version.

    Note: Copy over the folder to get the new files included in the "custom" folder of the standard version in use.

    • Make a copy of the template project folders included in the ../shared/template/projects folder of the BD 2020 (26.0) standard version (copy to C:/temp folder, for example).
    • Copy the "custom" and "shared" folders from the previous version to the BD 2020 (26.0) version.
      Select "Replace original files", when the operating system asks you to.
    • Delete or rename the template project copied from the previous version: for example ../shared/template/projects/TEMPL-BASIC to TEMPL-BASIC_old (if there was one). Rename, if you wish to keep a project or parts of it!
    • Move the template project folders from the C:/temp folder to the \shared\template\projects folder of the BD 2020 (26.0) version.
    • If you know that the ../user/SETUP file has custom fitted settings, copy them from the ../user/SETUP file of the previous version to the ../user/SETUP file of the BD 2020 (26.0) version, if there are any.
      Note: Just copy the settings from one file to the other, do not replace the user\setup file in the new version with the one from the old version.
  3. Enable the system administration functions by setting the keyword in the ../user/SETUP file:
    set.system.menu= 1
  4. Start Vertex BD.
  5. The custom update function starts automatically.
  6. Select the latest version you have used from the Previous update list. If the last version you updated was 2019 (25.0), it is selected by default in the list.
  7. Confirm by clicking OK. Analysis of the Custom folder takes a while. Finally, you will see a list of the conducted measures.
  8. Open your own template projects (if you have any) in the BD 2020 (26.0) version and save them to change the version of the projects.
  9. Test the BD 2020 (26.0) version before the deployment and notify the BD helpdesk of the possible faults.

If you are using a version older than the BD 2013 (19.0), please contact the support service to ensure that the environment can be copied directly to the BD 2020 (26.0) environment.

Update Custom Files

Update software version changes to custom fitted files by using the custom update function. The function starts automatically when you have followed the steps described above and started the program.

If necessary, you can also start the function by selecting System | Update Custom.

 

Files to be Updated

The system update function performs the following operations.


Building Component Libraries

The update function adds the following fields to the databases of customer-specific building component libraries (or macro component libraries):

  • ITEM_CODE - Item. This field allows you to enter an external system code that will be included in the material collection.
  • IFC_PROP - IFC Property Set



Eaves trim library

The update function adds the ORDER field to the custom/complibs/eave_trim/d_EAVE_TRIM database.



Roof accessories

Improvements have been made to the positioning of the lead-ins in the roof accessories library on the roof slopes. If you use the standard library, no action is required.

If the roof_accessories library is located in the custom folder, the update function adds the INPUT_FUNC field to the custom/complibs/roof_accessories/d_ROOF_ACCESSORIES database. You can enter the name of the ADT program that is run when the component is added as the field value. The basic software delivery includes two different programs:

  • XDirOppSlope.prg
  • YDirOppSlope.prg

The programs turn the component's local x- or y-direction perpendicular to the roof slope.

The format file connected with the database has also changed. The old format file was named as macrolib_brw. The new format file is roofacc_brw. It is located in the system/forms folder. Change the name of the format file in the custom/complibs/roof_accessories/complibs.xml file.

Open the file in Notepad++, for example.

Find the row:

<ScreenForm>macrolib_brw</ScreenForm>

Change the name of the format file:

<ScreenForm>roofacc_brw</ScreenForm>



Floor or ceiling sheathing tool library

The update function adds fields for defining an offset for the sheathing origin to the database of the customer-specific floor and ceiling sheathing tool library (for example custom/complibs/frmtool_gen_sheet_cst/d_FRMTOOL_GEN_SHEET):

  • OFFSETX - Offset X
  • OFFSETY - Offset Y



Cladding library

The update function adds a field for defining the number of overlapping board courses when automatic cut of siding boards is enabled to the database of the customer-specific cladding library (for example custom/complibs/cladding_cst/d_FRMTOOL_CLADDING):

  • CUTROWQTY - Overlapping rows



Panel template drawings

The update function adds a new layer “179 Bracing” to the customer-specific panel template drawings.



Insulation library

The update function adds the following fields to the custom/dbases/d_INSULATIONLIB database:

  • INJECTED - Injected
  • VOLUME_WEIGHT - Weight/Volume
  • ITEM_CODE - Item. This field allows you to enter an external system code that will be included in the material collection.



Contact person library

The update function adds the field COMPANY to the custom/dbases/d_ADDRESS_BOOK database.



Framing area assembly library

The update function adds the field INT_PCE_DET (Details) to the custom/dbases/d_FRMASSY database. The value in the field is read for the parameter Joist Detail in the framing tool.



Sheathing library

The update function adds field ITEM_CODE (Item) to the custom/dbases/d_SHEETLIB database. This field allows you to enter an external system code that will be included in the material collection.



Settling and installation spaces for a slanting opening in a log wall

The update function checks, if the application development program LOGW_OPEXT.PRG has been customer-fitted. The application development program calculates the installation spaces for openings in a log wall. Two new parameters can be used in calculation for calculating the settling and installation spaces for slanted openings. If the program has been customer-fitted, the parameters must be added manually to the file.

If parameters are not defined, the installation spaces are calculated as before.

The new parameters are:

  • SETTLING - Vertical settling space at the top edge.
  • ANGLE - The parameter defines how the slanted edges are handled.

The possible customer-fitted program is located in the custom/macros/logmach folder. Submit the file LOGW_OPEXT.PRG to Vertex BD Helpdesk (bdhelp@vertex.fi) for adding parameters.



Please note:

If the format files connected to the databases are customer-specific, you must also add the fields to these format files, or you can start using the format files in system folder (system/forms). The files in the system folder will be used when you rename the files in the custom/forms folder.