75
76 5.2 場所の構造
(1) 基本構造
図 5-3に示すように場所は観測所「ObsrvtnPoint」を基点として事務所・水系が存在する。累 加リセット情報を作成する場合は観測所を基点としてデータを取り扱う。この観測所を特定するた めに,事務所・水系を持つ。また水系にデータ種別を区別する親要素を持つ
図 5-3 閉局設定:場所の構造
(2) 場所の要素
場所の要素一覧を表 5-1に示す。
表 5-1 場所の要素一覧
英語名 日本語名 内容 区分 構造
Office 事務所 観測データを管理する事務所 要素 OfficeType
ItemKind 種別 観測データの種別 要素 ItemKindType
RvrSys 水系 河川における水域 要素 RvrSysType
ObsrvtnPoint 観測所 観測データを測定する場所 要素 ObsrvtnPointType
77 (3) 事務所の構造
図 5-4に示すように,事務所と種別は親子関係にあるので,事務所の構造は子要素に種別・
名称をもつ。またその事務所を識別するための事務所コードを属性にもつ。事務所コードは統一 手順に従った値の範囲を持つ。
図 5-4 事務所の要素の構造
事務所(OfficeType)の構造を表 5-2に示す。
表 5-2 事務所の構造
登場頻度
英語名 日本語名 内容 区分 Type
min max 必須
officeCode 事務所コード 事務所を識別する固有のコード 属性 officeIntType 1 1 ○
ItemKind 種別 河川における観測データの種別 要素 ItemKindType 0 ∞
Name 名称 統一河川における最大 24 文字の正式名称 要素 NameType 0 1
事務所コードは共通の事務所コード(officeIntType)を持つ XML インスタンス例
<Office officeCode="21289">
<ItemKind itemKindCode="1"/>
<ItemKind itemKindCode="2"/>
</Office>
Office ItemKind
事務所 種別
Name 名称
78 (4) 種別の構造
図 5-5に示すように,種別と水系は親子関係にあるので,種別の構造は子要素に水系・名称を もつ。またその種別を識別するための種別コードを属性にもつ。
図 5-5 種別の要素の構造
種別(ItemKindType)の構造を表 5-3に示す。
表 5-3 種別の構造
登場頻度
英語名 日本語名 内容 区分 Type
min max 必須
itemKindCode 種別コード 事務所を識別する固有のコード 属性 int 1 1 ○
RvrSys 水系 河川における水域 要素 RvrSysType 0 1
Name 名称 統一河川における最大 24 文字の正式名称 要素 NameType 0 1
XML インスタンス例
<ItemKind itemKindCode="1">
<RvrSys rvrSysCode="83028000">
</ItemKind>
(5) 水系の構造
図 5-6に示すように,水系と観測所は親子関係にあるので,水系の構造は子要素に観測所・
名称をもつ。またその水系を識別するための水系コードを属性にもつ
図 5-6 水系の要素の構造
RvrSys ObsrvtnPoint
水系 観測所
Name 名称
ItemKind RvrSys
種別 水系
Name 名称
水系(RvrSysType)の構造を表 5-4に示す。
表 5-4 水系の構造
登場頻度
英語名 日本語名 内容 区分 Type
min max 必須
rvrSysCode 水系コード 水系域を識別する固有のコード 属性 int 1 1 ○
ObsrvtnPoint 観測所 観測データを取得する場所 要素 ObsrvtnPointType 0 ∞
Name 名称 統一河川における最大 24 文字の正式名称 要素 NameType 0 1
XML インスタンス例
<RvrSys rvrSysCode="83028000">
<Name>利根川水系</Name>
<ObsrvtnPoint obsrvtnPointCode="1"/>
<ObsrvtnPoint obsrvtnPointCode="2"/>
</RvrSys>
(6) 観測所の構造
図 5-7に示すように,観測所は子要素に名称を持つ。またその観測所を識別するためのコード を持つ。
図 5-7 観測所の要素の構造
ObsrvtnPoint Name
観測所 名称
観測所の構造(ObsrvtnPointType)を表 5-5に示す。
表 5-5 観測所の構造
登場頻度
英語名 日本語名 内容 区分 Type
min max 必須
obsrvtnPointCode 観測所コード 観測所を識別する固有のコード 属性 int 1 1 ○
Name 名称 統一河川における最大 24 文字の正式名称 要素 NameType 0 1
XML インスタンス例
<ObsrvtnPoint obsrvtnPointCode="1" >
<Name>栗橋</Name>
</ObsrvtnPoint>
79
5.3 閉局設定:主題の構造 (1) 基本構造
図 5-8に示すように閉局設定で取り扱う主題は,観測項目とする。
図 5-8 閉局設定:主題の構造
(2) 観測項目の構造
図 5-9に示すように,観測項目は子要素に名称を持つ。またその観測項目を識別するための コードを持つ。
図 5-9 観測項目の要素の構造
観測項目の構造(ItemType)を表 5-6に示す。
表 5-6 観測項目の構造
Item Name
観測項目 名称
登場頻度
英語名 日本語名 内容 区分 Type
min max 必須
itemCode 観測項目コード 観測項目を識別する固有のコード 属性 int 1 1 ○
Name 名称 統一河川における最大 24 文字の正式名称 要素 NameType 0 1
XML インスタンス例
<Item itemCode="10">
<Name>10分雨量</Name>
</Item ItemCode>
80
81 5.4 閉局設定:データの構造
(1) 基本構造
図 5-10に示すように閉局設定のデータは,設定状態,設定値,設定理由を扱う
図 5-10 閉局設定:データの構造
(2) データの要素
データの要素一覧を表 5-7に示す。
表 5-7 データの要素一覧
英語名 日本語名 内容 区分 構造
ClsdStnSts 設定状態 閉局設定の状態 要素 int
NumData 閉局設定値 情報の操作種別 要素 NumDataType
ClsdStnRsn 設定理由 降雨開始時の生データデータ 要素 int
(3) 設定状態の構造
図 5-11に示すように,設定状態は子要素を持たず,テキストデータに状態を示す値をもつ。
図 5-11 閉局状態の要素の構造
ClsdStnSts
閉局状態
82 閉局状態の構造を表 5-8に示す。
表 5-8 閉局状態の構造
登場頻度
英語名 日本語
名 内容 区分 Type
min max 必須
(テキストデータ) - 閉局設定の状態
0:常時稼動中(機関の影響なし)
1:常時閉局中
2:常時閉局中(閉局中値あり) 3:閉局期間あり
4:閉局期間あり(閉局中値あり)
- int 1 1 ○
XML インスタンス例
<ClsdStnSts>2</ClsdStnSts>
(4) 閉局設定値の構造
図 5-12に示すように,閉局設定値の構造は子要素を持たず,テキストデータにデータをもつ。
また統一手順に従ったフラグ情報を属性に持つこととする。
図 5-12 閉局設定値の要素の構造
閉局設定値の構造(NumDataType)を表 5-9に示す。
表 5-9 数値データの構造(NumDataType)
登場頻度
英語名 日本語名 内容 区分 Type
min max 必須
ContentsCode 内容コード 観測データのフラグ情報(フラグ 1 データ情報) 属性 int 0 1
SituatnCode 状況コード 観測データのフラグ情報(フラグ 2 付加情報) 属性 int 0 1
AlarmCode 警報コード 観測データのフラグ情報(フラグ 3 警戒情報) 属性 int 0 1
SpareCode 予備コード 観測データのフラグ情報(フラグ 4 予備) 属性 int 0 1
- 観測データ(数値データ) - int 1 1 ○
XML インスタンス例
<NumData contentsCode="00" situatnCode="00" alarmCode="00" spareCode="00">10</NumData>
NumData
閉局設定値
83 閉局設定理由の構造
図 5-13に示すように,閉局設定理由は子要素を持たず,テキストデータに理由を示す値をも つ。
図 5-13閉局設定理由の要素の構造
閉局設定理由の構造を表 5-10に示す。
表 5-10 閉局設定理由の構造
登場頻度
英語名 日本語
名 内容 区分 Type
min max 必須
(テキストデータ) - 閉局設定の理由
1:工事中 2:故障 3:冬季閉局中 4:夏季閉局中 5:点検中 6:その他
- int 1 1 ○
XML インスタンス例
<ClsdStnRsn>3</ClsdStnRsn>
ClsdStnSts
閉局状態
5.5 用語集
運用管理系(閉局設定)で使用する用語を表 5-11に示す。
表 5-11 運用管理系の用語一覧(抜粋)
英語名 内容 日本語名 慣用 単語 ルール
Clsd 閉 閉 ○
Rsn 理由 理由 ○
Stn 局 局 ○
Sts 状態 状態 ○
84
5.6 XMLSchema ファイル
1<?xml version="1.0" encoding="UTF-8"?>
2<xs:schema xmlns:rxs=http://unify.river.go.jp
xmlns:xs="http://www.w3.org/2001/XMLSchema">
3 <xs:import namespace="http://unify.river.go.jp" schemaLocation="rxs_sample.xsd"/>
4 <xs:complexType name="ItemType">
5 <xs:sequence>
6 <xs:element name="Name" type="rxs:NameType"/>
7 <xs:element name="ClsdStnSts" type="xs:int"/>
8 <xs:element name="NumData" type="rxs:NumDataType"/>
9 <xs:element name="ClsdStnRsn" type="xs:int"/>
10 </xs:sequence>
11 <xs:attribute name="itemCode" type="xs:byte" use="required"/>
12 </xs:complexType>
13 <xs:complexType name="ItemKindType">
14 <xs:sequence>
15 <xs:element name="RvrSys" type="RvrSysType"/>
16 </xs:sequence>
17 <xs:attribute name="itemKindCode" type="xs:int" use="required"/>
18 </xs:complexType>
19 <xs:element name="Name" type="rxs:NameType"/>
20 <xs:complexType name="ObsrvtnPointType">
21 <xs:sequence>
22 <xs:element ref="Name"/>
23 <xs:element name="Item" type="ItemType" maxOccurs="unbounded"/>
24 </xs:sequence>
25 <xs:attribute name="obsrvtnPointCode" type="xs:int" use="required"/>
26 </xs:complexType>
27 <xs:complexType name="OfficeType">
28 <xs:sequence>
29 <xs:element name="ItemKind" type="ItemKindType" maxOccurs="unbounded"/>
30 </xs:sequence>
31 <xs:attribute name="officeCode" type="rxs:officeinttype" use="required"/>
32 </xs:complexType>
33 <xs:element name="CLOSE">
34 <xs:complexType>
35 <xs:sequence>
36 <xs:element name="Office" type="OfficeType"/>
37 </xs:sequence>
38 </xs:complexType>
39 </xs:element>
40 <xs:complexType name="RvrSysType">
41 <xs:sequence>
42 <xs:element name="Name" type="rxs:NameType"/>
43 <xs:element name="ObsrvtnPoint" type="ObsrvtnPointType" minOccurs="0"
maxOccurs="unbounded"/>
44 </xs:sequence>
45 <xs:attribute name="rvrSysCode" type="xs:int" use="required"/>
46 </xs:complexType>
47</xs:schema>
85
5.7 XML インスタンス例
1<?xml version="1.0" encoding="UTF-8"?>
2<!-- 閉局設定定義 -->
6 <RvrSys rvrSysCode="83028000">
7 <Name>利根川水系</Name>
8 <ObsrvtnPoint obsrvtnPointCode="1">
9 <Name>三ノ倉</Name>
10 <Item itemCode="10">
11 <!-- 項目番号 -->
12 <Name>10分雨量</Name>
13 <!--閉局設定-->
14 <ClsdStnSts>2</ClsdStnSts>
15 <!-- 0:常時稼働中(期間の影響なし)-->
16 <!-- 1:常時閉局中 -->
17 <!-- 2:常時閉局中(閉局中値あり) -->
18 <!-- 3:閉局期間あり -->
19 <!-- 4:閉局期間あり(閉局中値あり)-->
20 <!-- 閉局設定値 -->
21 <NumData contentsCode="40" situatnCode="0" alarmCode="0"
spareCode="0">10</NumData>
22 <!--閉局理由-->
23 <ClsdStnRsn>1</ClsdStnRsn>
24 <!-- 1:工事中 -->
25 <!-- 2:故障 -->
26 <!-- 3:冬季閉局中 -->
27 <!-- 4:夏季閉局中 -->
28 <!-- 5:点検中 -->
29 <!-- 6:その他 -->
30 </Item>
31 </ObsrvtnPoint>
32 </RvrSys>
33 </ItemKind>
34 </Office>
35</CLOSE>
3<CLOSE xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">
4 <Office officeCode="21289">
5 <ItemKind itemKindCode="1">
86
87