Sensor Trigger Resource

Get Sensor Trigger

HTTP Request

GET /api/sensorTriggers/{id}

📋 Description: Retrieves detailed information about a specific sensor trigger identified by the provided ID, enabling users to access relevant data for monitoring and analysis.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

SensorTriggerDTO

Update Sensor Trigger

HTTP Request

PUT /api/sensorTriggers/{id}

📋 Description: Updates the configuration of a specific sensor trigger identified by its unique ID, allowing for adjustments to operational parameters in response to changing business needs.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

SensorTriggerTemplateDTO

true

Request body containing the updated configuration details for the specified sensor trigger, including parameters such as threshold values and notification settings.

Responses

Status

Meaning

Description

Schema

200

OK

OK

None

Delete Sensor Trigger

HTTP Request

DELETE /api/sensorTriggers/{id}

📋 Description: Deletes a specified sensor trigger from the system, ensuring that obsolete or unnecessary triggers are effectively removed to maintain optimal operational efficiency.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

204

No Content

No Content

None

Get All Sensor Triggers

HTTP Request

GET /api/sensorTriggers

📋 Description: Retrieves a list of sensor triggers, enabling users to monitor and manage sensor events effectively within their operational environment.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[SensorTriggerDTO]

false

none

[Data transfer object representing a sensor trigger event, encapsulating relevant details such as sensor ID, trigger type, and timestamp, to facilitate real-time monitoring and response in operational environments.]

» id

integer(int64)

false

none

Unique identifier for the resource

» createdBy

string

false

none

Username of who created this resource

» createdAt

string(date-time)

false

none

Timestamp when this resource was created

» displayId

string

false

none

Unique identifier for the display

» name

string

false

none

Name of the resource

» description

string

false

none

Description of the resource

» triggerValue

string

false

none

Value that indicates the specific condition or threshold that activates the associated sensor trigger within the system.

» triggerType

string

false

none

Type of the trigger

» thresholdFrequency

string

false

none

Specifies the frequency threshold for sensor-triggered events, enabling precise monitoring and response within operational parameters.

» thresholdCondition

string

false

none

Specifies the condition that triggers the sensor, enabling proactive monitoring and response to predefined thresholds.

» startDate

string(date)

false

none

Start date of the resource

» sensorId

integer(int64)

false

none

Unique identifier for the sensor

» sensorName

string

false

none

Name of the sensor

» sensorDto

SensorDTO

false

none

Data transfer object representing a sensor’s attributes and operational data, facilitating real-time monitoring and analysis for enhanced decision-making in enterprise environments.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» createdBy

string

false

none

Username of who created this resource

»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»» displayId

string

false

none

Unique identifier for the display

»» name

string

false

none

Name of the resource

»» imageId

integer(int64)

false

none

Unique identifier for the image

»» description

string

false

none

Description of the resource

»» measurementType

string

false

none

Type of the measurement

»» measurementFrequency

string

false

none

Specifies the frequency at which sensor measurements are taken, enabling effective monitoring and analysis of data trends.

»» sensorSourceId

integer(int64)

false

none

Unique identifier for the sensor source

»» sensorSourceName

string

false

none

Name of the sensor source

»» sensorTypeId

integer(int64)

false

none

Unique identifier for the sensor type

»» sensorTypeName

string

false

none

Name of the sensor type

»» sensorScaleId

integer(int64)

false

none

Unique identifier for the sensor scale

»» sensorScaleName

string

false

none

Name of the sensor scale

»» assetId

integer(int64)

false

none

Unique identifier for the asset

»» assetName

string

false

none

Name of the asset

»» mainAssetDto

MainAssetDTO

false

none

MainAssetDTO is a data transfer object that encapsulates key information about a primary asset within the organization, including its attributes, status, and associated metadata, facilitating effective asset management and decision-making.

»»» id

integer(int64)

false

none

Unique identifier for the resource

»»» createdBy

string

false

none

Username of who created this resource

»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»» displayId

string

false

none

Unique identifier for the display

»»» name

string

false

none

Name of the resource

»»» description

string

false

none

Description of the resource

»»» qrCode

string

false

none

Code for the qr

»»» barCode

string

false

none

Code for the bar

»»» imageId

integer(int64)

false

none

Unique identifier for the image

»»» model

string

false

none

Specifies the model associated with the main asset, providing essential context for asset classification and management.

»»» manufacturer

string

false

none

Name of the manufacturer associated with the asset, providing essential information for inventory management and supplier relations.

»»» serialNumber

string

false

none

Unique identifier for the asset, used to track and manage inventory within the system.

»»» cost

string

false

none

Represents the total cost associated with the main asset, providing essential financial information for budgeting and resource allocation.

»»» premiseId

integer(int64)

false

none

Unique identifier for the premise

»»» premiseDisplayId

string

false

none

Unique identifier for the premise display

»»» premiseDto

PremiseDTO

false

none

Data transfer object representing a premise, encapsulating essential details such as location, type, and associated attributes to facilitate effective decision-making in real estate and operational planning.

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» createdBy

string

false

none

Username of who created this resource

»»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»»» displayId

string

false

none

Unique identifier for the display

»»»» premiseName

string

false

none

Name of the premise

»»»» description

string

false

none

Description of the resource

»»»» address

string

true

none

Represents the physical location associated with the premise, essential for logistics and service delivery.

»»»» internalTeamNames

[string]

false

none

List of names representing the internal teams associated with the premise, facilitating streamlined collaboration and resource allocation within the organization.

»»»» internalTeamIds

[integer]

false

none

List of unique identifiers representing the internal teams associated with the premise, facilitating streamlined collaboration and resource allocation.

»»»» premiseAvailable

boolean

false

none

Indicates whether the premise is available for use within the specified context.

»»»» premiseFromNrm

boolean

false

none

Indicates whether the premise is sourced from the National Resource Management (NRM) framework, facilitating compliance and reporting within environmental management processes.

»»»» nlmId

integer(int64)

false

none

Unique identifier for the nlm

»»»» nlmDisplayId

string

false

none

Unique identifier for the nlm display

»»»» nlmUsed

boolean

false

none

Indicates whether the National Labor Market (NLM) resources have been utilized in the premise evaluation process.

»»»» manager

integer(int64)

false

none

Unique identifier for the manager associated with the premise, facilitating effective organizational hierarchy and resource management.

»»»» managerName

string

false

none

Name of the manager

»»»» imageId

integer(int64)

false

none

Unique identifier for the image

»»»» area

string

false

none

Represents the geographic area associated with the premise, providing essential context for location-based services and analysis.

»»»» modifiedAt

string(date-time)

false

none

Timestamp when this resource was last modified

»»» acquisitionDate

string(date)

false

none

Date of the acquisition

»»» endOfLife

string(date)

false

none

Indicates the end-of-life date for the asset, providing critical information for lifecycle management and planning.

»»» assetStatusId

integer(int64)

false

none

Unique identifier for the asset status

»»» assetStatus

string

false

none

Status of the asset

»»» assetStatusType

string

false

none

Type of the asset status

»»» parentAssetId

integer(int64)

false

none

Unique identifier for the parent asset

»»» parentAssetDisplayId

string

false

none

Unique identifier for the parent asset display

»»» parentAsset

string

false

none

Identifier for the parent asset associated with the main asset, facilitating hierarchical relationships within asset management.

»»» parentAssetDto

MainAssetDTO

false

none

MainAssetDTO is a data transfer object that encapsulates key information about a primary asset within the organization, including its attributes, status, and associated metadata, facilitating effective asset management and decision-making.

»»» upcomingMaintenanceDate

string(date)

false

none

Date of the upcoming maintenance

»»» assetCategoryIds

[integer]

false

none

Array of unique identifiers representing the categories to which the asset belongs, facilitating effective asset classification and management.

»»» assetCategories

[string]

false

none

Array of asset categories that classify the main assets within the system, facilitating better organization and management of asset data.

»»» internalTeamIds

[integer]

false

none

Array of unique identifiers representing the internal teams associated with the main asset, facilitating streamlined collaboration and resource allocation.

»»» internalTeamDtos

[InternalTeamDTO]

false

none

An array of MainAssetDTO objects representing the internal teams associated with the asset, facilitating effective resource management and collaboration within the organization.

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» createdBy

string

false

none

Username of who created this resource

»»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»»» displayId

string

false

none

Unique identifier for the display

»»»» name

string

false

none

Name of the resource

»»»» email

string

false

none

Email address of the internal team member, used for communication and notifications within the organization.

»»»» phone

string

false

none

Contact number for the internal team, facilitating communication and collaboration within the organization.

»»»» manager

string

false

none

Represents the name or identifier of the team manager responsible for overseeing the internal team.

»»»» requestCategoryName

[string]

false

none

Name of the request category

»»»» requestCategoryId

[integer]

false

none

Unique identifier for the request category

»»»» requestCategoryDisplayId

[string]

false

none

Unique identifier for the request category display

»»»» description

string

false

none

Description of the resource

»»»» internalTeamUser

[integer]

false

none

An array of InternalTeamDTO objects representing the users within the internal team, facilitating collaboration and resource management.

»»»» members

integer(int32)

false

none

Represents the total number of members within the internal team, providing insight into team size for resource allocation and management.

»»»» mainAssets

[integer]

false

none

An array of internal team assets that represent the key resources and capabilities utilized within the organization.

»»»» premiseNames

[string]

false

none

List of names associated with the premises relevant to the internal team, facilitating efficient identification and management of locations within the organization.

»»»» internalTeamAvailable

boolean

false

none

Indicates the availability of the internal team for project allocation and resource planning.

»»»» premiseIds

[integer]

false

none

Array of unique identifiers representing the premises associated with the internal team.

»»» internalTeams

[string]

false

none

An array of internal teams associated with the main asset, facilitating collaboration and resource allocation within the organization.

»»» assignedUserIds

[integer]

false

none

Array of unique identifiers representing users assigned to the main asset, facilitating effective resource management and accountability.

»»» assignedUserDtos

[UserDTO]

false

none

Array of user assignments associated with the main asset, providing insights into resource allocation and accountability.

»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»» createdBy

string

false

none

Username of who created this resource

»»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»»» userName

string

false

none

Name of the user

»»»» firstName

string

false

none

Name of the first

»»»» lastName

string

false

none

Name of the last

»»»» email

string

false

none

Email address of the user, used for communication and account verification purposes within the system.

»»»» roleIds

[Role]

false

none

Array of unique identifiers representing the roles assigned to the user, facilitating role-based access and permissions within the system.

»»»»» id

integer(int64)

false

none

Unique identifier for the resource

»»»»» createdBy

string

false

none

Username of who created this resource

»»»»» createdAt

string(date-time)

false

none

Timestamp when this resource was created

»»»»» modifiedBy

string

false

none

Username of who last modified this resource

»»»»» modifiedAt

string(date-time)

false

none

Timestamp when this resource was last modified

»»»»» roleName

string

false

none

Name of the role

»»»»» entity

string

false

none

Represents the specific role associated with the entity within the organizational structure, facilitating effective resource allocation and management.

»»»»» new

boolean

false

none

Indicates whether the role is newly created within the system, facilitating effective management of organizational changes.

»»»» internalTeamNames

[string]

false

none

List of names representing the internal teams associated with the user, facilitating effective collaboration and resource allocation within the organization.

»»»» internalTeamIds

[integer]

false

none

An array of unique identifiers representing the internal teams associated with the user, facilitating team management and collaboration within the organization.

»»»» internalTeamDisplayIds

[string]

false

none

An array of unique identifiers representing the internal teams associated with the user, facilitating streamlined team management and collaboration.

»»»» premiseIds

[integer]

false

none

Array of unique identifiers representing the premises associated with the user, facilitating efficient management and tracking of user-related locations.

»»»» premiseNames

[string]

false

none

List of names associated with the user’s premises, providing essential context for location-based services and operations.

»»»» userAvailable

boolean

false

none

Indicates whether the user is available for assignment or engagement within the system.

»»»» temporaryWorkload

integer(int32)

false

none

Represents the temporary workload allocation for the user, measured in integer units, to facilitate effective resource management and planning.

»»»» preferredCultureCode

string

false

none

Code for the preferred culture

»»» assignedUsers

[string]

false

none

List of users assigned to the main asset, facilitating effective resource management and collaboration within the organization.

»»» assetPriority

string

false

none

Priority of the asset

»»» assetPriorityId

integer(int64)

false

none

Unique identifier for the asset priority

»»» assetPriorityDisplayId

string

false

none

Unique identifier for the asset priority display

»»» assetPriorityType

string

false

none

Type of the asset priority

»»» assetAvailable

boolean

false

none

Indicates whether the asset is currently available for allocation or use within the system.

»»» exactPlacement

string

false

none

Specifies the precise location or context in which the main asset is intended to be utilized within the business framework.

»»» fosId

integer(int64)

false

none

Unique identifier for the fos

»»» downtimeStatus

string

false

none

Status of the downtime

»»» premiseFromNrm

boolean

false

none

Indicates whether the asset is sourced from the National Resource Management (NRM) framework, facilitating compliance and resource tracking.

»»» modifiedAt

string(date-time)

false

none

Timestamp when this resource was last modified

»» premiseId

integer(int64)

false

none

Unique identifier for the premise

»» premiseName

string

false

none

Name of the premise

»» premiseDto

PremiseDTO

false

none

Data transfer object representing a premise, encapsulating essential details such as location, type, and associated attributes to facilitate effective decision-making in real estate and operational planning.

»» sensorAvailable

boolean

false

none

Indicates the availability status of the sensor, enabling efficient resource management and operational decision-making.

»» modifiedAt

string(date-time)

false

none

Timestamp when this resource was last modified

Create Sensor Trigger

HTTP Request

POST /api/sensorTriggers

📋 Description: Creates a new sensor trigger within the system, enabling automated responses based on specific sensor data inputs to enhance operational efficiency.

Parameters

Name

In

Type

Required

Description

body

body

SensorTriggerTemplateDTO

true

Request body containing the configuration details for sensor triggers, including parameters for activation conditions and notification settings.

Responses

Status

Meaning

Description

Schema

201

Created

Created

SensorTriggerDTO

Find Sensor Triggers

HTTP Request

POST /api/sensorTriggers/search

📋 Description: Submits a request to search for sensor triggers based on specified criteria, enabling efficient identification and management of sensor-related events within the system.

Parameters

Name

In

Type

Required

Description

pageable

query

Pageable

true

Indicates whether the search results for sensor triggers should be returned in a paginated format to enhance data management and user experience.

body

body

SensorTriggerDtoFilter

true

Request body containing the criteria for searching sensor triggers, including parameters such as trigger type, status, and relevant metadata.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageSensorTriggerDTO

Get Threshold Frequencies

HTTP Request

GET /api/sensorTriggers/value

📋 Description: Retrieves the current values of sensor triggers, enabling real-time monitoring and analysis for operational decision-making.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Get Trigger Types

HTTP Request

GET /api/sensorTriggers/type

📋 Description: Fetches the list of available sensor trigger types, enabling users to identify and utilize specific triggers for monitoring and automation purposes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema

Get Trigger With Event

HTTP Request

GET /api/sensorTriggers/event/{id}

📋 Description: Retrieves detailed information about a specific sensor trigger event identified by the unique event ID, enabling users to monitor and analyze sensor activity effectively.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

SensorTriggerTemplateDTO

Get Threshold Conditions

HTTP Request

GET /api/sensorTriggers/condition

📋 Description: Retrieves the current sensor trigger conditions, enabling users to monitor and manage sensor-related events effectively.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

Response Schema