Raw Data Component

A raw data component is used for storing numbers and strings which are used as they are. 

Text blocks and text phrases are translate able by default, raw data components are not translated by default.

A product for example may have a translated description or name, but the SKU number may always be the same no matter what the locale or language used. 

Data that is used universally as is no matter what the locale, or language, and which does not repeat over and over like a phrase or keyword, is managed using a raw data type.

Use Cases:

  • A product SKU
  • An identifier like a product number or person ID
  • A third party reference from an external system, like a product or code from SAP or some other system.

Configuration

Raw data types for a particular item are typically similar.  Like a SKU or a an ISBN number typically are consistently similar for a particular product type.  So when configuring a component to accept that data, the length, height, and format of the data can be decided for this data.

Field Size

Example:

* product wight may be an input box 5 spaces wide and may indicate KG or LBS

* Items per carton may be a number 1-5 digits

Most unique non translated fields for products are small identifiers handled by a simple input, which is the default, but more than one row can be used if desired.

Field Data Type

The data type can be numeric, or alpha characters and that type can be enforced. 

Field Data Mask

The format of the data can be enforced - always uppercase, or three numbers followed by a dash and two numbers 444-44 etc. so that errors entering the data are limited.

Field Validation

Field validation converts to uppercase if that is what is specified, or will reject 44-44 if the required pattern is 444-44.

Editor

In the editor the user enters the data.  If there is a data mask or type specified, then this is indicated above the field.  If data which does not match the specification is given then a clear message is given so the user can fix the data.

Display

Display of the raw data type is simply displaying the raw data with any applicable data masks as it is configured.

A raw data value of 24 would simply put 24 onto the page.  Any formatting or label associated with that data would require a container, text phrase or other elements.

Benefits

The benefits of having the item configuration is that the input field in the editor is appealing and appropriate.  Also validation makes sure that the appropriate type of data is used and that it is done so consistently.  If weight is only intended to be numbers for example this may prevent a new user from putting in say "five pounds" in the weight field when a number is required since the weight is used to calculate shipping and "five pounds" would break other integrations with say a shipping tool, ERP or other system.

Summary

Raw data types are used to manage data which is typically not repeated among a set of items.  Raw data types can be configured to enforce data type, provide a data mask, and to validate that the data entered into the field is appropriate.

Something like color if all items have a color, is not a raw data type because many items may have the same color, it is not unique for each item.  The color is a phrase and may be repeated over and over again so it is looked up as a phrase.