Export Profile Field Definition

Field type	Determines the type of the document data exported by the selected Export profile field. The following types of document data could be exported: ATR CustomTools attribute Get value from the desired ATR CustomTools attribute. You can use your ATR CustomTools Properties that are on the Model, Part, Assembly and Revision scopes in the Export Profiles to retrieve the data from. NOTE: ATR CustomTools Attributes that are not associated with any ATR CustomTools Property on the supported scopes are not shown in the list. SOLIDWORKS property Get value from the SOLIDWORKS document property, such as the configuration name or the filename for example. See the following Field Data Options for the SOLIDWORKS Property Fields section on this help page for more information about the SOLIDWORKS property data available for the Profile fields. Value User defined static value. The user defined value applies the same for all items included in the exported model structure.
Field data	Select an attribute associated to the desired Property or, select a SOLIDWORKS property to retrieve the value from. A list of properties or attributes available in the Field data box is based on the properties source selected in the Field type box.
Label	Specifies the name for the field. Label is automatically defined based on the attribute name selected in the Field data box in case that the Label box is empty when you select the field data source from the Field data box. If the Label name is already defined before selecting the Field data attribute, the label does not get changed.
Value	If you have selected Value from the Field type box, type the desired field value here. This box is disabled when the selected Field type is ATR CustomTools attribute or SOLIDWORKS property.

Maximum length	Determines the amount of characters to be exported from the selected Export profile field. If the Export profile field value has more characters than defined in the Maximum length box, the exported field value is cut. Length of the field value is always counted from the beginning of the string. By default the Maximum length is unlimited.
Compulsory field	Select this option to make the field required. If the field has been set as compulsory, every item in the structure must have a value in the property used in the compulsory field.

All ATR CustomTools attribute field types can be set as numeric fields. ATR CustomTools Export can interpret a large variety of different numeric strings into a decimal value. For example, all following numbers are detected to be exactly the same:

• 123,456,789.123
• 123 456 789.123
• 123,456,789.123
• 123'456'789.123
• 12,34,56,789.123
• 123456789.123
• 123 456.789,123
• 123 456 789,123
• 123456789,123
• 123456789 123/1000

More common cases are:

• 1234.123
• 1234,123
• 1234 3/4
• 1234 ¾
• 1234'56¾"

In addition to arbitrary fractional representations, ATR CustomTools can detect the following fractional unicode characters, with or without leading whole number: ½ ⅓ ⅔ ¼ ¾ ⅕ ⅖ ⅗ ⅘ ⅙ ⅚ ⅐ ⅛ ⅜ ⅝ ⅞ ⅑ ⅒. It's also possible to create wild fractional compositions that look similar and support all numbers (e.g. ¹²³⁄₄₅₆) using unicode, however, those unicode compositions are not supported by ATR CustomTools.

No other text is allowed in numeric fields, with following exceptions:

• Preceding sign +/- is allowed. There can be arbitrary amount of space between the sign and the number.
• Feet-inches (e.g. 2'24 3") MUST have the unit character for both the feet (') and the inches ("). When feet-inches is in raw decimal format, its value is shown in inches.

Field Contains:	Text: No special treatment will be applied for the field. Numeric value(s): ATR CustomTools attempts to detect numeric values in the field. Precision/divisor and locale settings will be applied. Mass value(s): ATR CustomTools attempts to detect numeric values in the field and considers them to be mass values. Knowing the document unit, ATR CustomTools can convert the mass to configured target unit. Precision/divisor and locale settings will be applied. Length value(s): ATR CustomTools attempts to detect numeric values in the field and considers them to be length values. Knowing the document unit, ATR CustomTools can convert the length to target unit set. Precision/divisor and locale settings will be applied. NOTE: If the field value is a concatenation of linked CustomProperty values such as dimensions, ATR CustomTools Export attempts to apply its numeric detection for each linked value individually. This makes it possible to convert also combinations having e.g. linked width and length dimensions in the same CustomProperty (e.g."Steel Sheet" <Width>x<Length>")
Convert To:	Target unit to convert the numeric value in the field. Depends on Field Contains selection. Text -field: Not available. Numeric value(s) -field: Not available. Mass value(s) -field: Milligrams, Grams, Kilograms, Pounds. Length value(s) -field: Millimeters, Centimeters, Meters, Inches, Feet, Feet-inches, Angstroms, Nanometers, Microns, Mils, Microinches.
Use fractional representation	Enable to round the decimal number into the nearest fraction, which divisor is set using the Divisor option. Locale setting only applies to the possible whole number preceding the fraction. Disable to use decimal representation. NOT supported for Material Quantity field type.
Precision	-1 to not do any decimal rounding. 0 for no decimals at all; up to 15 decimal precision. Only available when Use fractional representation is disabled.
Divisor	Round the number to nearest fraction, which divisor is set by this option. Valid values are from 2 to 1000. For example, 6.5 with divisor 2 would be 6 1/2 and with divisor 10 it would be 6 5/10. Only available when Use fractional representation is enabled.
Locale	The Locale ID used for converting the decimal number back into text. For example: <empty> The default setting: Dot (.) as decimal separator and thousands not separated. All written together with possible preceding minus sign. 123456789.123 en-US or en-GB Dot (.) as decimal separator and thousands separated with a comma (,). 123,456,789.123 fr-FR Comma (,) as decimal separator and thousands separated with a space ( ). 123 456 789,123

You can retrieve the latest revision information of your SOLIDWORKS documents to the structure export by using the ATR CustomTools Revision Properties in your Export Profile.

To read values from the ATR CustomTools Revision Properties properly in structure export, include your model scope Revision property in your Export Profile. In addition to that, you can include your ATR CustomTools Revision Properties in your Export Profile to retrieve more details of the document's latest revision in the structure export.

You may add SOLIDWORKS Property data of your SOLIDWORKS documents to the Export Profile to be included in the output. The following table explains the SOLIDWORKS Properties available for use in the ATR CustomTools Export Profiles.

Configuration	The Configuration property retrieves the referenced configuration name from the SOLIDWORKS document. If several configurations of the same SOLIDWORKS document are being used in your model structure, each instance of the component in the structure shows the configuration name referenced by the associated structure item.
Filename	The Filename property retrieves the complete path and filename of the SOLIDWORKS document referenced in the model structure.
Item Number	The Item Number property gets the item's identifier number based on the context it is being used in. If the component is located in a sub-assembly of your bigger model structure, the Item Number property's value refers to the component's identifier number in a sub-assembly where it belongs to.
Material Quantity	Material Quantity equals total number of instances multiplied by the BOM Quantity associated to the component in the structure. The Material Quantity refers to the amount of material needed to produce for example a sheet metal component referenced in the model structure. Please notice that the Accumulate quantities option in the Export Profile's settings affects the quantity retrieved by this type of Field data. You may define the Property used as BOM Quantity in ATR CustomTools, in the Properties options of your ATR CustomTools Profile.
Part Number	The Part Number property retrieves the associated model configuration's display name defined by the Part number displayed when used in a bill of materials option in SOLIDWORKS model's configuration Properties. Please refer to the SOLIDWORKS documentation for more information and guidance about the model configuration properties.
Quantity	The Quantity property retrieves the total number of instances of the associated component used in your model structure. When you use the Quantity property, please notice that the Accumulate quantities option in the Export Profile's settings affects the quantity retrieved by this type of Field data.
Type	By the Type property you can retrieve the type of the SOLIDWORKS document used in your model structure. The document types are presented by their file extension in the Export dialog box in a field which Field data is Type.

Message	Problem description	Solution
Field for specified label already exists	The label specified in the Label box is already used by another export profile field.	Type another label for the specific field.

• Export profiles
• ATR CustomTools database attributes
• Manage your revision scope properties in the Revision Properties options
• Manage your model scope properties in the Model Properties options
• Setup the Properties used as BOM Quantity in the Properties options