Page History

...

Team DB contains some additional APIs for working with attribute templates which are specified in this section.

Create an attribute template
Get all the attribute templates that belongs to a team
Get the info about a particular attribute template
Update a particular attribute template
Delete a particular attribute template

...

Deck of Cards

id	bimcreateBimUnit

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units

Example: https://api-stage.bimplus.net/v2/content/units

JSON Structure:

Name	Mandatory / Optional	Type	Description
name	mandatory	string	Name of the unit
description	optional	string	Short description of the unit
symbol	mandatory	string	Symbol of the unit
baseunitid	optional	string(guid)	Specify this property for deriving a unit from a base unit
usequence	optional	int	Unit sequence (default is 1)
upower	optional	int	Unit power (default is 1)
ufactor	optional	int	Unit factor (default is 1)

Card

label	HTTP Method

POST

Card

label	Description

Creates a new unit. An unit can be created fresh(base unit) or we can derive an unit from a base unit by specifying the baseunitid

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
title	JSON
lang	xml

{
  "name": "MyDerivedUnit",
  "description": "Example of derived unit",
  "symbol": "Sym",
  "baseunitid": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
  "usequence": 1,
  "ufactor": 2,
  "upower": 3
}

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 201 Created

Code Block

borderColor	Red
title	JSON
lang	xml

{
  "symbol": "Sym",
  "baseunitid": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
  "usequence": 1,
  "ufactor": 2.0,
  "upower": 3,
  "id": "9c75f2e7-bf66-4274-96a6-fb61ecb0e21a",
  "name": "MyDerivedUnit",
  "description": "Example of derived unit"
}

Anchor

	getBimUnitList
	getBimUnitList

Get all the units from Bimplus DB

Deck of Cards

id	bimGetBimUnitList

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units

Example: https://api-stage.bimplus.net/v2/content/units

Filter: https://api-stage.bimplus.net/v2/content/units?symbol=<symbolname>", returns all the unit with the specified symbol name.

Card

label	HTTP Method

GET

Card

label	Description

Get all the units from Bimplus DB.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Code Block

borderColor	Red
title	JSON
lang	xml

[
    {
        "unit": "kg",
        "contextUnitType": "MASSUNIT",
        "id": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
        "name": "kilogram",
        "description": "base unit for mass"
    },
    {
        "unit": "m",
        "contextUnitType": "LENGTHUNIT",
        "id": "7be3452a-47f9-4fd8-bd94-ef6c967d684e",
        "name": "meter",
        "description": "base unit for length"
    },
    {
        "unit": "s",
        "contextUnitType": "TIMEUNIT",
        "id": "456e899b-2bda-49a5-8e6f-e1ff8bfd9e14",
        "name": "second",
        "description": "base unit for time"
    },
    {
        "unit": "K",
        "contextUnitType": "THERMODYNAMICTEMPERATUREUNIT",
        "id": "cbd91636-49fa-4a4f-bdcc-03f27ca205f8",
        "name": "kelvin",
        "description": "base unit for thermodynamic temperature"
    },
......
]

Anchor

	getBimUnit
	getBimUnit

Get the info about a particular unit in Bimplus DB

Deck of Cards

id	bimGetBimUnit

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units/<unit_id>

Example: https://api-stage.bimplus.net/v2/content/units/3b871b65-516e-4e7e-a35f-faa7501d5d0d

Card

label	HTTP Method

GET

Card

label	Description

Get the info about a particular unit in Bimplus DB.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Code Block

borderColor	Red
title	JSON
lang	xml

{
    "unit": "kg",
    "contextUnitType": "MASSUNIT",
    "id": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
    "name": "kilogram",
    "description": "base unit for mass"
}

Anchor

	updateBimUnit
	updateBimUnit

Update a particular unit

Deck of Cards

id	updateBimUnit

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units/<id>

Example: https://api-stage.bimplus.net/v2/content/units/3b871b65-516e-4e7e-a35f-faa7501d5d0d

JSON Structure:

Name	Mandatory / Optional	Type	Description
id	will be ignored	string(guid)	id of the unit
name	mandatory	string	Name of the unit
description	optional	string	Short description of the unit
symbol	mandatory	string	Symbol of the unit
baseunitid	optional	string(guid)	Specify this property for deriving a unit from a base unit
usequence	optional	int	Unit sequence (default is 1)
upower	optional	int	Unit power (default is 1)
ufactor	optional	int	Unit factor (default is 1)

Card

label	HTTP Method

PUT

Card

label	Description

Update a particular unit.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
title	JSON
lang	xml

{
    "description": "updated description"
}

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Code Block

borderColor	Red
title	JSON
lang	xml

{
    "unit": "kg",
    "contextUnitType": "MASSUNIT",
    "id": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
    "name": "kilogram",
    "description": "updated description"
}

Anchor

	deleteBimUnit
	deleteBimUnit

Delete a particular unit

Deck of Cards

id	bimDeleteBimAttributeGroup

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units/<unit_id>

Example: https://api-stage.bimplus.net/v2/content/units/3b871b65-516e-4e7e-a35f-faa7501d5d0d

Card

label	HTTP Method

DELETE

Card

label	Description

Deletes the specific unit.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Anchor

	createTeamTemplate
	createTeamTemplate

Create an attribute template

Deck of Cards

id	bimCreateTeamTemplate

Card

default	true
label	URL / Resource / JSON Structure

Resource: attributetemplates

URL: https://api-stage.bimplus.net/v2/<team_slug>/attributetemplates

Example: https://api-stage.bimplus.net/v2/bimplus/attributetemplates

JSON Structure:

Name	Mandatory / Optional	Type	Description
name	mandatory	string	Name of the attribute template
description	optional	string	Short description of the attribute template
freeattributes	mandatory	JSON Array	List of free attribute ids
elementtypes	mandatory	JSON Array	List of element type ids

Card

label	HTTP Method

POST

Card

label	Description

Creates a new attribute template using free attributes & element types.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
title	JSON
lang	xml

{
  "name": "Attribute Template 1",
  "description": "Testing template",
  "freeattributes": [
    {
      "Id": "5EED7275-0B0D-41D5-A13E-0C1C1FA87B33"
    },
    {
      "Id": "67900FFF-A744-4EA3-A0DC-4140E424B756"
    },
    {
      "Id": "B5850E23-B1DF-4D4F-AAE8-CEE0D4BB06E6"
    }
  ],
  "elementtypes": [
    {
      "id": "F18DE608-0F7F-40E3-A0F7-8088778D18CB"
    },
    {
      "id": "F8E1D9E3-82C0-4F14-8337-7FE568117616"
    }
  ]
}

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 201 Created

Code Block

borderColor	Red
title	JSON
lang	xml

{
  "name": "Attribute Template 1",
  "description": "Testing template",
  "elementtypes": [
    {
      "type": "not implemented",
      "category": "/7/1/10/",
      "name": "ID_Wandobjekte",
      "ifcType": "ID_IFCWall",
      "id": "f8e1d9e3-82c0-4f14-8337-7fe568117616"
    },
    {
      "type": "not implemented",
      "category": "/",
      "name": "ID_Hall",
      "ifcType": null,
      "id": "f18de608-0f7f-40e3-a0f7-8088778d18cb"
    }
  ],
  "freeattributes": [
    {
      "type": "double",
      "minvalue": "0",
      "decimal": 2,
      "unitid": "f99f40cf-da64-4c4f-8434-cb90722ba485",
      "unit": "mm",
      "visible": 1,
      "changeable": 1,
      "controltype": "TextBox",
      "id": "b5850e23-b1df-4d4f-aae8-cee0d4bb06e6",
      "name": "bend radius",
      "description": "bend diameter for reinforcement bars"
    },
    {
      "type": "double",
      "decimal": 2,
      "unitid": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
      "unit": "kg",
      "visible": 1,
      "changeable": 1,
      "controltype": "TextBox",
      "id": "5eed7275-0b0d-41d5-a13e-0c1c1fa87b33",
      "name": "double value",
      "description": ""
    },
    {
      "type": "int",
      "minvalue": "1",
      "maxvalue": "1000",
      "defaultvalue": "1",
      "decimal": 0,
      "unitid": "f99f40cf-da64-4c4f-8434-cb90722ba485",
      "unit": "mm",
      "optionalunit": "milimeter",
      "visible": 1,
      "changeable": 1,
      "controltype": "textbox",
      "id": "67900fff-a744-4ea3-a0dc-4140e424b756",
      "name": "NewFreeAttribute1_G2",
      "description": "Test attribute"
    }
  ],
  "created": "2015-04-23T05:42:52.91",
  "createdby": {
    "id": "7c555899-5a5f-44d1-930e-284930678bed",
    "email": "sslacky@nemetschek.com"
  },
  "id": "3e5c0964-8f28-469b-b176-bcfad48f2eef"
}

Anchor

	getBimUnitList
	getBimUnitList

Get all the units from Bimplus DB

Deck of Cards

id	bimGetBimUnitList

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units

Example: https://api-stage.bimplus.net/v2/content/units

Filter: https://api-stage.bimplus.net/v2/content/units?symbol=<symbolname>", returns all the unit with the specified symbol name.

Card

label	HTTP Method

GET

Card

label	Description

Get all the units from Bimplus DB.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Code Block

borderColor	Red
title	JSON
lang	xml

[
    {
        "unit": "kg",
        "contextUnitType": "MASSUNIT",
        "id": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
        "name": "kilogram",
        "description": "base unit for mass"
    },
    {
        "unit": "m",
        "contextUnitType": "LENGTHUNIT",
        "id": "7be3452a-47f9-4fd8-bd94-ef6c967d684e",
        "name": "meter",
        "description": "base unit for length"
    },
    {
        "unit": "s",
        "contextUnitType": "TIMEUNIT",
        "id": "456e899b-2bda-49a5-8e6f-e1ff8bfd9e14",
        "name": "second",
        "description": "base unit for time"
    },
    {
        "unit": "K",
        "contextUnitType": "THERMODYNAMICTEMPERATUREUNIT",
        "id": "cbd91636-49fa-4a4f-bdcc-03f27ca205f8",
        "name": "kelvin",
        "description": "base unit for thermodynamic temperature"
    },
......
]

Anchor

	getBimUnit
	getBimUnit

Get the info about a particular unit in Bimplus DB

Deck of Cards

id	bimGetBimUnit

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units/<unit_id>

Example: https://api-stage.bimplus.net/v2/content/units/3b871b65-516e-4e7e-a35f-faa7501d5d0d

Card

label	HTTP Method

GET

Card

label	Description

Get the info about a particular unit in Bimplus DB.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Code Block

borderColor	Red
title	JSON
lang	xml

{
    "unit": "kg",
    "contextUnitType": "MASSUNIT",
    "id": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
    "name": "kilogram",
    "description": "base unit for mass"
}

Anchor

	updateBimUnit
	updateBimUnit

Update a particular unit

Deck of Cards

id	updateBimUnit

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units/<id>

Example: https://api-stage.bimplus.net/v2/content/units/3b871b65-516e-4e7e-a35f-faa7501d5d0d

JSON Structure:

Name	Mandatory / Optional	Type	Description
id	will be ignored	string(guid)	id of the unit
name	mandatory	string	Name of the unit
description	optional	string	Short description of the unit
symbol	mandatory	string	Symbol of the unit
baseunitid	optional	string(guid)	Specify this property for deriving a unit from a base unit
usequence	optional	int	Unit sequence (default is 1)
upower	optional	int	Unit power (default is 1)
ufactor	optional	int	Unit factor (default is 1)

Card

label	HTTP Method

PUT

Card

label	Description

Update a particular unit.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Code Block

borderColor	Red
title	JSON
lang	xml

{
    "description": "updated description"
}

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Code Block

borderColor	Red
title	JSON
lang	xml

{
    "unit": "kg",
    "contextUnitType": "MASSUNIT",
    "id": "3b871b65-516e-4e7e-a35f-faa7501d5d0d",
    "name": "kilogram",
    "description": "updated description"
}

Anchor

	deleteBimUnit
	deleteBimUnit

Delete a particular unit

Deck of Cards

id	bimDeleteBimAttributeGroup

Card

default	true
label	URL / Resource / JSON Structure

Resource: content/units

URL: https://api-stage.bimplus.net/v2/content/units/<unit_id>

Example: https://api-stage.bimplus.net/v2/content/units/3b871b65-516e-4e7e-a35f-faa7501d5d0d

Card

label	HTTP Method

DELETE

Card

label	Description

Deletes the specific unit.

Card

label	Request

Code Block

borderColor	Green
title	Headers
lang	xml

Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json

Card

label	Response

Code Block

borderColor	Green
title	Status
lang	xml

Status: 200 OK

Math Editor

Space shortcuts

Page tree

Versions Compared

Old Version 30

New Version 31

Key

Get all the units from Bimplus DB

Get the info about a particular unit in Bimplus DB

Update a particular unit

Delete a particular unit

Create an attribute template

Get all the units from Bimplus DB

Get the info about a particular unit in Bimplus DB

Update a particular unit

Delete a particular unit