SOLIDOS API - SolidosConnectNodes(upHandle, downHandle)
SolidosConnectNodes(upHandle, downHandle) - Connects a basin/device/sector to another basin/device/sector
- Input Parameters
- upHandle (Dynamo: String, Visual List: Entity Name) - the identifier of the upstream basin/device/sector that will be connected to the downHandle. basin/device/downstream sector
- downHandle (Dynamo: String, Visual List: Entity Name) - the handle of the basin/device/downstream sector
- Output (string) - a text message stating:
- "OK" - successful connection
- "InProxyState" - Civil 3D is in the ProxyState state. in proxy mode (current version of Civil 3D incompatible with the saved version of the DWG, or it was opened as pure AutoCAD)
- "NoConnectable" - not connectable
- "NoShortCut" - cannot connect external references
- "OtherNotExist" - the output device does not exist
- "NoLicence" - the license is not valid valid
- "IsSameObject" - items must be different
- "NeedDiferentType" - items must be different types (linear/point or point/linear)
- "NeedSameNetwork" - devices must be on the same network
- "NeedLinearDevice" - upstream or downstream is not a linear device
- "NeedPointDevice" - upstream or downstream is not a point device
- "NeedGravityNetwork" - device is not on a gravity network
- "NeedStartClosed" - linear device tip is not closed closed
- "LoopConnection" - the connection causes a loop
- "JustConnected" - they are already connected
- "OutIsConnected" - the downstream item is already connected to another device
- "InIsConnected" - the upstream item is already connected to another device
- Errors that may occur
- "InvalidUpHandle" - the handle of the upstream basin is invalid or is not a contributing basin
- "InvalidDownHandle" - the handle of the downstream item is invalid invalid or not a connectable item
Example of usage in Visual Lisp:
(setq device1 (handent "AD01")
device2 (handent "FC15"))
(setq msg (SolidosConnectNodes device1 device2))
;"Ok"
Example usage in Dynamo:
device1 = "AD01";
device2 = "FC15";
msg = SolidosConnectNodes(device1, device2);
#"Ok"