Problem Object
Root Connection
Section titled “Root Connection”All Problem objects of an account are accessible by a query on the root connection
problems
.
Such a query will return a
ProblemConnection!
, which contains the Problem objects in its
nodes
field.
problems (
ProblemConnection!
)
Root connection for retrieving Problem 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 | ProblemFilter | Filter to determine which Problem records are returned. |
first | Int | Returns the first n elements from the list. |
last | Int | Returns the last n elements from the list. |
order | ProblemOrder | Order of the Problem records returned. |
view | ProblemView | View name. The default value is current_account . |
Fields
Section titled “Fields”The fields in this section list which values can be retrieved when querying Problem records.
account (
Account
)
The account this record belongs to.
agileBoard (
AgileBoard
)
Board this item is placed on.
agileBoardColumn (
AgileBoardColumn
)
Column this item is placed in.
agileBoardColumnPosition (
Int
)
The (one based) position of this item in its column.
analysisTargetAt (
ISO8601Timestamp
)
Used to specify when the current assignee needs to have completed the root cause analysis of the problem.
category (
ProblemCategory
)
The category of the problem.
createdAt (
ISO8601Timestamp
)
The date and time at which the record was created.
customFields (
CustomField
)
Values of custom fields.
id (
ID!
)
Unique identifier of the record.
impact (
ProblemImpact
)
Used to select the extent to which the service is impacted when an incident occurs that is caused by the problem.
knowledgeArticle (
KnowledgeArticle
)
The knowledge article which instructions should be followed to resolve incidents caused by this problem until a structural solution has been implemented.
knownError (
Boolean
)
Whether the underlying cause of the problem has been found and a temporary workaround has been proposed.
lifeCycleState (
LifeCycleState
)
Current state of the record.
manager (
Person
)
Person who is responsible for coordinating the problem through root cause analysis, the proposal of a structural solution and ultimately its closure.
member (
Person
)
The person to whom the problem is to be assigned.
plannedEffort (
Int
)
The number of minutes the member is expected to spend working on the problem.
problemId (
String
)
The record ID as displayed in the UI
productBacklog (
ProductBacklog
)
Product backlog this item is placed on.
productBacklogEstimate (
Int
)
Estimate of the relative size of this item on the product backlog.
productBacklogPosition (
Int
)
The (one based) position of this item on the backlog.
project (
Project
)
Used to link the problem to a project.
resolutionDuration (
Int
)
The number of minutes it took to complete this problem, which is calculated as
the difference between the
createdAt
and
solvedAt
values.
service (
Service
)
The service in which instance(s) the problem resides.
solvedAt (
ISO8601Timestamp
)
Automatically set to the date and time at which the problem is saved with the status “Solved”.
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 (
ProblemStatus
)
The current status of the problem.
subject (
String
)
A short description of the symptoms that the problem causes.
supplier (
Organization
)
The supplier organization that has been asked for a solution to the problem.
supplierRequestID (
String
)
The identifier under which the request to help with the solution of the problem has been registered at the supplier organization. If the supplier provided a link to the request, enter the entire URL in this field.
team (
Team
)
The team to which the problem is to be assigned. After a service has been selected in the Service field, the support team of the service is automatically selected in this field.
uiExtension (
UiExtension
)
UI extension that is linked to the record.
updatedAt (
ISO8601Timestamp
)
The date and time of the last update of the record. If the record has no updates it contains the
createdAt
value.
urgent (
Boolean
)
Whether the problem has been marked as urgent.
waitingUntil (
ISO8601Timestamp
)
The date and time at which the status of the problem is to be updated from
waiting_for
to
assigned
. This field is available only when the Status
field is set to
waiting_for
.
workaround (
String
)
Used to describe the temporary workaround that should be applied to resolve incidents caused by this problem until a structural solution has been implemented.
workflow (
Workflow
)
The workflow that will implement the proposed permanent solution for the problem.
Connections
Section titled “Connections”The connection fields in this section allow (paged) access to objects related to a specific Problem record.
The actual objects will be in the
nodes
field of the connection.
configurationItems (
ConfigurationItemConnection
)
Configuration items of this problem.
| 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. |
notes (
NoteConnection
)
Notes of the record.
| 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
)
Requests of this problem.
| 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
)
Service instances of this problem.
| 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. |
sprintBacklogItems (
SprintBacklogItemConnection
)
Sprint backlog items 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. |
timeEntries (
TimeEntryConnection
)
Time entries for this record.
| 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. |
workaroundAttachments (
AttachmentConnection
)
Inline images linked to the Workaround 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. |
Implements
Section titled “Implements”Problem implements the following interfaces. This means that fragments defined on these interfaces may be used in queries returning a Problem.