Creating an incident entry


You can use the platform REST API to create incident requests. The following video (6:50) describes how to create an incident request.


icon-play.png https://youtu.be/iM8wIEqGQq0

The video was recorded using an earlier version of Action Request System, but is valid for AR System 9.and later versions.


To use the REST API to create an incident request

Use the /entry/{formName} URL to create an incident entry on a form. Perform the following steps to create an entry:

  1. Open the Postman - REST Client.
  2. Create a token. 
  3. Set the Request URL as:
    http://serverName:port/api/arsys/v1/entry/HPD:IncidentInterface_Create
    ?fields=values(Incident Number)  
  4. Select the operation as POST.
  5. Click Headers.
  6. Enter the following data as key-value pair in the header:

    Key

    Value

    Authorization

    AR-JWT <token generated>

    Content-Type

    application/json

  7. Select raw.
  8. From the list, select JSON.
  9. Enter the JSON input for creating an entry:

    {
     "values": {
       "First_Name": "Allen",
       "Last_Name": "Allbrook",
       "Description": "REST API: Incident Creation",
       "Impact": "1-Extensive/Widespread",
       "Urgency": "1-Critical",
       "Status": "Assigned",
       "Reported Source": "Direct Input",
       "Service_Type": "User Service Restoration"    
    }
    }

    (Optional) Alternatively, enter the JSON to create an incident from a template:

    {
    "values": {
    "Description": "Summary limited to 100 characters",
    "Detailed_Decription": "Notes Unlimited",
       "TemplateID":"AGHAA5V0AAFM7ANPGENXBFRLQBAZSH",
       "Company":"Your Company",
    "First_Name":"Allen",
    "Last_Name":"Allbrook",
    "z1D_Action":"CREATE"
    }
    }
     

    Note

    Template ID is derived from the instance ID found in HPD:Template form.

  10. Click Send to send the request.
  11. Click Headers in response.
    The plug-in returns a URL in the Location section for the newly created entry.

Where to go from here

Modifying-an-incident-entry

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*