Info |
---|
This page is a work in progress by the Standards & Guidelines Committee's /wiki/spaces/SGC/pages/59703357. |
Introduction
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 | ||||||
---|---|---|---|---|---|---|
| ||||||
<?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 | ||||
---|---|---|---|---|
| ||||
<?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 belongs.
Compound Units of Measure
Units of Measure Conversion
While "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. While this may lead to ambiguity, no issues have been reported as trading-partner pairs typically agree to the code list set that applies to the messages that they exchange.
Compound Units of Measure
The concept of compound units of measure at a basic level is best explained through a couple of examples:
- pounds per acre
- milliliters per square meter
Units of Measure Conversion
Converting from gallons to liters or feet to meters is straightforward. Converting from anything to anything–including compound units of measure–is another. Field operations information processing often requires units of measure conversion that tend toward the more complex end of the use case spectrum. As with compound units of measure, AgGateway's Precision Ag Council and its projects are working in this area. AgGateway will update this section as deliverables are published. For concrete examples of how compound units of measure are being used today, see the Units of Measure for Field Operations
Units of Measure Used by John Deere
Units of Measure Used by MapShotsbelow.
For concrete examples of how compound units of measure are being used today, see the Units of Measure for Field Operations below.
Units of Measure Cross-Reference and Translation
What domains use what code list sources. While UN Rec 20 is specified for use within AgGateway Open Standards (supply-chain-focused standards) and AGIIS supports X12 as well, field operations information requires units of measure specified in several domains with lists managed by various agencies (e.g., soil conditions, meteorology). AgGateway's Precision Ag Council and its projects will be creating a cross-reference among various unit of measure codes lists. AgGateway will update this section as deliverables are published.
Units of Measure for Field Operations
See the Compound Units of Measure, Units of Measure Conversion, and Units of Measure Cross-Reference and Translation sections above. The referenced concrete examples are: