Migration guide v7.3.0

Breaking changes for all users

IIDM

IIDM 1.17

Adaptations for IIDM 1.17

Downstream projects should:

• TBD

• Upgrade the version in their XIIDM / JIIDM unit test files corresponding to the current version:

  • For ".xiidm" or ".xml" files: replace xmlns:iidm="http://www.powsybl.org/schema/iidm/1_16" with xmlns:iidm="http://www.powsybl.org/schema/iidm/1_17";

  • For ".json" or ".jiidm" files: replace "version" : "1.16" with "version" : "1.17".

TBD

N/A

Detail of the renamed classes, methods, constants, ...

Classes

The following classes were renamed:

Old name	New name
TBD	TBD

Methods

The following methods were renamed:

Old name	New name
TBD	TBD

Constants

The following constants were renamed:

Old name	New name
TBD	TBD

Reports

The following ReportNode keys were renamed:

Old name	New name
TBD	TBD

In the messages of the following ReportNode keys, some variables were renamed:

• ReportNode keys:
  • TBD

Old name	New name
TBD	TBD

Contingency

LimitViolation constructors deprecation

If you are using the following constructors:

• LimitViolation(String subjectId, @Nullable String subjectName, String operationalLimitsGroupId, LimitViolationType limitType, @Nullable String limitName, int acceptableDuration, double limit, double limitReduction, double value, @Nullable ThreeSides side, @Nullable ViolationLocation voltageLocation)
• LimitViolation(String subjectId, LimitViolationType limitType, double limit, double limitReduction, double value, ViolationLocation voltageLocation)

Then no change is required.

Otherwise you can:

• use LimitViolationBuilder, either with new LimitViolationBuilder() or with LimitViolation.builder(), add the values and then use .build()
• use the constructor of LimitViolation with all the variables (mentionned above), and provide null values for all the variables you do not have a value for

Note that if you were using a constructor and were providing null values to it, you do not need to do that with the Builder. Also note that the default limitReduction is 1 and the default acceptableDuration is Integer.MAX_VALUE.

Security analysis

TBD

N/A

TBD

N/A

CGMES

TBD

N/A

TBD

N/A

Documentation

TBD

N/A

Notice for custom IIDM implementations maintainers

IIDM

TBD

N/A

TBD

N/A

Deprecated methods