Issue associated build

The Teamwork Graph API is coming soon. The relationship types documented here are indicative of what will be available in the Graph via the Teamwork Graph API. Please note that relationships, their properties, and functionality may change before and during the Early Access Program.

Interested in early access? Express your interest in joining the EAP

The IssueAssociatedBuild relationship represents the link between a Jira issue and an external build within the Teamwork Graph. It allows you to:

Retrieve external builds associated with a specific Jira issue
Find which Jira issues are associated with an external build
Traverse and analyze issue-build relationships

Relationship type: Canonical

From object type	To object type
Jira issue - `ati:cloud:jira:issue`	External build - `ati:cloud:jira:build`

Cypher

We recommend using parameterized Cypher queries rather than placing parameters directly in the query string. This helps improve performance.

Forward query

GraphQL

1
2
query IssueAssociatedBuild_CypherQuery($cypherQuery: String!, $params: JSON!) {
 graphStore @optIn(to: ["GraphStore", "GraphStoreCypherQueryV2"]) {
  cypherQueryV2(query: $cypherQuery, params: $params) {
   edges {
    node {
     columns {
      key
      value {. on GraphStoreCypherQueryV2NodeList {
        nodes {
         data {. on ExternalBuildInfo {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on ExternalBuildInfo {
          id
         }
        }
       }. on GraphStoreCypherQueryV2BooleanObject {
        bool_val: value
       }. on GraphStoreCypherQueryV2IntObject {
        int_val: value
       }. on GraphStoreCypherQueryV2FloatObject {
        float_val: value
       }. on GraphStoreCypherQueryV2StringObject {
        str_val: value
       }
      }
     }
    }
   }
  }
 }
}

Params

1
2
{
 "cypherQuery": "MATCH (issue:JiraIssue {ari: $id})-[:issue_associated_build]->(build:GraphBuild) RETURN build",
 "params": {
  "id": "$id"
 }
}

Inverse query

GraphQL

1
2
query IssueAssociatedBuild_CypherQuery($cypherQuery: String!, $params: JSON!) {
 graphStore @optIn(to: ["GraphStore", "GraphStoreCypherQueryV2"]) {
  cypherQueryV2(query: $cypherQuery, params: $params) {
   edges {
    node {
     columns {
      key
      value {. on GraphStoreCypherQueryV2NodeList {
        nodes {
         data {. on JiraIssue {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on JiraIssue {
          id
         }
        }
       }. on GraphStoreCypherQueryV2BooleanObject {
        bool_val: value
       }. on GraphStoreCypherQueryV2IntObject {
        int_val: value
       }. on GraphStoreCypherQueryV2FloatObject {
        float_val: value
       }. on GraphStoreCypherQueryV2StringObject {
        str_val: value
       }
      }
     }
    }
   }
  }
 }
}

Params

1
2
{
 "cypherQuery": "MATCH (issue:JiraIssue)-[:issue_associated_build]->(build:GraphBuild {ari: $id}) RETURN issue",
 "params": {
  "id": "$id"
 }
}

Metadata

This relationship is not indexed. You will not be able to filter by this metadata when querying this relationship.

To metadata

Name	Type	Description
`state`	BuildState (`Enum`)	Current state of the build.
`testInfo`	TestInfo (`Message`)	Information about tests executed as part of this build.

BuildState

Name	Internal Name	Index	Description
`not-set`	`BUILD_STATE_NOT_SET`	`0`	No build state has been set.
`pending`	`BUILD_STATE_PENDING`	`10`	Build is queued and waiting to start.
`in_progress`	`BUILD_STATE_IN_PROGRESS`	`20`	Build is currently running.
`successful`	`BUILD_STATE_SUCCESSFUL`	`30`	Build completed successfully without errors.
`failed`	`BUILD_STATE_FAILED`	`40`	Build failed due to errors or test failures.
`cancelled`	`BUILD_STATE_CANCELLED`	`50`	Build was cancelled before completion.
`unknown`	`BUILD_STATE_UNKNOWN`	`60`	Build state cannot be determined.

TestInfo

Name	Type	Description
`totalNumber`	`Long`	Total number of tests executed in this build.
`numberPassed`	`Long`	Number of tests that passed successfully.
`numberFailed`	`Long`	Number of tests that failed during execution.
`numberSkipped`	`Long`	Number of tests that were skipped during execution.