Dela via


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
Email 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

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