Specifying the project name and databases

Specifying the project name and databases

On the Build menu, click System File Specification, or click the Buildplus gobutton.png button on the toolbar.

The System File Specification dialog allows you to:

  • specify the project name and databases to be included in the project in the initial build, or
  • change which databases are chosen for a rebuild,
  • add or change the 800xA graphics locations, and
  • identify the location of function code help files (.pdf) to be built in.

Before starting a build, you may need to extract a current database for your 800xA graphics, Symphony Plus graphics, or PPB graphics

At any time, contextual help can be obtained by clicking on the ? box in the top right corner of the dialog box, and then clicking on the object you are wondering about.

Naming the project

In the System File Specification dialog, enter a unique and meaningful name for your project (e.g. a few words that identify the function, location, plant or company). Note:maximum 220 characters including build root, and certain characters may not be allowed.

Database Specification.png

Choosing database types and 800xA graphics

In the System File Specification dialog, check the boxes that apply to database types (and 800xA graphics) in your project:

  • Composer systems – .EBP databases
  • Process Portal B / Operate IT / Conductor NT systems / 800xA – .MDB databases. Note: for 800xA VB, use a Harmony Tag Export MDB file (replacing the configserver.mdb). (See also instructions to extract an Operate IT Database for 800xA and for PPB)
  • .XML Databases – for some Process Portal B systems
  • WinCAD/WinTools systems – .PTT FoxPro databases
  • Generic tag and trend databases: .DBF, .TTG and .TTR in addition to OPC-90 .CSV, Citect Console Databases, .UCF files plus any other database types that you can export into .DBF format.
  • PI, generic - .XLS,.XLSX Excel Workbooks - This is limited to simple tabular spreadsheets, including OSISoft PI configuration documents.
  • 800xA .AFW Backup Folder (.AFW dir) - AFW full backup directories (generally containing a number of file names starting with 0_). This is used for extracting VB graphics and for getting more information for PG2 graphics, and should be built into all 800xA projects. Contact GMCL for more information and help with your specific systems. See also the instructions to extract 800xA graphics.
  • 800xA Files Folders (.PNG dir) - Directory by default named AssystSnapshot that contains .png graphics files in folder AssystSnapshot; it should exist alongside a corresponding AssystInfo folder containing encrypted .txt files.
  • 800xA Display Documentation (.XLS dir) - XLS files containing 800xA PG2 graphics information. See also instructions to extract PG2 graphics with the Documentation Tool.
  • Function Code Help Files (.pdf) can be built in by ensuring this box is checked.

If there are other database types you wish to build in, please contact GMCL.

More information is available:

Specifying where to search for your database, 800xA graphics and Function Code files

Entering paths to databases, 800xA graphics and function code help files

Note the databases, graphics and function code files do not have to be located on the same computer, or on the build computer, and DBDOC access is read-only. But if you don't have access to the computer that contains the source files, you will have to copy them to your local computer. In this case, leave the directory structure the same. Using UNC naming conventions may be helpful if you later move to a new computer.

  • Enter the folder name in which the file(s) reside, and BuildPlus will find the files, or you may include the name of the file.
  • Once a path has been entered, the drop-down arrow can be used to select the same location for other file types OR you can copy and paste from one box to another.

Browsing to choose paths

  • Clicking on Browse will bring up the Windows "Browse for Files or Folders" dialog, where a directory or file can be selected, or the folder path can be copied in.
  • You can select the directory in which the file(s) reside and BuildPlus will find the files, or you may include the name of the file.
  • This choice will be appended to the end of any search paths already entered.

Adding more than one path

  • More than one path will be searched if multiple paths are listed for each database type, separated with a "|" character
  • Multiple paths can be quickly added by clicking the Browse button and selecting additional paths.

You many also add the location of your function code pdf help files.

After specifying the locations of your files, click Next to have BuildPlus find your files.

Selecting specific databases and 800xA graphics locations

  • The left panel displays "databases to select from"; all databases of the specified type found by BuildPlus in the specified search paths. If you wish to change the search path to find additional databases, use the Back button.
  • The right panel displays "databases to be included in the build", including any database names entered previously (provided they were located in the search). If only one database was found during the search, it will be automatically moved into the final list.
  • Move a database from one list to another by selecting it from the initial list and clicking the enabled Add or Remove button as required. Using the CTRL or SHIFT key in combination with the mouse can make multiple database selections.
  • If a database has "Unimplemented Type" listed for the file size, BuildPlus has identified that it cannot process the file, and that file cannot be selected.
  • The Next/Finish button will be enabled when there is at least one database in the final list.
  • To proceed with the build without selecting any databases of a given type, use the checkbox Check here to continue without selecting any databases. You may also use the Back button to omit that type of database from the build.

Buildplus 7.png

  • Composer EBP databases are each shown with a checkbox in the final selection list. Unchecking the box means that databases extracted from that EBP file will not be used or included in your build. (All databases are of equal importance unless you choose to exclude the databases extracted from an .ebp file, giving more importance the graphics databases.) Generally, you would only uncheck the EBP database if it is unused, obsolete or in some other way invalid, and a better database can be built in (for example a graphics database).
  • Locations of Function Code .pdf files are listed for information, and BuildPlus will select the appropriate files. To change which locations of Function Code .pdf files are included, use the Back button to the System File Specification box, find your preferred file location and check the Redo box, then click Next to proceed.

System File(s) Chosen lists all your selections so far. If corrections need to be made, press the Back button to review the system file selection panels. Otherwise, press the Finish button to continue. After some database processing, the Configuration Wizard will appear.

See also