Add Dimensions to an Object Record

User Story

Given an Object record, a user can choose a dimension aspect (e.g. "height" or "weight") and set dimensions for the object.

The User can specify, per the Dimensions Schema:

• The name of the part being measured (e.g. "overall", "base", "bicondylar length" [for a femur bone] ...)
• The dimension aspect being measured (e.g. "height", "width", "weight" ...)
• A dimension value (e.g. "6", "0.372")
• A value qualifier (free text that qualifies the value; e.g. "approximate" or a measurement of statistical deviation)
• A dimension measurement unit (e.g. "cm", "in", "g" ...)
• The date on which the dimension value was recorded.

Auto-conversion of dimension value:

• Conversion patterns may be defined by admin or by user
  • imperial to metric, metric to imperial
• Value entered entered into dimension value field is converted, on-the-fly, to the corresponding dimension value
  • inches to centimeters, kilograms to pounds, meters to miles, centimeters to inches, etc.
• Values may be entered using slashes and dashes i.e., to represent fractions. 
• Values will be stored with separators, dashes, slashes, etc., for input and display.
  • 1 1/2; 5 1/3; 3 3/4
• Values may be entered using decimal points
• Values will be stored as decimals for sort and search
  • 5.76; 2.25; 10.37
•  

Display version of the measurements

• Need to add a field to Dimensions Schema for the 'Display' or 'Narrative' version of dimensions.  This is the version that would go on a wall label, be used in a condition assessment, used for a loan agreement, online, etc.
  • Examples:
• Auto-generate the value for

This story is not about:

• Customizing or personalizing the names of parts presented to the user (such as "overall" or "base").
• Customizing or personalizing dimension aspects presented to the user (such as "height" or "weight").
• Customizing or personalizing dimension units of measurement.
• Associating dimension aspects with allowed units of measurement (e.g. "height can be expressed in mm, cm, meters, inches, or feet").
• Converting values between different units of measurement (for display purposes only).

Scope for implementation:

• For the Hello Mercury 0.4 release:
  • The scope of this user story is restricted to adding a single dimension entry (e.g. one dimension "line" in the UI) per object record.
  • User may add information to three related fields: dimension, dimension measurement unit, and dimension value fields.
  • Dimension and dimension value are both alphanumeric string fields
  • Dimension measurement unit is a controlled list with values:

centimeters
millimeters
meters
liters
kilograms
cubic centimeters
minutes
carats
pixels
count
stories
inches
square feet
feet

• In a future (as yet-unspecified) release:
  • Dimensions will be a multi-valued field, in which multiple dimension entries - for multiple object parts ("overall", "base" ...) and aspects ("height", "weight" ...) can be applied to the Object record, and their values set.

Note that there are two types of dimensions that can be set:

• Overall dimensions
  and/or
• Dimensions for named parts

In the UI in the current Object Cataloging Wireframe (below), "overall" dimensions are intermingled with part dimensions, thus treating "overall" as just another instance of a named part, per [a decision by the Design Team at their July 10, 2009 meeting].

See also:

Dimensions Schema

Measurement Requirements

Object Cataloging Wireframe, displaying a representative set of Dimensions (under "Object Description Information", then "Physical Dimensions").

[Services Team Design Meeting June 18, 2009], featuring an extensive discussion of dimensions.

Related User Stories:

Derived Stories: