Occurrences.addNewExternalSheetMetalComponent Method

Description

Method that creates a new occurrence by creating a new external sheet metal component (X-Ref) that is not saved yet. This is similar to addNewExternalComponent but the resulting component will have the design's active sheet metal rule applied, which defines the thickness, bend radius, K factor, gap, and relief parameters for sheet metal features. The component will be saved automatically when the parent assembly is saved.

Syntax

Python
C++
TypeScript 🧪

"occurrences_var" is a variable referencing an Occurrences object.

returnValue = occurrences_var.addNewExternalSheetMetalComponent(componentName, targetFolder, transform)

"occurrences_var" is a variable referencing an Occurrences object.

#include <Fusion/Components/Occurrences.h>

returnValue = occurrences_var->addNewExternalSheetMetalComponent(componentName, targetFolder, transform);

"occurrences_var" is a variable referencing an Occurrences object.

returnValue = occurrences_var.addNewExternalSheetMetalComponent(componentName, targetFolder, transform);

Return Value

Occurrence

Returns the newly created occurrence or null if the creation failed. The component referenced by the occurrence can be edited but is not saved until the parent assembly is saved.

Parameters

componentName

string

The name for the new external sheet metal component.

targetFolder

DataFolder

The DataFolder where the component will be saved when the parent assembly is saved.

transform

Matrix3D

A transform that defines the location for the new occurrence.

Samples

Create Sheet Metal Component Sample

Demonstrates creating new sheet metal components programmatically, covering both the local case (Occurrences.addNewSheetMetalComponent) and the external / X-Ref case (Occurrences.addNewExternalSheetMetalComponent). Each method takes a SheetMetalRule (picked from the library) and a transform.

Type	Description
Occurrence	Returns the newly created occurrence or null if the creation failed. The component referenced by the occurrence can be edited but is not saved until the parent assembly is saved.