Project documentation entity

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 ProjectDocumentationEntity relationship represents the link between a Jira project and a documentation entity within the Teamwork Graph. It allows you to:

Retrieve documentation entities for a specific Jira project
Find which Jira projects relate to a documentation entity
Traverse and analyze project-documentation relationships

Relationship type: Canonical

From object type	To object type
Jira project - `ati:cloud:jira:project`	Confluence space - `ati:cloud:confluence:space`
	Confluence page - `ati:cloud:confluence:page`
	External document - `ati:cloud:jira:document`
	External document - `ati:cloud:graph:document`

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 ProjectDocumentationEntity_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 ConfluenceSpace {
           id
          }. on ConfluencePage {
           id
          }. on DevOpsDocument {
           id
          }. on ExternalDocument {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on ConfluenceSpace {
          id
         }. on ConfluencePage {
          id
         }. on DevOpsDocument {
          id
         }. on ExternalDocument {
          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 (project:JiraProject {ari: $id})-[:project_documentation_entity]->(space:ConfluenceSpace) RETURN space",
 "params": {
  "id": "$id"
 }
}

Inverse query

GraphQL

1
2
query ProjectDocumentationEntity_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 JiraProject {
           id
          }
         }
        }
       }. on GraphStoreCypherQueryV2AriNode {
        data {. on JiraProject {
          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 (project:JiraProject)-[:project_documentation_entity]->(space:ConfluenceSpace {ari: $id}) RETURN project",
 "params": {
  "id": "$id"
 }
}