I E C TR 61 968-900 ® Edition 201 5-1 TE CH N I CAL R E POR T colour i n si de Appl i cati on i n teg rati on at el ectri c u ti l i ti es – System i n terfaces for d i stri bu ti on m an ag em en t – IEC TR 61 968-900:201 5-1 0(en) Part 900: G u i d an ce for i m pl em en tati o n o f I E C 61 968-9 TH I S P U B L I C ATI O N I S C O P YR I G H T P R O TE C TE D C o p yri g h t © I E C , G e n e va , Sw i t z e rl a n d All rights reserved Unless otherwise specified, no part of this publication may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from either IEC or IEC's member National Committee in the country of the requester If you have any questions about IEC copyright or have an enquiry about obtaining additional rights to this publication, please contact the address below or your local IEC member National Committee for further information IEC Central Office 3, rue de Varembé CH-1 21 Geneva 20 Switzerland Tel.: +41 22 91 02 1 Fax: +41 22 91 03 00 info@iec.ch www.iec.ch Abo u t th e I E C The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes International Standards for all electrical, electronic and related technologies Ab o u t I E C p u b l i c a t i o n s The technical content of IEC publications is kept under constant review by the IEC Please make sure that you have the latest edition, a corrigenda or an amendment might have been published I EC C atal og u e - webstore i ec ch /catal o g u e E l ectro ped i a - www el ectro ped i a org The stand-alone application for consulting the entire bibliographical information on IEC International Standards, Technical Specifications, Technical Reports and other documents Available for PC, Mac OS, Android Tablets and iPad The world's leading online dictionary of electronic and electrical terms containing more than 30 000 terms and definitions in English and French, with equivalent terms in additional languages Also known as the International Electrotechnical Vocabulary (IEV) online I EC pu bl i cati on s search - www i ec ch /search pu b I E C G l o ssary - s td i ec ch /g l ossary The advanced search enables to find IEC publications by a variety of criteria (reference number, text, technical committee,…) It also gives information on projects, replaced and withdrawn publications More than 60 000 electrotechnical terminology entries in English and French extracted from the Terms and Definitions clause of IEC publications issued since 2002 Some entries have been collected from earlier publications of IEC TC 37, 77, 86 and CISPR I EC J u st Pu bl i s h ed - webstore i ec ch /j u stp u bl i s h ed Stay up to date on all new IEC publications Just Published details all new publications released Available online and also once a month by email I E C Cu s to m er S ervi ce Cen tre - webstore i ec ch /csc If you wish to give us your feedback on this publication or need further assistance, please contact the Customer Service Centre: csc@iec.ch I EC TR 61 968-900 ® Edition 201 5-1 TECH N I CAL R E POR T colour i n si de Appl i cati on i n teg rati on at el ectri c u ti l i ti es – System i n terfaces for d i stri bu ti on m an ag em en t – Part 900: G u i d an ce for i m pl em en tati on of I EC 61 968-9 INTERNATIONAL ELECTROTECHNICAL COMMISSION ICS 33.200 ISBN 978-2-8322-2950-7 Warn i n g ! M ake su re th at you obtai n ed th i s pu bl i cati on from an au th o ri zed d i stri bu tor ® Registered trademark of the International Electrotechnical Commission –2– I EC TR 61 968-900:201 © I EC 201 CONTENTS FOREWORD I N TRODU CTI ON 1 Scope N ormati ve references 3 I EC 61 968-1 00 basics 3 General 3 I EC 61 968-1 00 m essag e exchan g e patterns 3 I EC 61 968-1 00 m essag e types 3 General 3 Requ est messages 3 Response messages 3 U nsol ici ted event m essag es I EC 61 968-1 00 m essag e ten t General Verb an d nou n elements in th e messag e h eader 20 Get requests 20 4 Other requ ests 21 The Correlati onI D elem en t 21 Other elemen ts in the message header 21 The Message xsd XSD sch em a definition fil e 22 Request and response messag es in detail 23 General 23 Several poten tial response messages for each request m essag e 23 Response messag es contain a status indication 24 4 Response messag es contain ing data and error notificati ons 24 Specific error in dicati ons i n th e response m essages 24 I m plici t indication of su ccess 27 General error in dications in th e response m essages 28 General 28 Settin g the < Repl y >< Resu l t > el ement 28 M u l ti pl e response messag es 29 M u lti ple < Request > , < Repl y > and < Payload > el em ents 29 I m plem entation -speci fic messag es 30 The n am in g of objects 30 General 30 N am ing meters 30 En dDeviceGrou ps, U sag ePoin ts an d U sagePoin tGrou ps 32 N am ing of oth er objects 33 5 Provision in g and in terrogatin g a system 33 M eter read requests and responses 33 General 33 M essage exch ang e patterns 34 General 34 2 Requ est message with a sing le response messag e 34 Requ est message with m u l tipl e response messages 35 GetMeterReading s requ est 37 I EC TR 61 968-900:201 © I EC 201 –3– General 37 6 N aming of meters 39 3 The Reading Type elemen t 39 The Reading Qual ity elemen t 41 The TimeSchedu le elemen t 42 6 Speci fying m u l tipl e constraints in a requ est messag e 43 Coinciden t m eter reads 46 On-demand m eter reads 47 General 47 Pi ng ing a meter 49 M eterReadin g s response 49 General 49 The < MeterReading >< Meter > elemen t 51 The < MeterReading >< Reading s > elemen t 52 The < MeterReading >< Reading s >< Reading Qu ali ti es > el ement 53 5 The < MeterReading >< Reading s >< Reading Type > elemen t 53 6 The < MeterReading >< Reading s >< I ntervalBlocks > elemen ts 53 The En dDevi ceType, Reading Quali tyType and Reading Type elemen ts 53 6 U nsol ici ted m eter reads 56 6 General 56 6 M essage exch ang e pattern 56 6 M issin g reads 58 6 U nsol ici ted M eterReads tog eth er with EndDeviceEvents 59 M ore abou t tim estamps an d in terval data 60 General 60 I n terval data 61 The interval block 62 Raw data 62 M eter trol requ ests an d responses 63 General 63 M essage exch ang e pattern 64 Create(EndDeviceCon trols) messag e 65 General 65 En dDeviceCon trols elemen t 66 Repl y(EndDeviceCon trols) message 70 Created(EndDeviceEven ts) messag e 71 General 71 En dDeviceEven ts elemen t 71 U nsol ici ted En dDeviceEven ts Messag es 74 General 74 M essage exch ang e pattern 75 7 Prem ises area networks 75 7 General 75 7 M essage exch ang e pattern 75 7 Pairing the M eter and PAN device 76 Con fi gu rati on and provision in g 76 General 76 M essage exch ang e pattern 77 –4– I EC TR 61 968-900:201 © I EC 201 M eter config u ration 78 8 General 78 Create(MeterCon fig) message 79 3 Repl y(MeterCon fi g) m essage, success case 81 Repl y(MeterCon fi g) m essage, fai lu re case 81 M aster data li nkag e 81 General 81 Create(MasterDataLinkag e) m essage 82 Operation Sets 83 General 83 Operati onSet requ est messag e 84 Operati onSet Response M essag e 86 Sch edu l ing actions for fu tu re execu ti on 87 General 87 Sch edu l ing a meter read 87 General 87 2 M essage exch ang e pattern 88 M eterReadSchedu le elem en t 89 Create(MeterReadSch edu le) messag e 92 General 92 Repl y(MeterReadSchedu le) message 93 Cancelli ng a requ est 94 General 94 Cancel(M eterReadSch edu le) requ est 94 Transporting I EC 61 968-9 messag es 95 1 General 95 Transporting over SOAP 95 General 95 2 Generic WSDL 96 Si mple acknowledg ement m essag es 96 Example messag e flow 97 Transporting over J M S 98 General 98 Explicit acknowledgements 99 3 JM S property details 99 Process detai ls 99 Object details 00 1 Su mm ary of m essag e fields 00 1 General 00 1 M eter read operati ons 00 1 General 00 1 2 Requ est message 00 1 Response message 02 1 U nsol ici ted m eter read 06 1 M eter control operations 06 1 General 06 1 Requ est message elements 06 1 3 I n itial response messag e 08 1 Su bsequen t consequen tial even t m essages 09 I EC TR 61 968-900:201 © I EC 201 –5– U nsol ici ted m eter event 1 1 1 Con fig u rati on and provision in g 1 1 General 1 1 Provision ing a meter 1 1 Creation of a Com Modu le 1 1 4 ServiceLocati on 1 1 ServiceCateg oryCon fig 1 1 Service su ppl ier 1 1 U sag ePoin t location 1 1 U sag e poi n t 20 1 Custom er 22 1 Custom er accou n t 24 1 1 Custom er Ag reemen t 26 1 Pricing Stru cture 28 1 M asterDataLinkag e 29 1 4 Operati onSet 32 1 Adding , ch an g ing or deletin g an object iden tifi er 37 Fi gu re Fi gu re Fi gu re Fi gu re Fi gu re Fi gu re – – – – – – Example messag e for a sim ple m eter read requ est Example response messag e to a sim ple meter read request Example unsol ici ted even t m essag e Requ estMessag e definition according to Messag e xsd ResponseMessag e defini tion according to Message xsd EventMessag e defin i tion accordin g to Messag e xsd 20 Fi gu re – Su belements allowed i nside a < H eader > elemen t 23 Fi gu re – Example of a success indication i n a Repl y elem ent 24 Fi gu re – Example of error i ndications in a Reply elemen t (incom pl ete) 25 Fi gu re – Su belem en ts al lowed inside a < Reply > element 26 Fi gu re 1 – Su belem en ts al lowed inside a < Reply >< Error >< I D > el ement 27 Fi gu re – Example of overall i ndication of success in a Reply element 28 Fi gu re – Example of error in dications i n a Repl y elemen t (corrected) 28 Fi gu re – EndDevice defin ition 31 Fi gu re – Example of a Meter Read Requ est wi th N ameType and N ameTypeAu thority 32 Fi gu re – M essag e exch ang e pattern for a meter read requ est with a si ng le response message 35 Fi gu re – M essag e exch ang e pattern for a meter read requ est with mu ltipl e response messages 37 Fi gu re – GetMeterReading s definition accordin g to GetMeterReadi ng s xsd 39 Fi gu re – defini tion 41 Fi gu re 20 – < GetMeterReading >< Readi ng Qu ality > defi n iti on 42 Fi gu re 21 – < GetMeterReading s >< Tim eSchedu le > defin iti on 43 Fi gu re 22 – Example of a requ est message for two Readin gType codes over two meters 45 Fi gu re 23 – Example of a requ est message for two meter/Reading Type combin ations 46 Fi gu re 24 – M essag e exch ang e pattern for an on-deman d meter read 48 –6– I EC TR 61 968-900:201 © I EC 201 Fi gu re 25 – Example of an on -deman d m eter read requ est m essag e 49 Fi gu re 26 – Example of a response to a meter read request 50 Fi gu re 27 – M eterReadin g s defin i tion accordi ng to MeterReadin gs xsd 51 Fi gu re 28 – < MeterReadi ngs >< M eter > defi n iti on 52 Fi gu re 29 – < MeterReadi ngs >< Readin g > defi ni tion 52 Fi gu re 30 – < MeterReadi ng >< Readi ng Qu al i ty > defi n ition 53 Fi gu re 31 – < MeterReadi ngs >< I n tervalBlock > defi n iti on 54 Fi gu re 32 – Example of a meter read response with nam ed Reading Type and Reading Quali ty el em en ts 56 Fi gu re 33 – M essag e exch ang e pattern for a set of u nsol icted meter reads 57 Fi gu re 34 – Example of an u nsol ici ted meter read message 57 Fi gu re 35 – Example of a missi ng reading in a pu blished messag e 58 Fi gu re 36 – Example of a known m issing readi ng i n a publ ished m essag e 59 Fi gu re 37 – Example of a messag e showi ng both an even t and a reading 60 Fi gu re 38 – Reading Timestam ps 61 Fi gu re 39 – Example u se of I n tervalBlocks 63 Fi gu re 40 – M essag e exch ang e pattern for a meter trol operation 65 Fi gu re 41 – Example of a create(EndDeviceControls) messag e for one meter 66 Fi gu re 42 – Example of a create(EndDeviceControls) messag e for two meters 66 Fi gu re 43 – EndDeviceCon trols definition 67 Fi gu re 44 – EndDeviceCon trol defini tion 69 Fi gu re 45 – EndDeviceCon trolType defin ition 70 Fi gu re 46 – Example of a repl y(En dDeviceControls) messag e 70 Fi gu re 47 – Example of a created(En dDeviceEven ts) m essag e 71 Fi gu re 48 – EndDeviceEven ts defin ition 71 Fi gu re 49 – EndDeviceEven t defin ition 73 Fi gu re 50 – EndDeviceEven tType defi n iti on 74 Fi gu re 51 – M essag e exch ang e pattern for an u nsolicted EndDevice even t 75 Fi gu re 52 – M essag e exch ang e pattern for a create(M eterCon fig ) messag e 78 Fi gu re 53 – M eterConfig defi ni tion 79 Fi gu re 54 – Example of a create(M eterCon fig ) messag e 80 Fi gu re 55 – Example of a repl y(MeterCon fig) message, su ccess case 81 Fi gu re 56 – Example of a repl y(MeterCon fig) message, fai lu re case 81 Fi gu re 57 – M asterDataLinkageCon fig Relationsh ips 82 Fi gu re 58 – Example of a create(M asterDataLi nkag eCon fi g) m essage 83 Fi gu re 59 – Example of an execu te(Operation Set) messag e 85 Fi gu re 60 – Example of a repl y(OperationSet) message, success case 86 Fi gu re 61 – Example of a repl y(Operation Set) message, failure case 87 Fi gu re 62 – M essag e exch ang e pattern for schedu ling a set of meter reads 89 Fi gu re 63 – M eterReadSch edu le defini tion 90 Fi gu re 64 – M eterReadSch edu le TimeSchedu le defin i tion 92 Fi gu re 65 – Example of a meter read schedul e request 93 Fi gu re 66 – Example of a response to a meter read schedu le requ est 93 I EC TR 61 968-900:201 © I EC 201 –7– Fi g ure 67 – Example of a meter read schedu le cancel m essag e 95 Fi gu re 68 – Example of a si mple m eter read requ est i mbedded in a SOAP m essag e 95 Fi gu re 69 – Example of a si mple ackn owl edg emen t messag e 97 Fi gu re 70 – M essag e exch ang e pattern sh owing th e si mple acknowledg emen t messages 98 Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table – Comm on EndDeviceCon trols and th ei r correspondin g EndDeviceEvent codes 64 – Comm on EndDeviceEven t codes for u nsol ici ted messag es 75 – Con fi g Profil es 77 – J M S properties 99 – g et(MeterReadi ng s) fi el ds 01 – repl y(MeterReadi ng s) fields 03 – create(En dDevi ceCon trols) fields 07 – repl y(En dDeviceCon trols) fields 08 – created(EndDeviceEven ts) fields 09 – create(MeterCon fi g) fields 1 1 – create(Com Modu leCon fig ) fields 1 – create(ServiceLocationCon fig ) fiel ds 1 – create(ServiceCateg oryConfig ) fields 1 – create(ServiceSu ppl ierCon fig ) fi el ds 1 – create(U sag ePoin tLocationCon fig ) fields 1 – create(U sag ePoin tCon fig ) fi elds 20 – create(Custom erConfig ) fields 23 – create(Custom erAccoun tCon fi g) fields 25 – create(Custom erAg reemen tConfig ) fields 26 20 – create(Pricing Structu reCon fig ) fields 28 21 – create(MasterDataLinkag eCon fig ) fields, exam ple 29 22 – create(MasterDataLinkag eCon fig ) fields, exam ple 31 23 – execu te(Operation Set) H eader and Payload fi el ds, exam ple 32 24 – execu te(Operation Set) H eader and Payload fi el ds, exam ple 35 25 – execu te(Operation Set) H eader and Payload fi el ds, exam ple 39 –8– I EC TR 61 968-900:201 © I EC 201 I NTERNATI ONAL ELECTROTECHN I CAL COMMI SSI ON APPLICATION INTEGRATION AT ELECTRIC UTILITIES – SYSTEM INTERFACES FOR DISTRIBUTION MANAGEMENT – Part 900: Guidance for implementation of IEC 61 968-9 FOREWORD ) Th e I n tern ati on al El ectrotech n i cal Com m i ssi on (I EC) i s a worl d wi d e org an i zati on for stan dard i zati on com pri si n g al l n ati on al el ectrotech n i cal com m i ttees (I EC N ati on al Com m i ttees) Th e obj ect of I E C i s to prom ote i n tern ati on al co-operati on on al l q u esti on s cern i n g stan dard i zati on i n th e el ectri cal an d el ectron i c fi el ds To th i s en d an d i n ad di ti on to oth er acti vi ti es, I EC pu bl i sh es I n tern ati on al Stan d ards, Tech n i cal Speci fi cati on s, Tech n i cal Reports, Pu bl i cl y Avai l abl e Speci fi cati on s (PAS) an d G u i d es (h ereafter referred to as “I EC Pu bl i cati on (s) ”) Th ei r preparati on i s en tru sted to tech n i cal com m i ttees; an y I EC N ati on al Com m i ttee i n terested i n th e su bj ect d eal t wi th m ay parti ci pate i n th i s preparatory work I n tern ati on al , g overn m en tal an d n on g overn m en tal org an i zati on s l i si n g wi th th e I EC al so parti ci pate i n th i s preparati on I EC col l aborates cl osel y wi th th e I n tern ati on al Org an i zati on for Stan d ard i zati on (I SO) i n accordan ce wi th d i ti on s d eterm i n ed by ag reem en t between th e two org an i zati on s 2) Th e form al d eci si on s or ag reem en ts of I EC on tech n i cal m atters express, as n earl y as possi bl e, an i n tern ati on al sen su s of opi n i on on th e rel evan t su bj ects si n ce each tech n i cal com m i ttee h as represen tati on from al l i n terested I EC N ati on al Com m i ttees 3) I EC Pu bl i cati on s h ave th e form of recom m en d ati on s for i n tern ati on al u se an d are accepted by I E C N ati on al Com m i ttees i n th at sen se Wh i l e al l reason abl e efforts are m ad e to en su re th at th e tech n i cal ten t of I EC Pu bl i cati on s i s accu rate, I EC can n ot be h el d respon si bl e for th e way i n wh i ch th ey are u sed or for an y m i si n terpretati on by an y en d u ser 4) I n ord er to prom ote i n tern ati on al u n i form i ty, I E C N ati on al Com m i ttees u n d ertake to appl y I E C Pu bl i cati on s tran sparen tl y to th e m axi m u m exten t possi bl e i n th ei r n ati on al an d reg i on al pu bl i cati on s An y d i verg en ce between an y I EC Pu bl i cati on an d th e correspon d i n g n ati on al or reg i on al pu bl i cati on sh al l be cl earl y i n di cated i n th e l atter 5) I EC i tsel f d oes n ot provi d e an y attestati on of form i ty I n d epen d en t certi fi cati on bodi es provi d e form i ty assessm en t servi ces an d , i n som e areas, access to I EC m arks of form i ty I EC i s n ot respon si bl e for an y servi ces carri ed ou t by i n d epen d en t certi fi cati on bodi es 6) Al l u sers sh ou l d en su re th at th ey h ave th e l atest edi ti on of th i s pu bl i cati on 7) N o l i abi l i ty sh al l attach to I EC or i ts di rectors, em pl oyees, servan ts or ag en ts i n cl u di n g i n d i vi d u al experts an d m em bers of i ts tech n i cal com m i ttees an d I EC N ati on al Com m i ttees for an y person al i n j u ry, property d am ag e or oth er d am ag e of an y n atu re wh atsoever, wh eth er di rect or i n d i rect, or for costs (i n cl u d i n g l eg al fees) an d expen ses ari si n g ou t of th e pu bl i cati on , u se of, or rel i an ce u pon , th i s I EC Pu bl i cati on or an y oth er I EC Pu bl i cati on s 8) Atten ti on i s d rawn to th e N orm ati ve referen ces ci ted i n th i s pu bl i cati on U se of th e referen ced pu bl i cati on s i s i n d i spen sabl e for th e correct appl i cati on of th i s pu bl i cati on 9) Atten ti on i s d rawn to th e possi bi l i ty th at som e of th e el em en ts of th i s I EC Pu bl i cati on m ay be th e su bj ect of paten t ri g h ts I EC sh al l n ot be h el d respon si bl e for i d en ti fyi n g an y or al l su ch paten t ri g h ts The main task of I EC tech nical commi ttees is to prepare I n ternational Standards H owever, a techn ical com m ittee may propose th e pu blication of a techn ical report when i t has collected data of a differen t kin d from th at wh ich is normall y pu blished as an I nternational Standard, for exam pl e "state of th e art" I EC TR 61 968-900, wh ich is a techn ical report, has been prepared by I EC technical comm ittee 57: Power systems manag emen t and associated in form ati on exchang e The text of th is techn ical report is based on the followin g docu men ts: En q u i ry d raft Report on voti n g 57/1 579/DTR 57/1 61 6/RVC Fu ll in formati on on the votin g for the approval of th is technical report can be fou nd in th e report on voting in dicated in th e above table – 28 – I EC TR 61 968-900:201 © I EC 201 1 4.1 Pricing Structure A requ est to figu re a cu stom er accoun t is m ade by sendi ng a message wi th a header < Verb > of c rea t e an d a header < N ou n > of Pri c i n gS t ru c t u reCon fi g The n am e of th e profile file is Pri c i n gSt ru c t u reC on fi g xs d The corresponding namespace is h t t p: / / i ec c h / TC5 7/ 01 / Pri c i n gSt ru c t u reC on fi g# Table 20 lists th e elem en ts pertai ni ng to a create(ServiceLocationConfig ) requ est messag e Table 20 – create(PricingStructureConfig) fields H ead er Element name XSD data type Descri ption Verb Stri n g c rea t e N ou n Stri n g Pri c i n gS t ru c t u reCon fi g Ti m estam p d ateTi m e Date an d ti m e th i s m essag e was created Repl yAd d ress Stri n g Ad d ress to be u sed for asyn ch ron ou s web servi ce repl i es Th i s el em en t i s om i tted wh en n ot u si n g web servi ces AckReq u i red Bool ean Set to t ru e to req u est an ackn owl ed g em en t respon se m essag e from th e H ES Set to fa l s e to h ave th e H ES su ppress th e ackn owl ed g m en t respon se m essag e Payl oad Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re Wh en u si n g web servi ces, th i s el em en t m ay be om i tted – an ackn owl ed g m en t respon se m essag e i s al ways sen t M essag eI D Stri n g M DM S-speci fi ed m essag e i d en ti fi er Correl ati on I D Stri n g M DM S-speci fi ed i den ti fi er u sed for al l owi n g req u est-respon se correl ati on cod e Stri n g U ti l i ty-d esi g n ated rate cod e Con fi g u rati on Even ts cre ated DateTi m e DateTi m e Date an d ti m e th e com m an d to create th e Pri ci n g Stru ctu re was g en erated Con fi g u rati on Even ts effe cti veDateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e Pri ci n g Stru ctu re to h ave been or to be created I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Con fi g u rati on Even ts effe cti veEn d DateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e Pri ci n g Stru ctu re to n o l on g er be avai l abl e for u se Su ppl i ed on l y i f an en d to th e i n terval of ti m e th at th e Pri ci n g Stru ctu re i s to be si d ered val i d an d u sabl e i s kn own at th e ti m e of th e creati on req u est Con fi g u rati on Even ts N a m es n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Con fi g u rati on Even ts N a m es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re Con fi g u rati on Even ts N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Con fi g u rati on Even ts N a m es N am eType N am eTy peAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re Con fi g u rati on Even ts N am es n am e cou pl ed wi th th e Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re Con fi g u rati on Even ts N am es N am eType n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er I EC TR 61 968-900:201 © I EC 201 El em en t name – 29 – XSD data type Descri pti on N am es n am e Stri n g Pri m ary I d en ti fi er of th e Pri ci n g Stru ctu re For ven i en ce, i t i s recom m en d ed bu t n ot req u i red th at th e Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re N am es n am e be set to th e sam e val u e as th e Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re cod e N am es N am eType n am e Stri n g For th e Pri m ary I d en ti fi er, speci fy a N am eType n am e of “Pri m aryN am e” N am es N am eType N am e TypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re N am es n am e cou pl ed wi th th e Pri ci n g Stru ctu reCon fi g Pri ci n g Stru ctu re N am es N am eType n a m e i s provi d ed an d i s n ot u n i qu e i n th e absen ce of th i s ad d i ti on al i d en ti fi er 1 4.1 MasterDataLinkag e A requ est to l ink two or more previou sly defined fig u ration items is made by sen ding a m essage wi th a h eader < Ve rb > of c rea t e an d a header < Nou n > of Ma s t e rDa t a L i n ka geC on fi g The n am e of th e profile file is Ma s t erDa t a L i n ka ge Con fi g xs d The corresponding namespace is h t t p: / / i ec c h / TC 7/ 01 / Ma s t erDa t a L i n ka geC on fi g# The fol l owi ng two examples i llustrate a master data l inkage The fi rst exam ple, shown in Table 21 , demonstrates creating an association between a comm un icati ons modu le an d a meter Table 21 – create(MasterDataLinkageConfig ) fields, example H ead er El emen t n ame XSD d ata type Descri pti on Verb Stri n g c rea t e N ou n Stri n g Ma s t erDa t a L i n ka geC on fi g Ti m estam p d ateTi m e Date an d ti m e th i s m essag e was created Repl yAd d ress Stri n g Ad d ress to be u sed for asyn ch ron ou s web servi ce repl i es Th i s el em en t i s om i tted wh en n ot usi n g web servi ces AckReq u i red Bool ean Set to t ru e to req u est an ackn owl ed g em en t respon se m essag e from th e H ES Set to fa l s e to h ave th e H ES su ppress th e ackn owl ed g m en t respon se m essag e Wh en u si n g web servi ces, th i s el em en t m ay be om i tted – an ackn owl ed g m en t respon se m essag e i s al ways sen t M essag eI D Stri n g M DM S-speci fi ed m essag e i d en ti fi er Correl ati on I D Stri n g M DM S-speci fi ed i den ti fi er u sed for al l owi n g req u est-respon se correl ati on – 30 – Payl oad M asterDataLi n kag eCon fi g Element name XSD data type I EC TR 61 968-900:201 © I EC 201 Description Con fi g u rati on Even t create d DateTi m e DateTi m e Date an d ti m e th e com m an d to create th e M asterDataLi n kag e was g en erated Con fi g u rati on Even t effecti veDateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e Com M od u l e to h ave been or to be associ ated wi th th e M eter I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Con fi g u rati on Even t effecti veEn d DateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e Com M od u l e to h ave been rem oved or to be rem oved from th e M eter Su ppl i ed on l y i f th e en d of th e ti m e i n terval th at th i s associ ati on i s si d ered val i d i s kn own at th e ti m e of th e create req u est Con fi g u rati on Even t N am e s n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Con fi g u rati on Even t N am e s N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Con fi g u rati on Even t N am e s N am eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es n am e cou pl ed wi th th e M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es N am eT ype n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Com M od u l e N am es n am e Stri n g I d en ti fi er of th e Com M od u l e Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i q u e N am es n am e for th e Com M od u l e Com M od u l e N am es N am e Type n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f M asterDataLi n kag eCon fi g Com M od u l e N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Com M od u l e N am es N am e Type N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f M asterDataLi n kag eCon fi g Com M od u l e N am es n am e cou pl ed wi th th e M asterDataLi n kag eCon fi g Com M od u l e N am es N am eType n a m e i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er M eter N am es n am e Stri n g I d en ti fi er of th e M eter Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i qu e N am es n am e for th e M eter M eter N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f M asterDataLi n kag eCon fi g M eter N am es n am e i s n ot u n i qu e i n th e absen ce of th i s ad di ti on al i d en ti fi er M eter N am es N am eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f M asterDataLi n kag eCon fi g M eter N am es n am e cou pl ed wi th th e M asterDataLi n kag eCon fi g M eter N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er The second example, g iven in Table 22, dem onstrates creatin g an association between a meter and a u sage poin t I EC TR 61 968-900:201 © I EC 201 – 31 – Table 22 – create(MasterDataLinkageConfig ) fields, example Payyl oad M asterDataLi n kag eCon fi g H ead er El em en t name XSD data type Descri pti on Verb Stri n g c rea t e N ou n Stri n g Ma s t erDa t a L i n ka geC on fi g Ti m estam p d ateTi m e Date an d ti m e th i s m essag e was created Repl yAd d ress Stri n g Ad d ress to be u sed for asyn ch ron ou s web servi ce repl i es Th i s el em en t i s om i tted wh en n ot usi n g web servi ces AckReq u i red Bool ean Set to t ru e to req u est an ackn owl ed g em en t respon se m essag e from th e H ES Set to fa l s e to h ave th e H ES su ppress th e ackn owl ed g m en t respon se m essag e Wh en u si n g web servi ces, th i s el em en t m ay be om i tted – an ackn owl ed g m en t respon se m essag e i s al ways sen t M essag eI D Stri n g M DM S-speci fi ed m essag e i d en ti fi er Correl ati on I D Stri n g M DM S-speci fi ed correl ati on i den ti fi er u sed for al l owi n g req u est-response correl ati on Con fi g u rati on Even t creat ed DateTi m e DateTi m e Date an d ti m e th e com m an d to create th e M asterDataLi n kag e was g en erated Con fi g u rati on Even t effec ti veDateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e M eter to h ave been or to be i n stal l ed at th e U sag ePoi n t I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Con fi g u rati on Even t effec ti veEn d DateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e M eter to h ave been rem oved or to be rem oved from th e U sag ePoi n t Su ppl i ed on l y i f th e en d of th e ti m e i n terval th at th i s associ ati on i s si d ered val i d i s kn own at th e ti m e of th e create req u est Con fi g u rati on Even t N am es n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Con fi g u rati on Even t N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Con fi g u rati on Even t N am es N am eType N am eTyp eAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es n am e cou pl ed wi th th e M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es N am eT ype n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er M eter N am es n am e Stri n g I d en ti fi er of th e M eter Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i qu e N am es n am e for th e M eter M eter N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f M asterDataLi n kag eCon fi g M eter N am es n am e i s n ot u n i qu e i n th e absen ce of th i s ad di ti on al i d en ti fi er M eter N am es N am eType N am eTypeAu th ori ty n a me Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f M asterDataLi n kag eCon fi g M eter N am es n am e cou pl ed wi th th e M asterDataLi n kag eCon fi g M eter N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er U sag ePoi n t N am es n am e Stri n g I d en ti fi er of th e U sag ePoi n t Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i q u e N am es n am e for th e U sag ePoi n t U sag ePoi n t N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er U sag ePoi n t N am es N am eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e cou pl ed wi th th e M asterDataLi n kag eCon fi g U sag ePoi n t N am es N am eType n a m e i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er – 32 – I EC TR 61 968-900:201 © I EC 201 1 4.1 OperationSet An operati on set is u sed to com bine several comm ands into one transactional un i t Such a messag e h as a header < Verb > of exec u t e an d a h eader < N ou n > of Opera t i on Set There is no profile file specific to this messag e type The following two examples il lu strate u sag e of an operation set Th e first exam pl e, sh own in Table 23, shows the creation of a u sag e poi n t and associates a meter wi th i t Ei ther of these operations wi ll fai l if th e meter h as not been previou sly created or th e m eter is already associated wi th a di fferent u sag e poi n t or vice versa Table 23 – execute(OperationSet) Header and Payload fields, example H ead er Element name XSD data type Description Verb Stri n g e xec u t e N ou n Stri n g Opera t i on S et Ti m estam p d ateTi m e Date an d ti m e th i s m essag e was created Repl yAd d ress Stri n g Ad d ress to be u sed for asyn ch ron ou s web servi ce repl i es Th i s el em en t i s om i tted wh en n ot u si n g web servi ces AckReq u i red Bool ean Set to t ru e to req u est an ackn owl ed g em en t respon se m essag e from th e H ES Set to fa l s e to h ave th e H ES su ppress th e ackn owl ed g m en t respon se m essag e Payl oad Operati on Set Wh en u si n g web servi ces, th i s el em en t m ay be om i tted – an ackn owl ed g m en t respon se m essag e i s al ways sen t M essag eI D Stri n g M DM S-speci fi ed m essag e i d en ti fi er Correl ati on I D Stri n g M DM S-speci fi ed i den ti fi er u sed for al l owi n g req u est-respon se correl ati on en forceM sg Seq u en ce Bool ean Set to “tru e” to d i rect th at th e Operati on s i n th e Operati on Set be perform ed i n ord er of i n creasi n g Operati on Set Operati on operati on I d en forceTran sacti on al I n teg ri ty Bool ean Set to “tru e” to speci fy th at al l Operati on s i n th e operati on Set sh ou l d fai l i f an y Operati on fai l s Operati on operati on I d I n teg er “1 ” as th i s i s th e fi rst Operati on i n th i s Operati on Set Operati on n ou n Stri n g “U sag ePoi n tCon fi g ” as th e i n ten t i s to create a U sag ePoi n t Operati on verb En u m erated Stri n g “create” as th e i n ten t i s to create a U sag ePoi n t Operati on el em en tOperati on Bool ean “fal se” as th i s Operati on i s n ot i n ten ded to d el ete attri bu tes an d i n stan ces of cl asses from a U sag ePoi n t’ s fi g u rati on (Note: This element is optional in this use case because the default value is “false”) Operati on U sag ePoi n tCon fi g U sag ePoi n t n ecti on State En u m erated S tri n g “con n ected ” En ter th e state of th e U sag ePoi n t wi th respect to n ecti on to th e di stri bu ti on n etwork Operati on U sag ePoi n tCon fi g U sag ePoi n t i sSd p Bool ean Set to tru e i f th e U sag ePoi n t i s a Servi ceDel i veryPoi n t I f om i tted , a val u e of tru e i s assu m ed Operati on U sag ePoi n tCon fi g U sag ePoi n t i sVi rtu al Bool ean Set to tru e i f th e U sag ePoi n t i s a Vi rtu al U sag ePoi n t I f om i tted , a val u e of fal se i s assu m ed Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts created DateTi m e DateTi m e Date an d ti m e th e com m an d to create th e U sag ePoi n t was g en erated I EC TR 61 968-900:201 © I EC 201 Element name XSD data type – 33 – Description Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts effecti veDateTi me DateTi m e Date an d ti m e th e M DM S sh al l si d er th e U sag ePoi n t to h ave been or to be created I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts N am es n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts N am es N am eTy pe n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts N am es N am eTy pe N am eTypeAu th ori ty n a me Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts N am es n am e cou pl ed wi th th e Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t Con fi g u rati on Even ts N am es N am eType n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on U sag ePoi n tCon fi g U sag ePoi n t Cu stom Attr i bu tes n am e Stri n g “Cu stom Attri bu te1 ” Su bseq u en t Cu stom Attri bu tes wi l l h ave n am es of Cu stom Attri bu te2, Cu stom Attri bu te3, etc Operati on U sag ePoi n tCon fi g U sag ePoi n t Cu stom Attr i bu tes seq u en ceN u m ber I n teg er “1 ” Su bsequ en t Cu stom Attri bu tes wi l l h ave seq u en ceN u m bers of “2”, “3”, etc Req u i red on l y i f a Cu stom Attri bu te wi th Cu stom Attri bu te n am es of “Cu stom Attri bu te1 ” i s provi ded Operati on U sag ePoi n tCon fi g U sag ePoi n t Cu stom Attr i bu tes val u e Stri n g U ti l i ty speci fi c ten t for th i s Cu stom Attri bu te Req u i red on l y i f a Cu stom Attri bu te wi th Cu stom Attri bu tes n am es of “Cu stom Attri bu te1 ” i s provi ded Operati on U sag ePoi n tCon fi g U sag ePoi n t Di stri bu ti on Detai l tran sform erI d Stri n g Th e i d en ti fi er of th e d i stri bu ti on tran sform er servi n g th i s U sag ePoi n t Appl i cabl e on l y to el ectri c U sag ePoi n ts Operati on U sag ePoi n tCon fi g U sag ePoi n t N am es n a me Stri n g Pri m ary I d en ti fi er of th e U sag ePoi n t Operati on U sag ePoi n tCon fi g U sag ePoi n t N am es N a m eType n am e Stri n g For th e Pri m ary I d en ti fi er, speci fy a N am eType n am e of “Pri m aryN am e” Operati on U sag ePoi n tCon fi g U sag ePoi n t N am es N a m eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t N am e s n am e cou pl ed wi th th e Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t N am e s N am eType n am e i s provi ded an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Operati on U sag ePoi n tCon fi g U sag ePoi n t N am es n a me Stri n g s t Al tern ate I den ti fi er of th e U sag ePoi n t I f a s t Al tern ate I d en ti fi er i s n ot speci fi ed , i t i s assu m ed to be th e sam e as th e Pri m ary I d en ti fi er Operati on U sag ePoi n tCon fi g U sag ePoi n t N am es N a m eType n am e Stri n g For th e s t Al tern ate I d en ti fi er, speci fy a N am eType n am e of “U ti l i tyU sag ePoi n tI D” Operati on U sag ePoi n tCon fi g U sag ePoi n t N am es N a m eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t N am e s n am e cou pl ed wi th th e Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t N am e s N am eType n am e i s provi ded an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Operati on U sag ePoi n tCon fi g U sag ePoi n t Pri ci n g Stru ctu res cod e Stri n g U ti l i ty cod e for th e rate (tari ff) appl i cabl e to th e U sag ePoi n t U se of Cu stom Attri bu tes i s u ti l i ty-speci fi c an d provi ded sol el y for backward s com pati bi l i ty wi th l eg acy d ata syn ch ron i zati on i n terfaces Th i s el em en t i s g en eral l y req u i red wh en th e EOM m od u l e of th e Ecol og i c M DM S i s bei n g i m pl em en ted – 34 – Element name XSD data type I EC TR 61 968-900:201 © I EC 201 Description Operati on U sag ePoi n tCon fi g U sag ePoi n t Servi ceCat eg ory ki n d En u m erated Operati on U sag ePoi n tCon fi g U sag ePoi n t U sag ePoi n tLocati on N am es n am e Stri n g I d en ti fi er of th e U sag ePoi n tLocati on at wh i ch th i s U sag ePoi n t exi sts Operati on U sag ePoi n tCon fi g U sag ePoi n t U sag ePoi n tLocati on N am es N am eTy pe n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t U sag e Poi n tLocati on N am es n am e cou pl ed wi th th e Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t U sag e Poi n tLocati on N am es N am eType n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on U sag ePoi n tCon fi g U sag ePoi n t U sag ePoi n tLocati on N am es N am eTy pe N am eTypeAu th ori ty n a me Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t U sag e Poi n tLocati on N am es n am e cou pl ed wi th th e Operati on Set Operati on U sag ePoi n tCon fi g U sag ePoi n t U sag e Poi n tLocati on N am es N am eType n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on operati on I d I n teg er “2” as th i s i s th e secon d Operati on i n th i s Operati on Set Operati on n ou n Stri n g “M asterDataLi n kag eCon fi g ” as th e i n ten t i s to create a M asterDataLi n kag e Operati on verb En u m erated Stri n g “create” as th e i n ten t i s to create a M asterDataLi n kag e Operati on el em en tOperati on Bool ean “fal se” as th i s Operati on i s n ot i n ten ded to del ete attri bu tes an d i n stan ces of cl asses from a M asterDataLi n kag e Stri n g Ki n d of servi ce su ppl i ed at th e U sag ePoi n t Cu rren tl y su pported ki n ds are “el ectri ci ty”, “g as”, an d “water” (Note: This element is optional in this use case because the default value is “false”) Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t created DateTi m e DateTi m e Date an d ti m e th e com m an d to create th e M asterDataLi n kag e was g en erated Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t effecti veDateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e M eter to h ave been or to be i n stal l ed at th e U sag ePoi n t I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es N am eType n a me Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on E ven t N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es N am eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on E ven t N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on E ven t N am es N am eType n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g M eter N am es n am e Stri n g I d en ti fi er of th e M eter Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i qu e N am es n am e for th e M eter Operati on M asterDataLi n k ag eCon fi g M eter N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g M eter N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g M eter N am es N am eType N am eTypeAu th o ri ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g M eter N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g M ete r N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er I EC TR 61 968-900:201 © I EC 201 Element name – 35 – XSD data type Description Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es n am e Stri n g I d en ti fi er of th e U sag ePoi n t Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i q u e N am es n am e for th e U sag ePoi n t Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es N am eType N am eTyp eAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er The second example of an Operation Set performs a meter exchan g e data synchronizati on Th is is sh own in Table 24 Two operations are inclu ded in the Operati on Set The fi rst operation reflects th e removal of a m eter from a usag e point The second operation reflects th e installation of a new (di fferen t) m eter at the same u sag ePoin t The basic u se case i llustrated h ere cou ld be extended wi th addi tional operations for u pdatin g th e meter an d usage poin t fig u rati ons consi stent wi th th e basic meter exchang e For exampl e, a ch ang e(M eterCon fig ) operations coul d be inclu ded to update th e li fecycl e fi elds i n the fig u ration records of the two m eters Either of th ese operations wil l fai l if one or both m eters have n ot been previou sl y created or the U sag ePoin t has n ot been previousl y created or the meter in the removal operation is not instal led at th e usag e poin t or the m eter in the i nstall ation operati on is already installed at differen t u sag e poin t Table 24 – execute(OperationSet) Header and Payload fields, example H ead er Element name XSD data type Description Verb Stri n g e xec u t e N ou n Stri n g Opera t i on S et Ti m estam p d ateTi m e Date an d ti m e th i s m essag e was created Repl yAd d ress Stri n g Ad d ress to be u sed for asyn ch ron ou s web servi ce repl i es Th i s el em en t i s om i tted wh en n ot u si n g web servi ces AckReq u i red Bool ean Set to t ru e to req u est an ackn owl ed g em en t respon se m essag e from th e H ES Set to fa l s e to h ave th e H ES su ppress th e ackn owl ed g m en t respon se m essag e Wh en u si n g web servi ces, th i s el em en t m ay be om i tted – an ackn owl ed g m en t respon se m essag e i s al ways sen t M essag eI D Stri n g M DM S-speci fi ed m essag e i d en ti fi er Correl ati on I D Stri n g M DM S-speci fi ed correl ati on i den ti fi er u sed for al l owi n g req u est-response correl ati on – 36 – Element name XSD data type I EC TR 61 968-900:201 © I EC 201 Description en forceM sg Seq u en ce Bool ean Set to “tru e” to d i rect th at th e Operati on s i n th e Operati on Set be perform ed i n ord er of i n creasi n g Operati on Set Operati on operati on I d en forceTran sacti on al I n teg ri ty Bool ean Set to “tru e” to speci fy th at al l Operati on s i n th e operati on Set sh ou l d fai l i f an y Operati on fai l s Operati on operati on I d I n teg er “1 ” as th i s i s th e secon d Operati on i n th i s Operati on Set Operati on n ou n Stri n g “M asterDataLi n kag eCon fi g ” as th e i n ten t i s to d el ete a M asterDataLi n kag e Operati on verb En u m erated Stri n g “d el ete” as th e i n ten t i s to d el ete a M asterDataLi n kag e Operati on el em en tOperati on Bool ean “fal se” as th i s Operati on i s n ot i n ten ded to d el ete attri bu tes an d i n stan ces of cl asses from a M asterDataLi n kag e Payl oad Operati on Set (Note: This element is optional in this use case because the default value is “false”) Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t created DateTi m e DateTi m e Date an d ti m e th e com m an d to d el ete th e M asterDataLi n kag e was g en erated Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t effecti veDateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e M eter to h ave been or to be rem oved from th e U sag ePoi n t I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es N am eType n a me Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es N am eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on Even t N am es N am eType n am e i s provi ded an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g M eter N am es n am e Stri n g I d en ti fi er of th e M eter Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i qu e N am es n am e for th e M eter Operati on M asterDataLi n k ag eCon fi g M eter N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g M ete r N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g M eter N am es N am eType N am eTypeAu th o ri ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g M ete r N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g M ete r N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es n am e Stri n g I d en ti fi er of th e U sag ePoi n t Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i q u e N am es n am e for th e U sag ePoi n t Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es N am eType N am eTyp eAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er I EC TR 61 968-900:201 © I EC 201 Element name – 37 – XSD data type Description Operati on operati on I d I n teg er “2” as th i s i s th e secon d Operati on i n th i s Operati on Set Operati on n ou n Stri n g “M asterDataLi n kag eCon fi g ” as th e i n ten t i s to create a M asterDataLi n kag e Operati on verb En u m erated Stri n g “create” as th e i n ten t i s to create a M asterDataLi n kag e Operati on el em en tOperati on Bool ean “fal se” as th i s Operati on i s n ot i n ten ded to del ete attri bu tes an d i n stan ces of cl asses from a M asterDataLi n kag e (Note: This element is optional in this use case because the default value is “false”) Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t created DateTi m e DateTi m e Date an d ti m e th e com m an d to create th e M asterDataLi n kag e was g en erated Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t effecti veDateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e M eter to h ave been or to be i n stal l ed at th e U sag ePoi n t I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es N am eType n a me Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on E ven t N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g Con fi g u rati on E ven t N am es N am eType N am eTypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on E ven t N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g Con fi g u rati on E ven t N am es N am eType n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g M eter N am es n am e Stri n g I d en ti fi er of th e M eter Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i qu e N am es n am e for th e M eter Operati on M asterDataLi n k ag eCon fi g M eter N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g M eter N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g M eter N am es N am eType N am eTypeAu th o ri ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g M eter N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g M ete r N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es n am e Stri n g I d en ti fi er of th e U sag ePoi n t Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i q u e N am es n am e for th e U sag ePoi n t Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er Operati on M asterDataLi n k ag eCon fi g U sag ePoi n t N a m es N am eType N am eTyp eAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es n am e cou pl ed wi th th e Operati on Set Operati on M asterDataLi n kag eCon fi g U sag ePoi n t N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er 1 4.1 Adding, changing or deleting an object identifier Some u tility in teg ration scenarios requ i re th e abi li ty to add, ch ang e, or del ete one or more iden tifiers (N ames cl ass i nformation ) for an object This is accomplish ed by means of the ObjectN amesConfig profile – 38 – I EC TR 61 968-900:201 © I EC 201 To m odi fy the N am es class iden ti fi er(s) for an y object su ch as a m eter, cu stom er or an y other object as l isted in clause 8, the object must be i den ti fied by i ts mRI D or on e or more valid instances of i ts N ames class in th e appropriate strong ly-typed elemen t of the m essag e (e g , Meter, Cu stomer, etc ) I f one or m ore existing instances of the N am es class are being modified or del eted, all su ch instances shou ld be inclu ded To add a new N am es class iden ti fier, u se th e verb c rea t e and place th e new N ames class in formation i n the < Obj e c t Na mes C on fi g >< Na mes > portion of the messag e With the verb create, all N ames class i den ti fiers in the stron gl y-typed elemen t will be retain ed and al l Names class i den ti fiers i n the < Obj ec t Na mes C on fi g >< Na me s > portion of the messag e wil l be added To ch ang e one or more N ames cl ass iden ti fiers, u se the verb c h a n ge and place th e revised N ames class in formation in the < Obj ec t Na mes C on fi g >< Na mes > portion of the messag e I n th is case, all N ames class identifiers in the strong l y-typed element wi ll be del eted an d al l N ames cl ass iden tifiers i n the < Obj ec t Na mes C on fi g >< Na me s > portion of th e message wil l be added To delete on e or m ore N ames class identifiers, u se the verb d el et e and not popu l ate th e < Obj e c t Na me s C on fi g >< N a mes > portion of the m essage With the verb d el e t e , al l N ames class iden tifiers i n the strong ly-typed elemen t wi ll be deleted m RI Ds are im mu table and cannot be chang ed As n oted I n 2, each mRI D mu st be provided as a 28-bit u niversal l y un iqu e iden ti fier or U U I D An y attempt to use ObjectN amesCon fig that l eaves an object wi th no valid iden tifiers wil l fail Si milarl y, an y attempt to use ObjectN amesCon fig that leaves an object wi th fl ictin g or ambig u ou s N ames class iden ti fiers wil l fai l The fol lowing u se case i ll ustrates chang ing N ames class in formation for a usag e poin t I n th e example g iven i n Table 25, the U sag ePoin t with a < Na me s >< n a me > of “A1 234” is renamed to “A5678” Th e old identifier (“A1 234”) is placed in the < Obj e c t Na mes Con fi g >< Us a gePoi n t >< Na me s >< n a me > an d the n ew identifier is placed in the < Obj e c t Na me s Con fi g >< N a mes >< n a me > Th e option al < Na meType >< n a me > an d < Na meType > < N a meType Au t h ori t y >< n a me > for each is also provided I EC TR 61 968-900:201 © I EC 201 – 39 – Table 25 – execute(OperationSet) Header and Payload fields, example H ead er Element name XSD data type Descripti on Verb Stri n g e xec u t e N ou n Stri n g Opera t i on Se t Ti m estam p d ateTi m e Date an d ti m e th i s m essag e was created Repl yAd d ress Stri n g Ad d ress to be u sed for asyn ch ron ou s web servi ce repl i es Th i s el em en t i s om i tted wh en n ot u si n g web servi ces AckReq u i red Bool ean Set to t ru e to req u est an ackn owl ed g em en t respon se m essag e from th e H ES Set to fa l s e to h ave th e H ES su ppress th e ackn owl edg m en t respon se m essag e Payl oad Obj ectN am esCon fi g Wh en u si n g web servi ces, th i s el em en t m ay be om i tted – an ackn owl ed g m en t respon se m essag e i s al ways sen t M essag eI D Stri n g M DM S-speci fi ed m essag e i d en ti fi er Correl ati on I D Stri n g M DM S-speci fi ed i den ti fi er u sed for al l owi n g req u est-respon se correl ati on Con fi g u rati on Even ts cre ated DateTi m e DateTi m e Date an d ti m e th e com m an d to ch an g e th e U sag ePoi n t i d en ti fi er was g en erated Con fi g u rati on Even ts effe cti veDateTi m e DateTi m e Date an d ti m e th e M DM S sh al l si d er th e i d en ti fi er of th e U sag e Poi n t to h ave been or to be ch an g ed I f th i s d ate/ti m e i s i n th e fu tu re, M DM S wi l l pen d th e tran sacti on an d process i t at th e speci fi ed fu tu re d ate an d ti m e Con fi g u rati on Even ts N a m es n am e Stri n g I d en ti fi er of th e Con fi g u rati on Even t th at can be u sed for tracki n g /au d i ti n g processes Con fi g u rati on Even ts N a m es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f th e Obj ectN am esCon fi g Con fi g u rati on Even t N am es n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er Con fi g u rati on Even ts N a m es N am eType N am eTy peAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Obj ectN am esCon fi g Con fi g u rati on Even t N am es n am e cou pl ed wi th th e Obj ectN am esCon fi g Con fi g u rati on Even t N am es N am eType n am e i s provi d ed an d i s n ot u n i q u e i n th e absen ce of th i s ad di ti on al i d en ti fi er N am es n am e Stri n g N ew i d en ti fi er of th e U sag ePoi n t Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i q u e N am es n am e for th e U sag ePoi n t N am es N am eType n am e Stri n g I d en ti fi er of th e N am eType Req u i red on l y i f Obj ectN am esCon fi g N am es n am e i s n ot u n i qu e i n th e absen ce of th i s ad di ti on al i d en ti fi er N am es N am eType N am e TypeAu th ori ty n am e Stri n g I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Obj ectN am esCon fi g N am es n am e cou pl ed wi th th e Obj ectN am esCon fi g N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er U sag ePoi n t N am es n am e Stri n g Ol d i d en ti fi er of th e U sag ePoi n t Th i s m ay be th e Pri m ary I d en ti fi er (N am eType n am e = “Pri m aryN am e”) or an y oth er u n i q u e N am es n am e for th e U sag ePoi n t U sag ePoi n t N am es N am e Stri n g Type n am e I d en ti fi er of th e N am eType Req u i red on l y i f Obj ectN am esCon fi g U sag ePoi n t N am es n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er U sag ePoi n t N am es N am e Stri n g Type N am eTypeAu th ori ty n am e I d en ti fi er of th e N am eTypeAu th ori ty Req u i red on l y i f Obj ectN am esCon fi g U sag ePoi n t N am es n am e cou pl ed wi th th e Obj ectN am esCon fi g U sag ePoi n t N am es N am eType n am e i s n ot u n i q u e i n th e absen ce of th i s ad d i ti on al i d en ti fi er _ INTERNATIONAL ELECTROTECHNICAL COMMISSION 3, rue de Varembé PO Box 31 CH-1 21 Geneva 20 Switzerland Tel: + 41 22 91 02 1 Fax: + 41 22 91 03 00 info@iec.ch www.iec.ch