Previously exported BUS_BRANCH network with all switches open is not readable #3623
Description
Describe the current behavior
When exporting a network with voltage level missing bus because all switches are open in BUS_BRANCH then the network is not readable afterwards. Indeed, a Generator::connectableBusId must not be null.
Describe the expected behavior
The user should be warned in any case: when a voltage level has all switches open then log with a warning and in a report that "Voltage level has all switches open".
The user can chose what to do when exporting a BUS_BRANCH network with voltage levels having all switches open. A new export option allows to chose the expected behaviour in case voltage levels with all switches open are encountered:
- throws an exception at export (should be the behaviour by default if the option is not set)
- avoid throwing the exception but keep the original topology for the problematic voltage levels during BUS_BRANCH export so that the network will be readable afterwards.
Add documentation about this export option and its options
Describe the steps
- import this NODE_BREAKER topology network
- export it in BUS_BRANCH
- import it
- it throws an exception "connectable bus is not set"
Breaking change
Possible breaking change for users that expect to export network in BUS_BRANCH with some voltage level with all open switches. They now should expect an error during the export if the new option is not set.