Naming Conventions

<< Click to Display Table of Contents >>

Navigation:  IMS version 22.6 & 22.9 > IMS Basics - User Guide 22.6 & 22.9 >

Naming Conventions

Naming conventions in IMS can be setup for the following entities:

 

Circuit                (Setup in Speed)

 

01-01-NameGeneratorSpeed

 

There are 2 name generators. The first one called CircuitNameTemplate is applied during the standard method of creating a Circuit instance. The second one called CableConnectNameTemplate is applied during the right mouse option on ports (Cable Connect) - typically on DDF/ODF ports connecting to each other or out to other types of equipment.

 

See the section below called Cable Connect Name Template below for example details.

 

OloCircuit        (Setup in OloCircuitType)

 

01-02-NColoCctTypes

 

DdfOdf        (Setup in DdfOdfDefinition)

 

01-03-NCDDFODF

 

 

Node                (Setup in EquipmentDefinition)

 

01-04-NCnode_equipDef

 

 

Order                (Setup in OrderType)

 

01-05-NCorderNameTemplate

 

PlannedWork         (Setup in PwCategory) 

 

01-06-NCplannedWorkCategory

 

 

Site                         (Setup in SiteType)

 

01-07-NCsiteType

 

 

 

 

More naming convention details:

 

All properties of the entity can be used in the naming convention

 

Sequential Numbers setup

 

[NUM:4:100:7:700:1]

                        4        =LENGTH OF THE NUMBER STRING.

                        100        =START OF THE RANGE. (OPTIONAL)

                        7        =SIZE OF THE STEP WITHIN THE RANGE. (OPTIONAL)

                        700        =END OF THE RANGE. (OPTIONAL)

 

for site-related objects

1=0 OR 1          0=COUNT PER SITE (Default)

1=CONTINUOUS COUNTING (OPTIONAL)

or

 

for city-related objects

1=0 OR 1          0=COUNT PER CITY (Default)

1=CONTINUOUS COUNTING (OPTIONAL)

or

 

for definition-related objects

1=0 OR 1              0=COUNT PER DEFINITION (Default)

1=CONTINUOUS COUNTING (OPTIONAL)

or

 

for customer-related objects

1=0 OR 1          0=CONTINUOUS COUNTING (Default)

1=COUNT PER CUSTOMER (OPTIONAL)

 

Current date can be used

 

[DATEformat]

format can be like yyyy-MM-dd    

 

Check for all options at ...

https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings)

 

 

All data not between brackets is considered a fixed string

 

Examples:

 

Site:          [CITY.NAME]-[NUM:3]

A new site in London city will be created like LONDON-001

 

Site:           Tower-[CITY.NAME]-[NUM:3:100]

A new site in London city will be created like Tower-LONDON-100

 

 

Standard Naming Convention Override

 

The standard naming convention rules can be bypassed by putting double brackets around an entity:

 

Example

 

[[AUTH [NUM:5:20000:1:90000]]] [PROPERTYNAME] [NAVIGATIONPROPERTY.PROPERTYNAME] [EXTRAFIELDGROUPNAME.EXTRAFIELDNAME] [NAVIGATIONPROPERTY.EXTRAFIELDGROUPNAME.EXTRAFIELDNAME]

 

Explanation

 

[[

= Start part of the name that needs to be unique

]]

= End part of the name that needs to be unique

AUTH

= Plain text

 

[NUM:5:20000:1:90000]

= Number to be generated. In this case a number of 5 digits with    a start range of 20000, increment by 1 and an end range of 90000

[PROPERTYNAME]      

= property of the entity

[NAVIGATIONPROPERTY.PROPERTYNAME]

= property of upper navigation property  [CUSTOMER.NAME]

[EXTRAFIELDGROUPNAME.EXTRAFIELDNAME]

= extra field of entity.

[NAVIGATIONPROPERTY.EXTRAFIELDGROUPNAME.EXTRAFIELDNAME]

= extra field of upper navigation property

[CUSTOMER. EXTRAFIELDGROUPNAME.EXTRAFIELDNAME]

 

 

Regarding the second last option (extra fields); these are not available yet when the entity is created, so first create the entity, then enter the extra field values and then update the name.

 

Entities for which this applies:

 

Site

Node

DdfOdf

Plannedwork

Order

Circuit

OloCircuit

 

 

Cable Connect Name Template

 

Some examples are given below on what can be used to formulate a naming convention.

 

A complete example:

 

[FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.SHELFANDPATCHPOINTNAME][FROMPORT.PORTNAME.NAME]-[FROMDDFODF.NAME][FROMNODE.NAME]-[TODDFODF.NAME][TONODE.NAME]-[SPEED.NAME]-[NUM:3:1:1:10000:0:0:0:0]

 

Further options:

 

When [FROMDDFODF.NAME][FROMNODE.NAME] is added to the template, IMS will automatically detect if it is a node or distribution frame 

 

It is also possible to use [TOPORTORPOSITION] or [FROMPORTORPOSITION] in the nametemplate, IMS will automatically get the portname or ddfodfpositionname based on the given type when having both in the template.

 

It is also possible to use [FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.NAME][FROMPORT.PORTNAME.NAME] , IMS It will automatically get the portname or ddfodfpositionname based on the given type when having both in the template. 

 

With [FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.NAME] and [FROMPORT.PORTNAME.NAME] you have more available options as follows:

 

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.SITEANDDDFNAME

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.SHELFANDPATCHPOINTNAME

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.SHELFANDPATCHPOINTNAMEINCLFREEOROCCUPIED

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.FREEOROCCUPIED

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.FULLNAME

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.FULLNAMEINCLFREEOROCCUPIED

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.SHELFSEQUENCE

FROMDDFODFPOSITION.DDFODFPOSITIONNAMEDETAILS.PATCHPOINTSEQUENCE

FROMPORT.PORTNAME.SHORTPORTNAME

FROMPORT.PORTNAME.FULLPORTNAME

FROMPORT.PORTNAME.FULLPORTNAMEINCLCABLEFREEOROCCUPIED