CreateFunctions Method (DeviceService)

In This Topic

Creates new functions for a new or existing DT according to a particular numbering pattern. This functionality is only available for particular functions (terminals, pins, coil and relay contacts, device, and PLC connections and busbars). Depending on the selected function definition, the numbering pattern defines either terminal, contact, or connection point designations.

Syntax

C#
C++/CLI

public bool CreateFunctions( 
   Project oProject,
   string strFullDeviceTag,
   string strNumberingPattern,
   FunctionDefinition oFuncDef,
   int nNewTerminalDevicePosition,
   int nNewTerminalSortCode,
   bool bMultilevelTerminals,
   int nNumberOfLevels,
   bool bNumberByLevels
)

public:
bool CreateFunctions( 
   Project^ oProject,
   String^ strFullDeviceTag,
   String^ strNumberingPattern,
   FunctionDefinition^ oFuncDef,
   int nNewTerminalDevicePosition,
   int nNewTerminalSortCode,
   bool bMultilevelTerminals,
   int nNumberOfLevels,
   bool bNumberByLevels
)

Parameters

Parameter Name	Description
oProject	The project in which the new function will be created.
strFullDeviceTag	The full DT to which the function will be assigned
strNumberingPattern	This parameter defines the numbering patern
oFuncDef	This parameter defines the function definition used for the new functions
nNewTerminalDevicePosition	This parameter defines terminal's device position. It is applicable if the function to be created is terminal or plug
nNewTerminalSortCode	This parameter defines terminal's sorting order. It is applicable if the function to be created is multilevel terminal.
bMultilevelTerminals	If this parameter is set to true, it means multilevel terminals are formed
nNumberOfLevels	This parameter defines how many levels each generated multi-level terminal has.
bNumberByLevels	If this parameter is set to true, the terminals are numbered by level. If set to false, the terminals are numbered by terminal.

Exceptions

Exception	Description
System.ArgumentException	Is thrown in case of invalid arguments.
System.ArgumentNullException	Is thrown, if some of the arguments are NULL.
System.ApplicationException	A necessary internal interface for creating devices could not be created.
Eplan.EplApi.Base.BaseException	If an error occurred while creating a device.

Reference

DeviceService Class
DeviceService Members

Use the Eplan Global Support Portal for feedback and support