productCreate Mutation

Creates a new product.

Input Argument

productCreate accepts a single input argument, an input type, which contains the values it uses.

The fields inside input are:

brand (String!)

The brand name is typically the name of the product's manufacturer.

category (String!)

The appropriate product category for the product.

clientMutationId (String)

A unique identifier for the client performing the mutation.

customFields ([CustomFieldInput!])

Values for custom field to be used by the UI Extension that is linked to the record.

disabled (Boolean)

Whether the product may no longer be used to register new configuration items.

financialOwnerId (ID)

Identifier of the internal organization which budget is normally used to obtain the product.

model (String)

The model of the product.

name (String!)

The name of the product. Fill out the Brand, Model, Product ID (optional) and Category fields to automatically generate a name based on the values entered in these fields.

pictureUri (String)

The hyperlink to the image file for the record.

productID (String)

The unique identifier of the product that is used by the manufacturer.

rate (Int)

The yearly rate that should normally be applied to calculate the depreciation of configuration items that are based on the product using the reducing balance (or diminishing value) method.

remarks (String)

Any additional information about the product that might prove useful.

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.

salvageValueCurrency (Currency)

The currency of the salvage value attributed to this configuration item.

serviceId (ID)

Identifier of the Service which Service Instances would typically include the product.

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

supplierId (ID)

Identifier of the organization from which the product is typically obtained. If the product is developed internally, select the internal organization that develops it. Note that a lease company should be selected in this field if the product is normally leased.

supportTeamId (ID)

Identifier of the team responsible for maintaining the product's information in the configuration management database (CMDB).

uiExtensionId (ID)

UI extension that is to be applied to the record.

usefulLife (Int)

The number of years within which configuration items that are based on the product are typically depreciated.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

depreciationMethod (ProductDepreciationMethod)

Used to specify whether or not configuration items that are based on the product are typically depreciated and if so, which depreciation method is normally applied. Valid values are:

  • not_depreciated: Not Depreciated
  • double_declining_balance: Double Declining Balance
  • reducing_balance: Reducing Balance (or Diminishing Value)
  • straight_line: Straight Line (or Prime Cost)
  • sum_of_the_years_digits: Sum of the Year's Digits
errors ([ValidationError!])

Errors encountered during the mutation.

product (Product)

Record after mutation.