Using additional tools

Terra Office add-in for ArcGIS Pro provides additional functionality through the Tools button on the toolbar. Functionality pertains to both TerraFlex Workflows and Legacy Workflows (e.g., TerraSync).

TerraFlex workflows

  • To add ArcGIS schema to one or more layers in the current map:

    1. Click the Add ArcGIS fields to use for TerraFlex auto field values… link. This will open an ArcGIS Pro Geoprocessing tool window with the Add Fields For TerraFlex tool selected (from the Terra Office toolbox that is installed with the add-in).

    2. Select the Input Features layers and the Auto Field Set to use for each layer—either the currently configured (default) set or the full set.

    3. Click Run to add the selected auto field set to the selected layers. If any fields currently exist, they will be skipped. If you want to make changes to what that default set includes, or what field names are used, you should make those changes first (see next bullet).

      4. You do not have to use this tool to add ArcGIS schema for auto field values and can instead create them using any ArcGIS tool or process. Terra Office just needs to know what field name to use for each auto field type (and the data type must match—double for accuracies/DOPs/height, datetime for created/updated, long for auto increment (numeric), and string for everything else).

  • To make changes to any auto field defaults:

    1. Click the Open the TerraFlex auto field configuration file… link. This will open the settings file (AutoFieldConfiguration.txt) in the default text editor. The file is stored in the path C:\ProgramData\Trimble\TerraOfficeArcGISProAddIn and can also be opened directly from there. The file is simple (comma separated values) and has one row for each supported auto field type along with 2 header rows.

    2. To change whether or not a particular auto field is included in your standard set, use the first column (1 to include it, 0 to not include it). To change the ArcGIS field name or attribute used for a particular auto field, use the third and fourth columns. To change the default start values for the two auto-increment auto fields, use the fifth column. Do not change the value of the second column as this defines the underlying TerraFlex auto field type.

    3. After making changes, save the file.

  • To view the Local Project processing queue for all projects, click the Show GNSS data sessions for all projects… link. This will open the processing queue window where data for all projects on the local machine will be shown.

    1. Review the list of sessions that have been queued or processed. The list of projects shows the project, user/device, session start time and end time, when processing is expected (for those queued), the number of forms, the source of the session (e.g., the TerraFlex Forms file name), the status, and whether or not the GIS features have been updated following processing.

    2. Click the column headers as necessary to sort the list of sessions.

    3. To refresh the list (i.e., to see the latest processing status), click Refresh in the upper right corner of the window.

    4. To view processing details about a GNSS data session in the queue, either double-click the row or select the row and click Details. In the details window, for files that have one or more sessions processed, additional Details… links will be available; these can be used to view the detailed processing results (e.g., base station used and number of positions in each accuracy range).

    5. To remove the selected session from the queue (e.g., after it is corrected and the GIS features have been updated), click Remove. This does not affect the features that were created or updated from the session.

    6. Click Close when done.

Legacy workflows

  • To import a TerraSync data (SSF) or data dictionary (DDF) file, click the Import SSF/DDF to a file geodatabase… link. This will open a dialog box with several entries.

    1. Specify the source SSF/DDF file by clicking the … button next to the SSF/DDF file: entry box.

    2. Specify the target (empty) file geodatabase by clicking the … button next to the File geodatabase: entry box.

    3. Specify the horizontal and vertical coordinate system for the (new) feature classes to be created by clicking the … button next to the Geodatabase coordinate system (horizontal + vertical): entry box.

    4. To import features in addition to schema, select the Import features box.

    5. Specify the horizontal coordinate system used in the SSF feature geometries by selecting a value from the SSF geometry coordinate system (horizontal GCS only; vertical always HAE): drop down.

      If you specified a coordinate system based on a local datum in the Geodatabase coordinate system entry box above, you will generally have the choice here of that datum in addition to WGS 1984 (with some dependence on the extent of the data in the SSF). You will also have the option of changing the transformations used (both horizontal and vertical if setting an orthometric height).