REFRESH - please provide more detail

[yitzchokl-medatech]

REFRESH - refreshes screen with updated values after data manipulation; used only in form triggers

https://github.com/PrioritySoftware/PrioritySoftware.github.io/blob/51c62dec97728caf6f31a4a1637ceebeba1b8e8a/_sdk/Flow-Control.md?plain=1#L44C1-L45C45

This line has been in the documentation since Priority v.5 or even earlier. The impression this command gives is that it will do something like what Ctrl-F11 does. That behaviour is wanted quite frequently. But it does not seem to do that. Maybe it only works in combination with something else? In the code we can find REFRESH 1 (as in the example given lower down) and REFRESH 2 and REFRESH 8. Would you please update the document to explain more clearly what REFRESH does and the parameter values it takes.

[yitzchokl-medatech]

Today I discovered the following on another page. I think it's important that the above note includes or refers to this.

Do not include the REFRESH command in POST-UPDATE or POST-INSERT triggers in froms that include a BPM chart, as these can negatively interact with business rules.

https://github.com/PrioritySoftware/PrioritySoftware.github.io/blob/51c62dec97728caf6f31a4a1637ceebeba1b8e8a/_sdk/Form-Refresh.md?plain=1#L28

[yitzchokl-medatech]

Further to previous comments - Given that the REFRESH command is mentioned on the same page as the auto-refresh function, one might get the impression that it will even add new records to the form, and not just update the records already on screen. But if that's the case, how would the function behave? The auto-refresh function has two modes. Please make sure that improvements to the documentation cover these points. Thank you

[yitzchokl-medatech]

Priority Software - We have also opened a service ticket on this topic, where we describe three scenarios in which we would like to be able to force different types of screen refresh. Please see SCI24091250. Thanks