Set Up window (External Tools)

Use this window to set up commands that enable operators to start external software programs without having to leave Sage Estimating.

Programs you set up appear in the External Tools List window that you open from the Advanced tab (Interface menu in classic view).

  1. Open the Set Up window.

    • On the ribbon, click the Advanced tab, and then from the Custom group, click Set Up.
    • In classic view, click File > External Tools.

  2. Type the name of the external software program in the Title box as you want it to appear in the External Tools list.

  3. Type the full file path to a .EXE, .BAT, .CMD or other external software file (including the file name) that you want to start when the program is selected from the External Tools list.

    Example: If you want to start Microsoft Excel, a typical path is C:\Program Files (x86)\Microsoft Office\Office14\Excel.exe.

    You can also browse to the file by clicking the browse button.

  4. If you want the command to send information to the external software program, type the information in the Arguments box.

    For example, if you start Microsoft Excel using the Command box (as described in the previous step), use the Arguments box to add the file path for a target file such as c:\data\account.xls.

    If desired, click the arrow key to the right of the Arguments box to select from a list of variables that you can use with your argument.

  5. Specify the working directory for the external software program by typing it directly in the Initial Directory box or by clicking the browse button.

    The working directory is the file path to the location where the external program sends or retrieves key operational information such as data or initialization files.

  6. Click [OK] to save your changes and close the window.

Items in this window

Item Notes
Menu Contents

Displays a list of the external programs as they appear on the External Tools list. You can change the order and appearance of external programs appearing on the list using the following buttons:

  • Up arrow moves the selected program up in the order of listed programs.
  • Down arrow moves the selected program down in the order of listed programs.
  • Plus sign adds a new program to the External Tools list.
  • Minus sign removes the selected program from the External Tools list.
Title Type the label of the external software program as you want it to appear in the External Tools list.
Command Type the file path to the .exe, .bat, .cmd, or other external software file that you want to start when the program is selected from the External Tools list. If desired, you can also browse to the software file by clicking the browse button.
Arguments

Type any additional command information ("arguments") that you want to provide to the external software program upon starting. For example, you can add the file path for a target file such as c:\data\account.xls.

You can specify more than one argument for a command. However, each argument must be separated by a space. If a single argument includes a space, enclose it in quotation marks (" ").

If desired, click the arrow key to the right of the Arguments box to select from a list of existing variables that you can use with your argument. The following variables are available:

Variable Syntax Description
Estimate database instance name $(EstimateDBInstanceName) The SQL connection string for the current estimate database. For example: Data Source=COMPUTER01\SAGE_ESTIMATING;Initial Catalog=MyEstimates.
Estimate database name $(EstimateDBName) Name of the estimate database.
Estimate name $(EstimateName) Name of the currently active estimate.
Estimate ID $(EstimateId) Identifier of the currently active estimate. Use this variable to query all estimate database rows belonging to the estimate.
Estimate global data source ID (EstimateGlobalId) The unique global identifier of the currently active estimate.
Initial Directory

Type the working directory for the external software program or click the browse button to browse for it.

[OK] Click to save your changes and close the External Tools window.
[Cancel] Click to close the External Tools window without saving your changes.
[Apply] Click to put your changes into effect. The External Tools window remains open.