productCreate Mutation
Creates a new product.
Input Argument
Section titled “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 fields to be used by the UI Extension that is linked to the record.
customFieldsAttachments (
AttachmentInput
)
The attachments used in the custom fields’ values.
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 Depreciateddouble_declining_balance: Double Declining Balancereducing_balance: Reducing Balance (or Diminishing Value)straight_line: Straight Line (or Prime Cost)sum_of_the_years_digits: Sum of the Year’s Digits
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. The
concatenation of
brand
and
productID
must be unique within a R-Service account.
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.
recurrence (
RecurrenceInput
)
Recurrence for maintenance of configuration items created from the product.
remarks (
String
)
Any additional information about the product that might prove useful.
remarksAttachments (
AttachmentInput
)
The attachments used in the
remarks
field.
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.
workflowManagerId (
ID
)
The person who will be responsible for coordinating the workflows that will be generated automatically in accordance with the recurrence schedule.
workflowTemplateId (
ID
)
The workflow template that is used to periodically maintain configuration items created from the product.
Return Fields
Section titled “Return Fields”clientMutationId (
String
)
A unique identifier for the client performing the mutation.
errors (
ValidationError
)
Errors encountered during the mutation.
product (
Product
)
Record after mutation.