Business To Manufacturing

Markup Language
Material
Version 6.0 - March 2013
B2MML-Material

MESA • 107 S. Southgate Drive • Chandler, AZ 85226 USA • 480-893-6110 • hq@mesa.org • www.mesa.org
 B2MML-V0600-Material.docx

IMPORTANT: While the information, data, and standards provided in this publication were developed and are presented
in good faith in accordance with a reasonable process that was subject to intellectual property and antitrust policies to
benefit the industry as a whole, the publication is provided “as is” for information and guidance only, and there is no
representation or warranty of any type or kind, including but not limited to warranties of merchantability or fitness for a
particular purpose, and no warranty that use of the information, data, or standards will not infringe patent, copyright,
trademark, trade secret, or other intellectual property rights of any party.

Copyright © 2013 MESA International

All Rights Reserved. http://www.mesa.org
This MESA Work (including specifications, documents, software, and related items) referred to as the
Business To Manufacturing Markup Language (B2MML) is provided by the copyright holders under the
following license.
Permission to use, copy, modify, or redistribute this Work and its documentation, with or without
modification, for any purpose and without fee or royalty is hereby granted provided MESA
International is acknowledged as the originator of this Work using the following statement:
"The Business To Manufacturing Markup Language (B2MML) is used courtesy of MESA International."
In no event shall MESA International, its members, or any third party be liable for any costs, expenses,
losses, damages or injuries incurred by use of the Work or as a result of this agreement.

Material from ANSI/ISA-88 and ANSI/ISA-95 series of standards used with permission of ISA - The Instrumentation,
Systems, and Automation Society, www.isa.org

Copyright © MESA 2013, All rights reserved. Page 1

Revision 1, Saved March 16, 2013 at 11:03
 Material

Table of Contents

CHANGE HISTORY .............................................................................. 3

SCHEMA SCOPE ................................................................................. 4
Key Information Assumptions ............................................................ 4
MaterialInformation .......................................................................... 5
MaterialLot........................................................................................ 5
MaterialSubLot .................................................................................. 5
MaterialDefinition ............................................................................. 5
MaterialClass ..................................................................................... 5
MaterialTestSpecification .................................................................. 5
ELEMENT DEFINITIONS....................................................................... 6
TRANSACTION ELEMENTS ................................................................ 13
DIAGRAM CONVENTION .................................................................. 16

Copyright © MESA 2013, All rights reserved. 2

Revision 1, Saved March 16, 2013 at 11:03
 B2MML-V0600-Material.docx

CHANGE HISTORY
Change Date Person Description
V01 7 April 2002 Dennis Brandl Initial release
Dave Emerson
V02 23 Sept 2003 Dennis Brandl • Added Location information to lot type
Dave Emerson • Changed ##any to "Any" element of type
"AnyType"
• Move StorageLocation and Quantity to
MaterialLotType
V03 26 Aug 2005 Dennis Brandl • Added substitution groups. One group added
Dave Emerson just before each Any element.
• Added MaterialLotID to MaterialSubLot so a
stand alone MaterialSubLot element can be
identified with a Lot ID.
V0301 29 Dec 2005 Dennis Brandl • Added properties to sublots

V04 04 June 2007 Dennis Brandl • Added transaction elements

V0401 Oct 2008 Dennis Brandl • Changed version number

V0500 Mar 2011 Dennis Brandl • Updated for ISA 95.02-2010

• Added assembly definitions
• Changed QATest to MaterialTest
V0600 Aug 2012 D. Brandl Updated MESA Copyright

Copyright © MESA 2013, All rights reserved. Page

Revision 1, Saved March 16, 2013 at 11:03
 Material

SCHEMA SCOPE
This document defines the information about material definitions, material classes, material lots, material sublots, and
QA (Quality Assurance) tests that may be exchanged between business systems and manufacturing operations systems.
This information is based on the data models and attributes defined in the ANSI/ISA 95.00.02 Enterprise/Control System
Integration standard. Contact ISA (The Instrumentation, System, and Automation Society) for copies of the standard.
Additional information on the standard is available at www.isa.org.

Key Information Assumptions

The data represented in these schemas is derived from the UML model below. This model is defined in the ANSI/ISA
95.00.02 standard. The information model in the model below is not hierarchical, so the key assumption is that the
information may be accessed from any of four starting points: material class, material definition, material lot, material
sublot or material test specifications, as identified by the dotted collections in the figure.

Information About Information About Information About Information About

Material Classes Material Definitions Material Lots Material Sublots
Information
About Tests
Is assembled from

Is assembled from Is assembled from Is assembled from

0..n 0..n 0..n 0..n 0..n 0..n

Defines
0..n Made up of
Material a grouping Material Material
Material Lot
Class 0..n 0..n Definition 1..1 Defined by 0..n Sublot

0..n
Has Has Is tested Has
properties properties Is tested values for Has
by a > by a > values for
of Is tested of May be made up
by a > 0..n 0..n of sublots
0..n
Material Test
0..n Specification
Is tested Records the
0..n 0..n execution of
by a > Defines a Material Test
Is tested
by a > procedure Result
for
0..n 0..n 0..n obtaining a 0..n
Material Material 0..n 0..n 0..n
Material Lot
Class Definition
May Maps to Property
Property Property
map to

0..n 0..n 0..n

< may contain nested < may contain nested < may contain nested

Model of Exchanged Material Information

This schema uses a common schema for definition of elements that are used in multiple schemas, such as ID,
Description, and Value. See the document defining the Common schema for definition of the common elements.

Copyright © MESA 2013, All rights reserved. 4

Revision 1, Saved March 16, 2013 at 11:03
 B2MML-V0600-Material.docx

MaterialInformation
The main structuring element of the schema definition is MaterialInformation.

MaterialLot
A material lot object uniquely identifies a specific amount of material, countable or weighable. This describes the actual
total quantity or amount of material available, its current state, and its specific property values.
MaterialLot elements may be used to contain information about specific material and subsets of the material stored as
sublots. It may also include the definition of QA test results. It may include the list of material definitions the material
belongs to and the list of QA test specifications associated with properties.

MaterialSubLot
A material lot may be stored as separately identifiable quantities. Each separate identifiable quantity of the material is
identified in a material sublot. All material sublots must contain the same material lot, so they use the material lot
element’s property values. A material sublot may be just a single item. Material sublots may have sublot specific
properties, such as RFID tag IDs or other identification properties, maintained in a MaterialSublotProperty element.

Each material sublot also contains the location of the sublot, the quantity or amount of material available in the sublot,
and a reference to the material lot. Material sublots may contain other sublots. For example, a sublot may be a pallet,
each box on the pallet may also be a sublot, and each material blister pack in the box may also be a sublot.

MaterialDefinition
A material definition is a means to describe goods with similar characteristics for purposes of scheduling and planning.
Examples of these may be “City Water”, “HCl”, and “Grade B Aluminum”. The materials may be identified as raw,
intermediate, or final and may have other state information, such as availability of safety information.
MaterialDefinition information may be used to contain information about material definitions. It may contain the list of
material lots belonging to the definition and the list of QA test specifications associated with material definition
properties.

MaterialClass
A material class is means of defining groupings material definitions for use in production scheduling or processing. An
example of a material class is "Sweetener", with members of "Fructose", "Corn Syrup", and "Sugar Cane Syrup".
Another example of a material class is "Water", with members of "City Water", "Recycled Water", and "Spring Water". A
material definition may belong to zero or more material classes.
MaterialClass information may be used to contain information about material classes. It may contain the list of material
definitions belonging to the class and the list of QA test specifications associated with material class properties.

MaterialTestSpecification
A material test specification may be associated with a material class property. This is typically used where a test is
required to ensure that the material has the required property value. A material test specification may identify a test for
one or more material class properties. Not all properties need to have a defined material test specification.
MaterialTestSpecification information may be used to contain information about material tests. It may contain
identifications of the tested material properties and the tested material class properties.

Copyright © MESA 2013, All rights reserved. Page 5

Revision 1, Saved March 16, 2013 at 11:03
 Material

ELEMENT DEFINITIONS

Element/Type Description
MaterialClass Contains a definition of a material class, the properties associated with the
MaterialClassType class, and the list of material definitions associated with the class.
ID

Description

0..∞

Location

HierarchyScope

MaterialClassProperty

0..∞

MaterialDefinitionID
MaterialClassType
0..∞

MaterialTestSpecificationID

0..∞

Assem blyClassID

0..∞

Assem blyType

Assem blyRelationship

Extended:MaterialClass

MaterialClassProperty Contains a definition of a property for a material class, the nominal value of the
MaterialClassPropertyType property, any nested properties, and the ID of a QA test specification for the
property.
ID

Description

0..∞

Value

0..∞
MaterialClassPropertyType
MaterialClassProperty

0..∞

MaterialTestSpecificationID

0..∞

Extended:MaterialClassProperty

Copyright © MESA 2013, All rights reserved. 6

Revision 1, Saved March 16, 2013 at 11:03
 B2MML-V0600-Material.docx

Element/Type Description
MaterialDefinition Contains a definition of a material definition, the properties associated with the
MaterialDefinitionType definition, the list of material class the definition belongs to, and the list of
material lots belonging to the definition.
ID

Description

0..∞

Location

HierarchyScope

M aterialDefinitionProperty

0..∞

M aterialClassID

0..∞
MaterialDefinitionType
M aterialLotID

0..∞

M aterialTestSpecificationID

0..∞

Assem blylDefinitionID

0..∞

Assem blyType

Assem blyRelationship

Extended:MaterialDefinition

MaterialDefinitionProperty Contains a definition of a property for a material definition, the nominal value of
MaterialDefinitionPropertyType the property, any nested properties, and the ID of a QA test specification for the
property.
ID

Description

0..∞

Value

0..∞
MaterialDefinitionPropertyType
MaterialDefinitionProperty

0..∞

MaterialTestSpecificationID

0..∞

Extended:MaterialDefinitionProperty

Copyright © MESA 2013, All rights reserved. Page 7

Revision 1, Saved March 16, 2013 at 11:03
 Material

Element/Type Description
MaterialInformation Contains material information, may include a list of material classes, material
MaterialInformationType definitions, material lots, material sublots, and QA test specifications.
ID

Description

0..∞

Location

HierarchyScope

PublishedDate

MaterialClass

0..∞
MaterialInform ationType
MaterialDefinition

0..∞

MaterialLot

0..∞

MaterialSubLot

0..∞

MaterialTestSpecification

0..∞

Extended:MaterialInformation

Copyright © MESA 2013, All rights reserved. 8

Revision 1, Saved March 16, 2013 at 11:03
 B2MML-V0600-Material.docx

Element/Type Description
MaterialLot Contains a definition of a material lot, the properties associated with the lot, the
MaterialLotType material definition of the lot, a status of the lot, the list of material sub lots
associated with the lot, an optional storage location and quantity.
ID

Description

0..∞

Location

HierarchyScope

MaterialDefinitionID

Status

MaterialLotProperty

0..∞

MaterialSubLot

0..∞

MaterialLotType
StorageLocation

Quantity

0..∞

MaterialTestSpecificationID

0..∞

Assem blyLotID

0..∞

Assem blySubLotID

0..∞

Assem blyType

Assem blyRelationship

Extended:MaterialLot

Copyright © MESA 2013, All rights reserved. Page 9

Revision 1, Saved March 16, 2013 at 11:03
 Material

Element/Type Description
MaterialLotProperty Contains a definition of a property for a material lot, the value of the property,
MaterialLotPropertyType any nested properties, and the ID of a QA test specification for the property. It
may contain a storage location and quantity, and test results from QA material
tests.
ID

Description

0..∞

Value

0..∞

MaterialLotProperty
MaterialLotPropertyType
0..∞

MaterialTestSpecificationID

0..∞

TestResult

0..∞

Extended:MaterialLotProperty

Copyright © MESA 2013, All rights reserved. 10

Revision 1, Saved March 16, 2013 at 11:03
 B2MML-V0600-Material.docx

Element/Type Description
MaterialSubLot Contains a definition of a material sublot, a status of the sublot, the storage
MaterialSubLotType location of the sublot, the quantity of the sublot, any sublots that make up the
sublot, and the ID of the associated material lot.
NOTE: The MaterialSublotProperty is of type MasterialLotPropertyType.
ID

Description

0..∞

Location

HierarchyScope

Status

MaterialSublotProperty

0..∞

StorageLocation

Quantity
MaterialSubLotType 0..∞

MaterialSubLot

0..∞

MaterialLotID

Assem blyLotID

0..∞

Assem blySubLotID

0..∞

Assem blyType

Assem blyRelationship

Extended:MaterialSubLot

Copyright © MESA 2013, All rights reserved. Page 11

Revision 1, Saved March 16, 2013 at 11:03
 Material
Element/Type
MaterialTestSpecification
MaterialTestSpecificationType
TestedMaterialClassProperty
TestedMaterialClassPropertyType
TestedMaterialDefinitionProperty
TestedMaterialDefinitionPropertyType
TestedMaterialLotProperty
TestedMaterialLotPropertyType
Copyright © MESA 2013, All rights reserved.
Description
Contains a definition of a material test specification, including the ID and
version of the test, the list of tested material class properties, the list of tested
material definition properties, the list of tested material lot properties, and
application defined elements.
Nam e
Description
0..∞
Version
Location
HierarchyScope
MaterialTestSpecificationType
TestedMaterialClassProperty
0..∞
TestedMaterialDefinitionProper...
0..∞
TestedMaterialLotProperty
0..∞
Extended:MaterialTestSpecification
Contains an identification of a tested material class and a property ID.
MaterialClassID
TestedMaterialClassPropertyTy... PropertyID
Extended:TestedMaterialClassProperty
Contains an identification of a tested material definition and a property ID.
MaterialDefinitionID
TestedMaterialDefinitionPropert... PropertyID
Extended:TestedMaterialDefinitionPro...
Contains an identification of a tested material lot and a property ID.
MaterialLotID
TestedMaterialLotPropertyType PropertyID
Extended:TestedMaterialLotProperty
12
Revision 1, Saved March 16, 2013 at 11:03

TRANSACTION ELEMENTS
The following elements are defined to support the ISA 95 Part 5 transactions, using the transaction data types defined in
the B2MML-Common.xsd schema.
Material Information Elements
GetMaterialInformation
ShowMaterialInformation
ProcessMaterialInformation
AcknowledgeMaterialInformation
ChangeMaterialInformation
RespondMaterialInformation
CancelMaterialInformation
SyncMaterialInformation
Material Class Elements
GetMaterialClass
ShowMaterialClass
ProcessMaterialClass
AcknowledgeMaterialClass
ChangeMaterialClass
RespondMaterialClass
CancelMaterialClass
SyncMaterialClass
Material Definition Elements
GetMaterialDefinition
ShowMaterialDefinition
Copyright © MESA 2013, All rights reserved.
B2MML-V0600-Material.docx
Description
Get MaterialClass, MaterialDefinition, MaterialLot,
MaterialSubLot, and MaterialTestSpecification definitions.
Returned information from the GetMaterialInformation message.
Process MaterialClass, MaterialDefinition, MaterialLot,
MaterialSubLot, and MaterialTestSpecification definitions.
Returned status from the ProcessMaterialInformation message.
Change MaterialClass, MaterialDefinition, MaterialLot,
MaterialSubLot, and MaterialTestSpecification definitions.
Returned status from the ChangeMaterialInformation message.
Cancel MaterialClass, MaterialDefinition, MaterialLot,
MaterialSubLot, and MaterialTestSpecification definitions.
Published MaterialClass, MaterialDefinition, MaterialLot,
MaterialSubLot, and MaterialTestSpecification definitions.
Description
Get MaterialClass definitions.
Returned information from the GetMaterialClass message.
Process MaterialClass definitions.
Returned status from the ProcessMaterialClass message.
Change MaterialClass definitions.
Returned status from the ChangeMaterialClass message.
Cancel MaterialClass definitions.
Published MaterialClass definitions.
Description
Get MaterialDefinition definitions.
Returned information from the GetMaterialDefinition message.
Page 13
Revision 1, Saved March 16, 2013 at 11:03
 Material

Material Definition Elements Description

ProcessMaterialDefinition
AcknowledgeMaterialDefinition
ChangeMaterialDefinition
RespondMaterialDefinition
CancelMaterialClass
SyncMaterialDefinition
Process MaterialDefinition definitions.
Returned status from the ProcessMaterialDefinition message.
Change MaterialDefinition definitions.
Returned status from the ChangeMaterialDefinition message.
Cancel MaterialDefinition definitions.
Published MaterialClass definitions.

Material Lot Elements Description

GetMaterialLot Get MaterialLot definitions.
ShowMaterialLot Returned information from the GetMaterialLot message.
ProcessMaterialLot Process MaterialLot definitions.
AcknowledgeMaterialLot Returned status from the ProcessMaterialLot message.
ChangeMaterialLot Change MaterialLot definitions.
RespondMaterialLot Returned status from the ChangeMaterialLot message.
CancelMaterialLot Cancel MaterialLot definitions.
SyncMaterialLot Published MaterialLot definitions.

Material Sublot Elements Description

GetMaterialSubLot Get MaterialSubLot definitions.
ShowMaterialSubLot Returned information from the GetMaterialSubLot message.
ProcessMaterialSubLot Process MaterialSubLot definitions.
AcknowledgeMaterialSubLot Returned status from the ProcessMaterialSubLot message.
ChangeMaterialSubLot Change MaterialSubLot definitions.
RespondMaterialSubLot Returned status from the ChangeMaterialSubLot message.
CancelMaterialSubLot Cancel MaterialSubLot definitions.
SyncMaterialSubLot Published MaterialSubLot definitions.

QA Material Test Specification Description

Elements

Copyright © MESA 2013, All rights reserved. 14

Revision 1, Saved March 16, 2013 at 11:03
 B2MML-V0600-Material.docx

QA Material Test Specification Description

Elements
GetMaterialTestSpec Get MaterialTestSpecification definitions.
ShowMaterialTestSpec Returned information from the GetMaterialTestSpec message.
ProcessMaterialTestSpec Process MaterialTestSpecification definitions.
AcknowledgeMaterialTestSpec Returned status from the ProcessMaterialTestSpec message.
ChangeMaterialTestSpec Change MaterialTestSpecification definitions.
RespondMaterialTestSpec Returned status from the ChangeMaterialTestSpec message.
CancelMaterialTestSpec Cancel MaterialTestSpecification definitions.
SyncMaterialTestSpec Published MaterialTestSpecification definitions.

Copyright © MESA 2013, All rights reserved. Page 15

Revision 1, Saved March 16, 2013 at 11:03
 Material

DIAGRAM CONVENTION
The schema diagrams using the following convention to illustrate the structure of the schema elements, the type of the
elements and attributes, and the rules for optional elements and repetition.

Name of an element or element type

Indicates fixed order of elements

Indicates elements

Indicates 1 instance only

Indicates 1 to many instances

Indicates 0 or 1 instance only

Indicates 0 to many instances

Indicates selection of alternatives

Indicates contained elements

Indicates no contained elements

Copyright © MESA 2013, All rights reserved. 16

Revision 1, Saved March 16, 2013 at 11:03
 B2MML-V0600-Material.docx

About MESA: MESA promotes the exchange of best practices, strategies and innovation
in managing manufacturing operations and in achieving operations excellence. MESA’s
industry events, symposiums, and publications help manufacturers achieve
manufacturing leadership by deploying practical solutions that combine information,
business, manufacturing and supply chain processes and technologies. Visit us online at
http://www.mesa.org.
About the XML Committee: The XML Committe was formed within MESA to provide a
forum for the development of the B2MML and BatchML specifications.

Copyright © MESA 2013, All rights reserved. Page 17

Revision 1, Saved March 16, 2013 at 11:03