ISO/IEC 30118-4:2018 情報技術— Open Connectivity Foundation(OCF)仕様—パート4:リソースタイプ仕様 | ページ 2

※一部、英文及び仏文を自動翻訳した日本語訳を使用しています。

序文

ISO (国際標準化機構) と IEC (国際電気標準会議) は、世界標準化のための専門システムを形成しています。 ISO または IEC のメンバーである国家機関は、技術活動の特定の分野を扱うために、それぞれの組織によって設立された技術委員会を通じて、国際規格の開発に参加しています。 ISO と IEC の技術委員会は、相互に関心のある分野で協力しています。 ISO および IEC と連携して、政府および非政府の他の国際機関もこの作業に参加しています。情報技術の分野では、ISO と IEC が合同技術委員会 ISO/IEC JTC 1 を設立しました。

この文書の開発に使用された手順と、今後の維持のために意図された手順は、ISO/IEC 指令で説明されています。 1. 特に、さまざまなタイプの文書に必要なさまざまな承認基準に注意する必要があります ( www.iso.org/directives を参照)

このドキュメントの要素の一部が特許権の対象となる可能性があることに注意してください。 ISO および IEC は、そのような特許権の一部またはすべてを特定する責任を負わないものとします。ドキュメントの開発中に特定された特許権の詳細は、序文および/または受信した特許宣言の ISO リストに記載されます ( www.iso.org/patents を参照)

このドキュメントで使用されている商号は、ユーザーの便宜のために提供された情報であり、保証を構成するものではありません。

規格の自発的な性質の説明、適合性評価に関連する ISO 固有の用語と表現の意味、および技術的貿易障壁 (TBT) における世界貿易機関 (WTO) の原則への ISO の準拠に関する情報については、以下を参照してください。 www.iso.org/iso/foreword.html .

このドキュメントは、Open Connectivity Foundation (OCF) によって (OCF リソース タイプ仕様、バージョン 1.0.0 として) 作成され、その編集規則に従って起草されました。これは、JTC 1 PAS 手順の下で、合同技術委員会 ISO/IEC JTC 1, 情報技術によって採用されました。

ISO/IEC 30118 シリーズのすべての部品のリストは、ISO Web サイトで見つけることができます。

1 スコープ

OCF リソース タイプ仕様は、OCF デバイスによって公開される可能性がある、OCF によって定義されたリソースを指定します。

アプリケーション プロファイルのデバイス仕様 (スマート ホームやヘルスケア向けに作成されたものなど) は、プロファイルに適したデバイス タイプを指定します。このような仕様では、このドキュメントのリソース タイプの定義を使用します。

この仕様は、OCF コア仕様の上に構築されています。 OCF コア仕様は、IoT の使用法とエコシステムのプロファイルの実装を可能にする OCF フレームワークを指定します。 OCF コア フレームワークは、単純なデバイス (制約付きデバイス) とより機能的なデバイス (スマート デバイス) をサポートするように拡張可能です。

2 参考文献

以下のドキュメントの全体または一部は、このドキュメントで規範的に参照されており、その適用に不可欠です。日付のある参考文献については、引用された版のみが適用されます。日付のない参照については、参照文書の最新版 (修正を含む) が適用されます。

  • OCF コア仕様、 Open Connectivity Foundation コア仕様、バージョン 1.0.
  • JSON スキーマ、 JSON スキーマ: コアの定義と用語、バージョン 4.0, http://json-schema.org/latest/json-schema-core.html
  • RAML, Restful API モデリング言語、バージョン 0.
    https://github.com/raml-org/raml-spec/blob/master/versions/raml-08/raml-08.md
  • ISO 8601:2004, データ要素と交換フォーマット - 情報交換 - 日付と時刻の表現。
  • CIE CIE159:2004, カラー マネージメント システムのカラー アピアランス モデル: CIECAM02, 2004 年1 月 19 日。
    http://www.cie.co.at/index.php/Publications/index.php?i_ca_id=435
  • Swagger2.0, Swagger RESTful API ドキュメンテーション仕様、バージョン 2.0
    http://swagger.io/specification/
  • OCF リソース タイプ定義、OCF リソース タイプ定義のAPI 定義言語、リリース OCF-v1.0.0
    https://github.com/OpenInterConnect/IoTDataModels

3 用語、定義、記号、略語

3.1 用語と定義

3.1.1

アクチュエータ

UPDATE 操作をサポートするリソース。

3.1.2

複合リソース タイプ

他のリソース タイプの OCF コレクションとして定義されたリソース タイプ。

3.1.3

センサー

UPDATE 操作をサポートしていないリソース。

3.2 記号と略語

3.2.1

CRUDN

作成 取得 更新 削除 通知

これは、リソースで可能な操作を示す頭字語です。

3.2.2

CSV

カンマ区切り値リスト

コンマ区切り値リストは、コンマで区切られた 1 つの文字列に複数のフィールドを持つ構造です。値にコンマが含まれる場合、コンマの前に「\」を追加することでコンマをエスケープできます。

3.2.3

OCF

オープン コネクティビティ ファンデーション

OCF は、この仕様を作成および所有する標準化団体です。

3.2.4

ラムル

RESTful API モデリング言語

RAML は、RESTful API を記述するシンプルで簡潔な方法です。詳細については、RAML を参照してください。

3.2.5

休み

代表的な状態の転送

REST は、ネットワーク化されたアプリケーションを設計するためのアーキテクチャ スタイルであり、ステートレス、クライアント サーバー、キャッシュ可能な通信プロトコルに依存しています。

3.2.6

未定

決断される

3.3 規約

この仕様では、多くの用語、条件、メカニズム、シーケンス、パラメーター、イベント、状態、または同様の用語が、各単語の最初の文字が大文字で残りが小文字で印刷されます (例: リソース タイプ)これらの単語の小文字の使用は、通常の技術的な英語の意味を持ちます。

Foreword

ISO (the International Organization for Standardization) and IEC (the International Electrotechnical Commission) form the specialized system for worldwide standardization. National bodies that are members of ISO or IEC participate in the development of International Standards through technical committees established by the respective organization to deal with particular fields of technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other international organizations, governmental and non-governmental, in liaison with ISO and IEC, also take part in the work. In the field of information technology, ISO and IEC have established a joint technical committee, ISO/IEC JTC 1.

The procedures used to develop this document and those intended for its further maintenance are described in the ISO/IEC Directives, 1. In particular, the different approval criteria needed for the different types of document should be noted (see www.iso.org/directives ).

Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent rights. Details of any patent rights identified during the development of the document will be in the Introduction and/or on the ISO list of patent declarations received (see www.iso.org/patents ).

Any trade name used in this document is information given for the convenience of users and does not constitute an endorsement.

For an explanation of the voluntary nature of standards, the meaning of ISO specific terms and expressions related to conformity assessment, as well as information about ISO’s adherence to the World Trade Organization (WTO) principles in the Technical Barriers to Trade (TBT), see www.iso.org/iso/foreword.html .

This document was prepared by the Open Connectivity Foundation (OCF) (as the OCF Resource Type Specification, Version 1.0.0) and drafted in accordance with its editorial rules. It was adopted, under the JTC 1 PAS procedure, by Joint Technical Committee ISO/IEC JTC 1, Information technology.

A list of all parts in the ISO/IEC 30118 series can be found on the ISO website.

1 Scope

The OCF Resource Type Specification specifies the Resources that have been defined by OCF that may be exposed by an OCF Device.

Application profile device specifications (for example those created for Smart Home or Healthcare) specify device types appropriate to the profile; such specifications use Resource Type definitions from this document.

This specification is built on top of the OCF Core Specification. The OCF Core Specification specifies the OCF Framework that enables the implementation of profiles for IoT usages and ecosystems. The OCF Core Framework is scalable to support simple devices (constrained device) and more capable devices (smart device).

2 Normative references

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.

  • OCF Core Specification, Open Connectivity Foundation Core Specification, Version 1.0.0.
  • JSON SCHEMA, JSON Schema: Core Definitions and Terminology, Version 4.0, http://json-schema.org/latest/json-schema-core.html .
  • RAML, Restful API modelling language, Version 0.8.
    https://github.com/raml-org/raml-spec/blob/master/versions/raml-08/raml-08.md
  • ISO 8601:2004, Data elements and interchange formats — information interchange — Representation of dates and times.
  • CIE CIE159:2004, A colour appearance model for colour management systems: CIECAM02, January 19, 2004.
    http://www.cie.co.at/index.php/Publications/index.php?i_ca_id=435
  • Swagger2.0, Swagger RESTful API Documentation Specification, Version 2.0
    http://swagger.io/specification/
  • OCF Resource Type Definitions, API Definition Language for OCF Resource Type Definitions, Release OCF-v1.0.0
    https://github.com/OpenInterConnect/IoTDataModels

3 Terms, definitions, symbols and abbreviations

3.1 Terms and definitions

3.1.1

Actuator

Resource with support of the UPDATE operation.

3.1.2

Composite Resource Type

A Resource Type defined as an OCF Collection of other Resource Types.

3.1.3

Sensor

Resource without support of the UPDATE operation.

3.2 Symbols and abbreviations

3.2.1

CRUDN

Create Retrieve Update Delete Notify

This is an acronym indicating which operations are possible on the Resource.

3.2.2

CSV

Comma Separated Value List

Comma Separated Value List is a construction to have more fields in 1 string separated by commas. If a value contains a comma then the comma can be escaped by adding “\” in front of the comma.

3.2.3

OCF

Open Connectivity Foundation

OCF is the standards organization which created and owns this specification.

3.2.4

RAML

RESTful API modelling language

RAML is a simple and succinct way of describing RESTful APIs. See RAML for further details.

3.2.5

REST

Representational State Transfer

REST is an architecture style for designing networked applications and relies on a stateless, client-server, cacheable communications protocol.

3.2.6

TBD

To Be Determined

3.3 Conventions

In this specification a number of terms, conditions, mechanisms, sequences, parameters, events, states, or similar terms are printed with the first letter of each word in uppercase and the rest lowercase (e.g., Resource Type). Any lowercase uses of these words have the normal technical English meaning.