/
Configuring the File Naming Format of Downloaded 3d Files

Configuring the File Naming Format of Downloaded 3d Files

On the 3YOURMIND platform, you can download .stl files from various locations. You have the option to customize the file naming format of the downloaded files.

The file naming format for all 3D files that you download across the platform can be configured in the admin panel at Partner > Fulfillment Partners in the section Advanced Options. The field File naming format can be used to define the format of downloaded 3d files.

To define the format a a custom syntax is available. The default template expression for file naming is
:order_number:-:sequence_number:-:name: .

However, you can create a custom template expression that uses pre-defined markers of your choice. These markers will later be replaced by our templating engine to generate the final file name.

Below is a list of available markers that you can use to create your custom template expression.

Marker

Description

Marker

Description

:name:

Name of the part

:quantity:

Number of units ordered

:material:

Name of the material if one is configured

:part_id:

The id of the MES part, if one is known. Otherwise it is set to Unknown

:order_number:

When downloading .stl files from the MES Part detail view or from the Order detail view:

  • order project number + stage + order sequence number

Otherwise:

  • order project number

For more info, please refer to the Sales Transaction Naming Structure

:order_reference:

When downloading .stl files from the MES Part detail view or from the Order detail view:

  • The reference provided when creating the order

Otherwise:

Unknown

See also https://3yourmind.atlassian.net/wiki/spaces/PD/pages/1509425157/Creating+and+Editing+Quotes+as+a+Service#Step-3%3A-you-can-specify-a-reference-(optional)

:order_created_by:

Full name of the user who created the order, e.g.
John Doe

:sequence_number:

The index number appended to the of each request, quote or order

In addition to the described syntax the suffix “_original” or “_optimized” will be added to the file name, depending on whether you select download the original 3d model or the optimized 3d model.

The optimized 3d model will always have the .stl extension, the original 3d model will have the extension in which the file was originally uploaded.

Example

Here is an example of how a custom template expression can be used to generate a file name. If you configure the setting with the expression

:name:---:order_number:---:sequence_number:---:order_created_by:

the generated file name could look like this:

  • Download original: transport_sprocket_wheel---100456---5---john_doe_original.step

  • Download optimized: transport_sprocket_wheel---100456---5---john_doe_optimized.stl