Importing Parts and Assemblies from Onshape

Overview

This page gives instructions for importing parts and assemblies from a user's Onshape account directly into our application.

Integrating Your Account

  • Click on the Geometries Tab on the left.
  • Click on Parts
  • Click on the Cloud icon.
  • Click the text "Click Here to Integrate your Onshape Account". You will then be redirected to a page that will prompt you for your Onshape account login.
  • Enter your Onshape credentials, then click "Give Access". You will automatically be redirected back to the app.

Once you are redirected, follow the directions for "Selecting a Document" below.

Selecting a Document

  • Change the drop down box to select the document that you want to import Parts/Assemblies from. If you are not sure which document to choose, click the "Click here to open [your document name] in Onshape" link to see the document in a new tab.
  • Once you select your document, all of your Parts/Assemblies will be shown in a drop down menu.

Note: If you would like to import parts from multiple Onshape documents, simply repeat this process for each of the documents (select a document, import the parts/assemblies desired, then when the page reloads, select another document).

Selecting a Part

  • Select the name of the part that you wish to import in the dropdown box (if you only want to import an Assembly, skip to the next section). If you have multiple tabs within one Onshape document, this dropdown box will contain all of the parts from all of the tabs in your document.

Note: If you would like to import multiple parts (either from the same document, or from different documents), either repeat this process, or import them as an Assembly following the steps below. For instructions on how to create an Assembly of parts in Onshape, see https://cad.onshape.com/help/Content/assembly.htm.

Note: Meshes cannot be imported directly from Onshape, so they will not appear as options in the select drop down box. If you would like to import a mesh, you can upload the mesh file directly in the parts-manager tab of the app.

  • Do not fill in any of the values except for the Units.

Field Descriptions:

  • Scale: Number, used as the scale for measurements. Default if not supplied is 1.0.
  • Angle Tolerance: Number, represents the angle tolerance. Note that the value must be less than pi/2, and must be in radians. If not provided, no angle tolerance is applied to the part.
  • Chord Tolerance: Number, represents the chord tolerance. If not provided, no chord tolerance is applied to the part.
  • Min Facet Width: Number, represents the minimum facet width. If not provided, no minimum facet width is applied to the part.
  • Max Facet Width: Number, represents the maximum facet width. If not provided, no maximum facet width is applied to the part.
  • Units: select a base unit for the part. If not selected, Onshape will determine the unit of the part for you. Choosing incorrect units will cause the import to fail.

3. Click "Import Part". A success popup alert will appear when the import is finished. Click "OK", then you can import additional parts/assemblies if desired, or navigate back to the parts-manager tab to see the imported parts.

Note: After navigating to the parts-manager tab, you may need to refresh the page to get the imported parts to show up.

Importing Assemblies

  • Select the desired assembly in your Onshape document from the drop down menu. For instructions on how to create an Assembly in Onshape, see https://cad.onshape.com/help/Content/assembly.htm.
  • Click "Import All Parts From Assembly" to import it. A success popup alert will appear when the import is finished. Click "OK", then navigate back to the parts-manager tab.

Note: Large assemblies will take a few minutes to import.

Note: After navigating to the parts-manager tab, you may need to refresh the page to get the imported parts and the assembly to show up. The parts from the assembly will show up under "Parts" on the left, and the imported assembly will show up under "Assemblies" on the right.

Troubleshooting

Note: If the part that you selected appears in red inside your document in Onshape, and says "contains faulty topology" when you hover over it, please go to Onshape and fix the issue before attempting to import it into the app. The import will fail until the topology is fixed. An example of this is shown in the picture to the left.

  • If you see the this text instead of select boxes, it means that your document does not have any parts (or the parts are all meshes).
  • If you see this box, you most likely entered incorrect values in the optional fields mentioned above under "Importing Parts". Please verify these and try again.
  • If you did not enter any optional values, check your part in Onshape to ensure that it is not faulty, or a mesh.

If you still cannot diagnose the problem, send us an email at app-support@totalsim.us and we will take a look at your part.

  • If you see this pop up box, it likely means that it has been over 1 hour since you first integrated your Onshape account through the app. To fix it, simply click "OK", then after the page reloads, click "Click Here to Integrate Your Onshape Account".

If you encounter any other errors while importing your part, send us an email at app-support@totalsim.us with information about the problem, and we will get back to you.