International ISO Standard ISO 21622-3 Irrigation techniques Remote First edition 2024-03 monitoring and control for irrigation - Part 3: Interoperability @ Reference number ISO 21622-3:2024(en) @ ISO 2024 IS0 21622-3:2024(en) COPYRIGHT PROTECTEDDOCUMENT IS02024 All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address below or Iso's member body in the country ofthe requester. ISO copyright office CP 40i: Ch. de Blandonnet 8 CH-1214 Vernier, Geneva Phone: +41 22 749 01 11 Email: [email protected] Website: www.iso.org Published in Switzerland @ IS0 2024 - All rights reserved i IS0 21622-3:2024(E) Contents Page Foreword... Introduction vi 1 Scope. 2 Normative reference .... 3 Terms and definitions. 4 Interoperability I: System architecture... 4.1 Levels and components of an interoperable architecture.. 4.2 Interfacespecifications. 5 Interoperability II: exchange of data from irrigation entities.... 5.1 General outline. 20 5.2 Static data of the irrigation entities 20 5.3 Structure of an irrigation entity identifier (EntityID).... 28 5.4 Properties... .28 5.5 Entity events.... 6 Interoperability Ill: Exchange of data from procedural elements performed in irrigation entities .... 6.1 Generaloutline. 6.2 Statuses and actions . 6.3 Types of Operation recipes .... 6.4 Types of Unit Procedure recipes.. 56 6.5 Types of Procedure recipes ... 58 6.6 Report....... 6.7 Procedural element events ... Annex A (normative) Management interface with SOAP 1.2 .... A.1 Overview.. A.2 Requirements.... .64 A.3 Implementationclassesforwebservices. 66 A.4 Implementation classes for authorization server .... 87 A.5 .88 Annex B (normative) Subsystem interface with SOAP 1.... 104 B.1 Overview.... 104 B.2 Requirements... .104 B.3 Implementation classes for web services .. 106 B.4 Implementation classes for authorization server .. 121 B.5 WSDL.. 122 Annex C (normative) Event interface with SOAP 1.2 ... 135 C.1 Overview. 135 C.2 Requirements... C.3 Implementationclassesforwebservices.. 137 C.4 Implementation classes for authorization server .. .140 C.5 Annex D (informative) Interoperability test protocol. .144 D.1 Overview.. .144 D.2 General description...... 144 D.3 IT infraestructure... 145 @ IS0 2024 - All rights reserved ii IS0 21622-3:2024(E) D.4 Test bed description ..146 D.5 Test procedure... D.6 .151 D.7 Tests over coordination brokers... 235 D.8 Tests over management information systems .. D.9 Tests report.. .245 Annex E (informative) Coordination broker software requirement specifications .. ..247 E.1 Overview ...247 E.2 Data model.. .249 E.3 Minimal functions - Coordination broker .. 255 E.4 Desirable functions .... ..259 E.5 Specific requirements... .267 E.6 Request management .. ..285 E.7 Cases of use... Annex F (normative) Management interface with REST.. ..295 F.1 Overview ... F.2 Reguirements 295 F.3 Implementation method for web services.. .297 F.4 ComplexType definition .. F.5 Implementationmethodsforauthorization......... .321 F.6 WADL... .322 F.7 ComplexType... Annex G (normative) Subsystem interface with REsT ..334 G.1 ..334 G.2 ..334 G.3 Implementation method for web services... 336 G.4 ComplexType definition ... ..342 G.5 G.6 WADL... .354 G.7 ComplexTypeG .. 356 Annex H (normative) Event interface with REST.. ..363 H.1 Overview. .363 H.2 H.3 Implementation methods for web services - NewEvent method. .364 H.4 ComplexType definition .. ..365 H.5 Implementation methods for authorization ... H.6 WADL .369 H.7 ComplexTypeH 370 Bibliography .371 @ IS0 2024 - All rights reserved iv IS0 21622-3:2024(E) Foreword ISo (the International Organization for Standardization) is a worldwide federation of national standards bodies