BlueCell XML Import from Microvellum (Reference)

BlueCell XML Import from Microvellum (Reference)

This article is a reference of the BlueCell® processing station properties as well as for the XML parts file SheetGroup and PartGroup elements produced by Microvellum.

Think of the BlueCell processing station as the configuration mapping function of the BlueCell import, and the XML file as the communication device between Microvellum and the BlueCell. The XML file contains everything that BlueCell needs to know about the Microvellum project and work order to optimize the parts and material.

This reference assumes that you have read and understand the information in the BlueCell Overview and Tutorial articles in the Microvellum Knowledge Network. Create a BlueCell processing station and process a work order with that station. The XML files, as shown in this reference, are created as examples of files produced by such a station.

BlueCell Processing Station Properties

Processing Station > Associates tab


Fig. 01 – Associates Tab

  • Add Associate – Click to add a row for a new secondary machining associate.
  • Delete Associate – Click to delete a row for a new secondary machining associate.
  • Index – Enter a number that represents the priority of data to appear on the labels. In other words, if you have multiple machines that produce the same type of G-Code, such as multiple point-to-point machines or multiple edgeboring machines, the lower this number, the higher that Associate will be in priority for displaying its data on the labels. This data is displayed in the XML file in a single row as a pipe-delimited list of values. The first value in the list is the one with the lowest index number of the group.
  • Type – Select a machine type from the list that matches the machine on the row that you’re editing.
  • Name – Select a processing station name from the list of existing stations.

Processing Station > Files & Pictures tab


Fig. 02 – Files & Pictures Tab

  • File Location – Click the Browse button to select a folder to contain the XML file that is produced when processing with the BlueCell processing station.
  • Part Picture File Location – Click the Browse button to select a folder to contain the part picture that is produced when processing with the BlueCell processing station. This part picture is often used on the labels produced by BlueCell.
  • Picture Type – Select the type of picture required by your BlueCell software.
  • Pixel Size – Select the resolution of the picture in pixels required by your BlueCell software.
  • Zoom Factor – Select the magnification of the picture required by your BlueCell software.
  • Use Legacy WMF Format – Not applicable for BlueCell. (Check the box if you are using a version of CutRite that requires a legacy graphics format. Does not apply to EMF picture types.)

Processing Station > Custom Settings tab


Fig. 03 – Custom Settings Tab

  • Available Values box – Select values from this box to enter in the User Values box to the right. These are the field values from the Parts table that are available to be passed to the BlueCell XML file for use by the optimizer in labels.
  • Add button – Select single or multiple values in the Available Values box on the left and click this button to add them to the User Values box on the right.
  • Delete button – Select single or multiple values in the Used Values box on the right and click this button to delete them from that list.
  • Used Values box –This box is empty by default. Add values to this box from the Available Values box to the left by using the Add button. The values in this box will be populated in the order they appear in this box to the XML file fields starting at “UserText07” and continuing through “UserText20.”
  • Move Up button – Select a single value in the Used Values box on the right and click this button to move that selection up in the list. This also changes the field this value is mapped to in the XML file.
  • Move Down button – Select a single value in the Used Values box on the right and click this button to move that selection down in the list. This also changes the field this value is mapped to in the XML file.

BlueCell XML File Produced by Microvellum

The XML file contains non-optimized parts and sheet information for import in the BlueCell program. The sections of that XML are displayed in the figures below.


Fig. 04 - Sample XML Header and Format

Sheet Group Element

The SheetGroup XML element is populated with all sheet information for the materials selected from the Processing Station. The sample file below contains the material “.6875 Core Liner-PL1 Solid,” which was added to the Sheet Group element.

A new Sheet element is added to the SheetGroup element for each sheet sizes available for any single material as defined in Microvellum.


Fig. 05 - XML Element for Sheet Group

Part Group Element

The PartGroup XML element is populated with all part information for the parts selected from the Processing Station. In the sample file, the Base Bottom was selected, so a new Part element was added to the PartGroup element that contains all the data for that part.

To populate Single Part G-Code and Horizontal or Edgebore Barcodes into the BlueCell parts file, the processing station associates must be set up as described elsewhere in the Microvellum Knowledge Network. Each processing station associate will generate a set of barcodes for the BlueCell XML file. These are added to that file as a string using the pipe character (“|”) as a delimiter in the order of the Associates property “Index.”

If using one Single Part G-Code processing stations and two HBore processing stations, the expected results will look like the following data. See figure 3 for the file output. 

.UserText01 = *HBoreBarcodeBottom*
.UserText02 = *HBoreBarcodeLeft*
.UserText03 = *HBoreBarcodeRight*
.UserText04 = *HBoreBarcodeTop*
.UserText05 = *Face5Barcode* | *Face5Barcode*
.UserText06 = *Face6Barcode* |*Face6Barcode*

Fig. 06 – XML Element for Parts Group

Processing Station Associates

To populate the BlueCell Parts File with single part G-Code and horizontal barcodes data, processing station associates must be set up. Each processing station associate will generate a set of barcodes for the BlueCell XML file and will be populated using a "|" delimiter in the order of Indexes set to the associates. For more information, see the appropriate section above.

If you are processing with one Single Part G-Code type station and two Horizontal Boring or Edgebore type station, the XML file contains these processing station associate values in the XML fields UserText01 – UserText06 as shown below.

.UserText01 = *HBoreBarcodeBottom*
.UserText02 = *HBoreBarcodeLeft*
.UserText03 = *HBoreBarcodeRight*
.UserText04 = *HBoreBarcodeTop*
.UserText05 = *Face5Barcode*|*Face5Barcode*
.UserText06 = *Face6Barcode*|*Face6Barcode*

BlueCell Output Units

BlueCell output units are dependent on the Library Units and Convert to Metric Settings.

If the “Library Units” = Imperial, and “Convert to Metric” = False
Then, the “Output Units” = Imperial
If the “Library Units” = Imperial, and “Convert to Metric” = True
Then, the “Output Units” = Metric
If the “Library Units” = Metric, and “Convert to Metric” = False
Then, the “Output Units” = Metric

    • Related Articles

    • BlueCell XML Import from Microvellum (Overview)

      Overview of BlueCell XML Parts File Import BlueCell® is a software optimizer produced by Eurosoft, Inc. It optimizes or determines the best location and rotation of parts on a material sheet to maximize material usage. It is one of several optimizers ...
    • Create and Configure a BlueCell Processing Station in Microvellum

      Before performing the actions itemized, you must have completed three tasks as outlined in the article “BlueCell XML Parts File Import from Microvellum (Overview).” Click here to view that article. Purchase & configure the BlueCell® software from ...
    • Microvellum Saw Optimization Settings (Reference)

      This article documents the current sawing optimization properties as of the most recent Toolbox build, Build 23.1.0523.641. Users may experience a different settings interface if using a version of Toolbox released prior to Build 23.1.0523.641 When ...
    • Microvellum Saw Connections (Reference)

      This article contains the current list of Microvellum beam saw connections as of February 5, 2020. It will be updated as new connections are created. Saw Brand Specific Notes Included in the documentation are samples of each Saw “Output Type.” When ...
    • Cut Rite PTX Parts File Import from Microvellum (Overview)

      Introduction Microvellum contains complete nesting optimizer and complete sawing optimizer solutions. It also supports the third-party optimizer Cut Rite manufactured by Stiles Machinery/Homag Group. There are two methods of communication between ...
    • Recent Articles

    • Toolbox Release Notes | Build 24.1.1105.641

      The following release notes apply to Toolbox build 24.1.1105.641 Nesting Fix Fig. 1: The fatal error that would occur during processing. There was reportedly an issue that occurred when clients attempted to process a work order using the nesting ...
    • Microvellum Foundation Library Release Notes | Build 24.1025

      The following release notes apply to Microvellum Foundation Library build 24.1025. Additions Added new global variable “Remove Stop Dado On Bottom Edge” for wood drawer boxes. Check this option to run the dado through at the bottom of the sub front ...
    • Toolbox Release Notes | Build 24.1.1030.641

      The following release notes apply to Toolbox build 24.1.1030.641 Routing and Profile Fixes Several issues were found with routing and polyline paths: Fig. 1: Horizontal routes off of a part disappearing (left) and appearing correctly (right). When ...
    • Toolbox Release Notes | Build 24.1.1010.641

      The following release notes apply to Toolbox build 24.1.1010.641 Biesse Winstore Fix Several issues with the Biesse Winstore plugin have been resolved: There was an issue that would sometimes occur wherein materials that were intended to stack wound ...
    • Toolbox Release Notes | Build 24.1.1001.641

      The following release notes apply to Toolbox build 24.1.1001.641 HBore Toolfile Fix Fig. 1: The location in the Toolfile UI where the error would occur. There was an issue reported with the functionality of the Horizontal Boring Machine setting in ...