ConfigurationItem Object

Configuration item

Root Connection

All ConfigurationItem objects of an account are accessible by a query on the root connection configurationItems. Such a query will return a ConfigurationItemConnection!, which contains the ConfigurationItem objects in its nodes field.

configurationItems (ConfigurationItemConnection!)

Root connection for retrieving ConfigurationItem records.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

filter ConfigurationItemFilter

Filter to determine which ConfigurationItem records are returned.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

order [ConfigurationItemOrder!]

Order of the ConfigurationItem records returned.

view ConfigurationItemView

View name.

The default value is current_account.

Fields

The fields in this section list which values can be retrieved when querying ConfigurationItem records.

account (Account)

The account this record belongs to.

assetID (String)

Number under which the configuration item has been registered in the financial application (e.g. SAP).

createdAt (ISO8601Timestamp)

The date and time at which the record was created.

customFields ([CustomField!])

Values of custom fields.

depreciationMethod (ProductDepreciationMethod)

Whether or not the configuration item should be depreciated and if so, which depreciation method is to be applied. When creating a new CI and a value is not specified for this field, it is set to the depreciation method of the CI's product.

financialOwner (Organization)

The internal organization which budget is used to pay for the configuration item. If the CI is leased or rented, the organization that pays the lease or rent is selected in this field. When creating a new CI and a value is not specified for this field, it is set to the financial owner of the CI's product.

id (ID!)

Unique identifier of the object.

label (String)

The label that is attached to the configuration item (CI). A label is automatically generated using the same prefix of other CIs of the same product category, followed by the next available number as the suffix.

licenseExpiryDate (ISO8601Date)

The date through which the temporary software license certificate is valid. The license certificate expires at the end of this day.

licenseType (CiLicenseType)

The type of license that the license certificate covers.

location (String)

The name or number of the room in which the CI is located, if it concerns a hardware CI.

name (String)

The name of the configuration item (CI). When creating a new CI and a value is not specified for this field, it is set to the name of the CI's product.

nrOfCores (Int)

The total number of processor cores that are installed in the server.

nrOfLicenses (Int)

The number of licenses that the license certificate covers.

nrOfProcessors (Int)

The number of processors that are installed in the server.

pictureUri (String)

The hyperlink to the image file for the record.

poNr (String)

Number of the purchase order that was used to order the (lease of the) configuration item from the supplier.

product (Product)

Related product.

purchaseValue (MonetaryAmount)

The amount that was paid for the configuration item (this is normally equal to the invoice amount).

rate (Int)

Used to specify the yearly rate that should be applied to calculate the depreciation of the configuration item (CI) using the reducing balance (or diminishing value) method. When creating a new CI and a value is not specified for this field, it is set to the rate of the CI's product.

remarks (String)

Any additional information about the configuration item that might prove useful. When creating a new CI and a value is not specified for this field, it is set to the remarks of the CI's product.

ruleSet (ProductCategoryRuleSet)

The Rule set field is automatically set to the rule set of the related product's product category, except when the CI is a license certificate, in which case the rule set is license_certificate.

salvageValue (MonetaryAmount)

The value of this configuration item at the end of its useful life (i.e. at the end of its depreciation period). When a value is not specified for this field, it is set to zero.

serialNr (String)

Serial number of the configuration item.

service (Service)

Which service instance(s) the configuration item is, or will be, a part of. When creating a new CI and a value is not specified for this field, it is set to the service of the CI's product.

site (Site)

Where the CI is located, if it concerns a hardware CI.

siteLicense (Boolean)

true for license certificates that may only be used at one or more specific locations.

source (String)

An identifier for the client application submitting the resource or the name of an external system

sourceID (String)

The unique identifier of the resource in an external system

startDate (ISO8601Date)

The date on which the expense for the configuration item (CI) was incurred or, if the CI is depreciated over time, the date on which the depreciation was started. This is typically the invoice date.

status (CiStatus)

The appropriate status for the configuration item (CI).

supplier (Organization)

The supplier from which the configuration item (CI) has been obtained. When creating a new CI and a value is not specified for this field, it is set to the supplier of the CI's product.

supportAccount (Account)

The account of the team that supports this configuration item.

supportTeam (Team)

The team responsible for supporting the configuration item and maintaining its information in the configuration management database (CMDB). When creating a new CI and a value is not specified for this field, it is set to the support team of the CI's product. Optional when status of CI equals "Removed", required otherwise.

systemID (String)

System identifier of the configuration item.

temporaryLicense (Boolean)

true for license certificates that are not valid indefinitely.

updatedAt (ISO8601Timestamp)

The date and time of the last update of the record. If the record has no updates it contains the createdAt value.

usefulLife (Int)

The number of years within which the configuration item is to be depreciated. When creating a new CI and a value is not specified for this field, it is set to the useful life of the CI's product.

warrantyExpiryDate (ISO8601Date)

The date through which the warranty coverage for the configuration item is valid. The warranty expires at the end of this day.

Connections

The connection fields in this section allow (paged) access to objects related to a specific ConfigurationItem record. The actual objects will be in the nodes field of the connection.

ciRelations (ConfigurationItemRelationConnection)

Relations to other configuration items.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

contracts (ContractConnection)

All contracts of this configuration item.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

customFieldsAttachments (AttachmentConnection)

Inline images linked to one of the custom fields.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

licensedSites (SiteConnection)

Sites at which the software that is covered by the license certificate may be used.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

problems (ProblemConnection)

All problems of this configuration item.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

remarksAttachments (AttachmentConnection)

Files and inline images linked to the Remarks field.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

requests (RequestConnection)

All requests of this configuration item.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

serviceInstances (ServiceInstanceConnection)

All service instances of this configuration item.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

users (PersonConnection)

All users of this configuration item.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

Implements

ConfigurationItem implements the following interfaces. This means that fragments defined on these interfaces may be used in queries returning a ConfigurationItem.