Honeywell Forge (Preview)
Honeywell Forge is an Enterprise Performance Management Software-as-a-Service. It enables autonomous control of devices and codifies domain knowledge of assets in a contextual way. Use Honeywell Forge Connector to subscribe to Honeywell Forge to receive service cases and to close existing service cases.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Honeywell Support |
| URL | https://www.honeywell.com/us/en/contact/support |
| DL-HCE-SRE@HoneywellProd.onmicrosoft.com |
| Connector Metadata | |
|---|---|
| Publisher | Honeywell International |
| Website | https://www.honeywell.com/us/en/honeywell-forge |
| Privacy policy | https://www.honeywell.com/us/en/privacy-statement |
| Categories | Internet of Things |
Honeywell Forge is an Enterprise Performance Management Software-as-a-Service. Featuring connected software and hardware solutions, Honeywell Forge measures, optimizes, and automates operations, as an open, extensible, cybersecure offering designed to work across any enterprise. It is purpose-built on a native edge-to-cloud and data-driven architecture to accelerate digital transformation by:
- Providing apps that deliver value in days
- Delivering a system of records that is always up-to-date
- Future-proofing investments via extensible applications
- Avoiding the rip-and-replace approach to extensive capital projects
Honeywell Forge enables autonomous control of devices and codifies domain knowledge of assets in a contextual way. Use Honeywell Forge Connector to subscribe to Honeywell Forge to:
- Receive new service cases.
- Close existing service cases.
Prerequisites
You must be a current Honeywell customer to be able to use this connector.
How to get credentials
Please email ConnectedBuildingSupport@honeywell.com to obtain:
- Project ID
- User account with permission to create integration
Getting started with your connector / How to register a webhook with Honeywell Forge
Before you can use this connector you will need to set up the following workflows. You will be asked for Project ID and Connector ID provided by Honeywell Forge spport.
- Create case template
- Close case template
How to close a service case
To close a service case, you will be required to specify a priority, a resolution code, and a root cause code. Please, select one of the values listed below.
Priority
| Priority | Description |
|---|---|
| Low | Low priority. |
| Medium | Medium priority. This is the default. |
| High | High priority. |
Resolution Code
| Resolution Code | Description |
|---|---|
| ADJUSTED | The rule has been adjusted. |
| ALARM | the alarm limits have been altered. |
| CALIBRATED | The equipment has been calibrated. |
| CANCELLED | The contract has been cancelled. |
| CANCELLED_CALL | Customer has cancelled the call. |
| CLEANED | The equipment has been cleaned. |
| CONTROL_LOOP | The control loop has been configured or tunned. |
| FAULT | The customer has provided information about the fault. |
| FIRMWARE | The software or firmware has been updated. |
| FIX | A temporary fix has been implemented. |
| HON_RELATED | The fault is non-Honeywell related. |
| INSPECTED | The equipment has been inspected. |
| ISOLATED | The equipment has been isolated. |
| NO_FAULT | No fault has been found. |
| PROGRAMMING | Programming has been altered. |
| REJECTED | Rule change has been rejected. |
| REMOTE | Remote analysis. |
| REPAIRED | The equipment has been repaired. |
| REPLACED | The equipment has been replaced. |
| REQUEST | Rule change has been requested. |
| RESOLVED | The customer request has been resolved. |
| RESOLVED_CALL | The customer has resolved the call. |
| REVIEWED | The case has been reviewed. |
| SCHEDULING | The scheduling has been altered. |
| SERVICE_RELATED | Non-service related. |
| SERVICED | The equipment has been serviced. |
| SETPOINTS | The setpoints have been altered. |
| SUPRESSED | The rule has been suppressed. |
| TEMPORARY | The rule has been temporarily suppressed. |
| TRAINED | The sustomer has been instructed / trained. |
| UNAVAILABLE | Remote connection is not available. |
Root Cause Code
| Root Cause Code | Description |
|---|---|
| ACCIDENTAL | Accidental damage |
| AGING | Aging equipment |
| CHANGE | Change request |
| END | End of service life |
| ERROR | Configuration error |
| EXTERNAL | External influence |
| FAILURE | Component failure |
| FAULT | Software fault |
| INSTALLATION | Poor installation |
| LEAK | Leak |
| MAINTENANCE | Poor maintenance |
| NOFAULT | No fault has been found. |
| NOFIT | The equipment is no longer fit for purpose. |
| OPERATOR | Operator error |
| POWER | Power failure |
| PROCESS | Process failure |
| PRODUCT | Misapplied product |
| TEMP | Temporary works |
| TRAINING | Training |
| VANDALISM | Vandalism |
| WATER | Water damage |
| WEATHER | Weather damage |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Close a service case |
This operation closes a service case. |
| Send event to Honeywell Forge |
This operation sends success and failure events to Honeywell Forge. |
Close a service case
This operation closes a service case.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Project ID
|
projectId | True | string |
Specify the ID of the Project for which you want to cancel a service case. |
|
Service Case Number
|
serviceCaseNumber | True | string |
Specify the number of the service case which you want to close. |
|
Site ID
|
siteId | True | string |
Specify the ID of the site where the equipment that caused the service case is located. |
|
Work Order ID
|
workOrderIDs | string |
Specify the work order ID |
|
|
Priority
|
priority | string |
Specify the priority of the service case. |
|
|
Resolution
|
resolutionText | True | string |
Specify the resolution of the service case.??added title |
|
Resolution Code
|
resolutionCode | string |
Specify the resolution code for the service case.??added title |
|
|
Root Cause Code
|
rootCauseCode | string |
Specify the root cause of the service case.??added title |
|
|
Service Case Closing Timestamp
|
serviceCaseClosedOn | integer |
Specify the date and time when the service has been closed in UNIX epoch format. |
Returns
- Body
- CloseCaseResponse
Send event to Honeywell Forge
This operation sends success and failure events to Honeywell Forge.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Project ID
|
projectId | True | string |
Specify the ID of the Project for which you want to send an event to Honeywell Forge. |
|
Event Name
|
event | True | string |
Specify the name of the event. |
|
Event Type
|
eventType | True | string |
Specify the type of the event. Acceptable values are: warning, error, information, telemetry. |
|
Message
|
message | True | string |
Specify the description of the event. |
|
Correlation ID
|
corelationId | True | string |
Specify Correlation ID of the transaction. |
|
Connector ID
|
connectorId | string |
Specify the ID of the connector. |
|
|
Source
|
source | True | string |
Specify the source system of the event. |
Triggers
| Register a webhook that allows you to receive open service cases |
This operation registers a webhook that allows you to receive open service cases from Honeywell Forge. |
Register a webhook that allows you to receive open service cases
This operation registers a webhook that allows you to receive open service cases from Honeywell Forge.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Project ID
|
projectId | True | string |
Specify an ID for your project. The Project ID is a unique identifier that represents you as a customer in Honeywell Forge. |
|
Connector ID
|
connectorId | True | string |
Specify an ID for your connector. Connector ID is a unique identifier that represents your connector in Honeywell Forge. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Service Cases
|
data | array of object |
List of open service cases. |
|
Summary
|
data.summary | string |
Brief description of the service case. |
|
Source System
|
data.sourceSystem | string |
System that caused the creation of the service case. |
|
Detailed Description
|
data.description | string |
Detailed description of the service case. |
|
Site Name
|
data.siteName | string |
The name of the site where the equipment that caused the service case is located. |
|
Notes
|
data.analystNotes | string |
Use this field for additional notes as needed. |
|
Priority
|
data.priority | string |
The priority of the service case. Possible values are: low, medium, high. |
|
Cost of Fault
|
data.costOfFault | string |
The estimated cost of the fault of the equipment. |
|
Equipment ID
|
data.equipmentId | string |
The ID of the equipment that caused the service case. |
|
Created By
|
data.createdBy | string |
The email of the user who has created the service case. |
|
Fault Creation Timestamp
|
data.faultCreatedOn | integer |
The date and time when the fault has occurred in UNIX epoch format. |
|
Service Case Number
|
data.serviceCaseNumber | string |
The unique number that identifies the service case. |
|
Site ID
|
data.siteId | string |
The ID of the site where the equipment that caused the service case is located. |
|
Equipment Location
|
data.location | string |
The specific location within a site where the equipment that caused the service case is located. This can be a building, a floor, or a zone. |
|
Equipment Type
|
data.equipmentGroup | string |
The type of the equipment that caused the service case, such as AHU, VAV. |
|
Status
|
data.status | string |
The status of the service case. |
Definitions
CloseCaseResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
correlationId
|
correlationId | string |