Creating Jobs via Magics CSV Import

You can automate the part selection for job creation by importing a Magics CSV report. This functionality needs to be activated in the admin panel under Organization → Switches.

A Magics CSV file can be imported during job creation to automatically match parts and their quantities with the build generated in Magics. This process significantly saves time, minimizes human error, and ensures data accuracy.

The Create Job form with activated Magics CSV Import button

The Magics CSV Import functionality needs to be activated in the Admin Panel under Organization → Switches.

Prerequisites for Successful Part Matching using Magics CSV Import

To ensure successful part matching using Magics CSV import, specific prerequisites must be met in the 3YOURMIND MES, and certain requirements must be adhered to when working with Magics CSV. This section outlines these prerequisites and requirements.

Prerequisites in 3YOURMIND

Prerequisites for the Magics CSV

  • File Naming: 3D files must be imported to Magics with the MES Part ID (“Part #”) at the beginning of the file name.

  • Export Report: A Magics report needs to be exported and saved as a .CSV file.

  • UTF-8 Format: The CSV file needs to be exported in UTF-8 format.

  • Parts in First Column: The names of the 3D files must be written in the first column of the CSV.

  • Separate Lines for Copies: Each copy of a part in the build must be written to the CSV in a separate line (e.g., a part with a quantity of 5 needs 5 individual lines in the CSV).

Example CSV File

An example CSV containing only the needed information is shown below. The following file represents a build containing part #437 with a total quantity of 5 (the number of lines are counted) and #438 with a total quantity of 3.

437-269309_O1-pa12-10_optimized 437-269309_O1-pa12-10_optimized 437-269309_O1-pa12-10_optimized 437-269309_O1-pa12-10_optimized 437-269309_O1-pa12-10_optimized 438-269309_O1-pa12-10_optimized_1 438-269309_O1-pa12-10_optimized_1 438-269309_O1-pa12-10_optimized_3

The important part of the part file name is the Part ID at the beginning of the string. The remaining name is not considered when matching csv content and parts in the MES.

File Validation During the Import

As an MES operator, it's crucial to understand issues with the CSV file during job creation to proceed efficiently. Furthermore, it is paramount that the created job contains exactly the parts and quantities as expected from the CSV file.

This section provides guidance on handling failures during the Magics CSV import process, explaining potential issues and offering solutions.

When Magics CSV Import Fails

Upon clicking the "Import Magics CSV" button on the Create Job page, if any part in the CSV cannot be imported, an interface will display the following information:

  • Which parts are failing the import.

  • Reasons for the failure.

image-20240619-110156.png

Partial Success: If some parts are imported successfully, users will have the option to either continue or cancel the operation. Choosing "Cancel" will remove all imported parts, while "Continue" will allow the user to proceed with the job creation using the successfully imported parts.

Reasons for (Partial) Import Failure

Error

Potential Reasons

Solution

Error

Potential Reasons

Solution

Part Not Found

The Part ID from the CSV file could not be matched with any part in the MES.

Check whether indicated Part ID is correct.

Quantity Issue

The specified quantity cannot be imported (e.g., overquantity cannot be applied)

Check whether the indicated part has a sequence in the first workflow step.

Parsing Error

  • Not a valid CSV file

  • First column not formatted as expected

  • Encoding errors

Check all the prerequisites listed under “Prerequisites for the Magics CSV” above.

Empty File

The CSV file is empty

Check that your CSV file exported correctly.