Queries
exchangeByFileId
Retrieves a single exchange by exchangeFileId.
Note: This query is deprecated. Use exchangeByFileUrn query instead.
Template for Query:
query GetExchangeByFileId($exchangeFileId: ID!) {
exchangeByFileId(exchangeFileId: $exchangeFileId) {
# ExchangeByFileId Fields
}
}
Template for Query Variables:
{
"exchangeFileId" : "<SOME-ID-TYPE-SCALAR-VALUE>"
}
Arguments
exchangeFileId* ID! non-null | The Exchange file Id. |
* Required
Possible Returns
Value Type | Description |
---|---|
Exchange! non-null |
A specific collection of Elements. |
Examples
Example 1
Retrieves an exchange by exchangeFileId.
Query:
query GetExchangeByFile($exchangeFileId: ID!) {
exchangeByFileId(exchangeFileId: $exchangeFileId) {
id
name
propertyDefinitions(filter: {names: ["Volume", "Structural Material"]}) {
results {
id
name
description
}
}
version {
id
versionNumber
}
}
}
Show More
Query Variables:
{
"exchangeFileId": "urn:adsk.wipprod:dm.lineage:wfjaO3PZSwC2gWg2A1AvbQ"
}
Response:
{
"data": {
"exchangeByFileId": {
"id": "ZXhjfnlwdWFzY1NicWlIT0R1R0s4OUkwTHdfTDJDfjkwMGM5ODY1LWI2ZmMtMzI0Ny04NWUxLTgxMmZhOGY1ZTJkNA",
"name": "SHARE -Multi-Fam Apt-Wing 2",
"propertyDefinitions": {
"results": [
{
"id": "autodesk.revit.parameter:hostVolumeComputed-1.0.0",
"name": "Volume",
"description": "Length x Cross Section Area"
},
{
"id": "autodesk.revit.parameter:structuralMaterialParam-1.0.0",
"name": "Structural Material",
"description": "Specifies a material for the element which will be used in structural analysis."
}
]
},
"version": {
"id": "1685627380181_264ef2b2-1501-34ed-b39e-68f725a9b32f",
"versionNumber": 1
}
}
}
}
Show More
Example 2
Retrieves elements of category ‘Windows’ in an exchange by exchange file ID.
Query:
query GetElementsByExchangeFile ($exchangeFileId: ID!,$elementFilter: ElementFilterInput, $elementPagination: PaginationInput){
exchangeByFileId(exchangeFileId: $exchangeFileId){
id
name
elements(filter: $elementFilter, pagination: $elementPagination){
pagination{
pageSize
cursor
}
results{
id
name
properties(filter: {names: ["category", "Area"]}){
results{
name
value
}
}
}
}
}
}
Show More
Query Variables:
{
"exchangeFileId": "urn:adsk.wipprod:dm.lineage:wfjaO3PZSwC2gWg2A1AvbQ",
"elementFilter": {
"query": "property.name.category==Windows"
},
"elementPagination": {
"limit": 3
}
}
Show More
Response:
{
"data": {
"exchangeByFileId": {
"id": "ZXhjfnlwdWFzY1NicWlIT0R1R0s4OUkwTHdfTDJDfjkwMGM5ODY1LWI2ZmMtMzI0Ny04NWUxLTgxMmZhOGY1ZTJkNA",
"name": "SHARE -Multi-Fam Apt-Wing 2",
"elements": {
"pagination": {
"pageSize": 3,
"cursor": "caed0af3-e3c5-44ab-b5c3-82659b239f50"
},
"results": [
{
"id": "08087FE00C00C0816458C80BFF254ACD74EF8FFC",
"name": "2608023",
"properties": {
"results": [
{
"name": "Area",
"value": 3.786146883117476
},
{
"name": "category",
"value": "Windows"
}
]
}
},
{
"id": "00F20DEBD19DDCE9130ED15C3C4DF92FB01B63DF",
"name": "1175245",
"properties": {
"results": [
{
"name": "Area",
"value": 6.768324705513875
},
{
"name": "category",
"value": "Windows"
}
]
}
},
{
"id": "0196ECCF03B90E022759BCE032CDA0D38050131F",
"name": "1174751",
"properties": {
"results": [
{
"name": "Area",
"value": 6.768324705513875
},
{
"name": "category",
"value": "Windows"
}
]
}
}
]
}
}
}
}
Show More