I am working on an integration between SolarWinds Orion and OpenText SMAX.
From my investigation, I understand that Orion.AlertActive is an ephemeral entity that exists only while an alert is active and is removed when the alert is reset. The persistent object is Orion.AlertObjects, which stores information about the monitored entity and is related to AlertActive, AlertHistory, AlertNote, and AlertIncident.
I also know that in case of the ServiceNow integration the AlertIncident records related to AlertObject are being used. In those cases, the AlertIncident.IncidentNumber property contains the ServiceNow incident number, and the relationship between AlertObject and AlertIncident provides a convenient way to associate an Orion alert with an external ITSM incident.
I would like to implement the same capability for an integration with OpenText SMAX, so that the SMAX Incident ID and Incident Number are stored in Orion and associated with the corresponding AlertObject in the same way.
Based on my investigation, I assume that this functionality is probably implemented by issuing one or more Create requests against the AlertIncident entity (or a related API). However, I have not been able to identify the required sequence of API calls.
Is there any documentation or example describing the complete sequence of requests required to associate an Orion alert with an external ITSM incident? Ideally, I would like to create an AlertIncident record containing the SMAX Incident ID, Incident Number, and Incident URL, similar to how the built-in ServiceNow integration appears to work.
This approach would be much cleaner than storing the external incident reference in a custom property or alert note, as it would leverage Orion's native incident association model.
Thank You.
Dariusz
