...
...
A hierarchical tree structure(eg: cost structure) could be added and later retrieved from a project/object using the Structure service
Anchor |
---|
| createStructure |
---|
| createStructure |
---|
|
...
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
label | URL / Resource / JSON Structure |
---|
| Resource: projects/<project_id>/structures URL: https://api-stage.bimplus.net/v2/<team_slug>/projects/<project_id>/structures Example:https://api-stage.bimplus.net/v2/bimplus/projects/622272da-f1ff-45ab-a3f0-c8f1255c80e8/structures JSON Structure: Name | Mandatory / Optional | Type | Description |
---|
parentId | mandatory | string(guid) | Parent node id of the structure (for the first structure, projectId is the parentId) | name | mandatory | string | Name of the structure | description | optional | string | Description of the structure | type | optional | string | Type of the structure (eg: costStructure, specificationStructure) | nr | will be ignored | integer | The index of the structure | color | optional | integer | Color of the structure | id | will be ignored | string(guid) | Unique guid of the structure | startDate | optional | string (date) | Start date ( depends on type of structure ) | endDate | optional | string (date) | End date ( depends on type of structure ) |
| card | | POST |
Card |
---|
| Create a new structure(eg: cost structure, specification structure) under a project |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "TestStructure",
"description": "FullLifeCycleTest",
"type": "CostStructure"
} |
|
optional | string(guid) | Free attribute Id. When this value is set, the corresponding attribute must have a suitable controlType to define set of structures to be created. At a moment is supported only controlType "Enumeration", for all other controlType-s is returned status 404 Not found. | variantType | optional | string(guid) | Variant Type Id to whom the object will be assigned. Used only when attributeId is defined. |
|
Card |
---|
| Create a new structure(eg: cost structure, specification structure) under a project. NOTE : When is defined attributeId of attribute with controlType "Enumeration" will be created structure hierarchy. The structure will be created under parent element (structure or project) together with its child structures. Child structures will be created according enumDefinition (enumeration list) of attribute (defined by attributeId). |
Card |
---|
|
| Card |
---|
| Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | StatusHeaders |
---|
| Status Authorization: 201 Created BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| A) Sample to create single structure:
{
"parentId": "622272da3904db18-f1ffcf1a-45ab4665-a3f09c2b-c8f1255c80e8152b84293259",
"name": "TestStructure",
"description": "FullLifeCycleTest",
"type": "CostStructure",
}
B) Sample to create structure hierarchy:
{
"nrparentId": 1"3904db18-cf1a-4665-9c2b-152b84293259",
"colorname": 0"Status structure",
"idattributeId": "179439d602bbe8de-df16c623-41cc489f-bd2c9baa-74d05b7995d587f8ff3205f2"
} |
|
|
...
,
"description": "Status of the project (enumeration)"
}
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 201 Created
|
|
|
...
Get the structure details
Deck of Cards |
---|
|
Card |
---|
| Get details of a specified structure. |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
| Card |
---|
| | A) Sample to create single structure:
{
"parentId": "3904db18-cf1a-4665-9c2b-152b84293259", |
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "TestStructure",
"description": "FullLifeCycleTest",
"type": "CostStructure",
"nr": 1,
"color": 0,
"id": "179439d6-df16-41cc-bd2c-74d05b7995d5"
} |
|
|
...
Create a sub-node under the structure
Deck of Cards |
---|
|
Card |
---|
|
default | true |
---|
label | URL / Resource / JSON Structure |
---|
|
Resource: structures/<structure_id> URL: https://api-stage.bimplus.net/v2/<team_slug>/structures/<structure_id>
Example:https://api-stage.bimplus.net/v2/bimplus/structures/179439d6-df16-41cc-bd2c-74d05b7995d5
JSON Structure:
Name | Mandatory / Optional | Type | Description |
---|
parentId | mandatory | string(guid) | Parent node id of the structure (the id specified in the resource url) |
name | mandatory | string | Name of the structure |
description | optional | string | Description of the structure |
type | optional | string | Type of the structure (eg: costStructure, specificationStructure) |
nr | will be ignored | integer | The index of the structure |
color | optional | integer | Color of the structure |
id | will be ignored | string(guid) | Unique guid of the structure |
Card |
---|
|
Create a sub-node under a particular structure |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "Node 1"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 201 Created
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"parentId": "179439d6-df16-41cc-bd2c-74d05b7995d5",
"name": "Node 1",
"type": "TopologyStructure",
"nr": 1,
"color
B) Sample to create structure hierarchy:
{
"projectId": "3904db18-cf1a-4665-9c2b-152b84293259",
"name": "Status structure",
"description": "Status of the project (enumeration)",
"type": "mainStructure2",
"nr": 0,
"id": "ee209608-19b1-40da-a089-53b20a858d41",
"structuretypeid": "14c1ca64-4001-438f-a2f6-77ca951c488d",
"children": [
{
"structuretypeid": "14c1ca64-4001-438f-a2f6-77ca951c488d",
"children": [],
"elements": [],
"parentId": "ee209608-19b1-40da-a089-53b20a858d41",
"name": "Undefined",
"description": "0",
"type": "mainStructure2",
"nr": 0,
"id": "adf506ae40da49c5-36283f3a-45014e12-9af1a4f8-22bcf27e4ab494fb829c7c1e"
} |
|
...
},
{
"structuretypeid": "14c1ca64-4001-438f-a2f6-77ca951c488d",
"children": [],
"elements": [],
"parentId": "ee209608-19b1-40da-a089-53b20a858d41",
"name": "in planning stage",
"description": "1",
"type": "mainStructure2",
"nr": 0,
"id": "ecf9c518-1e24-4706-8557-d29d75fb7ddc"
},
......
],
"elements": []
} |
|
|
Anchor |
---|
| getStructureDetails |
---|
| getStructureDetails |
---|
|
Get the structure details
Deck of Cards |
---|
|
Card |
---|
| Get details of a specified structure. |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "TestStructure",
"description": "FullLifeCycleTest",
"type": "CostStructure",
"nr": 1,
"color": 0,
"id": "179439d6-df16-41cc-bd2c-74d05b7995d5"
} |
|
|
Anchor |
---|
| createSubStructure |
---|
| createSubStructure |
---|
|
Create a sub-node under the structure
Deck of Cards |
---|
|
Card |
---|
| Create a sub-node under a particular structure |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "Node 1"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 201 Created
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"parentId": "179439d6-df16-41cc-bd2c-74d05b7995d5",
"name": "Node 1",
"type": "TopologyStructure",
"nr": 1,
"color": 0,
"id": "adf506ae-3628-4501-9af1-22bcf27e4ab4"
} |
|
|
Anchor |
---|
| getStructureTopology |
---|
| getStructureTopology |
---|
|
Get the structure topology
Deck of Cards |
---|
id | bimGetStructureTopology |
---|
|
Card |
---|
| Get details of a specified structure. |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"parent": null,
"name": "TestStructure",
"type": "Structure",
"children": [
{
"parent": "179439d6-df16-41cc-bd2c-74d05b7995d5",
"name": "Node 1",
"type": "Structure",
"children": [],
"id": "adf506ae-3628-4501-9af1-22bcf27e4ab4"
}
],
"id": "179439d6-df16-41cc-bd2c-74d05b7995d5"
} |
|
|
Anchor |
---|
| putReorderStructure |
---|
| putReorderStructure |
---|
|
Reorder the structure
Deck of Cards |
---|
id | bimGetStructureTopology |
---|
|
Card |
---|
| Reorder the structure for specified variant type. |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"parent": null,
"name": "TestStructure",
"type": "Structure",
"children": [
{
"parent": "179439d6-df16-41cc-bd2c-74d05b7995d5",
"name": "Node 1",
"type": "Structure",
"children": [],
"id": "adf506ae-3628-4501-9af1-22bcf27e4ab4"
}
],
"id": "179439d6-df16-41cc-bd2c-74d05b7995d5"
} |
|
|
Anchor |
---|
| assignStructure |
---|
| assignStructure |
---|
|
Assign an object to the latest/last structure node
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
label | URL / Resource / JSON Structure |
---|
| Resource: structures/<structure_id>/assign/<object_id> URL: https://api-stage.bimplus.net/v2/<team_slug>/structures/<structure_id>/assign/<object_id> Example:https://api-stage.bimplus.net/v2/bimplus/structures/179439d6-df16-41cc-bd2c-74d05b7995d5/assign/df4a81d6-42fb-4187-bbce-82a2fc093b2f JSON Structure: Name | Mandatory / Optional | Type | Description |
---|
color | optional | string(guid) | The id of the last node to which an object will be assigned | objectId | will be ignored | string(guid) | The id of the object to whom a structure will be assigned | name | mandatory | string | The name of the structure-object connection | nr | will be ignored | integer | The index of the structure-object connection | id | will be ignored | string(guid) | Unique guid of the structure-object connection | variantType | optional | string(guid) | Variant Type Id to whom the object will be assigned | IfcGloballyUniqueId | optional | string | IFC globally unique ID |
|
Card |
---|
| Assign an object to the latest/last structure node
Note : Works with two different inputs - Object ID is present in the url - this object ID is used
- Object ID is not present, but content json contains IfcGloballyUniqueId - a corresponding Bimplus object is found and used as input object ID
- if this IFC id is not found -> return "404 Not Found", if present multiple times -> return "409 Conflict"
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "WallConnection",
"variantType" : "35b986c2-e9cd-482e-9281-6000671a49f0"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 201 Created
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"structureId": "adf506ae-3628-4501-9af1-22bcf27e4ab4",
"objectId": "df4a81d6-42fb-4187-bbce-82a2fc093b2f",
"name": "WallConnection",
"nr": 1,
"id": "35b986c2-e9cd-482e-9281-6000671a49f0"
} |
|
|
Anchor |
---|
| assignAdditionalObjects |
---|
| assignAdditionalObjects |
---|
|
Assign additional objects to the latest structureElement node
Deck of Cards |
---|
id | bimAssignAdditionalObjects |
---|
|
Card |
---|
| {
"structureId": "adf506ae-3628-4501-9af1-22bcf27e4ab4",
"objectId": "df4a81d6-42fb-4187-bbce-82a2fc093b2f",
"name": "WallConnection",
"nr": 1,
"id": "35b986c2-e9cd-482e-9281-6000671a49f0", "variantType" : "35b986c2-e9cd-482e-9281-6000671a49f0" } |
|
Anchor |
---|
| assignProjectElements |
---|
| assignProjectElements |
---|
|
Assign a project element(s) into existing hierarchy structure
Deck of Cards |
---|
id | bimAssignProjectElements |
---|
|
Card |
---|
| Assign a project element(s) into existing hierarchy structure according attribute value of element (i.e. structure hierarchy description is identical to free attribute value) |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"attributeId": "8ef4d2fd-8959-4aa1-8da9-3e238b1c7705",
"variantType": "d120adc6-8382-4a0c-9638-a0d246590ed3"
}
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 201 Created
Function ended OK and minimal one project element was assigned to structure node
Status: 204 NoContent
Function ended OK, but no project element was assigned to structure node (i.e. no project element with requested free attribute was found) |
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"structuretypeid": "512b5bcd-619d-4ef5-9644-7fe5d783b73a",
"children": [
{
"structuretypeid": "512b5bcd-619d-4ef5-9644-7fe5d783b73a",
"children": [],
"elements": [
{
"structureId": "f0ebc65f-6ddc-4fa3-8f02-2911665adee4",
"objectId": "72bd0a48-f0e8-4385-9d95-f242d42deb60",
"name": "Basic Wall:Standard 20.0:491928",
"nr": 0,
"id": "23ee744f-0cca-4e39-adcd-e91396ad10ea"
}, |
|
|
...
Get the structure topology
Deck of Cards |
---|
id | bimGetStructureTopology |
---|
|
Card |
---|
|
default | true |
---|
label | URL / Resource / JSON Structure |
---|
|
Resource: structures/<structure_id>/topology?varianttype=<varianttype_id> URL: https://api-stage.bimplus.net/v2/<team_slug>/structures/<structure_id>/topology?varianttype=<varianttype_id>
Example:https://api-stage.bimplus.net/v2/bimplus/structures/179439d6-df16-41cc-bd2c-74d05b7995d5/topology?varianttype=733e429a-e232-4e5d-a41e-9bd50aa9763c
Optional query parameters
Name | Type | Default value | Description |
---|
varianttype | string (guid) | Guid.Empty | id of the variant type |
Card |
---|
|
Get details of a specified structure. |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"parent": null,
"name": "TestStructure",
"type": "Structure",
"children": [
{
"parentstructureId": "179439d6f0ebc65f-df166ddc-41cc4fa3-bd2c8f02-74d05b7995d52911665adee4",
"nameobjectId": "Node 1228b0d93-f3fd-433a-9242-c4dbfe806b53",
"typename": "StructureBasic Wall:Standard 20.0:491025",
"childrennr": []0,
"id": "adf506aec2586c7a-36285b61-4501456a-9af1ba84-22bcf27e4ab4c27ffe0976d6"
}
],
"idparentId": "179439d6653afdf7-df167cfb-41cc42e5-bd2c-74d05b7995d5"
} |
|
...
Assign an object to the latest/last structure node
...
...
default | true |
---|
label | URL / Resource / JSON Structure |
---|
...
URL: https://api-stage.bimplus.net/v2/<team_slug>/structures/<structure_id>/assign/<object_id>
Example:https://api-stage.bimplus.net/v2/bimplus/structures/179439d6-df16-41cc-bd2c-74d05b7995d5/assign/df4a81d6-42fb-4187-bbce-82a2fc093b2f
JSON Structure:
Name | Mandatory / Optional | Type | Description |
---|
color | optional | string(guid) | The id of the last node to which an object will be assigned |
objectId | will be ignored | string(guid) | The id of the object to whom a structure will be assigned |
name | mandatory | string | The name of the structure-object connection |
nr | will be ignored | integer | The index of the structure-object connection |
id | will be ignored | string(guid) | Unique guid of the structure-object connection |
variantType | optional | string(guid) | Variant Type Id to whom the object will be assigned |
IfcGloballyUniqueId | optional | string | IFC globally unique ID |
...
Assign an object to the latest/last structure node
Note :
Works with two different inputs
...
a9b5-e99275ce5cf4",
"name": "Subnode3",
"description": "TestStrukturyPreAtributy1",
"type": "FreeAttrTestStructure",
"nr": 4,
"color": 0,
"disableElementAssignment": false,
"id": "f0ebc65f-6ddc-4fa3-8f02-2911665adee4"
}
],
"elements": [],
"projectId": "3904db18-cf1a-4665-9c2b-152b84293259",
"name": "FreeAttrStructure",
"description": "MainNode",
"type": "FreeAttrTestStructure",
"nr": 1,
"color": 0,
"disableElementAssignment": false,
"id": "653afdf7-7cfb-42e5-a9b5-e99275ce5cf4"
} |
|
|
Anchor |
---|
| removeAssignedObject |
---|
| removeAssignedObject |
---|
|
Remove assigned object from the latest structureElement node
Deck of Cards |
---|
id | bimRemoveAssignedObject |
---|
|
|
Anchor |
---|
| copyStructure |
---|
| copyStructure |
---|
|
Copy Structure
Anchor |
---|
| updateStructure |
---|
| updateStructure |
---|
|
Update the structure
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
label | URL / Resource / JSON Structure |
---|
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "WallConnection",
"variantType" : "35b986c2-e9cd-482e-9281-6000671a49f0"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 201 Created
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"structureId": "adf506ae-3628-4501-9af1-22bcf27e4ab4",
"objectId": "df4a81d6-42fb-4187-bbce-82a2fc093b2f",
"name": "WallConnection",
"nr": 1,
"id": "35b986c2-e9cd-482e-9281-6000671a49f0"
} |
|
...
Deck of Cards |
---|
id | bimAssignAdditionalObjects |
---|
|
Card |
---|
| {
"structureId": "adf506ae-3628-4501-9af1-22bcf27e4ab4",
"objectId": "df4a81d6-42fb-4187-bbce-82a2fc093b2f",
"name": "WallConnection",
"nr": 1,
"id": "35b986c2-e9cd-482e-9281-6000671a49f0", "variantType" : "35b986c2-e9cd-482e-9281-6000671a49f0" } |
|
...
Remove assigned object from the latest structureElement node
Deck of Cards |
---|
id | bimRemoveAssignedObject |
---|
|
|
...
Copy Structure
...
...
label | Url / Resource /Json |
---|
Resource: structures/<structure_id>/copy
URL: https://api-stage.bimplus.net/v2/<team_slug>/structures/<structure_id>/copy?varianttype=<varianttype_id>
Example:https://api-stage.bimplus.net/v2/bimplus/structures/179439d6-df16-41cc-bd2c-74d05b7995d5/copy?varianttype=733e429a-e232-4e5d-a41e-9bd50aa9763c
JSON Structure:
| | | |
---|
| | | |
name | mandatory | string | Name of the new structure |
| | | |
type | optional | string | Type of the new structure (eg: costStructure, specificationStructure) |
nr | will be ignored | integer | The index of the new structure |
color | optional | integer | Color of the new structure |
id | will be ignored | string(guid) | Unique guid of the structure |
startDate | optional | string (date) | Start date ( depends on type of structure ) |
endDate | optional | string (date) | End date ( depends on type of structure ) |
Optional query parameters
Name | Type | Default value | Description |
---|
varianttype | string (guid) | Guid.Empty | id of the variant type |
bd2c-74d05b7995d5 JSON Structure: Name | Mandatory / Optional | Type | Description |
---|
parentId | optional | string(guid) | Parent node id of the structure (for the first structure, projectId is the parentId) | name | optional | string | Name of the structure | description | optional | string | Description of the structure | type | optional | string | Type of the structure (eg: costStructure, specificationStructure) | nr | optional | integer | The index of the structure | color | optional | integer | Color of the structure | id | will be ignored | string(guid) | Unique guid of the structure |
|
Card |
---|
| Update the specified structure |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "Updated Structure"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"parentId": "622272da-f1ff-45ab-a3f0-c8f1255c80e8",
"name": "Updated Structure",
"description": "FullLifeCycleTest",
"type": "CostStructure",
"nr": 1,
"color": 0,
"id": "179439d6-df16-41cc-bd2c-74d05b7995d5"
} |
|
|
Anchor |
---|
| deleteStructure |
---|
| deleteStructure |
---|
|
Delete the structure
...
Update the structure
Deck of Cards |
---|
|
Card |
---|
default | true |
---|
label | URL / Resource / JSON Structure |
---|
| Resource: structures/<structure_ id>id> URL: https://api-stage.bimplus.net/v2/<team_slug>/structures/<structure_id> id> Example:https://api-stage.bimplus.net/v2/bimplus/structures/179439d6db540336-df1647a3-41cc426e-bd2cb3bf-74d05b7995d51e532bfac8ea JSON Structure: Name | Mandatory / Optional | Type | Description |
---|
parentId | optional | string(guid) | Parent node id of the structure (for the first structure, projectId is the parentId) | name | optional | string | Name of the structure | description | optional | string | Description of the structure | type | optional | string | Type of the structure (eg: costStructure, specificationStructure) | nr | optional | integer | The index of the structure | color | optional | integer | Color of the structure | id | will be ignored | string(guid) | Unique guid of the structure |
| card
Optional query parameters | label | HTTP Method | PUT |
Card |
---|
| Update the specified structure |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "Updated Structure"
} |
|
Type | Default value | Description |
---|
forceDelete | string(boolean) | false | if true delete also all attachments which are under structure and are not lock, if under structure are locked document return 207 and delete just not locked document and structure. | deleteAll | string (boolean) | false | if true delete also all attachments which are under structure and are not lock, if under structure are locked document return forbidden. |
|
Card |
---|
| Deletes a specified structure. |
Card |
---|
|
| Card |
---|
| Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"parentId": "622272da-f1ff-45ab-a3f0-c8f1255c80e8",
"name": "Updated Structure",
"description": "FullLifeCycleTest",
"type": "CostStructure",
"nr": 1,
"color": 0,
"id": "179439d6-df16-41cc-bd2c-74d05b7995d5"
} |
|
|
...
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
|
|
Anchor |
---|
| downloadStructureAttachments |
---|
| downloadStructureAttachments |
---|
|
Download attachments of
...
the structure
Deck of Cards |
---|
id | bimDeleteStructurebimDownloadStructureAttachments |
---|
|
Card |
---|
| Deletes a specified structure. |
Card |
---|
| Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
|
|
|
Card |
---|
default | true |
---|
label | URL / Resource / JSON Structure |
---|
|
Resource: structures/<structure_id> URL: https://api-stage.bimplus.net/v2/<team_slug>/structures/<structure_id> Example: Card |
---|
| Downloads all attachments assigned to the required structure node including all children. Downloaded content is a compressed zip file. The directory structure in downloaded zip file reflects hierarchy of the structure nodes where structure names represent folder names. As a attachment name are used original filenames of the attachments. The requested attachment types included in result zip file can be defined in query parameters. e..g. | 179439d6df1641ccbd2c-74d05b7995d5JSON Structure: Name | Mandatory / Optional | Type | Description |
---|
parentId | optional | string(guid) | Parent node id of the structure (for the first structure, projectId is the parentId) | name | optional | string | Name of the structure | description | optional | string | Description of the structure | type | optional | string | Type of the structure (eg: costStructure, specificationStructure) | nr | optional | integer | The index of the structure | color | optional | integer | Color of the structure | id | will be ignored | string(guid) | Unique guid of the structure |
|
...
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/zip
|
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
The response format is application/octet-stream. |
|
Anchor |
---|
| createVariant |
---|
| createVariant |
---|
|
...
Deck of Cards |
---|
|
Card |
---|
| Create a new variant type of defined structure(eg: cost structure, specification structure) under a project |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "TestVariant type",
"description": "Description of the Test variant type"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 201 Created
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "TestVariant type",
"description": "Description of the Test variant type",
"id": "733e429a-e232-4e5d-a41e-9bd50aa9763c"
} |
|
|
...
Deck of Cards |
---|
|
Card |
---|
| Update the specified variant type |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "Updated TestVariantType4 name"
"description": "Updated description of the TestVariantType4"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "Updated TestVariantType4 name",
"description": "Updated description of the TestVariant type 4",
"id": "733e429a-e232-4e5d-a41e-9bd50aa9763c"
} |
|
|
...
Deck of Cards |
---|
|
Card |
---|
| Updates the specified target variant type with all structure element's assignments of elements from source variant type. When variant type id is missing will be used internally default variant type (Guid.Empty) as a source variant type Note: In case when at least one element is already assigned in target variant type and the same element is also present in source variant type, such api call will return Conflict response and target variant type will not be updated. |
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Headers |
---|
| Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "ignored variant type name",
"description": "ignored description of variant type",
"id": "f2cf9b21-c1bb-463d-bbee-a6fbfb5e8b3e"
} |
|
Card |
---|
|
Code Block |
---|
borderColor | Green |
---|
lang | xml |
---|
title | Status |
---|
| Status: 200 OK
|
Code Block |
---|
borderColor | Red |
---|
lang | xml |
---|
title | JSON |
---|
| {
"name": "Updated TestVariantType4 name",
"description": "Updated description of the TestVariant type 4",
"id": "733e429a-e232-4e5d-a41e-9bd50aa9763c"
} |
|
|
...