Foreach mediator doc improvements

[GDLMadushanka]

Description

We need to rephrase this text to better explain what happen when we iterate on body, variable and what happen when we give a result-target

The ForEach Mediator processes a collection, such as a JSON array or XML list derived from the message body or a defined variable, by splitting it into multiple messages, each corresponding to an item in the collection. The message in each iteration is flowing through the specified mediation sequence. After flowing through the mediation sequence, the sub-messages in each iteration are merged back to the corresponding original parent collection in the original message body or variable.

We need add a note to highlight the fact that if we are iterating a variable, datatype of that variable should be XML or JSON. same for body

We are getting the following error when try to iterate on non-array.
ERROR {ForEachMediatorV2} - {api:testForeach} Expression vars.tags did not resolve to a valid array

Steps to Reproduce

N/A

Version

4.4.0

Environment Details (with versions)

No response