Integrate Connected Worker and HCM/HNS for incident management

December 8, 2020 | 3 minute read
Derek Kam
Consulting Solutions Architect
Text Size 100%:

In Connected Worker, you can configure the platform to create a time-card and an incident in HCM/HNS (Health and Safety). This documentation describes the steps to configure this integration: https://docs.oracle.com/en/cloud/saas/iot-worker-cloud/iotcw/integrate-oracle-human-capital-management-cloud-oracle-iot-connected-worker-cloud-service.html#GUID-C083AE33-5B9E-4F56-9419-1690EB3CE501. In this blog, I will provide more details on the Connected Worker and HCM/HNS integration configuration for incident creation.

To enable Connected Worker incident creation in HCM/HNS, you need to enable this integration and provide your HCM access credentials and mapping information.  Login to Connected Worker platform as an administrator, go to Configuration->Integration, and provide the following HCM environment details: 

  • HCM server URL: Enter the URL for the Oracle Human Capital Management Cloud instance
  • Username: Enter the username for the Oracle Human Capital Management Cloud instance.  This user must have the manager role to manage user data and integrations (e.g. Integration Specialist role)
  • Password: Enter the password for the Oracle Human Capital Management Cloud instance.

You have an option to import HCM users to the Connected Worker platform or create a user mapping automatically using the user data in both platforms. Please note that the Connected Worker platform will use the username to search for the same username in HCM for user mapping.

Next, you need to check the incident checkbox to enable the incident creation integration and provide the mapping for the default and employee event code. 

Below is a list of event code available in HCM/HNS:

ORA_INDOOR_AIR An incident event type of air quality.
ORA_ERGONOMIC An incident event type of ergonomic.
ORA_FIRE An incident event type of fire or explosion.
ORA_INJURY_ILLNESS An incident event type of virus, illness, or injury.
ORA_ISSUE An incident event type of issue.
ORA_LOST_OR_STOLEN_DEVICE An incident event type of lost or stolen device.
ORA_NEAR_MISS An incident event type of near-miss.
ORA_NOTICE_OF_VIOLATION An incident event type of notice of violation.
ORA_OTHER_DATA_SECURITY_ISSUE An incident event type of other data security issue.
ORA_PROPERTY An incident event type of property damage.
ORA_SPILL_RELEASE An incident event type of spill or release.
ORA_SUGGESTION_FOR_IMPROVEMENT An incident event type of suggestion for improvement.
ORA_SUSPICIOUS_EMAIL_OR_CALL An incident event type of suspicious email or call.
ORA_UNAUTHORIZED_SYSTEM_ACCESS An Incident event type of unauthorized system access.
ORA_UNSAFE_ACT An incident event type of unsafe act
ORA_UNSAFE_CONDITION An incident event type of unsafe condition.
ORA_VEHICLE_INCIDENT An incident event type of vehicle incident.


Currently, HCM/HNS doesn’t allow you to add a new incident event type/code. However, you can modify the existing event type name/label.

To change the name/label of the incident event type:

  1. Login to the HCM as an administrator
  2. From Home navigate to Others>Setup and Maintenance work area.
  3. In the tasks panel, search for the Manage Environment, Health, and Safety Incident Events task.
  4. Click the task to open the Manage Incident Events Lookup page. 
  5. You can modify the event Meaning of the lookup code if you want to change the event name. Modify the Description as required.
  6. Select the Enable for Professional User and Enable for Employee Self-Service checkboxes, respectively. If you want to hide the event for the professional user or employee, deselect the checkboxes.
  7. Click Save and Close. The changes are into effect immediately.

Once you have the HCM/HNS integration configured and enabled in Connected Worker, you can create a rule in Connected Workers to create an incident when there is a violation.

Derek Kam

Consulting Solutions Architect

Derek Kam is a Consulting Solutions Architect in the A-Team at Oracle Corporation. He works closely with customers and partners, worldwide, providing guidance on architecture, best practices, troubleshooting and how best to use Oracle Cloud Services and products to solve customer business needs. Derek is a multi-skilled IT professional with more than 26 years of experience, possessing a wide range of experience and expertise in the Oracle Fusion Middleware and Oracle Clouds (PaaS and IaaS) technical and architecture design, development, software testing and quality assurance, and project management. Prior to joining Oracle in 2012, Derek has worked in consulting, financial and retail industries.


Previous Post

Fault Actions Behavior in OIC

Greg Mally | 4 min read

Next Post


Using OCI Private DNS to Resolve Private Oracle Analytics Cloud Data Source FQDNs

Dayne Carley | 8 min read