Context:
To assist during event based process mapping we want to offer a simple suggested event functionality that based on time sequence suggest potential event candidates to be mapped.

Notes to self (Josh):

• validate against non-existent flowNodeId for the target property and for the existing mappings
• make sure the xml is valid
• cache the BPMN built from the xml provided? Might make future validation easier

AT:

• optional parameter of the current event based process (we need xml and current mappings) and a task/event ID that needs suggestions. Based on existing mappings provided, suggest events based on mapping of previous/next group, source, eventName combinations. The api returns potential event candidates as part of its response.
• suggestions take precedence over sorting/order parameters. If search term is provided, only include suggestions that also match the search term
• documentation is updated