2.3. Push Notifications / WebHooks

This functionality provides to different beneficiaries push notifications for certain events that occur in SocrateCloud near in real time.

These notifications are sent automatically by SocrateCloud to the indicated ur atl the occurrence of the indicated event.

To configure a push data logic, must open window "Push Data", create new record with next settings

• • Name: Unique Name for Push Data configuration

  • URL: Remote web service URL

  • Table: table that trigger the push data

  • SDEI Published Table: Data content to be exported. To configure a publication see cap. 2.2. Using the RESTful web services

  • Document Value Logic: Context logic for data push. To check for available variables for a window you must go to Menu Settings -> Tools -> Context and select Tab Context

For a push data configuration for a specific table you could set Trigger columns. Only when a column specified in this tab is changed then push data starts

Push Data Log

For each push event a new log is created. Each log contains Record ID for record that was modified or added, Data from Published Table, using Record ID numeric parameter, Response from remote call (with text returned, maximum 1000 chars) and information about user that generate the push event and date when happens

If a push request failed than a backup service will make a new call for each active and not synchronized log every 5 minutes for maximum 20 attempts.

• • Synchronized: mark that data was posted to specified URL. Ok response is considered when status code from response is 2xx

  • Counter: count how many times the POST request was made to remote URL. After 20 tries, log became inactive

  • Active: no future post request will be made for inactive logs

SDEI Published Table

When configure a published table used for push data must respect one rule, must use one numeric parameter which is the ID from modified record that start push data event. Must add a new Where Params as numeric, see next imagine as example,