Issues Subgraph Reference

The su-issues subgraph provides comprehensive issue tracking, task management, and data collection capabilities.

Subgraph Information

Name: su-issues
Routing URL: https://6vapx1z4c0.execute-api.us-west-2.amazonaws.com/poc/graphql
Last Updated: 2025-11-03
SDL: View Schema

Overview

This subgraph owns:

Issue creation and management
Task and multi-task coordination
Issue templates
Data collection forms (XForms integration)
Annotations and comments
Issue-asset relationships

Root Query Fields

extend type Query {
  # Issue Management
  issues: Issues
  allIssues(after: String, first: Int, status: IssueStatus, severity: Int, subjectReference: ID, triggerReference: ID): IssuesConnection
  openIssueBySubjectAndReference(subjectReference: ID!, triggerReference: ID!): Issue

  # Issue Types
  issueMultitask: IssueMultitask
  issueTask: IssueTask
  issueSeverityTypes: [IssueSeverityDisplay!]

  # Forms & Datasets
  issueDataCollectionFormReferences: [IssueDataCollectionForm!] @deprecated
  formDatasets(group: ID!): [CamEngineDataset!]!
  issuesDatasets(group: ID!): [CamEngineDataset]!
}

Root Mutation Fields

extend type Mutation {
  # Issue Lifecycle
  triggerIssue(input: TriggerIssueInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  updateIssue(input: UpdateIssueInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  deleteIssue(input: DeleteIssueInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  undeleteIssue(input: UndeleteIssueInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  transitionIssueState(input: TransitionIssueStateInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  closeIssue(input: CloseIssueInput!, delayed: DelayedIssueMutationInput): IssueMutationResult! @deprecated
  reopenIssue(input: ReopenIssueInput!, delayed: DelayedIssueMutationInput): IssueMutationResult! @deprecated

  # Multitask & Subtasks
  triggerIssueMultitask(input: TriggerIssueMultitaskInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  triggerIssueSubTask(input: TriggerIssueSubTaskInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  createMultitaskProcedure(input: CreateMultitaskProcedureInput!): IssueMultitaskProcedureMutationResult!
  triggerIssueTask(input: TriggerIssueTaskInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!

  # Assignment & Comments
  assignIssueToUser(input: AssignIssueToUserInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  acknowledgeAssignment(input: AcknowledgeAssignment!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  commentIssue(input: CommentIssueInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  deleteIssueComment(input: DeleteIssueCommentInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!
  modifyIssueComment(input: ModifyIssueCommentInput!, delayed: DelayedIssueMutationInput): IssueMutationResult!

  # State & Data
  updateIssueStateData(input: UpdateIssueStateDataInput, delayed: DelayedIssueMutationInput): IssueMutationResult!
  bulkUpdateIssues(input: BulkUpdateIssuesInput!, delayed: DelayedIssueMutationInput): BulkIssuesMutationResult!

  # Data Collection Forms
  createIssueTaskDataCollectionForm(input: CreateIssueTaskDataCollectionFormInput!): IssueTaskDataCollectionFormMutationResult!
  updateIssueTaskDataCollectionForm(input: UpdateIssueTaskDataCollectionFormInput!): IssueTaskDataCollectionFormMutationResult!
  deleteIssueTaskDataCollectionForm(input: DeleteIssueTaskDataCollectionFormInput!): IssueTaskDataCollectionFormMutationResult!
  activateIssueTaskDataCollectionForm(id: ID!, subjectAssetProfile: ID): IssueTaskDataCollectionFormMutationResult!
  deactivateIssueTaskDataCollectionForm(id: ID!): IssueTaskDataCollectionFormMutationResult!
  cloneIssueTaskDataCollectionForm(input: CloneIssueTaskDataCollectionFormInput!): IssueTaskDataCollectionFormMutationResult!

  # Datasets
  reloadFormDatasets(group: ID): [CamEngineDataset!]!
  generateFormResponseDataset(async: Boolean! = true, formReference: String!): FormResponseCamDatasetGenerateResults!
  generateFormResponseDatasets(async: Boolean! = true): FormResponseCamDatasetGenerateResults!
}

Core Types

Issue

Main issue/task type.

type Issue implements Node @key(fields: "id") {
  id: ID!
  type: IssueType!          # ISSUE, TASK, MULTITASK, SUBTASK
  taskType: IssueTaskType
  title: String!
  description: String
  status: IssueStatus!      # OPEN, IN_PROGRESS, RESOLVED, CLOSED
  severity: Int!
  openedAt: DateTime!
  closedAt: DateTime
  dueAt: DateTime
  pastDue: Boolean
  subject: IssueSubject!
  trigger: IssueTrigger!
  annotations: [Annotation]
  assignee: IssueAssignee
  watchers: [IssueWatcher!]
  currentState: IssueState!
  auditHistory: [IssueAuditEntry!]!
  parentIssue: IssueReference
}

IssueTemplate

Reusable issue definition.

type IssueTemplate @key(fields: "id") {
  id: ID!
  title: String!
  description: String
  type: IssueType!
  defaultSeverity: Int
  defaultDueInDays: Int
  formReference: XFormReference
}

XForms Integration

Issues can include data collection forms:

type XFormDetails {
  model: XFormXMLNode!
  binds: [XFormBind!]
  body: [XFormBodyNode!]
}

type XFormBind {
  nodeset: String!
  type: XFormDataType!    # string, int, decimal, date, geopoint, etc.
  required: XFormXPath
  constraint: XFormXPath
}

Entity Extensions

Asset

Extends Asset with issue subject information.

type Asset @key(fields: "profile id") @extends {
  profile: ID! @external
  id: ID! @external
  issueSubject: IssueSubject!
}

Full SDL Schema - Complete type definitions

​Issues Subgraph Reference

​Subgraph Information

​Overview

​Root Query Fields

​Root Mutation Fields

​Core Types

​Issue

​IssueTemplate

​XForms Integration

​Entity Extensions

​Asset

​Related Resources