Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
integration:ivedix [2025/05/07 04:28] – [Errors] Gary Willettsintegration:ivedix [2026/01/29 13:09] (current) – [Store preferences] Gary Willetts
Line 3: Line 3:
 mSupply has an interface with the iVEDiX reporting API. The interface allows the automatic sending of batch and transaction information to the iVEDiX reporting platform. mSupply has an interface with the iVEDiX reporting API. The interface allows the automatic sending of batch and transaction information to the iVEDiX reporting platform.
  
 +
 +===== Set up =====
 +==== Preferences ====
 The preferences that define how this interface works are managed on the //iVEDiX// tab of the //File > Preferences// menu. The tab looks like this: The preferences that define how this interface works are managed on the //iVEDiX// tab of the //File > Preferences// menu. The tab looks like this:
  
Line 17: Line 20:
   * **Send errors to this email address:** All errors sending information to the iVEDiX platform are sent to this email address. You can enter multiple email addresses in here by entering them one after another separated with a semicolon ('';'').   * **Send errors to this email address:** All errors sending information to the iVEDiX platform are sent to this email address. You can enter multiple email addresses in here by entering them one after another separated with a semicolon ('';'').
  
 +==== Store preferences ====
 +You must also tell mSupply which stores to send information to iVEDiX for. This is done by adding a "pushToIvedix" custom field to a store. Set it to "true" in all stores that you want to send information to iVEDiX like this:
 +
 +{{ .:pasted:20260129-130754.png?650 }}
 +
 +Details on how to set these custom fields ina store's details window can be found on the [[other_stuff:virtual_stores#custom_fields_tab page|26.07. Virtual stores]].
  
 ===== What it does ===== ===== What it does =====
Line 46: Line 55:
 There are actually two schedulers running to control sending transactions to iVEDiX: one picks up all new transactions and sends them for the first time. The other picks up all the failed transactions and sends them again until they have reached the maximum number of retries before permanent failure. There are actually two schedulers running to control sending transactions to iVEDiX: one picks up all new transactions and sends them for the first time. The other picks up all the failed transactions and sends them again until they have reached the maximum number of retries before permanent failure.
 ===== Errors ===== ===== Errors =====
-If errors are encountered during either of the sending processes then the information to be sent is entered into a queue. All pices of information (batches or transactions) in that queu are attempted to be resent after the number of minutes stored in the **Interval between retries** field. When a piece of informaiton is successfully sent it is removed from the queue. If a piece of information is not sent successfully after the number of retries in the **Number of times to retry sending** field then it is removed from the queue, the final failure is logged (see the [[admin:the_log]] page for details on how to view the log) and an email giving details of the error is sent to the email address stored in the **Send errors ro this email address** field. +If errors are encountered during either of the sending processes then the information to be sent is entered into a queue. All pices of information (batches or transactions) in that queu are attempted to be resent after the number of minutes stored in the **Interval between retries** field. When a piece of informaiton is successfully sent it is removed from the queue. If a piece of information is not sent successfully after the number of retries in the **Number of times to retry sending** field then it is removed from the queue, the final failure is logged (see the [[admin:the_log]] page for details on how to view the log) and an email giving details of the error is sent to the email address stored in the **Send errors to this email address** field. 
  
 \\ \\
  • Last modified: 2025/05/07 04:28
  • by Gary Willetts