Skip to content
info
Note: Zea Parts documentation is currently a work in progress and is being actively developed. Some sections may be incomplete or subject to change. We appreciate your understanding and patience as we work to provide the most accurate and comprehensive information.

What is Zea Parts

An introduction to the Zea Parts app for creating interactive 3D spare parts catalogs.

Overview

Zea Parts is an app on the Zea platform that leverages your 3D models to create and maintain 3D parts catalogs, providing an intuitive 3D interface for users to find parts.

Purpose of Zea Parts

Automated Catalog Generation: Zea Parts uses your 3D models to quickly generate and update 3D parts catalogs, minimizing manual effort and ensuring accuracy.
zea-parts-03.png
Intuitive 3D Interface: The published catalog offers a user-friendly 3D interface, allowing customers to easily find parts, add them to a shopping cart, and request a quotation from your service center.
zea-parts-02.png

Core Concepts

To create a parts catalog in Zea Parts, you need to import various types of data using Zea Sync. This data will be used to map service parts to 3D models, specify which parts are sellable, and provide necessary information to the customer.

Zea Sync

Zea Sync is a desktop app that allows you to sync your data to the Zea Platform.
Learn more

3D Models

Sync a folder of 3D CAD files to the Zea Platform for web visualization. These 3D models will be mapped to service parts listed in the Master Parts List or Bill of Material (BOM).
Learn more

Master Parts List

A Master Parts List is a single spreadsheet containing a list of all serviceable parts. Each row in the spreadsheet represents a service part that needs to be mapped to at least one 3D model. The Master Parts List can also contain other data such as descriptions.
When importing a Master Parts List, Zea Parts will generate a BOM dynamically using the hierarchy defined in your 3D models. The tree it generates will closely match the tree defined in the 3D model inspector.
Learn more

Service Bill of Materials (SBOMs)

An SBOM is a list of parts specific to a manufactured product and includes information on all parts in an assembly, up to the root assembly. Multiple SBOMs are imported as a folder of spreadsheets, one for each manufactured product, and can include other data such as descriptions. If the same part appears in multiple SBOMs, it will not be duplicated across the system; instead, Zea Parts uses a single instance of the part.
Importing BOMs provides three main benefits:
Provide an Explicit Structure:
An SBOM allows you to control the structure of the BOM shown to customers.
Display Non-3D Items in Your SBOM:
The SBOM can specify any part to be shown in the tree, even parts without associated 3D models or parts that have 3D models but are not part of the same assembly (e.g., peripheral items included in the box with the product).
Control the Loading of 150% CAD Models:
Some manufacturers provide multiple variations of a product in a single CAD model and hide/show various options to display a specific configuration. The BOM for a specific product should specify exactly which options were included when manufacturing the product. The BOM loaded into Zea Parts can control the loading of these configurations.
Learn more

Serial Numbers

Serial numbers uniquely identify manufactured products. By importing a spreadsheet of serial numbers and associated serviceable parts, users can search for specific items based on their serial numbers, ensuring precise identification of parts and assemblies within the 3D parts catalog.
Learn more

Attachments

Attachments are additional files, such as manuals, images, and technical documents, that can be uploaded and mapped to serviceable parts. These attachments provide users with more detailed information about the parts, enhancing the usability and value of the 3D parts catalog by offering comprehensive documentation and resources. Attachments use rules to match filenames to parts, ensuring that the correct files are associated with each part.
Learn more

Related Articles

Import Master Parts List
Import Service Bill of Materials (SBOMs)

Importing a Master Parts List


Importing Service Bill of Materials (SBOMs)


Mapping Optional Fields

Map Optional Fields in Master Parts List and SBOMs.

Overview

These examples will help you understand how to set up various optional fields in the Master Parts List and Service Bill of Materials (SBOMs).

Add a Public ‘Description’ Field

Next we want to add a new public ‘Description’ field so our customers can identify parts easier.
Click the New button.
Leave the type as String and click Create.
If you want the field to be available in the published catalog, toggle Public to On.
This will create multiple Imported Fields with a corresponding language depending on how many languages you have set up.
Name your field.
Select the Imported Field containing the Description.
Select the corresponding Language.

Add a Public ‘Price’ Field

The final field need is Price.
Click the New button.
Change the type to Number and click Create.
If you want the field to be available in the published catalog, toggle Public to On.
Numbers do not have a language.
Name your field.
Select the Imported Field containing the Price.

Add a Private ‘Notes’ Field

Now that we have a public field, let’s create a private field for internal notes. This will be only be displayed to users of your Organization who are logged in.
Click the New button.
Leave the type as String and click Create.
If you want the field to remain private, leave the Public toggle to Off.
When a field is private you do not need to set a language.
Name your field.
Select the Imported Field containing the Notes.

Related Articles

Import a Master Parts List
Import Service Bill of Materials (SBOMs)

Importing Serial Numbers


Importing Attachments

Import Attachments into Zea Parts.

Overview

Attachments are additional files, such as manuals, images, and technical documents, that can be uploaded and mapped to serviceable parts. These attachments provide users with more detailed information about the parts, enhancing the usability and value of the 3D parts catalog by offering comprehensive documentation and resources. Attachments use rules to match filenames to parts, ensuring that the correct files are associated with each part.

Open the Zea Sync Desktop App

Launch the Zea Sync app on your desktop.
Log in if required, and select the Organization and Workspace where you want to set up your parts catalog.
Choose Attachments from the options.

Select Your Folder

The Attachments Settings dialog will open the first time you enter (if it does not open, click ⚙️ in the top right).
Click on the Select folder button.
Browse to the location of the folder containing your attachment files and select it.
image.png

Explore the Interface

A) Toolbar

Refresh folder button: Useful if you have made changes in your local folder.
Statistics: Displays the status of files.
Filter: Select an option to filter the file list.
Synchronize button: Click this button to sync to the Zea Platform.
Settings button: Access the Attachment settings.

B) File List

This is a list of all the files in your selected folder and if they are processed or not.

C) Preview

A preview of the selected file.
image.png

Process Your Attachments

Click the Synchronize button
The files will process one at a time and change to a ⚙️ Processing state.
If everything is correct, the file will change to a ✅ Processed state.
If there are issues with mapping, the file will show an ❎ Error state.
If you make changes to the source spreadsheets of processed files they will display as Processed and Modified state. In this case you may re-process the SBOMs if the change was intentional.

View Your Attachments

Go to the Zea Platform and navigate to the Workspace that you synced your parts to.
Here you can see statistics for how many attachments have been synced and the total file size.
Click on Zea Parts in the Workspace Dashboard.
Click on the ATTACHMENTS tab in the top left.
image.png
image.png

Fixing Attachment Mapping

When your Attachment filenames do not completely match your Service Part Numbers, you may find that Attachments are missing from files. Zea Parts offers tools that use regular expressions (regex) to help remedy this.
In this simplified example, our Service Part Number is a simple 4-digit number and our PDFs have “-manual” at the end. We will use Replacements to remove the extra text.
image.png
Go to Zea Parts on the Zea Platform.
Click on Settings and go to the ATTACHMENTS MAPPING tab.
Enter the Part Number and Filename that you wish to match.
In our case, they are 2027 and 2027-manual.pdf
You can see in the Replacement if the default regexes are creating a match.
Since they are not we want to Add Filename Replacement and add the regex /[A-Za-z]/g which will remove all letters.
Scroll down to the bottom of the page and you will see that the Final Match is correct.
Loading…

Outline

Core Concepts

Each row in the spreadsheet is a service part and it needs to be associated with at least one 3D model. Once published, users will be able to input a part number or serial number, view the model in 3D, add parts to the shopping cart, and send an email directly to your service center for quotation.

Importing Part Data
Open Zea Sync (Admin only)
Explain the differences between the 4 buttons.
Master Parts List
Bill of Material (BOM)
Serial Numbers
Attachments
Importing a Master Parts List
Introduction to mapping from the Spreadsheet rows to CAD Files.
Engineering Part Number vs Service Part Number
Adding Additional Fields
Strings vs Numeric Values
Configuring Languages
Public and private fields
Mandatory/optional fields
Sample spreadsheet
Importing a Bill of Material
Importing serial numbers
Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.