Book a Demo

Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.

Prev Next

The AddNew Function

The AddNew() function is used widely across the API to add new objects to a Collection. In all cases you must provide a Name and Type argument, but what these arguments are used for depends on the actual collection being accessed. For example, when adding a new element to the Elements collection, the 'Type' string can be either a basic UML element type or a fully qualified element type (stereotype) defined by a profile, such as SysML::Requirement differentiated from a standard requirement.

AddNew Attribute Arguments

This table provides guidance in specifying the AddNew arguments for each of the object attributes.

Attribute

Arguments

See also

AttributeConstraints

Name - The name of the constraint.

Type - The constraint type

Attributes

Name - The name of the attribute.

Type - The attribute type.

AttributesEx

Name - The name of the attribute.

Type - The attribute type.

AttributeTags

Name - The fully-qualified name, or plain text.

Type - The value of the Tagged Value.

Authors

Name - The author name.

Type - The author role.

Clients

Name - The client name.

Type - The client role.

ConnectorConstraints

Name - The name of the constraint.

Type - The constraint type.

ConnectorConveyedItems

Name - The GUID of an element.

Type - Not used.

Note: This does not return an object.

Connectors

Name - The name of the connector.

Type - The connector type (for example 'Realization').

ConnectorTags

Name - The fully-qualified name, or plain text.

Type - The value of the Tagged Value.

Constraints

Name - The name of the constraint.

Type - The constraint type.

ConstraintsEx

Name - The name of the constraint.

Type - The constraint type.

CustomProperties

You cannot create these.

DataTypes

Name - The datatype name.

Type - The datatype type.

DiagramLinks

Name - Not used.

Type - The style string (such as 'l=200;r=400;t=200;b=600;')

(You might prefer to leave the Type empty and use the Functions on this interface for size, colors and so on).

DiagramObjects

Name - This can either be an empty string, or it can specify the initial Left, Right, Top and Bottom values for the new DiagramObject. For example:

     diagram.DiagramObjects.AddNew("l=200;r=400;t=200;b=600;", "")

Note: Top and Bottom values should be specified here as positive numbers, but will be set in the repository as negative values.

Type - Unused.

Diagrams

Name - The name of the diagram.

Type - This can be either a standard UML metaclass type (such as 'Class' or 'UseCase') or a fully-qualified metatype defined by an MDG Technology (such as 'BPMN2.0::BusinessProcess' or 'SysML1.4::Block').

Efforts

Name - The name of the effort.

Type - The effort type.

Elements

Name - The name of the new element. If the repository has an auto-name counter defined for the element type being created, pass an empty string to use the auto-name counter instead.

Type - Can be either a standard UML metaclass type (such as 'Class' or 'UseCase') or a fully-qualified metatype defined by an MDG Technology (such as 'BPMN2.0::BusinessProcess' or 'SysML1.4::Block').

Files

Name - The full pathname of the file.

Type - The file type (such as 'Local File' or 'Web Address').

Issues

Name - The name of the issue.

Type - The problem type, (such as 'Issue' or 'Defect')

MethodPostConditions

Name - The name of the constraint.

Type - The constraint type

MethodPreconditions

Name - The name of the constraint.

Type - The constraint type.

Methods

Name - The name of the method.

Type - The return value of the method.

MethodsEx

Name - The name of the method.

Type - The return value of the method.

MethodTags

Name - The fully-qualified name, or plain text.

Type - The value of the Tagged Value.

Metrics

Name - The name of the metric.

Type - The metric type.

Models

Name - The name of the model.

Type - Unused.

Packages

Name - The name of the Package.

Type - Unused.

Parameters

Name - The parameter name.

Type - The parameter type.

ParamTags

Name - The fully-qualified name or plain text.

Type - The value of the Tagged Value.

Partitions

Name - The partition name.

Type - The partition note.

ProjectIssues

Name - The name of the issue.

Type - The issue type (such as 'Request', 'Defect', or 'Release')

ProjectResources

Name - The resource name.

Type - The resource role.

ProjectRole

Name - The role name.

Type - Not used.

PropertyTypes

Name - The tag name.

Type - The description (limited to 50 characters).

Requirements

Name - The name of the requirement.

Type - The requirement type.

RequirementsEx

Name - The name of the requirement.

Type - The requirement type.

Resources

Name - The resource name.

Type - The resource role.

Risks

Name - The name of the risk.

Type - The risk type.

ScenarioExtension

Name - The extension name.

Type - The scenario type

ScenarioStep

Name - The step name.

Type - The ScenarioStep type value.

Scenarios

Name - The name of the scenario.

Type - The scenario type.

Stereotypes

Name - The stereotype name.

Type - The element this applies to.

Note: You can only support multiple elements from within a Profile.

Tasks

Name - The task name.

Type - The task type.

TemplateBindings

Name - The formal name of the binding.

Type - The actual name of the binding or element GUID.

TemplateParameters

Name - The parameter name.

Type - The parameter type

Terms

Name - The term name.

Type - The term type.

Tests

Name - The name of the test.

Type - The test type.

Transitions

Name - The transition name.

Type - The transition value.