Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Application Server

Rename an Object

  • Last UpdatedMay 20, 2022
  • 2 minute read

You can rename an object. Although you can change an object’s containment relationship with another object, you cannot directly rename an object’s hierarchical name. You can rename its tagname and contained name, and its hierarchical name will change automatically. See Rename Contained Objects for more information about renaming contained objects.

Object names must be unique within each namespace, not within the Galaxy.

  • Template names can be up to 32 alphanumeric characters, including the required $ as the first character. The second character cannot be $ and the name must include at least one letter. You cannot use spaces in an object name.

  • Instance names can be up to 32 alphanumeric characters. You cannot use $ as the first character. The name must include at least one letter. You cannot use spaces.

    Note: You cannot use the following reserved names for objects: Me, MyContainer, MyArea, MyHost, MyPlatform, MyEngine and System.

An object can have three kinds of names if it is contained by another object. The three names include:

Name

Description

Tagname

The unique name of the individual object. For example, Valve1.

Contained name

The name of the object within the context of its container object. For example, the object whose Tagname is Valve1 may also be referred to as Tank1.Outlet, if Tank1 contains it and it has the contained name "Outlet".

Hierarchical Name

Hierarchical names are fully-qualified names of contained objects that include the name of the objects that contain it.

Because the object that contains it may also be contained, there are potentially multiple hierarchical names that refer to the same object.

For example, if:

"Reactor1" contains Tank1 (also known within Reactor1 by its contained name "SurgeTank").

"Tank1" contains Valve1 (also known within Tank1 by its contained name "Outlet").

Valve1 could be referred to as:

"Valve1"

"Tank1.Outlet"

"Reactor1.SurgeTank.Outlet".

When you rename an object, references from other objects to the object being renamed can be broken. Objects deployed with broken references receive bad quality data during run time.

Note: Some objects may refer to themselves or to parent/host objects up in the parent/child hierarchy. References that go up or down the hierarchy to refer to other objects are called relative references. Objects with relative referencing are updated automatically if you rename them.

After renaming, all IDEs connected to the Galaxy show the new object name.

To rename an object’s tagname

  1. Select the object you want to rename.

  2. On the Home ribbon, in the Edit area, select Rename.

  3. Type the new name for the object.

  4. When you are done, press Enter.

Related Links
TitleResults for “How to create a CRG?”Also Available in