About Importing Materials

This topic provides a list of parameters related to material import and specifies whether you can update them using a material master import document (MMID). For information on which of these records you can import for each schema version, refer to Supported Schema Versions for Importing Materials.
  • productionLines (optional): Identifies the route-enabled production line on which a material could be manufactured. A material imported to a route-enabled line will result in the:
    • Material associating to all units within the route-enabled line.
    • Material associating to the single path of the route-enabled line.
    In B2MML format, productionLines is represented by the ProductionLine parameter under EquipmentSpecificationProperty. A value is required and must match a production line in Plant Applications.
  • storageZone: Identifies the storage zone/line of the unit to which the material will be mapped. A value is required if you are using storageUnit; the value can be null if you are using productionLines.
  • storageUnit: Identifies the storage unit/unit to which the material will be associated. The unit must be located on the storageZone/line. The material imported to the unit will be associated to the unit. In B2MML format, storageUnit is represented by the StorageUnit parameter under EquipmentSpecificationProperty.
    Note: In schema 2, storageUnit can be optional under the following conditions:
    • A storageZone/line is supplied.
    • Within the storageZone/line configuration there is only one storageUnit/unit for each unit of measure.
    • A unit of measure property is supplied for the material import.
    If storageUnit is null, the behavior of the schema 2 import will automatically associate the material to the single unit of the storageZone/line that aligns to the material's unit of measure.
  • productCode: Unique identifier of the material. A value is required and must match the product code of an actual product in Plant Applications.
  • productDescription: Identifies the product description of the material.
  • productFamily: Identifies the product family of the material.
  • isSerialized: Identifies whether the material represents a serialized product.
  • propertyName and propertyValue: Identify the properties and their values of a material. The following conditions apply when you provide material properties in an MMID:
    • Only if a property exists in the Material Import property group in Plant Applications, can you add or update the property. Otherwise, the import will fail and return a corresponding error message. For more information, refer to:
    • All properties specified in an MMID will be associated to the material within Plant Application, including replacing any existing property values the material may have already had.
      • If a material already had a value for a property in Plant Applications and a new value is supplied in the MMID, the property value in Plant Applications is replaced.
      • If a material already had a value for a property in Plant Applications and a new value of "" is supplied in the MMID, the value in Plant Applications is cleared.
      • If a material already had a value for a property in Plant Applications and the property is not part of the MMID, the existing value in Plant Applications will be left unchanged.