1. Introduction
The Manual Data File Upload page lets you batch-import instrument configuration, calibration, revision and measurement data using standardized Excel/CSV templates. It ensures data consistency and gives you full visibility into each upload’s progress and results.
2. Prerequisites
A GeoSens account with Data-Entry access.
The correct template(s) downloaded locally for your instrument type and data category.
Completed template files populated with your data.
3. Navigation
Sign in to GeoSens.
In the left-hand menu, expand Instrument → click Data Entry.
The Manual Data File Upload panel loads on the right.
4. Page Layout & Controls
Control | Description |
Instrument Type | Dropdown/search: pick the instrument you’re uploading for (e.g. “In-Place Inclinometer (LS-IPI)”). |
Data Input Form | List of available upload templates, grouped by category (INIT, REV, CALI, DATA, ALARM). See Section 5. |
Data Input Form Template | Displays the exact filename of the selected template (for confirmation). |
Data Files (button) | Opens a file picker to select one or more completed template files for upload. |
Upload (button) | Submits the selected file(s) for processing. |
Uploaded Files (tab) | Shows all files you’ve just uploaded with basic metadata. |
Jobs Status (tab) | Displays each processing job spawned by your uploads, with start/end times, statuses, counts and error reports. |
5. Data Input Form Categories
5.1 Forms introduction
When you open Data Input Form, templates are organized by the stage of the instrument-data lifecycle:
Category | Purpose & Typical Templates |
INIT • Create NEW … (INIT) | Initial setup of a new instrument or alarm limits upon install. |
REV • REVISION PROPERTY • REV. PARAMETERS / Carry-Over Values • Alarm Trigger Limits (INIT) | Revisions to existing instruments’ metadata or parameters. |
CALI • Baseline Data (CALI) | Calibration baseline or factory calibration constants. |
DATA • Raw Data (.csv/.xlsx) • DATA MASTER (allows blank rows or additional survey IDs) | Regular measurement imports (angles, displacements, pressures, etc.): |
5.2 How to choose
New instrument? → INIT
Metadata change only? → REVISION PROPERTY
Recalibration? → CALI
Upload readings? → DATA
Adjust alarm limits? → ALARM
NOTE: To create a new instrument on Geosens, INIT file must be uploaded first and processed successfully, before REV --> CALI (if applicable) --> DATA can be uploaded.
The uploading process must follow: INIT --> REV --> CALI (if applicable) --> DATA.
6. Step-by-Step: Uploading a Data File
Select Instrument Type
Click the Instrument Type field → type or scroll → click the desired instrument.
Select and Prepare a Data Input Form
Click the Data Input Form list → choose the appropriate template.
Click the Data Input Form Template link to download the template and fill in fields to prepare the file to be uploaded.
Choose Data Files
Click Data Files → in the dialog select the completed templates → click Open.
The selected filenames appear beside the button.
Upload
Click Upload.
Check the uploading and processing status
Please refer to Section 7 below.
NOTE: To create a new instrument on Geosens, INIT file must be uploaded first and processed successfully, before REV --> CALI (if applicable) --> DATA can be uploaded.
The uploading process must follow: INIT --> REV --> CALI (if applicable) --> DATA.
7. Uploaded Files Section
7.1 Check uploaded file history
Once you upload, files appear in Uploaded Files:
Column | Description |
Instrument Type | The instrument you selected (e.g. Survey Settlement Point (SSP)). |
Data Input | Template code (e.g. |
File Name | Original filename you uploaded. |
File Size | Size in KB/MB. |
Uploaded By | Username or “System Account” if auto-uploaded. |
Uploaded On | Date & time the file hit the server. |
7.2 Actions & Tips
Sort: Click any header to reorder (e.g. newest first).
Filter: Use the funnel icon under headers to show only your uploads or a specific instrument.
8. Jobs Status Section
8.1 Job status data grid introduction
Each file-uploading spawns one Data Acquisition Job. Switch to Jobs Status for real-time feedback:
Column | Description |
Job Type | The category (DATA, INIT, REV, CALI, ALARM). |
Job Name | Internal processor label (e.g. “LS-IPI LoadSensing CSV DATA Reader (Sisgeo)”). |
Data Input Form | The data input form category you selected. |
Started On | Timestamp when processing began. |
Completed On | Timestamp when processing finished (success or failure). |
Status | In Progress, Succeeded (green), or Failed (red). |
Processed Row Count | Number of rows successfully imported. |
File URL | Link to the parsed CSV of imported rows (useful for auditing). |
Ignored Instruments | List of any instrument IDs skipped (e.g. duplicates, mismatches). |
Ignored Raw Rows | Count/IDs of raw data rows dropped due to validation errors or nulls. |
Message | Any error message due to a failed data-uploading job will appear here. |
8.2 Toolbar Actions
Refresh: Reload the job list and refresh the processing status.
Re-Submit: For Failed jobs, select the row then click Re-Submit to redo the file-uploading for the exact same uploading setting (re-upload same data file under same instrument type, data input form, and processor)
Filters: Use funnel icons to isolate, e.g., Status = Failed or Started On date ranges.
8.3 Interpreting Results
Succeeded:
Confirm Processed Row Count matches your file’s rows.
Download the File URL to review exactly what was imported.
Failed:
Click the Failed row or File URL to retrieve an error report CSV.
Correct the flagged rows in your source template (e.g. data types, missing required fields).
Re-Submit the job.
9. Tips & Best Practices
Match Template & Form: Always ensure the Data Input Form Template shown matches your file before uploading.
Use Correct Categories: INIT for new instruments; REV for metadata edits; CALI for calibration; DATA for readings; ALARM for threshold changes.
Maintain Sequential Indexes: In your templates, keep column orders contiguous and identifiers consistent.
Leverage Filters: Save filters for “Uploaded By = me” or “Status = Failed” to speed up triage.
Archive Logs: Download and store successful job CSVs and error reports for auditing.
You’re now fully equipped to upload and monitor your instrument data files in GeoSens. For further assistance, consult the online help portal or contact your GeoSens administrator.