1. Overview

Microservice containing the business logic for managing templates of property definitions.

1.1. URI scheme

Host : localhost
BasePath : /property-app-service/

1.2. Tags

  • data-type-controller : Data Type Controller

  • engineering-units-controller : Engineering Units Controller

  • property-category-controller : Property Category Controller

  • property-definition-controller : Property Definition Controller

  • property-group-controller : Property Group Controller

2. Resources

2.1. Data-type-controller

Data Type Controller

2.1.1. Query DataTypes

GET /v1/dataTypes
Parameters
Type Name Description Schema Default

Query

page
optional

page

integer (int32)

0

Query

size
optional

size

integer (int32)

20

Responses
HTTP Code Description Schema

200

OK

DataTypeInfosPage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.2. Engineering-units-controller

Engineering Units Controller

2.2.1. Query DataTypes

GET /v1/engineeringUnits
Parameters
Type Name Description Schema

Query

active
optional

engineering unit active to get uom details

boolean

Query

code
optional

engineering unit code to get uom details

string

Query

description
optional

engineering unit description to get uom details

string

Query

page
optional

Results page you want to retrieve (0..N)

integer (int32)

Query

size
optional

Number of records per page.

integer (int32)

Responses
HTTP Code Description Schema

200

OK

UnitOfMeasurePage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.3. Property-category-controller

Property Category Controller

2.3.1. createPropertyCategory

POST /v1/propertyCategories
Parameters
Type Name Description Schema

Body

propertyCategoryInfo
required

propertyCategoryInfo

PropertyCategoryRequest

Responses
HTTP Code Description Schema

201

Created

PropertyCategory

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

409

Category with that name already exists

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.3.2. Query Property Categories

GET /v1/propertyCategories
Parameters
Type Name Description Schema Default

Query

includeDeleted
optional

includeDeleted

boolean

"false"

Query

page
optional

page

integer (int32)

0

Query

size
optional

size

integer (int32)

20

Responses
HTTP Code Description Schema

200

OK

PropertyCategoriesPage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.3.3. Query Property Categories

GET /v1/propertyCategories/{id}
Parameters
Type Name Description Schema

Path

id
required

id

string

Responses
HTTP Code Description Schema

200

OK

PropertyCategoryPage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.3.4. updatePropertyCategory

PUT /v1/propertyCategories/{id}
Parameters
Type Name Description Schema

Path

id
required

id

string

Body

propertyCategoryInfo
required

propertyCategoryInfo

PropertyCategoryRequest

Responses
HTTP Code Description Schema

200

OK

PropertyCategory

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

409

Category with that name already exists

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.3.5. Delete Property Category

DELETE /v1/propertyCategories/{id}
Parameters
Type Name Description Schema Default

Path

id
required

id

string

Query

forceDelete
optional

forceDelete

boolean

"false"

Responses
HTTP Code Description Schema

200

OK

object

400

Bad Request.

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • /

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.4. Property-definition-controller

Property Definition Controller

2.4.1. getPropertyDefinitions

GET /v1/propertyDefinitions
Parameters
Type Name Description Schema Default

Query

includeDeleted
optional

includeDeleted

boolean

"false"

Query

page
optional

page

integer (int32)

0

Query

propertyCategoryId
optional

propertyCategoryId

string

Query

propertyDefinitionIds
optional

propertyDefinitionIds

< string > array(multi)

Query

propertyGroupId
optional

propertyGroupId

string

Query

propertyName
optional

propertyName

string

Query

size
optional

size

integer (int32)

20

Query

version
optional

version

integer (int32)

Responses
HTTP Code Description Schema

200

OK

PropertyDefinitionsPage

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.4.2. createPropertyDefinition

POST /v1/propertyGroups/{propertyGroupId}/propertyDefinitions
Parameters
Type Name Description Schema

Path

propertyGroupId
required

propertyGroupId

string

Body

createPropertyDefinitionRequest
required

createPropertyDefinitionRequest

PropertyDefinitionRequest

Responses
HTTP Code Description Schema

201

OK

PropertyDefinitionInfo

400

Invalid data supplied. See message for details.

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

409

Property definition with that name already exists in the propertyGroup

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.4.3. getPropertyDefinitionsByGroup

GET /v1/propertyGroups/{propertyGroupId}/propertyDefinitions
Parameters
Type Name Description Schema Default

Path

propertyGroupId
required

propertyGroupId

string

Query

includeDeleted
optional

includeDeleted

boolean

Query

page
optional

page

integer (int32)

0

Query

size
optional

size

integer (int32)

20

Responses
HTTP Code Description Schema

200

OK

PropertyDefinitionsPage

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.4.4. deletePropertyDefinitions

DELETE /v1/propertyGroups/{propertyGroupId}/propertyDefinitions
Parameters
Type Name Description Schema

Path

propertyGroupId
required

propertyGroupId

string

Responses
HTTP Code Description Schema

200

OK

object

400

propertyGroup not found

No Content

401

Unauthorized

No Content

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.4.5. getPropertyDefinition

GET /v1/propertyGroups/{propertyGroupId}/propertyDefinitions/{propertyDefinitionId}
Parameters
Type Name Description Schema

Path

propertyDefinitionId
required

propertyDefinitionId

string

Path

propertyGroupId
required

propertyGroupId

string

Responses
HTTP Code Description Schema

200

OK

PropertyDefinitionPage

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.4.6. updatePropertyDefinition

PUT /v1/propertyGroups/{propertyGroupId}/propertyDefinitions/{propertyDefinitionId}
Parameters
Type Name Description Schema

Path

propertyDefinitionId
required

propertyDefinitionId

string

Path

propertyGroupId
required

propertyGroupId

string

Body

updatePropertyDefinitionRequest
required

updatePropertyDefinitionRequest

PropertyDefinitionUpdateRequest

Responses
HTTP Code Description Schema

200

OK

object

400

Invalid data supplied. See message for details.

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not found

HttpErrorResponse

409

Property definition with that name already exists on the propertyGroup

HttpErrorResponse

412

Property definition has been updated since the GET on which the submitted changes were made. Response contains the current record.

HttpErrorResponse

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.4.7. deletePropertyDefinition

DELETE /v1/propertyGroups/{propertyGroupId}/propertyDefinitions/{propertyDefinitionId}
Parameters
Type Name Description Schema

Path

propertyDefinitionId
required

propertyDefinitionId

string

Path

propertyGroupId
required

propertyGroupId

string

Responses
HTTP Code Description Schema

200

OK

object

400

propertyGroup not found

No Content

401

Unauthorized

No Content

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.5. Property-group-controller

Property Group Controller

2.5.1. createPropertyGroup

POST /v1/propertyGroups
Parameters
Type Name Description Schema

Body

createProperyGroupRequest
required

createProperyGroupRequest

PropertyGroupRequest

Responses
HTTP Code Description Schema

201

Created

PropertyGroupPage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

409

Property Group with that name already exists

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.5.2. Query Property Groups

GET /v1/propertyGroups
Parameters
Type Name Description Schema Default

Query

categoryId
optional

categoryId

string

Query

includeDeleted
optional

includeDeleted

boolean

"false"

Query

page
optional

page

integer (int32)

0

Query

size
optional

size

integer (int32)

20

Responses
HTTP Code Description Schema

200

OK

PropertyGroupsPage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.5.3. Delete All the Property Groups

DELETE /v1/propertyGroups
Responses
HTTP Code Description Schema

200

OK

object

400

Bad Request.

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • /

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.5.4. Query Property Group

GET /v1/propertyGroups/{id}
Parameters
Type Name Description Schema

Path

id
required

id

string

Responses
HTTP Code Description Schema

200

OK

PropertyGroupPage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.5.5. updatePropertyGroup

PUT /v1/propertyGroups/{id}
Parameters
Type Name Description Schema

Path

id
required

id

string

Body

properyGroupRequest
required

properyGroupRequest

PropertyGroupRequest

Responses
HTTP Code Description Schema

200

OK

PropertyGroupPage

400

Bad Request

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

409

Property Group with that name already exists

HttpErrorResponse

412

Property Group has been updated since the GET on which the submitted changes were made. Response contains the current record.

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.5.6. Delete Property Group

DELETE /v1/propertyGroups/{id}
Parameters
Type Name Description Schema Default

Path

id
required

id

string

Query

forceDelete
optional

forceDelete

boolean

"false"

Responses
HTTP Code Description Schema

200

OK

object

400

Bad Request.

HttpErrorResponse

401

Unauthorized

HttpErrorResponse

404

Not Found

HttpErrorResponse

500

Internal Server error

HttpErrorResponse

Produces
  • /

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

3. Definitions

3.1. DataTypeInfosPage

Name Schema

content
optional

< PropertyDataTypeInfo > array

links
optional

< Link > array

page
optional

PageMetadata

3.2. Error

Name Schema

code
optional

string

details
optional

object

3.3. HttpErrorResponse

Name Schema

error
optional

Error

path
optional

string

timestamp
optional

string

Name Schema

href
optional

string

rel
optional

string

templated
optional

boolean

3.5. PageMetadata

Name Schema

number
optional

integer (int64)

size
optional

integer (int64)

totalElements
optional

integer (int64)

totalPages
optional

integer (int64)

3.6. PropertyCategoriesPage

Name Schema

content
optional

< PropertyCategory > array

links
optional

< Link > array

page
optional

PageMetadata

3.7. PropertyCategory

Name Description Schema

createdBy
optional

string

createdOn
optional

string (date-time)

deleted
optional

Example : false

boolean

id
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

name
optional

string

propertyGroups
optional

< PropertyGroup > array

version
optional

integer (int32)

3.8. PropertyCategoryPage

Name Description Schema

createdBy
optional

string

createdOn
optional

string (date-time)

deleted
optional

Example : false

boolean

id
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

links
optional

< Link > array

name
optional

string

propertyGroups
optional

< PropertyGroup > array

version
optional

integer (int32)

3.9. PropertyCategoryRequest

Name Schema

name
optional

string

3.10. PropertyDataType

Name Schema

dataTypeDesc
optional

string

id
optional

integer (int32)

name
optional

string

usePrecision
optional

integer (int32)

userDefined
optional

integer (int32)

3.11. PropertyDataTypeInfo

Name Schema

dataTypeDesc
optional

string

id
optional

integer (int64)

name
optional

string

usePrecision
optional

integer (int32)

userDefined
optional

integer (int32)

3.12. PropertyDefinition

Name Description Schema

createdBy
optional

string

createdOn
optional

string (date-time)

defaultValue
optional

string

deleted
optional

Example : false

boolean

displayName
optional

string

id
optional

string

initialId
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

name
optional

string

propertyDataType
optional

PropertyDataType

propertyGroup
optional

PropertyGroup

required
optional

Example : false

boolean

uom
optional

integer (int32)

version
optional

integer (int32)

3.13. PropertyDefinitionInfo

Name Schema

createdBy
optional

string

createdOn
optional

string (date-time)

defaultValue
optional

string

deleted
optional

boolean

displayName
optional

string

id
optional

string

initialId
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

name
optional

string

propertyCategoryId
optional

string

propertyCategoryName
optional

string

propertyDataType
optional

string

propertyDataTypeId
optional

integer (int32)

propertyGroupId
optional

string

propertyGroupName
optional

string

required
optional

boolean

uom
optional

integer (int32)

version
optional

integer (int32)

3.14. PropertyDefinitionPage

Name Description Schema

createdBy
optional

string

createdOn
optional

string (date-time)

defaultValue
optional

string

deleted
optional

Example : false

boolean

displayName
optional

string

id
optional

string

initialId
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

links
optional

< Link > array

name
optional

string

propertyCategoryId
optional

string

propertyCategoryName
optional

string

propertyDataType
optional

string

propertyDataTypeId
optional

integer (int32)

propertyGroupId
optional

string

propertyGroupName
optional

string

required
optional

Example : false

boolean

uom
optional

integer (int32)

version
optional

integer (int32)

3.15. PropertyDefinitionRequest

Name Schema

dataTypeId
optional

integer (int32)

defaultValue
optional

string

displayName
optional

string

name
optional

string

required
optional

boolean

uomId
optional

integer (int32)

3.16. PropertyDefinitionUpdateRequest

Name Schema

dataTypeId
optional

integer (int32)

defaultValue
optional

string

displayName
optional

string

name
optional

string

required
optional

boolean

uomId
optional

integer (int32)

version
optional

integer (int32)

3.17. PropertyDefinitionsPage

Name Schema

content
optional

< PropertyDefinitionInfo > array

links
optional

< Link > array

page
optional

PageMetadata

3.18. PropertyGroup

Name Description Schema

aliasName
optional

string

createdBy
optional

string

createdOn
optional

string (date-time)

deleted
optional

Example : false

boolean

description
optional

string

id
optional

string

initialId
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

name
optional

string

propertyCategory
optional

PropertyCategory

propertyDefinitions
optional

< PropertyDefinition > array

version
optional

integer (int32)

3.19. PropertyGroupInfo

Name Schema

aliasName
optional

string

createdBy
optional

string

createdOn
optional

string (date-time)

deleted
optional

boolean

description
optional

string

id
optional

string

initialId
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

name
optional

string

propertyCategoryId
optional

string

version
optional

integer (int32)

3.20. PropertyGroupPage

Name Schema

aliasName
optional

string

createdBy
optional

string

createdOn
optional

string (date-time)

deleted
optional

boolean

description
optional

string

id
optional

string

initialId
optional

string

lastModifiedBy
optional

string

lastModifiedOn
optional

string (date-time)

links
optional

< Link > array

name
optional

string

propertyCategoryId
optional

string

version
optional

integer (int32)

3.21. PropertyGroupRequest

Name Schema

aliasName
optional

string

description
optional

string

name
optional

string

propertyCategoryId
optional

string

3.22. PropertyGroupsPage

Name Schema

content
optional

< PropertyGroupInfo > array

links
optional

< Link > array

page
optional

PageMetadata

3.23. UnitOfMeasure

Name Description Schema

active
optional

Active
Example : false

boolean

code
optional

Engineering Unit code

string

description
optional

Engineering Unit description

string

engUnitId
optional

Engineering Unit id

integer (int64)

links
optional

< Link > array

3.24. UnitOfMeasurePage

Name Schema

content
optional

< UnitOfMeasure > array

links
optional

< Link > array

page
optional

PageMetadata

4. Security

4.1. access_token

Type : oauth2
Flow : accessCode
Token URL : https://10.181.213.73/uaa/oauth/authorize
Token URL : https://10.181.213.73/uaa/oauth/token

Name Description

default

Default oauth2 scope.

4.2. resource_owner

Type : oauth2
Flow : password
Token URL : https://10.181.213.73/uaa/oauth/token

Name Description

default

Default oauth2 scope.

4.3. implicit_grant

Type : oauth2
Flow : implicit
Token URL : https://10.181.213.73/uaa/oauth/authorize

Name Description

default

Default oauth2 scope.

4.4. client_creds

Type : oauth2
Flow : application
Token URL : https://10.181.213.73/uaa/oauth/token

Name Description

default

Default oauth2 scope.