ENTSO-E CODING SCHEMES MAPPING IMPLEMENTATION GUIDE - Microsoft

Transcription

12European Network ofTransmission System Operatorsfor ElectricityENTSO-ECODING SCHEMES MAPPINGIMPLEMENTATION GUIDE2016-01-21DOCUMENT APPROVEDVERSION 1.0ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

ENTSO-E Coding schemes mapping implementation guideVERSION 1.0European Network ofTransmission System Operatorsfor ElectricityTable of Contents341Objective . 552The mapping data exchange process. all business context . 5Business Description . 5Codelist values . 6Mapping document contextual model . 62.4.1Overview of the model . 62.4.2IsBasedOn relationships from the European style marketprofile . 6Coding schemes mapping document assembly model . 72.5.1Overview of the model . 72.5.2IsBasedOn relationships from the European style marketprofile . 72.5.3Detailed Coding schemes mapping document assembly model . 82.5.3.1 ResourceMapping MarketDocument root class . 82.5.3.2 RegisteredResource . 82.5.3.3 TimeSeries . 92.5.4Datatypes . 102.5.5ResourceMapping MarketDocument XML schema . 1123List of figures24Figure 1 - Coding schemes mapping document contextual model . 625Figure 2 - Coding schemes mapping document assembly model . 726Figure 3 – ResourceMapping MarketDocument schema structure . 1127List of tables28Table 1 - IsBasedOn dependency . 629Table 2 - IsBasedOn dependency . 73031Table 3 - Attributes of Coding schemes mapping document assemblymodel::ResourceMapping MarketDocument . 83233Table 4 - Association ends of Coding schemes mapping document assemblymodel::ResourceMapping MarketDocument with other classes . 83435Table 5 - Attributes of Coding schemes mapping document assemblymodel::RegisteredResource . 93637Table 6 - Attributes of Coding schemes mapping document assemblymodel::TimeSeries . 93839Table 7 - Association ends of Coding schemes mapping document assemblymodel::TimeSeries with other classes . 1040– Page 2 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

European Network ofTransmission System Operatorsfor ElectricityENTSO-E Coding schemes mapping implementation guideVERSION 1.041Copyright notice:42Copyright ENTSO-E. All Rights Reserved.43444546474849This document and its whole translations may be copied and furnished to others, and derivativeworks that comment on or otherwise explain it or assist in its implementation may be prepared,copied, published and distributed, in whole or in part, without restriction of any kind, provi dedthat the above copyright notice and this paragraph are included on all such copies andderivative works. However, this document itself may not be modified in any way, except forliteral and whole translation into languages other than English and under all circumstances, thecopyright notice or references to ENTSO-E may not be removed.50This document and the information contained herein is provided on an "as is" basis.51525354ENTSO-E DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOTLIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOTINFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY ORFITNESS FOR A PARTICULAR PURPOSE.55Maintenance notice:5657This document is maintained by the ENTSO-E WG EDI. Comments or remarks are to beprovided at EDI.Library@entsoe.eu– Page 3 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

ENTSO-E Coding schemes mapping implementation guideVERSION 1.0European Network ofTransmission System Operatorsfor ElectricityRevision st drafting of the document based on discussion with CGMES project team ondata exchanges.012016-01-14Version taking into account the comments issued by WG EDI after review.102016-01-21Version to be submitted to Market Committee following WG EDI meeting.59– Page 4 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

European Network ofTransmission System Operatorsfor ElectricityENTSO-E Coding schemes mapping implementation guideVERSION 1.0601Objective6162The purpose of this document is to enable the exchange of information about the mapping ofobjects modelled with different level of aggregation.636465The main purpose is to be used for individual grid model or the common grid model when someinformation are coming from market oriented or coordinated actions, such as coordinatedoutage planning, etc.662672.16869A TSO is using different levels of aggregation or views about the network elements, i.e. powersystem resources in the common information model.70As an example, let us consider the object “line”:717273 in a bus-branch model, the line is a single object connecting two electrical nodes, this objectis also the one used within the energy identification coding scheme (EIC) and thus has asingle master record identification number (mRID);747576 in a node-breaker model, the line is a set of individual components such as line segments,isolators, circuit breakers, etc. Each of these individual components requires to have also asingle mRID.77Thus a mapping is to be provided between the single EIC mRID and the multiple mRIDs.78798081Mapping is necessary when different modellings are used such as market resource object andpower system resource objects. In order to enable network studies when inputs are comingfrom market results (outage coordination, etc. ) and network models (common grid model, etc.),mapping is necessary. Examples of network studies are :8283 contingency analysis to validate the consequences of a given planned outage (identified inthe outage planning coordination);84 generation of a base case depending on the planned outages,85 etc.862.28788As stated previously, the TSO is the only one who masters the mapping between the detailedphysical views and the “market-oriented” views.89909192The TSO is thus able to provide the necessary mapping info rmation to different serviceproviders (RSCIs, coordinated capacity calculator, etc.) who need it for network study purposes.In particular, the TSO shall ensure the consis tency of the mapping provided, e.g. for a givenEIC code there shall be only one mapping description at a given time with CGM mRID.939495The TSO shall use the ResourceMapping MarketDocument to provide the mapping of a“market” code in a given coding scheme towards the detailed physical configuration using theCGMES mRIDs, or another coding scheme.9697In addition, for each “market” code, the TSO shall provide the information when this mapping iseffective.9899100101An existing mapping between a “market” code and CGMES mRIDs is valid from the start date,andifnecessarytime,providedinstart D ateAndOrTime.dateand/orstart DateAndOrTime.time either up to the next document submission providing a new startdate and time or to the end DateAndOrTime.date and/or end DateAndOrTime.time .102103104It shall be mentioned that this document is related only to the exchange of mapping information;the repository to store these master data is out of scope and under the sole responsibility ofthe receiver.The mapping data exchange processOverall business contextBusiness Description– Page 5 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

European Network ofTransmission System Operatorsfor ElectricityENTSO-E Coding schemes mapping implementation guideVERSION 1.01052.3Codelist values106107The “type” attribute of the ResourceMapping MarketDocument shall have the value A95, i.e.configuration document.1082.41092.4.1110Figure 1 shows the model.Mapping document contextual modelOverview of the model111112Figure 1 - Coding schemes mapping document contextual model1132.4.2IsBasedOn relationships from the European style market profile114115Table 1 shows the traceability dependency of the classes used in this package towards theupper level.116Table 1 - IsBasedOn dependencyNameComplete IsBasedOn nt::DateAndOrTimeMarket ResourceResourceMapping MarketDocument meSeries117– Page 6 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

ENTSO-E Coding schemes mapping implementation guideVERSION 1.01182.51192.5.1120Figure 2 shows the model.European Network ofTransmission System Operatorsfor ElectricityCoding schemes mapping document assembly modelOverview of the model121122Figure 2 - Coding schemes mapping document assembly model1232.5.2IsBasedOn relationships from the European style market profile124125Table 2 shows the traceability dependency of the classes used in this package towards theupper level.126Table 2 - IsBasedOn dependencyNameRegisteredResourceComplete IsBasedOn ourceResourceMapping MarketDocument meSeries127– Page 7 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

European Network ofTransmission System Operatorsfor ElectricityENTSO-E Coding schemes mapping implementation guideVERSION 1.01282.5.3Detailed Coding schemes mapping document assembly model1292.5.3.1130131An electronic document containing the information necessary to satisfy the requirements of agiven business process.132133134The mapping document provides association between an object identified by a code in a givencoding scheme and all the detailed objects in the CGMES detailed topology (e.g. a line withone EIC code is composed of N object for CGMES, segments, isolators, circuit brea kers, etc.).135Table 3 shows all attributes of ResourceMapping MarketDocument.136137ResourceMapping MarketDocument root classTable 3 - Attributes of Coding schemes mapping document assemblymodel::ResourceMapping MarketDocumentOrder mult.0Attribute name / Attribute type[1.1] mRIDThe unique identification of the document beingexchanged within a business process flow.ID String1[1.1] revisionNumberThe identification of the version that distinguishes oneevolution of a document from another.ESMPVersion String2[1.1] typeThe coded type of a document. The document typedescribes the principal characteristic of the document.MessageKind String3Description[1.1] sender MarketParticipant.mRIDThe identification of a party in the energy market.--- The document owner.PartyID String4[1.1] sender MarketParticipant.marketRole.type The identification of the role played by a market player.--- The document owner.MarketRoleKind String5[1.1] receiver MarketParticipant.mRIDThe identification of a party in the energy market .--- The document recipient.PartyID String6[1.1] receiver MarketParticipant.marketRole.type The identification of the role played by a market player.--- The document recipient.MarketRoleKind String7[1.1] createdDateTimeThe date and time of the creation of the document.ESMP DateTime138139Table 4 shows all association ends of ResourceMapping MarketDocument with other classes.140141Table 4 - Association ends of Coding schemes mapping document assemblymodel::ResourceMapping MarketDocument with other classesOrder mult.8Class name /RoleDescription[1.*] TimeSeriesTimeSeriesAssociation Based On:Coding schemes mapping document contextual model::TimeSeries.TimeSeries[1.*]----Coding schemes mapping document contextualmodel::ResourceMapping 4145A resource that is registered through the market participant registration system. Examplesinclude generating unit, load, and non-physical generator or load.146Table 5 shows all attributes of RegisteredResource.– Page 8 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

ENTSO-E Coding schemes mapping implementation guideVERSION 1.0147148European Network ofTransmission System Operatorsfor ElectricityTable 5 - Attributes of Coding schemes mapping document assemblymodel::RegisteredResourceOrder mult.0Attribute name /Attribute type[1.1] mRIDDescriptionThe unique identification of a resource.ResourceID String1[0.1] nameString2[0.1] descriptionStringThe name is any free human readable and possibly non unique text namingthe object.The description is a free human readable text describing or naming theobject. It may be non unique and may not correlate to a naming hierarchy.1491502.5.3.3151A set of time-ordered quantities being exchanged in relation to a product.152153In the ESMP profile, the TimeSeries provides not only time-ordered quantities but also timeordered information.154Table 6 shows all attributes of TimeSeries.155156TimeSeriesTable 6 - Attributes of Coding schemes mapping document assemblymodel::TimeSeriesOrder mult.0Attribute name / Attribute type[1.1] mRIDDescriptionA unique identification of the time series.ID String1[0.1] descriptionThe description of the mapping between the objects.The description is a free human readable text describing ornaming the object. It may be non unique and may notcorrelate to a naming hierarchy.String2[0.1] cancelledTSAn indicator stating that the TimeSeries, identified by themRID, is withdrawn. The mapping information is no longervalid.ESMPBoolean String3[1.1] start DateAndOrTime.dateThe date as "YYYY-MM-DD", which conforms with ISO 8601.--- The date from which the mapping is to be applied betweenthe objects.Date4[0.1] start DateAndOrTime.timeThe time as "hh:mm:ss.sssZ", which conforms with ISO 8601.--- The date from which the mapping is to be applied betweenthe objects.Time5[0.1] end DateAndOrTime.dateThe date as "YYYY-MM-DD", which conforms with ISO 8601.--- The date up to which the mapping is to be applied betweenthe objects, i.e. the end date.Date6[0.1] end DateAndOrTime.timeThe time as "hh:mm:ss.sssZ", which conforms with ISO 8601.--- The date up to which the mapping is to be applie d betweenthe objects, i.e. the end date.Time7[1.1] market RegisteredResource.mRIDThe unique identification of a resource.--- The identification of a resource associated with aTimeSeries.The code in a given coding scheme that is to be mapped withthe detailed configuration, e.g. a line described by a singleEIC code will have a detailed mapping with the CGMEScoding scheme objects (segment of lines, isolators, circuitbreakers, etc.).ResourceID String– Page 9 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

ENTSO-E Coding schemes mapping implementation guideVERSION 1.0Order mult.8Attribute name / Attribute type[0.1] market RegisteredResource.nameString9European Network ofTransmission System Operatorsfor ElectricityDescriptionThe name is any free human readable and possibly nonunique text naming the object.--- The identification of a resource associated with aTimeSeries.The code in a given coding scheme that is to be mapped withthe detailed configuration, e.g. a line described by a singleEIC code will have a detailed mapping with the CGMEScoding scheme objects (segment of lines, isolators, circuitbreakers, etc.).[0.1] market RegisteredResource.description The description is a free human readable te xt describing ornaming the object. It may be non unique and may notStringcorrelate to a naming hierarchy.--- The identification of a resource associated with aTimeSeries.The code in a given coding scheme that is to be mapped withthe detailed configuration, e.g. a line described by a singleEIC code will have a detailed mapping with the CGMEScoding scheme objects (segment of lines, isolators, circuitbreakers, etc.).157158Table 7 shows all association ends of TimeSeries with other classes.159160Table 7 - Association ends of Coding schemes mapping document assemblymodel::TimeSeries with other classesOrder mult. Class name / Role10Description[1.*] RegisteredResource The identification of a resource associated with a TimeSeries.RegisteredResource The detailed configuration, based on CGMES coding scheme, of the objectdescribed by a code.in a given coding scheme (e.g. an EIC code)Association Based On:Coding schemes mapping document urce[1.*]----Coding schemes mapping document contextual model::TimeSeries.[]1611622.5.4Datatypes163164The list of datatypes used for the Coding schemes mapping document assembly model is asfollows:165166167168169170171172 ESMP DateTime datatypeESMPBoolean String datatype, codelist IndicatorTypeListESMPVersion String datatypeID String datatypeMarketRoleKind String datatype, codelist RoleTypeListMessageKind String datatype, codelist MessageTypeListPartyID String datatype, codelist CodingSchemeTypeListResourceID String datatype, codelist CodingSchemeTypeList– Page 10 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

European Network ofTransmission System Operatorsfor ElectricityENTSO-E Coding schemes mapping implementation guideVERSION 1.01732.5.5ResourceMapping MarketDocument XML schema174Figure 3 provides the structure of the schema.175176Figure 3 – ResourceMapping MarketDocument schema structure177– Page 11 of 11 –ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu

ENTSO-E Coding schemes mapping implementation guide VERSION 1.0 ENTSO-E AISBL Avenue de Cortenbergh, 100 1000 Brussels Belgium Tel 32 2 741 09 50 Fax 32 2 741 09 51 info@entsoe.eu www.entsoe.eu 118 2.5 Coding schemes mapping document assembly model 119 2.5.1 Overview of the model