Update a Configuration Item

Update a Configuration Item#

Pre-Requisites#

Some ITSM packages are required to use this transition action:

GeneralCatalog
ITSMCore
ITSMConfigurationManagement

These can be downloaded from the ITSM Repository for Znuny

Summary#

Use this action to update configuration item(s).

The name of the transition action is ConfigItemUpdate

Transition Action Module Configuration#

The following list shows the mandatory items.

Key	Example Value	Description	Mandatory
ConfigItemID	123 or 123,456,789	Numerical entity ID of the configuration item.	yes, or optionally ConfigItemNumber. Multiple values are valid when comma separated.
ConfigItemNumber	123 or 123,456,789	Numerical reference of the configuration Item.	no, if ConfigItemID is used. Multiple values are valid when comma separated.
InciStateID	1	Numerical entity ID of the incident state ID found in the general catalog.	no
InciStateName	Operational	The named incident state as found in the general catalog.	no
DeplStateID	1	Numerical entity ID of the incident state ID found in the general catalog.	no
DeplStateName	Production	The named deployment state as found in the general catalog.	no
XML Keys
CPU	i7-1165G7	The value to be saved to the class. The Key is the XML key name as seen in the configuration items class definition.	no

XML Keys#

XML keys are named in the configuration item class definition. See the example below.

Example Class Definition

---
- Key: Vendor
  Name: Vendor
  Searchable: 1
  Input:
    Type: Text
    Size: 50
    MaxLength: 50
    # Example for CI attribute syntax check for text and textarea fields
    #RegEx: ^ABC.*
    #RegExErrorMessage: Value must start with ABC!

- Key: Model
  Name: Model
  Searchable: 1
  Input:
    Type: Text
    Size: 50
    MaxLength: 50

- Key: Description
  Name: Description
  Searchable: 1
  Input:
    Type: TextArea

- Key: Type
  Name: Type
  Searchable: 1
  Input:
    Type: GeneralCatalog
    Class: ITSM::ConfigItem::Computer::Type
    Translation: 1

- Key: CustomerID
  Name: Customer Company
  Searchable: 1
  Input:
    Type: CustomerCompany

- Key: Owner
  Name: Owner
  Searchable: 1
  Input:
    Type: Customer

- Key: SerialNumber
  Name: Serial Number
  Searchable: 1
  Input:
    Type: Text
    Size: 50
    MaxLength: 100

- Key: OperatingSystem
  Name: Operating System
  Input:
    Type: Text
    Size: 50
    MaxLength: 100

- Key: CPU
  Name: CPU
  Input:
    Type: Text
    Size: 50
    MaxLength: 100
  CountMax: 16

- Key: Ram
  Name: Ram
  Input:
    Type: Text
    Size: 50
    MaxLength: 100
  CountMax: 10

- Key: HardDisk
  Name: Hard Disk
  Input:
    Type: Text
    Size: 50
    MaxLength: 100
  CountMax: 10
  Sub:
  - Key: Capacity
    Name: Capacity
    Input:
      Type: Text
      Size: 20
      MaxLength: 10

- Key: FQDN
  Name: FQDN
  Searchable: 1
  Input:
    Type: Text
    Size: 50
    MaxLength: 100

- Key: NIC
  Name: Network Adapter
  Input:
    Type: Text
    Size: 50
    MaxLength: 100
    Required: 1
  CountMin: 0
  CountMax: 10
  CountDefault: 1
  Sub:
  - Key: IPoverDHCP
    Name: IP over DHCP
    Input:
      Type: GeneralCatalog
      Class: ITSM::ConfigItem::YesNo
      Translation: 1
      Required: 1
  - Key: IPAddress
    Name: IP Address
    Searchable: 1
    Input:
      Type: Text
      Size: 40
      MaxLength: 40
      Required: 1
    CountMin: 0
    CountMax: 20
    CountDefault: 0

- Key: GraphicAdapter
  Name: Graphic Adapter
  Input:
    Type: Text
    Size: 50
    MaxLength: 100

- Key: OtherEquipment
  Name: Other Equipment
  Input:
    Type: TextArea
    Required: 1
  CountMin: 0
  CountDefault: 0

- Key: WarrantyExpirationDate
  Name: Warranty Expiration Date
  Searchable: 1
  Input:
    Type: Date
    YearPeriodPast: 20
    YearPeriodFuture: 10

- Key: InstallDate
  Name: Install Date
  Searchable: 1
  Input:
    Type: Date
    Required: 1
    YearPeriodPast: 20
    YearPeriodFuture: 10
  CountMin: 0
  CountDefault: 0

- Key: Note
  Name: Note
  Searchable: 1
  Input:
    Type: TextArea
    Required: 1
  CountMin: 0
  CountDefault: 0

Input Types#

As you can see above there are different input types. In the case of GeneralCatalog, you must ensure the value used is registered in the general catalog.

Example:

Key	Example value
IPoverDHCP	Yes

Multiple Keys#

It is possible to have more than one of the same key using:

CountDefault
CountMax
CountMin

They may be modified individually or in one key. In example 2 you would have NIC::1 as Intel and NIC::2 as Wacom.

Example 1:

Key	Example value
NIC::1	Intel
NIC::2	Wacom

Example 2

Key	Example value
NIC::	Intel,Wacom

Sub-keys#

Sub-keys are always separated by “::”