Iec 62541 11 2015

I E C 62 541 -1 ® Edition 201 5-03 I N TE RN ATI ON AL S TAN D ARD N ORM E I N TE RN ATI ON ALE OPC u n i fi ed arch i tectu re – Part 1 : H i s tori cal Acces s Arch i tectu re u n i fi ée OPC – IEC 62541 -1 :201 5-03(en-fr) Parti e 1 : Accès l ’ H i s tori q u e colour in sid e TH I S P U B L I C ATI O N I S C O P YRI G H T P RO TE C T E D C o p yri g h t © I E C , G e n e va , S w i tze 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 Droits de reproduction réservés Sauf indication contraire, aucune partie de cette publication ne peut être reproduite ni utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique, y compris la photocopie et les microfilms, sans l'accord écrit de l'IEC ou du Comité national de l'IEC du pays du demandeur Si vous avez des questions sur le copyright de l'IEC ou si vous désirez obtenir des droits supplémentaires sur cette publication, utilisez les coordonnées ci-après ou contactez le Comité national de l'IEC de votre pays de résidence 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 Abou 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 ti 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 E C C atal og u e - webs tore i ec ch /catal og u e 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 I E C pu bl i cati on s s earch - www i ec ch /s earch pu b 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 E l ectroped i a - www el ectroped i a org 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 E C G l os s ary - s td i ec ch /g l os s ary 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 E C J u st P u bl i s h ed - webs tore i ec ch /j u s 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 C u s to m er S ervi ce C en tre - webs tore i ec ch /cs c If you wish to give us your feedback on this publication or need further assistance, please contact the Customer Service Centre: csc@iec.ch A propos d e l ' I E C La Commission Electrotechnique Internationale (IEC) est la première organisation mondiale qui élabore et publie des Normes internationales pour tout ce qui a trait l'électricité, l'électronique et aux technologies apparentées A propos d es p u bl i cati on s I E C Le contenu technique des publications IEC est constamment revu Veuillez vous assurer que vous possédez l’édition la plus récente, un corrigendum ou amendement peut avoir été publié C atal og u e I E C - webs tore i ec ch /catal og u e Application autonome pour consulter tous les renseignements bibliographiques sur les Normes internationales, Spécifications techniques, Rapports techniques et autres documents de l'IEC Disponible pour PC, Mac OS, tablettes Android et iPad Rech erch e d e pu bl i cati o n s I E C - www i ec ch /s earch p u b La recherche avancée permet de trouver des publications IEC en utilisant différents critères (numéro de référence, texte, comité d’études,…) Elle donne aussi des informations sur les projets et les publications remplacées ou retirées E l ectroped i a - www el ectroped i a org Le premier dictionnaire en ligne de termes électroniques et électriques Il contient plus de 30 000 termes et définitions en anglais et en franỗais, ainsi que les termes ộquivalents dans langues additionnelles Egalement appelé Vocabulaire Electrotechnique International (IEV) en ligne G l os s re I E C - s td i ec ch /g l os s ary Plus de 60 000 entrées terminologiques électrotechniques, en anglais et en franỗais, extraites des articles Termes et Dộfinitions des publications IEC parues depuis 2002 Plus certaines entrées antérieures extraites des publications des CE 37, 77, 86 et CISPR de l'IEC I E C J u st P u bl i s h ed - webs tore i ec ch /j u s tpu bl i s h ed Restez informé sur les nouvelles publications IEC Just Published détaille les nouvelles publications parues Disponible en ligne et aussi une fois par mois par email S ervi ce C l i en ts - webs tore i ec ch /cs c Si vous désirez nous donner des commentaires sur cette publication ou si vous avez des questions contactez-nous: csc@iec.ch I E C 62 541 -1 ® Edition 201 5-03 I N TE RN ATI ON AL S TAN D ARD N ORM E I N TE RN ATI ON ALE colour in sid e OP C u n i fi ed arch i tectu re – Part 1 : H i s tori cal Acces s Arch i tectu re u n i fi ée OP C – Parti e 1 : Accès l ’ H i s tori q u e INTERNATIONAL ELECTROTECHNICAL COMMISSION COMMISSION ELECTROTECHNIQUE INTERNATIONALE ICS 25.040.40; 35.1 00 ISBN 978-2-8322-2298-0 Warn i n g ! M ake s u re th at you ob tai n ed th i s pu bl i cati on from an au th ori zed d i s tri bu tor Atten ti on ! Veu i l l ez vou s as s u rer q u e vou s avez o bten u cette pu bl i cati on vi a u n d i s tri b u teu r ag réé ® Registered trademark of the International Electrotechnical Commission –2– I EC 62541 -1 : 201 © I EC 201 CONTENTS FOREWORD Scope Normative references Terms, definitions, and abbreviations Terms and definitions Abbreviations Concepts General Data architecture Timestamps 4 Bounding Values and time domain 1 Changes in AddressSpace over time H istorical Information Model H istoricalNodes 1 General Annotations Property H istoricalDataN odes 2.1 General 2.2 H istoricalDataConfigurationType 2.3 HasH istoricalConfiguration ReferenceType 5 2.4 H istorical Data Configuration Object 2.5 H istoricalDataN odes Address Space Model 2.6 Attributes H istoricalEventNodes 3.1 General 3.2 H istoricalEventFilter Property 3.3 H istoricalEventNodes Address Space Model 3.4 H istoricalEventNodes Attributes Exposing supported functions and capabilities 4.1 General 4.2 H istoryServerCapabilitiesType 20 5 Annotation DataType 22 H istorical Audit Events 23 6.1 General 23 6.2 AuditH istoryEventUpdateEventType 23 6.3 AuditH istoryValueUpdateEventType 24 6.4 AuditH istoryDeleteEventType 25 6.5 AuditH istoryRawModifyDeleteEventType 25 6.6 AuditH istoryAtTimeDeleteEventType 26 6.7 AuditH istoryEventDeleteEventType 26 H istorical Access specific usage of Services 27 General 27 H istorical Nodes StatusCodes 27 2.1 Overview 27 2.2 Operation level result codes 27 2.3 Semantics changed 29 I EC 62541 -1 : 201 © I EC 201 –3– Continuation Points 29 6 H istoryReadDetails parameters 30 4.1 Overview 30 4.2 ReadEventDetails structure 30 4.3 ReadRawModifiedDetails structure 32 4.4 ReadProcessedDetails structure 34 4.5 ReadAtTimeDetails structure 35 H istoryData parameters returned 36 5.1 Overview 36 5.2 H istoryData type 36 5.3 H istoryModifiedData type 36 5.4 H istoryEvent type 37 6 H istoryU pdateType Enumeration 37 PerformU pdateType Enumeration 37 H istoryU pdateDetails parameter 38 8.1 Overview 38 8.2 UpdateDataDetails structure 39 8.3 UpdateStructureDataDetails structure 40 8.4 UpdateEventDetails structure 41 8.5 DeleteRawModifiedDetails structure 43 8.6 DeleteAtTimeDetails structure 44 8.7 DeleteEventDetails structure 45 Annex A (informative) Client conventions 46 A How clients may request timestamps 46 A Determining the first historical data point 47 Bibliography 48 Figure Figure Figure Figure Figure Table Table Table Table Table Table Table Table Table Table Table Table Table – Possible OPC U A Server supporting H istorical Access – ReferenceType hierarchy – Historical Variable with Historical Data Configuration and Annotations – Representation of an Event with H istory in the AddressSpace – Server and H istoryServer Capabilities 20 – Bounding Value examples 2 – Annotations Property 3 – H istoricalDataConfigurationType definition 4 – ExceptionDeviationFormat Values 5 – HasH istoricalConfiguration ReferenceType 6 – H istorical Access configuration definition – H istorical Events Properties 8 – H istoryServerCapabilitiesType Ddefinition 21 – Annotation Structure 23 – AuditH istoryEventUpdateEventType definition 23 1 – AuditH istoryValueUpdateEventType definition 24 – AuditH istoryDeleteEventType definition 25 – AuditH istoryRawModifyDeleteEventType definition 25 –4– Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table Table I EC 62541 -1 : 201 © I EC 201 – AuditH istoryAtTimeDeleteEventType definition 26 – AuditH istoryEventDeleteEventType definition 26 – Bad operation level result codes 28 – Good operation level result codes 28 – H istoryReadDetails parameterTypeI ds 30 – ReadEventDetails 31 20 – ReadRawModifiedDetails 32 21 – ReadProcessedDetails 34 22 – ReadAtTimeDetails 36 23 – H istoryData Details 36 24 – H istoryModifiedData Details 37 25 – H istoryEvent Details 37 26 – H istoryU pdateType Enumeration 37 27 – PerformU pdateType Enumeration 37 28 – H istoryU pdateDetails parameter TypeI ds 38 29 – UpdateDataDetails 39 30 – UpdateStructureDataDetails 40 31 – UpdateEventDetails 42 32 – DeleteRawModifiedDetails 44 33 – DeleteAtTimeDetails 44 34 – DeleteEventDetails 45 A.1 – Time keyword definitions 47 A.2 –Time offset definitions 47 I EC 62541 -1 : 201 © I EC 201 –5– I NTERNATIONAL ELECTROTECHNI CAL COMMI SSI ON O P C U N I F I E D ARC H I T E C T U RE – P a rt 1 : H i s t o ri c a l Ac c e s s FOREWORD ) The I ntern ati onal El ectrotechnical Commi ssi on (I EC) is a worl d wid e org anizati on for standard izati on comprising all nati onal electrotech nical committees (I EC N ational Comm ittees) Th e object of I EC i s to promote i nternati on al co-operati on on al l q u esti ons cernin g standard izati on i n the el ectrical and el ectronic fi el ds To this end an d in ad di ti on to other acti vi ti es, I EC pu blish es I nternati onal Stan d ards, Technical Speci fi cati ons, Technical Reports, Pu blicl y Availabl e Specificati ons (PAS) an d Gu id es (hereafter referred to as “I EC Pu blicati on(s)”) Their preparati on is entru sted to technical committees; any I EC N ati onal Committee i nterested i n the subject d eal t wi th may parti ci pate i n thi s preparatory work I nternati onal , governmental and n ongovernm ental organizations l iaisi ng wi th the I EC al so participate i n this preparati on I EC coll aborates cl osel y wi th th e I n ternational Organizati on for Stand ard izati on (I SO) i n accordan ce wi th cond i ti ons d etermined by agreement between th e two org anizati ons 2) Th e form al d ecision s or ag reements of I EC on technical m atters express, as n earl y as possibl e, an i nternati onal consensus of opi ni on on the rel evan t su bjects si nce each technical committee has representati on from all i nterested I EC N ati onal Commi ttees 3) I EC Pu blications have th e form of recommend ati ons for internati onal u se and are accepted by I EC N ati onal Comm ittees i n th at sense While all reasonabl e efforts are mad e to ensu re that the technical content of I EC Pu blicati ons is accu rate, I EC cann ot be hel d responsi bl e for the way in wh i ch they are used or for an y misin terpretati on by any end u ser 4) I n ord er to promote i nternational u ni formi ty, I EC N ati onal Commi ttees u nd ertake to appl y I EC Publicati on s transparen tl y to the maximum extent possibl e i n thei r nati onal and regi on al pu blicati ons Any d i vergence between an y I EC Pu bl icati on and the correspond i ng nati onal or region al publi cation shal l be cl earl y i ndi cated in the l atter 5) I EC i tsel f d oes not provi d e any attestation of conform ity I nd epend ent certi ficati on bodies provi d e conformity assessment services an d , in some areas, access to I EC marks of conformi ty I EC i s not responsi bl e for an y services carried ou t by i nd epend en t certi fication bodi es 6) All users sh ould ensu re that they h ave the l atest edi ti on of this pu blicati on 7) N o li abili ty shal l attach to I EC or i ts di rectors, empl oyees, servants or agents incl u di ng i nd ivi du al experts and members of i ts technical commi ttees and I EC N ati onal Comm ittees for any personal i nju ry, property d amage or other d amage of any natu re whatsoever, wh eth er di rect or i nd i rect, or for costs (i nclud i ng l eg al fees) and expenses arising ou t of the pu bli cati on, use of, or rel iance u pon, this I EC Pu bl ication or any oth er I EC Pu blicati ons 8) Attention is d rawn to the N orm ative references cited i n this pu bl icati on U se of the referenced pu blicati ons is i ndi spensabl e for th e correct applicati on of this publicati on 9) Attention is d rawn to th e possibili ty that som e of the el ements of thi s I EC Pu bl icati on may be th e su bj ect of patent ri ghts I EC sh al l not be held responsi bl e for i d en ti fyi ng any or all su ch paten t ri ghts I nternational Standard IEC 62541 -1 has been prepared by subcommittee 65E: Devices and integration in enterprise systems, of I EC technical committee 65: I ndustrial-process measurement, control and automation The text of this standard is based on the following documents: CDV Report on voti ng 65E/380/CDV 65E/41 0/RVC Full information on the voting for the approval of this standard can be found in the report on voting indicated in the above table This publication has been drafted in accordance with the ISO/I EC Directives, Part –6– I EC 62541 -1 : 201 © I EC 201 A list of all parts of the I EC 62541 series, published under the general title Architecture , can be found on the IEC website OPC Unified The committee has decided that the contents of this publication will remain unchanged until the stability date indicated on the I EC web site under "http: //webstore iec.ch" in the data related to the specific publication At this date, the publication will be • • • • reconfirmed, withdrawn, replaced by a revised edition, or amended I M P O R T AN T th at it – Th e c o n ta i n s u n d e rs t a n d i n g c o l o u r p ri n t e r of 'col ou r c o l o u rs i ts i n si d e' wh i ch te n ts l og o a re U s e rs on th e c o ve r p a g e c o n s i d e re d sh ou l d to t h e re fo re of th i s be p ri n t p u b l i ca ti o n u s e fu l th i s fo r i n d i c a te s th e d ocu m en t c o rre c t using a I EC 62541 -1 : 201 © I EC 201 –7– O P C U N I F I E D ARC H I T E C T U RE – P a rt 1 : H i s t o ri c a l Ac c e s s S cope This part of I EC 62541 is part of the overall OPC Unified Architecture standard series and defines the information model associated with H istorical Access (H A) I t particularly includes additional and complementary descriptions of the NodeClass es and Attributes needed for H istorical Access, additional standard Properties , and other information and behaviour The complete AddressSpace Model including all NodeClass es and Attributes is specified in I EC 62541 -3 The predefined Information Model is defined in I EC 62541 -5 The Services to detect and access historical data and events, and description of the ExtensibleParameter types are specified in I EC 62541 -4 This standard includes functionality to compute and return Aggregates like minimum, maximum, average etc The Information Model and the concrete working of Aggregates are defined in I EC 62541 -1 N o rm a t i v e re fe re n c e s The following documents, in whole or in part, are normatively referenced in this document and are indispensable for its application For dated references, only the edition cited applies For undated references, the latest edition of the referenced document (including any amendments) applies I EC TR 62541 -1 , OPC Unified Architecture – Part 1: Overview and Concepts I EC 62541 -3, OPC Unified Architecture – Part 3: Address Space Model IEC 62541 -4, OPC Unified Architecture – Part 4: Services IEC 62541 -5, OPC Unified Architecture – Part 5: Information Model I EC 62541 -8, OPC Unified Architecture – Part 8: Data Access I EC 62541 -1 3, OPC Unified Architecture – Part 13: Aggregates T e rm s , d e fi n i t i o n s , a n d a b b re v i a t i o n s T e rm s a n d d e fi n i t i o n s For the purposes of this document, the terms and definitions given in I EC TR 62541 -1 , I EC 62541 -3, I EC 62541 -4, and I EC 62541 -1 as well as the following apply 1 An n o t a t i o n metadata associated with an item at a given instance in time N ote to entry: An Annotation i s metad ata that is associ ated wi th an i tem at a gi ven i nstan ce i n ti me There d oes not have to be a val u e stored at that ti me –8– I EC 62541 -1 : 201 © I EC 201 3.1 BoundingValues values associated with the starting and ending time N ote to entry: BoundingValues are the val u es that are associ ated wi th the starting and endi ng time of a speci fi ed wh en read i ng from the histori an BoundingValues may be req u i red by Clients to d etermi ne th e starti ng and end in g val u es when req u esti n g raw data over a ti me rang e I f a raw data val ue exists at th e start or end poi nt, i t is consid ered the bou nd i ng valu e even th ou g h it i s part of the d ata req u est I f no raw data val u e exists at the start or end poin t, then the Server wi ll d etermi ne the bou nd ary val u e, whi ch may req u i re d ata from a d ata point ou tsi d e of the req u ested range See 4 for d etail s on using BoundingValues ProcessingInterval 3.1 HistoricalNode Object, Variable , Property or View in data or Events the AddressSpace where a Client can access historical N ote to entry: A HistoricalNode is a term u sed i n thi s docu m ent to represen t any Object, Variable, Property or View i n the AddressSpace for wh i ch a Client may read and /or u pdate hi stori cal d ata or Events The terms “ HistoricalNode’s hi story” or “hi story of a HistoricalNode ” wi ll refer to the time seri es d ata or Events stored for this HistoricalNode The term HistoricalNode refers to both HistoricalDataNodes and HistoricalEventNodes 3.1 HistoricalDataN ode Variable or Property in the AddressSpace where a Client can access historical data N ote to entry: A HistoricalDataNode represen ts an y Vari abl e or Property i n the AddressSpace for whi ch a Client may read and /or u pd ate hi storical d ata “ HistoricalDataNode ’s history” or “hi story of a HistoricalDataNode ” refers to the ti me seri es d ata stored for this HistoricalNode Exampl es of su ch d ata are: • d evi ce d ata (l ike temperatu re sensors), • cal cul ated data, • statu s i nformation (open/closed , movi ng), • d ynami cal l y changi ng system d ata (li ke stock q u otes), • d i agnostic data The term HistoricalDataNodes is used when referencing aspects of the stand ard that appl y to accessi ng h istorical data onl y 3.1 HistoricalEventNode Object or View in the AddressSpace for which a Client can access historical Events N ote to entry: “ HistoricalEventNode ’ s hi story” or “hi story of a HistoricalEventNode ” Events stored in some histori cal system Exampl es of such d ata are: • Notifications, • system Alarms, • operator acti on Events, • refers to th e time series system tri ggers (such as n ew ord ers to be processed ) Th e term HistoricalEventNode Events onl y is used when referenci ng aspects of the stand ard that appl y to accessi ng historical 3.1 modified values HistoricalDataNode’s value that has been changed (or manually inserted or deleted) after it was stored in the historian N ote to entry: For some Servers , a l ab data en try valu e is not a modified value , bu t if a u ser corrects a l ab val u e, the ori gi n al val u e wou l d be consi d ered a modified value , and wou l d be retu rned d u ri n g a req u est for modified values Also manu al l y i nserti ng a valu e that was m issed by a stand ard coll ection system m ay be consid ered a modified value U nl ess speci fied otherwi se, all histori cal Services operate on the cu rren t, or most recent, valu e for the specifi ed HistoricalDataNode at the speci fi ed ti mestamp Requ ests for modified values are u sed to access val u es th at have been su persed ed, d el eted or inserted I t i s u p to a system to d etermine wh at is consid ered a modified value Whenever a Server h as mod ified d ata avail abl e for an entry i n the histori cal col l ecti on i t shall set th e ExtraData bit i n the StatusCode – 88 – I EC 62541 -1 : 201 © I EC 201 Tabl eau 22 – ReadAtTim eDetai ls N om Type Descri pti on Read AtTi meDetails Stru ctu re Spéci fie les d étail s u ti lisés pour réaliser u ne lectu re d 'hi storiq u e "à temps" req Ti mes [] U tcTi me Les entrées défi nissent l es h orod atages spécifi q ues d es valeu rs li re u seSi mpleBou nd s Booléen U til iser Si mpl eBou nds pou r détermi ner l a valeu r l 'horod atag e spécifiq u e 4.5.2 Fon ction n ali té ReadAtTi m e La structure ReadAtTimeDetails permet de lire les valeurs et qualités dans la base de données historique pour les horodatages spécifiés d'un ou de plusieurs HistoricalDataNodes Cette fonction est censée fournir des valeurs pour la corrélation avec d'autres valeurs d'un horodatage connu Par exemple, un Client peut souhaiter lire les valeurs de capteurs lors de la collecte des échantillons de laboratoire L'ordre des valeurs et des qualités renvoyées doit correspondre celui des horodatages fournis dans la requête En l'absence de valeur pour un horodatage spécifié, une valeur doit être Interpolée partir des valeurs environnantes afin de représenter la valeur l'horodatage spécifié L'interpolation suit les mêmes règles que l' Agrégat Interpolated présenté dans l'I EC 62541 -1 Si le fanion useSimpleBounds est True et que l'Interpolation est exigée, SimpleBounds est utilisé pour calculer la valeur de données Si une valeur est trouvée pour l'horodatage spécifié, le Serveur attribue la valeur Raw au StatusCode InfoBits Si la valeur est Interpolée partir de valeurs environnantes, le Serveur attribue la valeur Interpolated au StatusCode InfoBits Si le TimestampsToReturn demandé n'est pas pris en charge pour un Nœud, l'opération doit renvoyer le StatusCode Bad_TimestampNotSupported Paramètres H istoryData ren voyés 5.1 Vu e d ’ ensembl e Le Service HistoryRead renvoie différents types de données, selon que la requête concerne l' Attribut Valeur d'un Nœud ou les Événements historiques d’un Nœud L'historyData est un Paramètre extensible dont la structure dépend des fonctions réaliser pour le paramètre HistoryReadDetails Voir l'I EC 62541 -4 pour plus de détails sur les Paramètres extensibles 5.2 Type H i storyData Le Tableau 23 définit la structure de l' HistoryData utilisé pour les données renvoyer dans un HistoryRead Tabl eau 23 – Détai l s d'H istoryData N om Type Descri pti on d ataVal ues[] DataVal u e M atrice d e val eu rs d e d onnées histori q u es pou r l e Nœud La taill e d e la matrice d épend d es paramètres d e d on nées d eman d és 5.3 Type H i storyM odi fiedData Le Tableau 24 définit la structure de l' HistoryModifiedData utilisé pour les données renvoyer dans un HistoryRead lorsque IsReadModified = True I EC 62541 -1 : 201 © I EC 201 – 89 – Tableau 24 – Détails d'HistoryModifiedData N om Type Description d ataVal ues[] DataVal u e M atrice d e val eu rs d e d onnées histori q u es pou r l e Nœud La taill e d e l a matri ce d épend d es paramètres d e d onnées d emandés mod ificati on I nfos[] M od ificati on I nfo U sername Ch n e N om d e l 'u tili sateu r q ui a apporté la mod ification La prise en charge d e ce champ est facu ltati ve U n e val eu r nulle d oi t être renvoyée si ell e n'est pas défi nie mod ificati onTime U tcTi me H eu re l aqu elle l a modi ficati on a été apportée La prise en charg e d e ce champ est facu ltati ve U n e val eu r nulle d oi t être renvoyée si ell e n'est pas défi nie u pd ateType H i storyU pd ateType Type d e mod ificati on d e l 'él ément 6.5.4 Type HistoryEvent Le Tableau 25 définit le paramètre HistoryEvent utilisé pour les lectures d' Événement H istorique H istoryEvent définit une structure de tableau utilisée pour renvoyer les champs d' Événement un Historical Read La structure se présente sous la forme d'un tableau composé d'un ou de plusieurs Événements , contenant chacun une matrice d'un ou de plusieurs champs Le choix et l'ordre des champs renvoyés pour chaque Événement sont identiques ceux du paramètre sélectionné de l' EventFilter Tableau 25 – Détails d'HistoryEvent N om Type Description Events [] H istoryEven tFiel d List Liste d es BaseDataType Liste d es ch amps d ' Événement sél ectionnés I l s'agi d 'u ne correspondance u ni voq u e avec l es cham ps sél ecti on nés d an s l ' EventFilter eventFi el d s [] 6.6 Événements distri bués Énumération HistoryU pdateType Le Tableau 26 définit l'énumération HistoryUpdate Tableau 26 – Énumération H istoryUpdateType 6.7 N om Descripti on I N SERT_1 Les d on nées ont été insérées REPLACE_2 Les d onnées ont été rempl acées U PDATE_3 Les d onnées ont été insérées ou rempl acées DELETE_4 Les d onnées ont été su ppri mées Énumération PerformUpdateType Le Tableau 27 définit l'énumération Perform U pd a teType Tableau 27 – Énumération PerformUpdateType – 90 – I EC 62541 -1 : 201 © I EC 201 N om D e s c ri p t i o n I N SERT_1 Les d on nées ont été insérées REPLACE_2 Les d onnées ont été rempl acées U PDATE_3 Les d onnées ont été insérées ou rempl acées DELETE_4 Les d onnées ont été su ppri mées P a m è t re H i s t o ry U p d a t e D e t a i l s 8.1 Vu e d ’ e n s e m b l e Le Service HistoryUpdate défini dans l'I EC 62541 -4 peut réaliser plusieurs fonctions différentes Le paramètre historyUpdateDetails est un Paramètre extensible qui spécifie la fonction réaliser et les détails spécifiques cette fonction Voir l'IEC 62541 -4 pour la définition du Paramètre extensible Le Tableau 28 répertorie les noms symboliques des structures de Paramètre extensible valides Certaines structures exécutent des fonctions différentes selon les valeurs attribuées ses paramètres associés Pour plus de simplicité, une fonctionnalité de chaque structure est répertoriée Par exemple, un texte tel que "utilisation de la fonctionnalité de remplacement des données" fait référence la fonction que le Service HistoryUpdate exécute l'aide de la structure de Paramètre extensible UpdateDataDetails , la valeur REPLACE_2 étant attribuée au paramètre d'énumération performI nsertReplace Tabl eau N om s ym b o l i q u e U pd ateDataDetail s – T yp e I d s d u p a m è t re H i s t o ry U p d a t e D e t a i l s F o n cti o n n a l i té D e s c ri p ti o n I nsertion d e d on nées Cette foncti on permet d 'i nsérer d es d onn ées d ans l a base de d onnées historiq u e au x horod atag es spécifi és d 'u n ou d e pl usieu rs HistoricalDataNodes La val eu r d e l a Variable est représentée par u ne valeu r com posi te d éfin i e par l e type d e d onnées DataValue U pd ateDataDetail s Rem placement d e d on nées Cette foncti on remplace les valeu rs existantes d ans la base de d onnées historiq u e au x horod atag es spécifi és d 'u n ou d e pl usieu rs HistoricalDataNodes La val eu r d e l a Variable est représentée par u ne valeu r com posi te d éfin i e par l e type d e d onnées DataValue U pd ateDataDetail s M ise jou r d e d on nées Cette foncti on permet d 'i nsérer ou d e rem pl acer d es val eu rs d ans l a base de d onnées histori q u e au x horod atag es spécifi és d 'u n ou d e pl usi eu rs HistoricalDataNodes La val eu r d e l a Variable est représentée par u ne valeu r com posi te d éfin i e par l e type d e d onnées DataValue U pd ateStructu reDataDetails I nserti on d e d onn ées Cette foncti on permet d 'i nsérer d e nouvell es Données Historiques Structurées ou Annotations dans l a base d e d onnées historiq u e au x horod atages spécifi és d 'u n ou d e plu sieu rs HistoricalDataNodes La val eu r d e l a Variable est représentée par u n e valeu r com posi te d éfini e par l e type d e d onnées DataValue U pd ateStructu reDataDetails Remplacemen t d e d onn ées Cette foncti on permet d e rempl acer des Données Historiques Structurées ou Annotations d ans l a base d e d onnées hi stori qu e au x horod atag es spécifiés d 'u n ou d e pl u si eu rs HistoricalDataNodes La val eu r d e l a Variable est représentée par u n e valeu r composi te d éfini e par l e type d e d onnées DataValue U pd ateStructu reDataDetails M ise jou r d e d onn ées Cette foncti on permet d 'i nsérer ou d e rempl acer d es Données Historiques Structurées ou Annotations dans l a base d e d onnées historiq u e au x horod atages spécifi és d 'u n ou d e plu sieu rs HistoricalDataNodes La val eu r d e l a Variable est représentée par u n e valeu r com posi te d éfini e par l e type d e d onnées DataValue I EC 62541 -1 : 201 © I EC 201 – 91 – N om s ym bol i q u e Fon cti on n al i té D escri pti on U pd ateStructu reDataDetails Su ppressi on d e d onn ées U pd ateEventDetails I nserti on d 'événem ents Cette foncti on permet d e su ppri mer d es Données Historiques Structurées ou Annotations d e l a base d e d onn ées histori qu e au x horod atages spécifiés d 'u n ou d e pl u si eu rs HistoricalDataNodes La val eu r d e l a Variable est représentée par u n e valeu r com posi te d éfin i e par le type d e d onnées DataValue Cette foncti on permet d 'i nsérer d e nouveau x Événements d ans l a base d e d onnées histori qu e d 'u n ou d e plu sieu rs HistoricalEventNodes U pd ateEventDetails Remplacemen t d 'événem ents U pd ateEventDetails M ise jou r d 'événem ents Cette foncti on permet d 'i nsérer d e nouveau x Événements ou d e remplacer l es Événements exi stants dans l a base d e don nées h istoriq u e d 'u n ou d e pl usi eu rs HistoricalEventNodes Del eteRawM odi fi ed Detai ls Su ppressi on d e val eu r brute Cette foncti on permet d e su ppri mer tou tes les val eu rs d e l a base d e d onnées hi stori q ue pou r le d omai ne temporel spéci fi é d 'un ou d e pl u si eu rs HistoricalDataNodes Del eteRawM odi fi ed Detai ls Del eteM odi fi ed Certains historiq u es peuven t stocker pl usi eu rs val eu rs au mêm e h orod atage Cette fon ction su pprim e l es val eu rs et q u ali tés spécifiées pou r l 'horod atage spéci fi é d 'un ou d e pl u si eu rs HistoricalDataNodes Del eteAtTi meDetails Del eteAtTi me Cette foncti on permet d e su ppri mer tou tes l es val eu rs d e la base d e d onnées hi stori q ue pou r les horod atages spécifiés d 'u n ou d e plu sieu rs HistoricalDataNodes Del eteEventDetails Su ppressi on d 'événem ent Cette foncti on permet d e rempl acer l es val eu rs d es champs d ans l es Événements existants d ans l a base d e d onnées h istori q u e d 'u n ou d e pl usi eu rs HistoricalEventNodes Cette foncti on permet d e su ppri mer l es Événements d e la base d e d onnées hi stori q ue pou r le fil tre spéci fi é d 'u n ou d e pl usieu rs HistoricalEventNodes Service HistoryUpdate est utilisé pour mettre jour ou supprimer les DataValues et les Événements Pour des raisons de simplicité, le terme "entrée" est utilisé pour indiquer DataValue ou Événement, selon le contexte dans lequel il est utilisé Les exigences d'audit pour les Services H istory sont décrites dans l'I EC 62541 -4 Cette description part du principe que l'utilisateur qui formule la requête et que le Serveur qui la traite prennent en charge la capacité de mise jour des entrées Voir l'I EC 62541 -3 pour une description des Attributs qui Le présentent la prise en charge des Mises jour d'Historique 8.2 Stru ctu re U pdateDataDetai ls 8.2.1 Détai l s de l a stru ctu re U pdateDataDetai ls Le Tableau 29 définit la structure U pdateDataDetails Tabl eau 29 – U pdateDataDetai l s N om Type Des cri pti on U pd ateDataDetail s Stru ctu re Détails d e l 'i nsertion, d u rem pl acement et d e l 'i nsertion/rempl acement d es mises j ou r d 'histori q u e nod eI d N od eI d I D d e nœu d d e l ' Objet mettre jou r performI nsertRepl ace PerformU pd ate Type Val eu r q ui d étermi ne l 'acti on d'i nserti on , d e rem pl acement ou d e mise j ou r q u i est réal isée u pd ateVal u es[] DataVal u e Val eu r D escri pti on I N SERT_1 Voi r 2 REPLACE_2 Voi r U PDATE_3 Voi r N ou vell es valeu rs insérer ou rempl acer – 92 – 8.2.2 I EC 62541 -1 : 201 © I EC 201 Fon ction n ali té d'i n serti on d e don n ées Le paramétrage performI nsertReplace = IN SERT_1 permet d'insérer les entrées dans la base de données historique aux horodatages spécifiés d'un ou de plusieurs HistoricalDataNodes Si une entrée existe l'horodatage spécifié, la nouvelle entrée ne doit pas être insérée, le StatusCode doit plutôt indiquer Bad_EntryExists Cette fonction permet d'insérer de nouvelles entrées aux horodatages spécifiés (l'insertion de données de laboratoire pour refléter l'heure de la collecte de données, par exemple) 8.2.3 Fon cti on n ali té de rempl acement d e don n ées Le paramétrage performI nsertReplace = REPLACE_2 permet de remplacer les entrées dans la base de données historique aux horodatages spécifiés d'un ou de plusieurs HistoricalDataNodes Si aucune entrée n'existe l'horodatage spécifié, la nouvelle entrée ne doit pas être insérée, sinon le StatusCode doit indiquer Bad_NoEntryExists Cette fonction permet de remplacer les entrées existantes l'horodatage spécifié (des données de laboratoire correctes ayant été traitées de manière incorrecte et insérées dans la base de données historique, par exemple) Fon ctionn ali té de m ise j ou r de don n ées Le paramétrage performI nsertReplace = U PDATE_3 permet d'insérer ou de remplacer des entrées dans la base de données historique pour les horodatages spécifiés d'un ou de plusieurs HistoricalDataNodes Si l'élément comporte une entrée l'horodatage spécifié, la nouvelle entrée remplace l'ancienne En l'absence d'entrée cet horodatage, la fonction insère les nouvelles données Un Serveur peut créer une valeur modifiée pour une valeur remplacée ou insérée (voir 3.1 6) Toutefois, cela n'est pas requis Cette fonction est censée insérer/remplacer sans condition des valeurs et qualités (correction de valeurs de capteurs incorrects, par exemple) Good en tant que StatusCode pour une entrée individuelle est admis lorsque le Serveur n'est pas en mesure de dire si une valeur était déjà présente cet horodatage Si le Serveur peut déterminer si la nouvelle entrée remplace une entrée déjà présente, il convient qu'il utilise Good_EntryInserted ou Good_EntryReplaced pour renvoyer cette information 8 Stru ctu re U pdateStru ctu reDataDetai l s Détai ls de la stru ctu re U pdateStru ctu reDataDetai ls Le Tableau 30 définit la structure U pdateStructureDataDetails I EC 62541 -1 : 201 © I EC 201 – 93 – Tableau 30 – UpdateStructureDataDetails N om Type Description U pd ateStructu reDataDetails Stru ctu re Détails d es mises jou r d e d onnées hi storiq u es nod eI d N od eI d I D d e nœu d d e l ' Objet mettre jou r performI nsertRepl ace PerformU pd ate Type Val eu r q u i détermi n e l 'acti on d'in serti on, d e rempl acemen t ou d e mise j ou r q ui est réalisée u pd ateVal u e[] 6.8.3.2 DataVal u e Valeur Description I N SERT_1 Voi r 3 REPLACE_2 Voi r U PDATE_3 Voi r REM OVE_4 Voi r N ou vell es valeu rs insérer, remplacer ou suppri m er Caractère unique spécifié des Données Historiques Structurées Les Données Historiques Structurées fournissent les métadonnées décrivant une entrée dans la base de données historique Le Serveur doit définir ce que signifie le caractère unique de chaque type de structure de Données Historiques Structurées Par exemple, un Serveur peut uniquement permettre une Annotation par horodatage, ce qui signifie que l'horodatage est la clé unique de la structure Un autre Serveur peut permettre plusieurs Annotations par utilisateur Une combinaison nom d'utilisateur/horodatage/message peut faire office de clé unique pour la structure En 8.3.3,6 4, 6.8.3 et 6.8.3 6, les expressions "les Données Historiques Structurées existent" et "aux paramètres spécifiés" signifient qu'une entrée correspondante a été trouvée l'horodatage spécifié l'aide des critères de caractère unique du Serveur Si le Client souhaite remplacer un paramètre faisant partie des critères de caractère unique, le StatusCode obtenu est Bad_NoEntryExists Le Client doit supprimer la structure existante et insérer la nouvelle structure 6.8.3.3 Fonctionnalité d'insertion Le paramétrage performI nsertReplace = IN SERT_1 permet d'insérer les Données Historiques Structurées (les Annotations, par exemple) dans la base de données historique aux paramètres spécifiés d'une ou de plusieurs Propriétés des HistoricalDataNodes Si une entrée de Données Historiques Structurées existe déjà aux paramètres spécifiés, le StatusCode doit indiquer Bad_EntryExists 6.8.3.4 Fonctionnalité de remplacement Le paramétrage performI nsertReplace = REPLACE_2 permet de remplacer les Données (les Annotations, par exemple) dans la base de données historique aux paramètres spécifiés d'une ou de plusieurs Propriétés des HistoricalDataNodes Historiques Structurées Si une entrée de Données Historiques Structurées n'existe pas déjà aux paramètres spécifiés, le StatusCode doit indiquer Bad_NoEntryExists 6.8.3.5 Fonctionnalité de mise jour Le paramétrage performI nsertReplace = U PDATE_3 permet d'insérer ou de remplacer les Données Historiques Structurées (les Annotations, par exemple) dans la base de données historique aux paramètres spécifiés d'une ou de plusieurs Propriétés des HistoricalDataNodes – 94 – I EC 62541 -1 : 201 © I EC 201 Si une entrée de Données Historiques Structurées existe déjà aux paramètres spécifiés, elle est supprimée et la valeur fournie par le Client est insérée S'il n'existe aucune donnée, la nouvelle entrée est insérée Si une entrée existante a été remplacée avec succès, le StatusCode doit être Good_EntryReplaced Si une entrée a été créée, le StatusCode doit être Good_EntryInserted Si le Serveur ne peut pas déterminer s'il a remplacé ou inséré une entrée, le StatusCode doit être Good 6.8.3.6 Fonctionnalité de suppression Le paramétrage performI nsertReplace = REMOVE_4 permet de supprimer les Données Historiques Structurées (les Annotations, par exemple) de la base de données historique aux paramètres spécifiés d'une ou de plusieurs Propriétés des HistoricalDataNodes S'il existe une entrée de Données Historiques structurées aux paramètres spécifiés, elle est supprimée Si les Données Historiques Structurées n'existent pas déjà aux paramètres spécifiés, le StatusCode doit indiquer Bad_NoEntryExists 6.8.4 Structure UpdateEventDetails 6.8.4.1 Détails de la structure UpdateEventDetails Le Tableau 31 définit la structure U pdateEventDetails Tableau 31 – U pdateEventDetails N om Type Description U pd ateEventDetails Stru ctu re Détails d e l 'inserti on, d u rempl acement et d e l 'i nserti on/rempl acement d es mises j ou r d ' Événement histori q u e nod eI d N od eI d I D d e nœu d d e l' Objet m ettre jou r performI nsertRepl ace PerformU pd ateType Val eu r q ui d étermi ne l 'acti on d 'i nserti on, d e rempl acement ou d e mise jou r q ui est réalisée fil tre EventFil ter eventData[] H i storyEventFiel d List 6.8.4.2 Val eu r Descri ption I N SERT_1 Procéd er l 'i nsertion d ' Événement (voi r 2) REPLACE_2 Procéd er au rempl acement d ' Événement (voi r 3) U PDATE_3 Procéd er l a mise jou r d ' Événement (voi r 4) Si l 'histori q u e de l a Notification est forme l ' EventFilter, l 'histori qu e de la Notification est mis jou r Liste d es Notifications d'Événement i nsérer ou mettre jou r (voi r pou r l a défini ti on d 'H i storyEventFi el d List) Fonctionnalité d'insertion d'événement Cette fonction est censée insérer de nouvelles entrées (remplissage des historiques, par exemple) Événements Le paramétrage performI nsertReplace = I N SERT_1 permet d'insérer des entrées dans la base de données historique d' Événement d'un ou de plusieurs HistoricalEventNodes Le paramètre whereClause de l' EventFilter doit être vide Le SelectClause doit au moins fournir les champs d'Événement suivants: EventType et Time Il est également recommandé de fournir les champs SourceNode et SourceName Si l'un des champs requis n'est pas fourni, le statusCode doit indiquer Bad_ArgumentsMissing Si l'historique ne prend pas en charge l'archivage de l' EventType spécifié, le statusCode doit indiquer Bad_TypeDefinitionInvalid Si le SourceNode n'est pas la source valide des Événements , l' entrée operationResults connexe doit indiquer Bad_SourceNodeIdInvalid Si Time ne tombe pas dans la plage qui peut être I EC 62541 -1 : 201 © I EC 201 – 95 – stockée, l' entrée operationResults connexe doit indiquer Bad_OutOfRange Si la selectClause ne contient pas les champs obligatoires pour l' EventType, le statusCode doit indiquer Bad_ArgumentsMissing Si la selectClause spécifie des champs qui ne sont pas valides pour l' EventType ou qui ne peuvent pas être sauvegardés par l'historique, l' entrée operationResults connexe doit indiquer Good_DataIgnored Des informations supplémentaires relatives aux champs ignorés doivent être fournies par l'intermédiaire du DiagnosticInformation lié aux operationResults Le symbolicId contient l'indice de chaque champ ignoré séparé par un espace, le localizedText contenant les noms symboliques des champs ignorés L' EventId est une valeur opaque générée par le Serveur et un Client ne peut pas supposer qu'il sait comment créer des EventIds valides Un Serveur doit être en mesure de générer une valeur par défaut appropriée pour le champ EventId Si un Client spécifie l' EventId dans la selectClause et qu'il correspond un Événement existant, le statusCode doit indiquer Bad_EntryExists Un Client doit utiliser HistoryRead pour reconntre les EventIds générés automatiquement Si une erreur se produit lors du traitement des champs individuels, l' entrée operationResults connexe doit indiquer Bad_InvalidArgument, et les champs non valides doivent être indiqués dans le DiagnosticInformation lié l' entrée operationResults Le paramètre IndexRange de SimpleAttributeOperand n'est pas valide pour les opérations d'insertion, et le StatusCode doit spécifier Bad_IndexRangeInvalid si ce paramètre est spécifié Un Client peut demander au Serveur de choisir une valeur par défaut adaptée pour un champ en spécifiant une valeur nulle Si le Serveur n'est pas en mesure de sélectionner une valeur par défaut adaptée, l'entrée correspondante dans la matrice operationResults pour l' Événement concerné doit être Bad_InvalidArgument 8.4.3 Fon cti on n ali té de rempl acement d 'évén emen t Cette fonction est censée remplacer des champs dans les entrées d' Événement existantes (données d' Événement correctes contenues dans des données incorrectes en raison d'un capteur défectueux, par exemple) Le paramétrage performI nsertReplace = REPLACE_2 remplace des entrées dans la base de données historique d' Événement pour les EventIds spécifiés d'un ou de plusieurs HistoricalEventNodes Le paramètre SelectClause de l' EventFilter doit spécifier la Propriété EventId, et l' eventData doit contenir l' EventId qui sera utilisé pour rechercher l' Événement remplacer En l'absence de donnée correspondant l' EventId spécifié, aucune opération de remplacement n'est réalisée L'entrée operationResults de l' eventData doit plutôt indiquer Bad_NoEntryExists Le paramètre whereClause de l' EventFilter doit être vide Si la selectClause spécifie des champs qui ne sont pas valides pour l' EventType ou qui ne peuvent pas être sauvegardés ni modifiés par l'historique, l' entrée operationResults de l' Événement concerné doit indiquer Good_DataIgnored Des informations supplémentaires relatives aux champs ignorés doivent être fournies par l'intermédiaire du DiagnosticInformation lié aux operationResults Le symbolicId contient l'indice de chaque champ ignoré séparé par un espace, le localizedText contenant les noms symboliques des champs ignorés Si une erreur fatale se produit lors du traitement des champs individuels, l'entrée operationResults de l'Événement concerné doit indiquer Bad_InvalidArgument, et les champs non valides doivent être indiqués dans le DiagnosticInformation lié l' entrée operationResults – 96 – 8.4.4 I EC 62541 -1 : 201 © I EC 201 Fon ction n ali té de mi se j ou r d'évén emen t Cette fonction est censée insérer/remplacer sans condition des Événements (la synchronisation d'une base de données d' Événement de sauvegarde, par exemple) Le paramétrage performI nsertReplace = U PDATE_3 permet d'insérer ou de remplacer des entrées dans la base de données historique d' Événement pour le filtre spécifié d'un ou de plusieurs HistoricalEventNodes En fonction de ses propres critères, le Serveur tente de déterminer si l' Événement existe déjà Si c'est le cas, l' Événement est supprimé et le nouvel Événement inséré (en conservant l' EventId) Si l' EventID a été fourni, l' EventID est utilisé pour déterminer si l' Événement existe déjà Si l' Événement n'existe pas, un nouvel Événement est inséré, incluant la génération d'un nouvel EventId Toutes les restrictions, tous les comportements et toutes les erreurs spécifiés pour la fonctionnalité d'insertion (voir 6.8.4 2) s’appliquent également cette fonction Si une entrée d' Événement existante a été remplacée avec succès, l' entrée operationResults connexe doit être Good_EntryReplaced Si une entrée d' Événement a été créée, l'entrée operationResults connexe doit être Good_EntryInserted Si le Serveur ne peut pas déterminer s'il a remplacé ou inséré une entrée, l' entrée operationResults connexe doit être Good 8.5 Stru ctu re Del eteRawModifiedDetai l s 8.5.1 Détai ls de la stru ctu re Del eteRawM od i fi edDetai l s Le Tableau 32 définit la structure DeleteRawModifiedDetails Tabl eau 32 – DeleteRawMod ifiedDetai ls N om Type Descri pti on Del eteRawM odi fi ed Detai ls Stru ctu re Détails d e la suppressi on d es val eu rs bru tes et d es mises j ou r mod ifiées n od eI d N od eI d I D d e nœu d d e l ' Objet d ont l es val eu rs historiq u es sont suppri mer i sDeleteM od ified Booléen TRU E pou r M ODI FI ED, FALSE pou r RAW La val eu r par d éfau t est FALSE startTime endTime U tcTi me Débu t de l a péri od e su ppri mer U tcTi me Fi n d e la péri od e su ppri mer Ces fonctions sont censées être utilisées pour supprimer des données ayant été entrées par erreur dans la base de données historique (suppression de données d'une source avec des horodatages incorrects, par exemple) startTime et endTime doivent être définies startTime doit être inférieure endTime , les valeurs inférieures mais pas égales endTime étant supprimées startTime = endTime est admis, auquel cas la valeur en startTime est supprimée 8.5.2 Fon cti on n ali té DeleteRaw Le paramétrage isDeleteModified = FALSE permet de supprimer toutes les entrées Raw de la base de données historique pour le domaine temporel spécifié d'un ou de plusieurs HistoricalDataNodes Si aucune donnée n'est trouvée dans l'intervalle de temps pour un particulier, le StatusCode de cet élément est Bad_NoData HistoricalDataNode I EC 62541 -1 : 201 © I EC 201 6.8.5.3 – 97 – Fonctionnalité DeleteModified Le paramétrage isDeleteModified = TRU E permet de supprimer toutes les entrées Modified de la base de données historique pour le domaine temporel spécifié d'un ou de plusieurs HistoricalDataNodes Si aucune donnée n'est trouvée dans l'intervalle de temps pour un particulier, le StatusCode de cet élément est Bad_NoData 6.8.6 HistoricalDataNode Structure DeleteAtTimeDetails 6.8.6.1 Détails de la structure DeleteAtTimeDetails Le Tableau 33 définit la structure de DeleteAtTimeDetails Tableau 33 – DeleteAtTimeDetails N om Type Descri ption Del eteAtTi meDetails Stru ctu re Détails d es mises jou r d 'histori q u es Del eteRaw nod eI d N od eI d I D d e nœu d d e l ' Objet d ont l es val eu rs historiq u es son t suppri mer req Ti mes [] U tcTi me Les entrées défi ni ssent l es horod atages spécifiq ues d es valeu rs su ppri mer 6.8.6.2 Fonctionnalité DeleteAtTime La structure DeleteAtTime permet de supprimer toutes les entrées de la base de données historique pour les horodatages spécifiés d'un ou de plusieurs HistoricalDataNodes Ce paramètre est censé être utilisé pour supprimer des données spécifiques de la base de données historique (les données de laboratoire incorrectes et qui ne peuvent pas être correctement reproduites, par exemple) 6.8.7 Structure DeleteEventDetails 6.8.7.1 Détails de la structure DeleteEventDetails Le Tableau 34 définit la structure de DeleteEventDetails Tableau 34 – DeleteEventDetails N om Type Descri ption Del eteEven tDetails Stru ctu re Détails d e la suppressi on d es val eu rs bru tes et d es mises j ou r mod ifiées n od eI d N od eI d I D d e nœu d d e l' Objet d ont les val eu rs historiq u es sont su ppri m er ByteStri ng M atrice d es su ppri mer eventI d [] 6.8.7.2 EventIds visant i d entifi er les Événements Fonctionnalité de suppression d'événement La structure DeleteEventDetails permet de supprimer toutes les entrées d' Événement de la base de données historique correspondant l' EventId d'un ou de plusieurs HistoricalEventNodes aucun Événement correspondant au filtre spécifié HistoricalEventNode , le StatusCode de ce Nœud est Bad_NoData Si n'est trouvé pour un – 98 – I EC 62541 -1 : 201 © I EC 201 Annexe A (informative) Conventions du client A.1 Comment les clients peuvent demander des horodatages Les spécifications basées sur OPC HDA COM permettaient un Client de demander manière programmée une période historique en durée absolue (Jan 01 , 2006 2: 5:45) une représentation en chne d'heures relatives (NOW -5M) La spécification OPC U A permet pas d'utiliser une représentation en chne pour transmettre des informations date/heure l'aide des Services normalisés de ou ne de Les applications Clients OPC U A qui souhaitent représenter visuellement la date/l'heure au format de chne relatif doivent convertir ce format de chne en valeurs UTC DateTime avant d'envoyer les requêtes au Serveur UA I l est recommandé tous les Clients OPC U A d'utiliser la syntaxe définie dans l’Article A pour représenter les durées relatives dans leurs interfaces utilisateurs Le format de la durée relative est le suivant: keyword+/-offset+/-offset… où "keyword" et "offset" sont spécifiés au Tableau A ci-dessous Les espaces sont ignorés La chne temporelle doit commencer par un mot-clé Chaque décalage doit être précédé d'un entier signé qui spécifie le nombre et le sens du décalage Si l'entier qui précède le décalage n'est pas signé, la valeur du signe précédent est supposée (le signe par défaut de début est positif) Le mot-clé fait référence au début de la période de temps spécifiée DAY indique l'horodatage au début du jour courant (00:00 heures, minuit) MONTH indique l'horodatage au début du mois courant, etc Par exemple, "DAY -1 D+7H 30M" peut représenter l'heure de début des données demandées pour un rapport quotidien commenỗant le jour prộcộdent 7: 30 le matin du jour précédent (DAY = premier horodatage du jour courant, -1 D est le premier horodatage de la veille, +7H serait heures du matin la veille, +30M serait 7:30 heures du matin la veille (le signe + du dernier terme est étendu depuis le dernier terme) De la même manière, "MONTH-1 D+5H " serait heures du matin le dernier jour du mois précédent, "NOW-1 H1 5M" serait il y a une heure et quinze minutes, et "YEAR+3MO" serait le premier horodatage du er avril de cette année La résolution des horodatages relatifs repose sur ce que Microsoft a fait avec Excel Par conséquent, les résultats suivants sont obtenus pour différentes chnes temporelles douteuses: 0-Jan-2001 + MO = 0-Feb-2001 29-Jan-1 999 + MO = 28-Feb-1 999 31 -Mar-2002 + MO = 30-May-2002 29-Feb-2000 + Y = 28-Feb-2001 Dans la gestion des écarts du calendrier (les mois ou années ne contenant pas toujours le même nombre de jours), lorsque des mois ou des années sont ajoutés ou soustraits: Mois: si la réponse tombe dans l'écart, elle est sauvegardée jusqu'à la même heure du dernier jour du mois I EC 62541 -1 : 201 © I EC 201 – 99 – Année: si la réponse tombe dans l'écart (le 29 février), elle est sauvegardée jusqu'à la même heure du jour le 28 février Noter que cela n'est pas vrai en cas d'ajout ou de retrait de semaines ou de jours, mais uniquement pour l'ajout ou le retrait de mois ou d'années pouvant contenir un nombre de jours différents Noter que tous les mots-clés et décalages sont spécifiés en majuscules (voir Tableaux A et A 2) Tabl eau A – Défin i ti on s d e m ot-cl é temporel M ot-cl é D escri pti on N OW H eu re U TC en cou rs cal cul ée su r l e SECON D Débu t d e l a second e en cou rs M I N U TE Débu t d e l a minu te en cou rs H OU R Débu t d e l 'heu re en cou rs DAY Débu t du j ou r en cou rs WEEK Débu t d e l a sem ne en cou rs M ON TH Débu t d u mois en cou rs YEAR Débu t d e l 'année en cou rs Serveur Tabl eau A – Défin iti on s d e d écalage temporel A Décal ag e D escri pti on S Décal age temporel en second es M Décal age temporel en mi n utes H Décal age temporel en heu res D Décal age temporel en j ou rs W Décal age temporel en semai nes MO Décal age temporel en mois Y Décal age temporel en ann ées Détermi n ati on d u premi er poi n t d e don n ées h i stori qu es Dans certains cas, les Serveurs nécessitent de renvoyer le premier point de données disponible pour un Nœud historique L’Article A recommande la manière dont il convient qu'un Client demande ces informations, de sorte que le Serveur puisse optimiser cet appel, le cas échéant Même si plusieurs appels peuvent renvoyer la première valeur de données, la pratique recommandée consiste utiliser la Propriété StartOfArchive Si cette Propriété n'est pas disponible, utiliser les paramètres ReadRawModifiedDetails suivants: returnBounds=false numValuesPerNode =1 startTime =DateTime.MinValue+1 endTime = DateTime MinValue seconde – 00 – I EC 62541 -1 : 201 © I EC 201 Bibliography I EC TR 62541 -2, seulement) OPC Unified Architecture – Part 2: Security Model (disponible en anglais I EC 62541 -6, Architecture unifiée OPC – Partie 6: Correspondances I EC 62541 -7, Architecture unifiée OPC – Partie 7: Profils IEC 62541 -9, Architecture unifiée OPC – Partie 9: Alarmes et conditions _ INTERNATIONAL ELECTROTECHNICAL COMMISSI ON 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