Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

A Configuration Item (CI) is any service, component, or other asset that needs to be managed in order to deliver an IT service. Information about each configuration item is recorded in a configuration record and each is identified by a unique name. CI names should be concise, follow a consistent format, and contain

...

Project Name Elements

Project names should follow the form of:

      {verb} {noun} [to | from | with | on {modifier}] [for {sponsor}]

Where:

{verb}
A directive indicating what action is being taken. Good verbs for project names include things like Develop, Obtain, Upgrade, Implement, Research, Rehost, Migrate, etc.
{noun}

The item or system being worked on as a result of the project. For example, System, Server, Web Site, SQL Server, Telephone System, Network Switch, etc. Note that the noune can be a single word or a noun phrase.

{modifier}

Further defines the relationship between the verb and the noun. Modifiers should be prefixed with a preposition such as “from,” “on,” “to,” “with,” etc. For example “to Version 2.1” or “with Oracle.” In rare instances, it may be necessary to use multiple modifiers (e.g., “to Version 2.17 from Version 2.12”), but this should be done by exception.

{sponsor}
Optional and should only be used to eliminate any confusion about the purpose of similar projects. For example if several projects are under way to upgrade servers  from one OS to another but separate projects are being run for individual clients, the sponsor name should be included in each of the project names in order to tell them apart. The sponsor’s name should always be prefixed with the word “for.”

Other Considerations

...

enough information that a unique name can be assigned to each individual item and the nature of the item is immediately apparent to any user.

General Principles in Naming CIs

It is unlikely that the same naming standard can be used for all CI classes. The following are general guidelines that should be considered when determining the most appropriate naming convention for a particular CI.

  • A format should be chosen that eliminates the need to ever have to rename the CI throughout its life cycle. Do not include version numbers or release dates in CI names unless you are tracking that specific version of the CI through its entire life cycle.
  • The name should describe the CI in a way that it is recognizable by the majority of users (including clients) who will see it.

  • The name should have the more significant information at the beginning, which will make it easier for systems with autocomplete to find the name when a user searches for it.

  • For hardware, consider including the asset tag ID or chassis serial number in the name. This will uniquely identify the CI and typically will not change during the CI's life cycle.

  • For software, use the common industry name of the product (for commercial products) or the name by which the software is usually referenced (for software developed internally) as the basis of the name.

  • For servers, printers, workstations and other network devices, consider that host names often change and care should be taken when considering them as CI names.

  • Make every attempt to avoid abbreviations, jargon, and slang in

...

  • CI names. Keep in mind that everyone from

...

  • end users on the business side to the technical staff called on to

...

  • provide support will need to understand the name.
  • Use appropriate capitalization in the name. Pay particular attention to acronyms, application software names, and other words that have unusual letter casing. (See Capitalization Conventions for more information.)
  • Under no circumstances should a person’s name be included in a

...

  • CI name. If

...

  • , for some reason, a person's name must be included then use the person's home department rather than the

...

  • person’s name.

...

Examples

The following are examples of project names that have been normalized using the conventions described above.

...

QuickTemp Rewrite

...

Rewrite QuickTemp

...

Greentree Web and Database Servers Upgrade

...

Upgrade Greentree Web and Database Servers

...

WSG - Migrate File Storage from NetApp to Windows File Server

...

Migrate File Storage to Windows File Server

...

Constituent Engagement Management System

...

Implement Constituent Engagement Management System

...

Kuali Coeus and Cayuse 424 System to System Integration

...

Implement Integration of Kuali Coeus with Cayuse 424 System

...

Kuali Coeus Conflict of Interest for Research

...

Implement Kuali Coeus Conflict of Interest for Research

...

Kuali Coeus Negotiations Module Implementation

...

Implement Kuali Coeus Negotiations Module

...

LAOHP Administration System

...

Implement LAOHP Administration System

...

Planning and Budget Scanning Project

...

Implement Scanning System for Planning and Budget

...

Office365 Email Migration - University Advancement

...

Migrate Email to Office 365 for University Advancement

...

New User Account Automation

...

Automate New User Account Creation

...

Border IDS / IPS Replacement

...

Replace Border Intrusion Detection and Prevention System

...

Enhance OR and GD VB6 apps to support MS Office 2013

...

Enhance VB6 Applications to Support MS Office 2013

...

Netreo Automation

...

Automate Netreo

...

Enterprise Data Center Firewall Consolidation Project

...

Duplication of CI Names

CIs are classified into any number of categories based on the purpose of the item. CI classes typically include IT or business services, hardware, software, buildings, and formal documentation such as process documentation and service level agreements. Every effort should be made to prevent duplication of CI names even across different classes. For example, the name of an application software package often becomes synonymous with the business service supported by the software, as in the following examples:

Application Software
Business Service
ServiceNowITSM Services
CognosBusiness Intelligence
Xerox DocuShareElectronic Document Management

In everyday use, the application software name is commonly used to refer to both the application and the service. Naming both an application software CI and a business service CI "ServiceNow," even though they are in different configuration classes, leads to confusion when referring to one or the other.

Include Page
OIT CMS Navigation Pane
OIT CMS Navigation Pane

On this page...

Table of Contents
maxLevel4
indent20px
excludeTask report