Core

Core Details

The Core definition is an abstract class, used to represent some field visit activity which has a comment.

4 Properties	Required	Description
Comment	N	Sets the comment on the activity.
MergeWithComment [[MergeWithComments]]	N	These properties will be merged with the main comment.
Disabled - v21.4.12+	N	When 'true' the activity will not be imported, even when other properties are set. See Disabled activities for more details.

Most configurations will only ever need to use the single [Comment] field, but the mergable fields are there if you have a special edge case.

The [MergeWithComment] and [[MergeWithComments]] properties can be useful to accumulate comment text from multiple fields.

Some survey-based forms will often use this pattern to create the final comment from many different text input fields.

This configuration:

Location = '@Location'
Time = '@Time'

[Reading]
Value = '@Value'
ParameterId = 'TA'
UnitId = 'degC'
Comment = '@Comment'

[[Reading.MergeWithComments]]
ColumnHeader = 'Maintenance Notes'

[[Reading.MergeWithComments]]
ColumnHeader = 'Observation Notes'

Will parse this CSV:

Location, Time, Value, Comment, Maintenance Notes, Observation Notes
LOC1, 2020-Apr-01 12:35, 18.7, Warm, Swapped the logger battery., "Had to retake this measurement, which was unexpected."
Loc2, 1988-May-05 11:18, 12.5, Cool, , Squirrels might be building a nest. Better key an eye on this.

Line 2 will create this reading comment:

Warm
Swapped the logger battery.
Had to retake this measurement, which was unexpected.

Line 3 will create this reading comment:

Cool
Squirrels might be building a nest. Better key an eye on this.