UG_Preferences_Data Fields - GoldenCheetah/GoldenCheetah GitHub Wiki

Preferences: Data Fields (Version 3.7)

Select: Menu Bar -> Tools -> Options... to get to the Options Popup.

The Data Fields preferences cover four different areas:

  • Fields - here you define the list of additional fields available to either store additional activity data and to add/overwrite activity data.
  • Colour Keywords - defines the rules, how your activities are colored in the calendar(s) and in the activities section of the Activities view.
  • Defaults - defines rules, how a field is filled in depending on the content in another field.
  • Processors & Automation - allows the configuration of the Fix/adjust/correct tools build into GoldenCheetah and Python Fix.

Fields

Preferences - Datafields - Fields

The data fields are structured by Screen Tabs which then appear on the Activities view in the Details and Summary and Details charts. Please do also read the description of the Data Chart.

  • Screen Tab - groups the fields on different tabs
  • Field - name of the field - there are 2 cases to consider:
    • 1. Adding a Completely New Field: Ensure the field name is unique and not already used elsewhere in GoldenCheetah.
      :bangbang: :memo: Note: For a completely new field, it is recommended to use only 0-9, a-z or A-Z and space in the field name. Only those characters are recognized as part of a field name by the Filter tool in GoldenCheetah. If you use any other character e.g. - or a language specific character like รค, you will not be able to create any Filter queries for this new field.
    • 2. Make an Existing Field Editable: You must use the exact and existing name in the Screen Tab (For the tab name, see Data Chart) and make sure that you assign the correct Field name. Fields such as Workout Code, Route, Equipment, etc. are included in the default configuration for convenience, but they are not interpreted by GoldenCheetah, just stored to be used in filters, user metrics and displayed.
  • Type - technical type of a field - in case of existing GoldenCheetah fields, please use the correct field type (to understand the field types, please have a look at the standard examples GoldenCheetah is providing).
  • Values - is a way to restrict and simplify the input into fields of type Text and Short Text - by adding a list of values, separated by , for a specific field, only those values can be entered into that particular field. A value of * indicates previous values for the same field will be used to autocomplete input.
  • Summary - if checked, the concatenated contents of all checked fields is show in the Trends view -> Chart Bar -> Calendar also in the Activities view -> Side Bar -> Activities Pane.
  • Interval - if checked, Metadata items can be defined for each interval rather the overall activity, this Checkbox has no effect on Metric or Special fields.
  • Expression - Not currently implemented - see Interval Metadata

:memo: Note: You can use this to enter data for activities, where certain data was not captured at all, or to overwrite/correct certain values

Colour Keywords

Preferences - Datafields - ColourKeywords

The section Colour Keywords defines which field / field content is used to determine the color shown for a activity in e.g. the calendar view.

  • Field - you need to select ONE text field, which will contain the keywords relevant to set the colors - the drop-down list offers all Text, Short Text and Textbox field maintained under Fields.
  • Use for Background - if checked, the color is not applied to the text, but to the text background (this provides a behavior similar to GoldenCheetah 3.0x).
  • Keyword - this is the main keyword to determine the color - (which is set in field Color) - when comparing the keywords with your texts, Upper/Lower case writing is ignored (so FTP is treated equally to ftp or fTp).
  • Color - is set using a Color Chooser dialog box which is opened by "mouse-click" on the color box.
  • Related Notes Words - is useful, if you want more than one keyword to have the same color, instead of adding them one-by-one to the keyword list, you can just create one entry to define the color and enter all other keywords, separated by , into this field.

Defaults

Preferences - Datafields - Defaults

The processing logic is: if Field is filled with Value (exact match), then Linked Field is filled with Default Value, provided Linked Field is not previously set. Default rules are applied on import and when metadata fields referenced by them are changed in Data chart.

Processors & Automation

Preferences - Datafields - Processing

GoldenCheetah provides a number of fix/adjust/correct tools which are configured here. For further details, please read Special Topics: Activity processing

Here you can also create and manage the Python Fix. For further details, please read Custom Data Processors in Python

BACK: Preferences: Overview
BACK: Table of contents