Attribute Naming Convention

Attributes (also known as fields, properties or columns) are an important component of your data; they can control the visual appearance of a loaded file, or can be contained 'silently' within any data object as a means of storing data values. They can be added to new files or objects, including geological data (tables, drillholes, sample points, geological string and wireframe models), as well as mine planning data (planning outlines, mine design strings and wireframes).

  • An attribute can be either Numeric or Alphanumeric.

  • A table must contain unique attribute names - no two fields can be identical in name.

Your product supports attribute names up to 24 characters in length.

Excessively Long Field Names - What Happens?

Your system adopts the following behaviour if a field name is detected that is longer than the permitted limit:

  • When data is written to a file, excessively long attributes are truncated.

    • Unless the file is saved in the legacy system, the longer field names will still exist within the table - but only the first 8 characters are displayed in the legacy system.

  • If truncation occurs and it introduces a duplicate field name, only the first field is preserved. Subsequent (identically-named) fields are removed.

  • Where data is imported, excessively long attributes are truncated.

  • In specific cases, such as DILUTMOD, a lower limit is required in order to accommodate automatically-generated (and prefixed) field names.

Warning: In general, if you are working in a mixed-application environment where both 'short field' and 'long field' systems are in active use and data is transferred between them, you should retain an 8-character limit for field names. If you adopt a longer field naming convention, you should consider your data bound to post-2018 releases of Studio products. If in doubt, contact your local Datamine representative for advice.

Illegal Names

  • Restricted Datamine field names cannot be used.

  • If you attempt to add an attribute name that already exists in the selected object, a warning is displayed and the attribute will not be added.

 Illegal Characters

  • Attributes must not start with the following characters: "*", "&", "@", "!", "?", "." or "_"

  • Attributes must not contain spaces, or the following characters: ",", "!", " :", "*", "&", "=", "()".

Note: The underscore character, "_" can be used instead of a space within an attribute but should not be used at the start of an attribute as this can cause process such as INPUTD or INPFIL to terminate early.

Related topics and activities