Page Comparison

...

• Webhook Name: Input a name for the webhook, which needs to be configured.
• Select Tool: Input the tool name whose webhook needs to be configured.
• Is Event Processing : Toggle this flag if webhook is used for event processing.
• Label Name: This label name will be auto populated as soon as the user selects the tool. It should follow the nomenclature of ToolCategory:LabelName:DATA. ( Populated label name won't be editable in case of event processing and label is formed as WEBHOOKNAME_TOOLNAME_EVENT)
• Data Format: The data format which is supported, is JSON.
• MQ Channel : This field gets auto populated as soon as the webhook name is entered with a prefix “IPW_”
• Dynamic Template : This field is an alternate option of Response template .It has to be a valid JSON.
• Response Template: The response template has to be added should be in string format.
• Event Config Details : Event config json object has to be added if webhook is used for event processing.

          Sample Response Template:

...

• Node Updation :- If the Neo4j node has to be updated ,based on the unique key, set the flag true and enter the required unique property. (This is disabled in case of event processing)

• Insights TimeX : This has three fields namely -
  • Time Field : This has to be last value from key-pair of response template.
  • Epoch Time : If the time field is in epoch format mark the toggle as true.
  • Time Format : If the time field is not in epoch format, then time format has to be given.

          Sample Time Format -Time 1. 2020-03-02T05:48:48Z (yyyy-MM-dd'T'HH:mm:ss'Z')

                                                         2. 2019-06-27T14:19:55+05:30 (yyyy-MM-dd'T'HH:mm:ssXXX)

                                                         3. 2019-06-27T14:19:55-05:30 (yyyy-MM-dd'T'HH:mm:ssXXX)

                                                         4. 2019-11-13 14:35:17 UTC (yyyy-MM-dd HH:mm:ss)

                                                         5. 2019-07-03T10:39:22+0000 (yyyy-MM-dd'T'HH:mm:ssZ)                           

...

• Response Template : Response template must contain webhook event name as mandatory property and property name must be "webhookEvent"
• Event Config Details: Json Object which has to follow below structure .

      {
         "config":[
                         {
                         "event":"jira:issue_deleted",
                         "query":[
                                      "match(n:ALM:JIRA_AGENT:DATA) where n.key='{jiraKey}' set n.isDeleted =true return n "
                                      ]
                          },
                         {
                         "event":"jira:issue_updated",
                         "query":[
                                     "match(n:ALM:JIRA_AGENT:DATA) where n.key={jiraKey} set n.isDeleted =true return n"
                                      ]
                         }
                     ]
        }

in above config json property names "config" , "event" , "query" must be with the same name .

event property : Event property indicates for which webhook event the respective queries to be executed which are defined in query array .

query property : Query property is json array which takes multiple queries to be executed in order when webhook event matches to event property name.

                     Defined query takes dyanamic data with string substitution as {} 

                             The keys defined in the response template combined with dyanamic template are available to use as string substitution.

                             suppose response template is defined as :

                             sprint.name=sprintName,
                             sprint.id=sprintId,
                             sprint.originBoardId=boardId,
                             webhookEvent=webhookEvent,
                             issue.key=jiraKey

                             all above keys like sprintName , sprintId , boardId, webhookEvent , jiraKey are available to be used in query as string substitution like  "match(n:ALM:JIRA_AGENT:DATA) where n.key=                                   {jiraKey} set n.isDeleted =true return n" , here {jiraKey} key jiraKey is used from response template  and value of the key is replaced dynamically. 

•  Once webhook is configured and subscribed then any webhook event matches event name defined in event config then webhook engine run queries on the fly . If queries run successfully then MQ message is acknowledged .
• If queries have any syntax errors as well as if queries are failed due to data is not present on which query is being executed in such cases event are stored on the label defined while configuring webhook and those events will further be processed by webhook offline event processor. 

• Offline event processor retries missed events for the time window defined in server-config property as  "eventProcessingWindowInMin":60 , if window time is elapsed then event is discarded.

  Note
  If webhook event does not match up with event defined in event config json then MQ message is acknowledged and event is discarded.

  
  

...

Configuring webhook offline processor :

• server-config : for scheduling webhook offline processor"offlineWebhookEventProcessingInterval":20 this property needs to be added which defines offline processing interval in mins.