NCProgram Object

Derived from: OperationBase Object
Defined in namespace "adsk::cam" and the header file is <Cam/NCProgram/NCProgram.h>

Description

Object that represents an existing NC program.

Methods

Name	Description
classType	Static function that all classes support that returns the type of the class as a string. The returned string matches the string returned by the objectType property. For example if you have a reference to an object and you want to check if it's a SketchLine you can use myObject.objectType == fusion.SketchLine.classType().
copyAfter	Creates a duplicate of the operation in the tree after the given operation. Throws an exception if a not allowed copy operation is made for example copying a operation out of a setup.
copyBefore	Creates a duplicate of the operation in the tree before the given operation. Throws an exception if a not allowed copy operation is made for example copying a operation out of a setup.
copyInto	Creates a duplicate of the operation into the given container. You can only copy into containers, such as setups or folders. Copied operation will be copied at the end of all operations already in the container. Throws an exception if a not allowed copy operation is made for example copying a setup into a setup.
deleteMe	Deletes the operation from the document. In case of a setup or folder, all containing child operations will be deleted as well. Note: Child classes may overwrite this function and throw an exception if the object cannot be deleted.
duplicate	Creates a duplicate of the operation in the tree after the itself.
modifyUtility	Get ModifyUtility for the current operation by given utility type.
moveAfter	Move operation in tree after the given operation. Throws an exception if a not allowed move is made for example moving a operation out of a setup.
moveBefore	Move operation in tree before the given operation. Throws an exception if a not allowed move is made for example moving a operation out of a setup.
moveInto	Move operation in tree into the given container. This only works with setups, patterns and folders. Moved operation will be moved at the end of all operations already in the container. Throws an exception if a not allowed move is made for example moving a setup into a setup.
postProcess	Creates machine-specific NC code for this NC program.
updatePostParameters	Overrides the default post parameters of this NC program with the given user's input.

Properties

Name	Description
attributes	Returns the collection of attributes associated with this object.
error	Returns a message corresponding to any active error associated with the value of this parameter.
filteredOperations	Gets all valid operations derived from the operations property. The list is ordered with respect to the nc_program_oderByTool parameter and considers the number of instances in a setup.
fusionHubFolder	Gets and sets the DataFolder to which the exported files should be uploaded to if the parameter nc_program_postToFusionTeam is set to true. When a DataFolder is set, nc_program_postToFusionTeam is automatically set to true. An exception will be thrown if the DataFolder to set is not valid or not accessible. Depending on the FusionHubExecutionBehaviors used for the export the design may be saved at this location as well.
generatedDataCollection	Get the generated data associated with a given operation base instance. The type of data depends on the strategy type and might not be available for all strategy types. The available types can be found in GeneratedData.cs
hasError	Gets if errors were encountered when generating the operation.
hasWarning	Gets if problems were encountered when generating the operation.
isLightBulbOn	Gets if this operation is currently visible in the graphics window. Use the isLightBulbOn to change if the eye icon beside the operation node in the browser is on or not. Parent nodes in the browser can have their light bulb off which affects all of their children so this property does not indicate if the operation is actually visible, just that it should be visible if all of its parent nodes are also visible. Use the isVisible property to determine if it's actually visible.
isOptional	Gets and sets the "Optional" property value of the operation. Gets/sets true if the operation is optional.
isProtected	Gets and sets the "protected" property value of the operation. Gets/sets true if the operation is protected.
isSelected	Gets if this operation is selected in the 'Setups' browser.
isSuppressed	Gets and sets the "Suppressed" property value of the operation. Gets/sets true if the operation is suppressed.
isValid	Indicates if this object is still valid, i.e. hasn't been deleted or some other action done to invalidate the reference.
isVisible	Gets if this operation is currently visible in the graphics window. Use the isLightBulbOn to change if the eye icon beside the operation node in the browser is on or not. Parent nodes in the browser can have their light bulb off which affects all of their children. This property indicates the final result and whether this operation is actually visible or not.
machine	Gets and sets the machine of this NC program. When a machine is set, "use machine configuration" is automatically set to true. If this machine has a default post assigned, this post will be set for the NC program as well.
name	Gets and sets the name of the operation as seen in the browser. This name is unique as compared to the names of all other operations in the document.
notes	Gets and sets the notes of the operation.
objectType	This property is supported by all objects in the API and returns a string that contains the full name (namespace::objecttype) describing the type of the object. It's often useful to use this in combination with the classType method to see if an object is a certain type. For example: if obj.objectType == adsk.core.Point3D.classType():
operationId	Returns the id of the operation. This id is unique as compared to the ids of all other operations in the document. This id will not change when changing the order or parent of the operation. This id will remain valid when the document is saved and reloaded.
operations	Gets and sets the operations which will be included in the NC program. Valid input contains any number of operations, setups or folders. For setups and folders all child operations will be added. Operations will be post processed in setup order, with operations from the same setup grouped together. Setting the nc_program_orderByTool BooleanParameterValue on the parameters property to true will reorder operations across multiple setups to reduce the number of tool changes.
parameters	Gets the CAMParameters collection for this operation.
parentSetup	Gets the Setup this operation belongs to.
postConfiguration	Gets and sets the post configuration of this NC program.
postParameters	Gets the post parameters of this NC program.
strategy	Gets the name of the strategy associated with this operation.
warning	Returns a message corresponding to any active warning associated with the value of this parameter.

Accessed From

NCPrograms.add, NCPrograms.item, NCPrograms.itemByName, NCPrograms.itemByOperationId

Samples

Name	Description
Manufacturing Workflow API Sample	Manufacturing Workflow API Sample This sample script starts by creating a simple component which is then used to describe a milling workflow. It creates a setup, a few operations, pick some tools from a Fusion sample tool library using loops and queries and ends up post-processing the operations out using an NC Program.

Version

Introduced in version April 2023