Excel Worksheet Import Configuration dialog for importing station data
This dialog appears when you do the following:
- Start the Trimble 4D Control Server UI with Windows administrator rights.
- From a station data dialog, such as the Station Information (GNSS) dialog, select the Import > Excel Worksheet command for importing station data. A Windows file importer dialog opens.
- Select and open an Excel file containing station data in data formats which Trimble 4D Control Server support.
Use the dialog to select a worksheet from the import file, to assign Excel column headers to Trimble 4D Control Server properties, and to start the import of station data.
Tip - Imported station data will be available throughout the Trimble 4D Control Server system, independently of the currently active system configuration.
Warning - If previously any Excel file was not closed correctly and has to be recovered, the import might not function at once. First make sure that Excel is working as designed to.
Requirements for a valid Excel worksheet for station data to be recognized and imported
- Station data must follow each other in rows.
- Stations have to be identified by a unique station code and a station name.
- Column headers may be arbitrary. As long as the content of a column matches a station property, the column headers are not important. In this case, one assigns the columns of the Excel worksheet to the properties.
- However, all columns with headers that are identical to station property names can be assigned to the respective properties in one step.
- The number of worksheet columns is arbitrary; the worksheet may contain more or less information than is needed for the station to be set up.
- The station information can be split up into several worksheets, which can be imported in arbitrary order. If a data file contains less information than is required, the missing data can be imported in a next step.
- Trimble 4D Control Server must support the data formats and value ranges of the station properties given in the Excel file. If for a property the data format or the value does not conform to the Trimble 4D Control Server rules, the cell validation results in an error. Its contents will not be imported. Errors (and warnings) are output in a log file (see below).
List of valid parameters and settings for station data to be imported from an Excel worksheet
Property
|
Global station list property
|
Required
|
Allowed values (in brackets: alternatively allowed spelling)
|
Station ID
|
Station ID
|
|
Numeric value: 0 ... 1023. If the station already exists in the global station list, this value must match the Station ID property of the station. If empty, an existing station ID will not be overwritten.
|
Station Name
|
Station name
|
* Yes
|
Alphanumeric characters. If the station already exists in the global station list, this property must match the Station name property of the station.
|
Station Code
|
Station code
|
* Yes
|
Alphanumeric characters. If the station already exists in the global station list, this property must match the Station code property of the station.
|
Tectonic Plate
|
Tectonic plate
|
|
The value must match an option available in the System Properties.
|
Position X
|
Position > X (Cartesian)
|
|
Numerical value in meters, with decimals. The decimal separator must be a valid Excel separator.
|
Position Y
|
Position > y (Cartesian)
|
|
As above.
|
Position Z
|
Position > Z (Cartesian)
|
|
As above.
|
Velocity X
|
Position >Velocity X
|
|
Numerical value in meters per year, with decimals. The decimal separator must be a valid Excel separator.
|
Velocity Y
|
Position > Velocity Y
|
|
As above.
|
Velocity Z
|
Position > Velocity Z
|
|
As above.
|
Reference Time
|
Reference time
|
|
Reference data in the format DD.MM.YYYY. Make sure the Excel cell is formated as Date numbers. Per defualt, the time is set to 00:00.
|
Antenna Calibration
|
Antenna calibration, one of the following:
- Individually calibrated
- Type calibrated
|
|
Contains one of the following strings (Not case-sensitive):
|
ANTEX Filename
|
ANTEX file name
|
|
Path and file name according to the following convention: <drive>:\<folder>\<antexfilename.atx>. The file must exist on a local folder.
|
Antenna Name
|
Antenna Information > Name
|
* Yes
|
The antenna name of a type calibrated antenna must match the respective entry in the antenna.xml file. If an antenna name is not listed there, the import for this station will fail.
|
Antenna Serial
|
Antenna Information > Serial number
|
|
Any string. This value is not validated during station data import.
|
Antenna Height
|
Antenna height [m]
|
|
Numerical value in meters. The decimal separator must be a valid Excel separator.
|
Receiver Name
|
Receiver Information > Name
|
|
The receiver name must match an entry in the receivers.xml file. If a receiver name is not listed there, but the manufacturer is, the IGS site log import feature will apply a standard receiver name.
|
Receiver Manufacturer
|
Receiver Information > Manufacturer
|
|
The name of the manufacturer must match an entry in the receivers.xml file. If a receiver manufacturer is not listed there, the manufacturer name and the receiver name properties will not be filled with values.
|
Receiver Firmware Version
|
Receiver Information > Firmware
|
|
Any string. This value is not validated during station data import. However, some special characters cannot be stored internally. Note - With an active connection to the receiver, Trimble 4D Control Server receives and stores the firmware version automatically.
|
Examples
Examples for supported data formats
- Position data in Cartesian coordinates
- Antenna names in Antex-Format
Examples for data format not supported
- Station code with more than 4 digits
- Position data in geographical longitude, latitude, height
- A name of a tectonic plate that is not listed in the System Properties
- Reference time could not be read as date/time
- Antenna calibration not set to either TYPE or INDIVIDUA
Selecting the worksheet to be imported
Use the Excel Worksheet selection field for selecting the matching worksheet, if an Excel file contains more than one worksheets. By default, the first worksheet of an Excel file is selected.
Assigning Worksheet columns to station properties
The Excel Worksheet Import Configuration dialog displays two tables.
- The left-side table contains the single Excel Worksheet Column column displaying the header names of all columns in the selected worksheet.
- The right-side table is a list of all settable station properties. When one first imports an Excel worksheet, the second column of that table, the Excel Column Assignment column, is empty. An asterisk marks those properties, which are required to be available in the import file.
For the importer to assign the data of the worksheet to the station properties, it must know which Excel worksheet columns match the station properties.
For assigning columns of the Excel worksheet to properties, do one of the following:
If you later re-import data from an Excel worksheet whose column headers match those already assigned to properties, the Excel Column Assignment column of the right table will automatically be pre-filled with the matching column header.
Starting the import of station data
For reading in the data of the selected worksheet and starting the assignment of worksheet columns to station properties, accept the dialog. The following happens:
- Your standard text editor opens with the <Excel file name>.import.Log file displayed. This log file resides in your <user name>/AppData/Roaming folder. This file contains output messages of the INFO, WARN(ing), and ERRO(r) types. Use this file for a first information source on how well the import has succeeded.
- One of the following happens:
- If for all imported stations only identical station information is found in the global station list, importing is skipped.
- In any other case, the Station Data Import dialog appears for the first differing or new station. Use it to add new stations or update existing ones.