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.

alternateNames ([String!])

Alternate names the configuration item is also known by.

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.

endOfSupportDate (ISO8601Date)

The date at which the support for this configuration item ends.

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 record.

inUseSince (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.

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.

lastSeenAt (ISO8601Timestamp)

The date and time at which the configuration item was last seen.

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.

operatingSystem (ConfigurationItem)

The (software) configuration item representing the operating system of this configuration item.

pictureUri (String)

The hyperlink to the image file for the record.

product (Product)

Related product.

ramAmount (Int)

The amount of RAM (in GB) of this configuration item.

recurrence (Recurrence)

Recurrence for maintenance of the configuration item.

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 product category, except when the CI is a license certificate, in which case the rule set is license_certificate.

serialNr (String)

Serial number of the configuration item. The concatenation of product's' brand and serialNr must be unique within a 4me account.

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.

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.

warrantyExpiryDate (ISO8601Date)

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

workflowManager (Person)

The person who will be responsible for coordinating the workflows that will be generated automatically in accordance with the recurrence schedule.

workflowTemplate (WorkflowTemplate)

The workflow template that is used to periodically maintain the configuration item.

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.

invoices (InvoiceConnection)

Invoices associated with this object.

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.