Versions Compared

Old Version 12

changes.mady.by.user Jim Wilson

Saved on

compared with

New Version 13

changes.mady.by.user Jim Wilson

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This page is a work in progress by the Standards & Guidelines Committee's /wiki/spaces/SGC/pages/59703357.

Introduction

Consider the adjacent recipe for chocolate chip cookies. There is an obvious missing element to this: units of measure. One tablespoon of pure vanilla extract? Teaspoon? Drop? Like cooking, supply chain and field operations quantities are meaningless without knowing units of measure. AgGateway, other agriculture-industry associations, agricultural companies, and standards bodies have addressed units of measure in their standards, guidelines, and products. This page provides a starting point for implementers to understand how units of measure are used in agriculture.

Chocolate Chip Cookies

1/2 __ unsalted butter
3/4 __ packed dark brown sugar
3/4 __ sugar
2 large eggs
1 __ pure vanilla extract
1 __ semisweet chocolate chips, or chunks
2 1/4 __ all-purpose flour
3/4 __ baking soda
1 __ fine salt

Source: Food Network

Units of Measure in AgGateway Open Standards

AgGateway Open Standards specifies use of UN/CEFACT Rec 20.

Consider the following AgGateway Open Standards XML document:

Code Block
languagexml
titleMeasurement XML
linenumberstrue
<?xml version="1.0" encoding="UTF-8"?>
<Measurement
	xmlns="urn:cidx:names:specification:ces:schema:all:5:3">
	<Measurement>
	<MeasurementValue>50</MeasurementValue>
	<UnitOfMeasureCode Domain="UN-Rec-20">BG</UnitOfMeasureCode>
</Measurement>

Explain how this works.In this example, a measurement element provides two child elements: MeasurementValue and UnitOfMeasureCode. One could read this as: The measurement is 50 bags. We know that the unit of measure is "bag" because the code is "BG" and "BG" is defined by UN/CEFACT Recommendation 20 as "bag". The domain attribute specifies the source of the code and must be "UN-Rec-20" (i.e., UN/CEFACT Recommendation 20). 

Units of Measure in AGIIS

 AgGateway's AGIIS service supports UN/CEFACT Rec-Recommendation 20 and ANSI ASC X12 (i.e., EDI) unit of measure codes. The Excel file referenced below provides a list of units of measure specified in AGIIS product records as of the data specified in the file. It also includes a cross-reference to the X12 code list value. .<explain>AGIIS supports any UN/CEFACT Rec 20 unit of measure code. Consequently, the list, which is a subset, should not be understood to be the only permitted values.

Units of Measure in AgXML

Consider the following AgXML XML document:

Code Block
languagexml
linenumberstrue
<?xml version="1.0" encoding="UTF-8"?>
<QualityFactorValue
	xmlns="urn:www.agxml.org:schemas:all:4:0" 	unitOfMeasure="GL">1000.00</QualityFactorValue>

Line 1 simply indicates that the content is XML. The remaining lines contain The example contains a single element, QualityFactorValue with an attribute unitOfMeasure. Line 3 specifies the default namespace, to which the element belongsWhile "GL" would commonly be understood to mean "gallon", the source of the meaning "GL" is not specified. The standard does not declare that any particular code list must be used.

Compound Units of Measure

Units of Measure Conversion

Units of Measure for Field Operations

Units of Measure Used by John Deere

Units of Measure Used by MapShots

Units of Measure Cross-Reference and Translation

What domains use what code list sources. e.g., meteorology