5 Appendix: Standards Used by Energistics

Topic Version	1	Published	11/11/2016	Topic Change History
For Standard	CTA v2.1

The following table lists standards used in Energistics standards and the sponsoring organization for each standard.

Standards/Organization	Description of Use
XML Schema 1.1 XML Schema Part 1: Structures Second Edition http://www.w3.org/TR/2004/REC-xmlschema-1-20041028/ W3C- World Wide Web Consortium 28 October 2004	Used to define the schema that constrains the content of a PRODML XML document.
XML Schema Part 2: Datatypes Second Edition http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/ W3C-World Wide Web Consortium	Used to define the schema that constrains the content of a PRODML XML document.
Hierarchical Data Format 5 (HDF5) The HDF Group http://www.hdfgroup.org/	Open file formats and libraries. Designed to store and organize large amounts of array data, and improve speed and efficiency of data processing.
Geographic Markup Language (GML) Open Geospatial Consortium (OGC) http://www.opengeospatial.org/	The OpenGIS® Geography Markup Language Encoding Standard (GML). The Geography Markup Language (GML) is an XML grammar for expressing geographical features.
EPSG Codes International Association of Oil and Gas Producers (OGP) http://www.epsg.org/	The European Petroleum Survey Group (EPSG), the globally recognized experts on geodetic issues, has been absorbed into the Surveying and Position Committee of the International Association of Oil and Gas Producers (OGP), which is now the owner of the EPSG database of Geodetic Parameters and assigned codes. PRODML implementations can use EPSG codes to define a coordinate reference system.
Unified Modeling Language™ (UML®) Object Management Group http://www.uml.org/	UML is a general purpose modeling language, which was designed to provide a standard way to visualize system design. Originally intended for software architecture design, its use has expanded.
Energy Industry Profile of ISO/FDIS 19115-1	The EIP is an ISO Conformance Level 1 profile of the widely adopted international standards ISO 19115-1:2014 which provides XML implementation guidance with reference to ISO Technical Specification 19115-3:2016.
Open Packaging Conventions Standard ECMA-376Office Open XML File Formats http://www.ecma-international.org/publications/standards/Ecma-376.htm ISO/IEC 29500-2:2012 Information technology – Document description and processing languages – Office Open XML File Formats – Part 2: Open Packaging Conventions http://standards.iso.org/ittf/PubliclyAvailableStandards/index.html	To address the challenges of the multi-file data sets used in upstream oil and gas, Energistics and its members have developed file packaging conventions based on the Open Packaging Conventions (OPC), a widely used container-file technology that allows multiple types of files to be bundled together into a single package. The Energistics Packaging Convention (EPC) is intended for use with all Energistics standards. OPC is supported by the two organizations listed in the left column.
Internet Engineering Task Force IETF RFC 4122 https://tools.ietf.org/html/rfc4122	IETF RFC 4122 is a standard for defining universally unique identifiers (UUID). According to the abstract of the specification: “This specification defines a Uniform Resource Name namespace for UUIDs (Universally Unique Identifier), also known as GUIDs (Globally Unique Identifier). A UUID is 128 bits long, and can guarantee uniqueness across space and time.” For Energistics usage, see the Energistics Identifier Specification.
IETF RFC 2234: https://tools.ietf.org/html/rfc2234 IETF RFC 3986: https://tools.ietf.org/html/rfc3986	IETF syntax and serialization specifications referenced and used by the Energistics Identifier Specification for Uniform Resource Identifiers (URI).
WebSocket Protocol https://tools.ietf.org/html/rfc6455	From the abstract: The WebSocket Protocol enables two-way communication between a client running untrusted code in a controlled environment to a remote host that has opted-in to communications from that code. It is the underlying protocol for the Energistics Transfer Protocol (ETP).
JSON http://www.json.org/ http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf	JavaScript Object Notation (JSON) is a lightweight data-interchange format. It is easy for humans to read and write. It is easy for machines to parse and generate. Optionally, it can be used to encode ETP messages. ETP also supports binary encoding.
Avro Apache Avro specification (http://avro.apache.org/docs/current/spec.html)	The serialization of messages in ETP follows a subset of the Apache Avro specification. Avro is a system for defining schemas and serializing data objects according to those schemas.
JWT https://tools.ietf.org/html/rfc7519	JSON Web Token (JWT) is a compact, URL-safe means of representing claims to be transferred between two parties. All ETP servers MUST support authentication using JWT.

Standards/Organization

Description of Use

XML Schema 1.1

XML Schema Part 1: Structures Second Edition

http://www.w3.org/TR/2004/REC-xmlschema-1-20041028/

W3C- World Wide Web Consortium

28 October 2004

Used to define the schema that constrains the content of a PRODML XML document.

XML Schema Part 2: Datatypes Second Edition

http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/

W3C-World Wide Web Consortium

Used to define the schema that constrains the content of a PRODML XML document.

Hierarchical Data Format 5 (HDF5)

The HDF Group

http://www.hdfgroup.org/

Open file formats and libraries.

Designed to store and organize large amounts of array data, and improve speed and efficiency of data processing.

Geographic Markup Language (GML)

Open Geospatial Consortium (OGC)

http://www.opengeospatial.org/

The OpenGIS® Geography Markup Language Encoding Standard (GML).

The Geography Markup Language (GML) is an XML grammar for expressing geographical features.

EPSG Codes

International Association of Oil and Gas Producers (OGP)

http://www.epsg.org/

The European Petroleum Survey Group (EPSG), the globally recognized experts on geodetic issues, has been absorbed into the Surveying and Position Committee of the International Association of Oil and Gas Producers (OGP), which is now the owner of the EPSG database of Geodetic Parameters and assigned codes.

PRODML implementations can use EPSG codes to define a coordinate reference system.

Unified Modeling Language™ (UML®)

Object Management Group

http://www.uml.org/

UML is a general purpose modeling language, which was designed to provide a standard way to visualize system design. Originally intended for software architecture design, its use has expanded.

Energy Industry Profile of ISO/FDIS 19115-1

The EIP is an ISO Conformance Level 1 profile of the widely adopted international standards ISO 19115-1:2014 which provides XML implementation guidance with reference to ISO Technical Specification 19115-3:2016.

Open Packaging Conventions

Standard ECMA-376Office Open XML File Formats

http://www.ecma-international.org/publications/standards/Ecma-376.htm

ISO/IEC 29500-2:2012

Information technology – Document description and processing languages – Office Open XML File Formats – Part 2: Open Packaging Conventions

http://standards.iso.org/ittf/PubliclyAvailableStandards/index.html

To address the challenges of the multi-file data sets used in upstream oil and gas, Energistics and its members have developed file packaging conventions based on the Open Packaging Conventions (OPC), a widely used container-file technology that allows multiple types of files to be bundled together into a single package. The Energistics Packaging Convention (EPC) is intended for use with all Energistics standards.

OPC is supported by the two organizations listed in the left column.

Internet Engineering Task Force

IETF RFC 4122

https://tools.ietf.org/html/rfc4122

IETF RFC 4122 is a standard for defining universally unique identifiers (UUID). According to the abstract of the specification: “This specification defines a Uniform Resource Name namespace for UUIDs (Universally Unique Identifier), also known as GUIDs (Globally Unique Identifier). A UUID is 128 bits long, and can guarantee uniqueness across space and time.”

For Energistics usage, see the Energistics Identifier Specification.

IETF RFC 2234: https://tools.ietf.org/html/rfc2234

IETF RFC 3986: https://tools.ietf.org/html/rfc3986

IETF syntax and serialization specifications referenced and used by the Energistics Identifier Specification for Uniform Resource Identifiers (URI).

WebSocket Protocol

https://tools.ietf.org/html/rfc6455

From the abstract: The WebSocket Protocol enables two-way communication between a client running untrusted code in a controlled environment to a remote host that has opted-in to communications from that code.

It is the underlying protocol for the Energistics Transfer Protocol (ETP).

JSON

http://www.json.org/

http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf

JavaScript Object Notation (JSON) is a lightweight data-interchange format. It is easy for humans to read and write. It is easy for machines to parse and generate.

Optionally, it can be used to encode ETP messages. ETP also supports binary encoding.

Avro

Apache Avro specification (http://avro.apache.org/docs/current/spec.html)

The serialization of messages in ETP follows a subset of the Apache Avro specification. Avro is a system for defining schemas and serializing data objects according to those schemas.

JWT

https://tools.ietf.org/html/rfc7519

JSON Web Token (JWT) is a compact, URL-safe means of representing claims to be transferred between two parties.

All ETP servers MUST support authentication using JWT.