Migration guide v4.9.0

PlatformConfig changes

• PlatformConfig::moduleExists and PlatformConfig::getModuleConfig have been deprecated, the PlatformConfig::getOptionalModuleConfig should be used instead.
• Similary ModuleConfigRepository::moduleExists has been deprecated, please refer to the Optional returned by ModuleConfigRepository::getModuleConfig.
• PlatformConfig::getConfigDir now returns an Optional<Path> instead of a Path.

IIDM identifiers for CGMES imports: CGMES mRID or CGMES rdf:ID

Starting from 4.9.0 release, IIDM identifiers are equal to CGMES mRIDs (Master Resource Identifiers). Nonetheless, the 4.9.1 release introduced a configuration parameter for CGMES Import, which allows the source for IIDM identifiers to be set to rdf:ID (Resource Description Framework Identifiers). RDF identifiers are built from CGMES mRIDs prefixed with a _ character.

The name of the new parameter is iidm.import.cgmes.source-for-iidm-id. Its possible values are: mRID, rdfID. Case is not relevant in the parameter value.

Below is an example to set IIDM identifiers to rdf:ID:

Properties importParams = new Properties();
importParams.put(CgmesImport.SOURCE_FOR_IIDM_ID, CgmesImport.SOURCE_FOR_IIDM_ID_RDFID);
Network network = Importers.loadNetwork(Path.of("pathToFile"), LocalComputationManager.getDefault(), ImportConfig.load(), importParams);