目次 1. 変換の対象 砂防指定地 XML 作成メニュー シェープファイルからXMLへ変換 砂防指定地 XMLとシェープファイルの対応.csv 変換処理 CSVファイルによる属性指定... 5

2012/12/18 有限会社ジオ・コーチ・システムズ

「砂防指定地XML作成」プログラムについての説明書です。

この説明書は次のバージョンに対応しています。

アプリケーション名 バージョン 日付 砂防指定地XML作成 7.0.5 2012/12/18

プログラムのインストールについては「GeoCoach3Dシリーズ7 インストール説明書」を参照してください。「砂防指 定地XML作成」はWindows 7(64bit), Vista(64bit), XP Professional x64 上ではパソコンが搭載しているメモリすべて が使えます。

「砂防指定地XML作成」とフリーソフト「JPGIS-XMLビューF」の表示などの機能は共通です。共通する機能について は、「JPGIS-XMLビューF」の説明書を参照してください。

アプリケーション名 バージョン 日付 JPGIS-XMLビューF 7.0.2 2012/11/22

・説明書

現状、まだ「SaboShiteichi」「Hyochu」の変換のみの状況です。今後、他の地物の変換も追加してい きます。

ii

目次

1.

変換の対象

2.

砂防指定地

作成メニュー

2.1.

シェープファイルから

へ変換

2.1.1.

砂防指定地

とシェープファイルの対応

2.1.2.

変換処理

2.1.3. CSV

ファイルによる属性指定

2.2. XML

からシェープファイルへ変換

2.2.1.

対象の

ファイル

2.2.2.

設定

2.2.3.

ダイアログ

2.1. XML-XML

比較

3.

ファイル別メニュー

3.1.

保存 シェープファイル

3.2.

フィールド名変更

3.3.

フィールド型変更

3.4.

フィールド長変更

3.5.

少数部の長さ変更

4.

その他

4.1.

更新記録

1

1. 変換の対象

砂防指定地XML作成は、以下のファイルをJPGIS-XMLに変換します。

● 砂防指定地の情報をセットしたシェープファイルとCSVファイル

また、砂防指定地のXMLファイルをシェープファイルに変換する機能もあります。元のシェープファイルをXMLに 変換し、そのXMLをシェープファイルに変換して、情報が一致していることを確認するためです。

シェープファイルと

ファイル

XML

ファイル

シェープファイルと

ファイル

2

2. 砂防指定地XML作成メニュー

2.1.

シェープファイルからXMLへ変換

シェープファイルからJPGIS-XML(JPGIS2.1)ファイルを作成します。

シェープファイルフォルダ(入力)

変 換 す る シ ェ ー プ フ ァ イ ル の フ ォ ル ダ を 指 定 し ま す 。 変 換 対 象 と な る シ ェ ー プ フ ァ イ ル は フ ァ イ ル 名 に

「_SaboShiteichi」「_Hyochu」を含んでいる必要があります。また、シェープファイルと同じ名前のCSVファイルも参 照します。

「シェープファイルのフィールド名などは、「砂防指定地XMLとシェープファイルの対応.csv」で指定します。

砂防指定地XMLとシェープファイルの対応.csv(入力)

変換の設定ファイル「砂防指定地XMLとシェープファイルの対応.csv」を指定します。

砂防指定地JPGIS-XMLフォルダ (出力)

XMLファイルを出力するフォルダを指定します。

XMLファイルの文字コード

作成するXMLファイルの文字コードを指定します。仕様では「UTF-8」です。「Shift_JIS」と「Windows-31J」は、

XMLファイルの内容確をUTF-8に対応していないテキストエディタなどで確認するためのオプションです。

ＧＩ要素の属性

作成するXMLファイルのGI要素の内容を指定します。1から5まで、GI要素の設定としてXMLファイルに記録し

○○

変換

○○

○○

○○

○○

3 ます。「version="1.0"」は自動でGI要素に付加します。各文字列は改行してXMLファイルに出力します。

exchangeMetaData

XMLのexchangeMetaDataの内容を指定します。

時間属性の定義

XMLファイル中の「時間属性の定義」に記録する日付を指定します。年-月-日をYYYY-MM-DDの形式で指定します。

2.1.1.

砂防指定地XMLとシェープファイルの対応.csv

砂防指定地XMLファイルとシェープファイルの情報の対応関係を定義します。このファイルはインストールフォルダ

（C:¥Program Files ¥GeoCoachSystems¥砂防指定地XML作成)にあります。

シェープファイルからXMLファイルを作成する際には、1,2,3列の「XMLの地物名」「XMLのタグ名」「シェープの フィールド名」を参照します。(このファイルはXMLからシェープファイルへ変換する際も参照します)

1列目が「'」で始まる行はコメント行です。下図の例では27行までがコメント行で、28行からが設定です。

4

列 型 内容

1 文字列 XMLファイルの地物名

次の行からは空白にしておきます。

2 文字列 XMLファイルの地物のタグ名

XMLのタグが複数のタグを含む場合は、「/」でタグ名を分けます。

3 文字列 シェープファイルのフィールド名

フィールド名は10バイト(全角で5文字)までです 4 整数 シェープファイルのフィールドの型

「C」文字列

「N」数値

空白の場合は「C」の文字列になります。

5 整数 シェープファイルのフィールドのバイト数、1以上255までです。

空白の場合、実際のデータのバイト数から計算します。

6 文字列 シェープファイルのフィールドの小数点以下桁数。数値の場合に指定します。

空白の場合は0とします。

2.1.2.

変換処理

現段階では、指定されたフォルダのシェープファイルで、「_SaboShiteichi」「_Hyochu」を含むひと組のファイルづつ リードし、ひとつのXMLファイルに出力していきます。

作成するXMLのファイル名や、シェープファイル名のアンダーバーの直前までの文字列を使います。

例「sample_SaboShiteichi_Polygon.shp」⇒「sample.xml」

XMLファイルの座標は平面直角座標系です。座標を小数点以下３桁までのメートル単位で出力します。変換元のシェ ープファイルも座標は平面直角座標系にしておいてください。

○○

変換

○○

○○

□□

□□

□□

5 2.1.3. CSVファイルによる属性指定

XMLファイルのタグの値については、CSVファイルで指定することが可能です。例えば、XMLの「meisai」の「jusho」

の「chiban」は地番を多数記録しますが、シェープファイルのフィールドへ記録できるバイト数は255バイトの制限が

あります。この場合、CSVファイルに地番を記録しておくことで、CSVファイルの文字列をXMLへ記録することが可 能です。

CSVファイルはXMLと同じファイル名にします。CSVファイルがあれば、属性情報はCSVファイルを優先してXML に出力します。

CSVファイルは次の形式です。1列目の先頭文字が「'」の場合はコメント行です。

列 型 内容

1 整数 対応するシェープファイルのレコード番号。=1,2,3,…

2 文字列 XMLのタグ名。タグが子タグを含んでいる場合「/」で分けます。

3 文字列 シェープファイルのフィールド名。この列は空白でも構いません。

この列はプログラムからは参照しません。

4 文字列 XMLに記録する文字列。

空白の場合はシェープファイルに記録されていフィールドの文字列を参照します。

○○

変換

○○

○○

○○

○○

6 2.2. XMLからシェープファイルへ変換

2.2.1.

対象のXMLファイル

メニュー「シェープファイルからXMLへ変換」で作成したXMLファイルをシェープファイルに変換します。変換し たXMLファイルの内容確認のための機能です。

2.2.2.

設定

変換の設定ファイルは「シェープファイルからXMLへ変換」での「砂防指定地XMLとシェープファイルの対応.csv」 と同じです。

XML からシェープファイルに変換する際には、4,5列目のシェープファイルのフィールドの型、小数点以下桁数も参 照します。

2.2.3.

ダイアログ

JPGIS-XMLファイルフォルダ(入力)

XMLファイルのフォルダを指定します。指定されたフォルダ内の.xmlが変換対象になります。

変換設定CSVファイル (入力) 上記CSVファイルを指定します。

シェープファイルフォルダ(出力)

シ ェ ー プ フ ァ イ ル を 出 力 する フ ォ ル ダ を 指 定 し ま す 。シ ェ ー プ フ ァ イ ル 名 は 元の XML の フ ァ イ ル 名 に 「_ SaboShiteichi_Polygon」を付けます。

例：「sample.xml」⇒「sample_SaboShiteichi_Polygon.shp」

シェープファイルと同じ名前のCSVファイルも出力します。XMLファイルの各タグの値を出力します。

例：「sample.xml」⇒「sample_SaboShiteichi_Polygon.csv」

内容はメニュー「シェープファイルからXMLファイル作成」の説明を参照してください。

7 2.1. XML-XML比較

元になるXMLとシェープから変換したXMLが同じかを確かめためるのツールです。

XMLファイルのフォルダ(参照)

元のXMLファイルのフォルダを指定します。

XMLファイルのフォルダ(対象)

メニュー[シェープファイルへ変換]で作成したシェープファイルを[XMLファイルへ変換]で作成したXMLファイルの フォルダを指定します。

属性[timeStamp]の値の違いは許す OFFにします。

属性[id]と[idref]の値の違いは許す OFFのします。

要素[coordinate]は実数値で比較する OFFにします。

両方のフォルダで、同じ名前のXMLファイルを比較します。それぞれのファイルを一行ずつ取り出して、文字列が異 なれば、その旨を[レポート]パネルに表示して、比較を終了します。つまり、一番最初に違う行があれば、その行を示し、

後の行についての比較はしません。改行だけの空白行があれば、その行は飛ばします。また、要素のタグの前に半角スペ ースやタブがある場合に対応するため、各行の文字列から半角スペースとタブを除いた文字列で比較します。

XMLファイルをシェープファイルに変換し、シェープファイルを編集し、再度XML戻すことを意図する場合、シェ XML

シェープファイル

[シェープファイルへ変換]

XML

[XML

ファイルへ変換]

比較する

8 ープフィルを編集する前に、一旦XMLファイルへ戻してみることをお勧めします。メニュー「シェープファイルへ変換」

ダイアログで指定する「GI」要素の内容などが、元のXMLと異なっていないかを確かめることができます。異なる場合、

レポートが表示されます。この場合、ダイアログの指定を修正してください。

異なる例

同じ例

9

3. ファイル別メニュー

[データ]パネルに表示しているファイル名のポップアップメニューで、そのファイルを対象とした操作ができます。

3.1.

保存 シェープファイル

開いているシェープファイルを保存します。

3.2.

フィールド名変更

対象のシェープファイルのフィールド名を変更します。

右側に新しいフィールド名を入れて、エンターキーを押してください

3.3.

フィールド型変更

。シェープファイルの仕様上、フィールド名は 10バイト以下(全角で5文字まで)になります。OKボタンで入力されたフィールド名の重複などをチェックし、確認のダ イアログを表示し、フィールド名を変更します。フィールド名の変更の「元に戻す」ことはできません。

対象のシェープファイルのフィールド型を変更します。

10 右側に新しいフィールド型の１文字を入れて、エンターキーを押してください

文字

。 型

C 文字列

N 数値

F 数値(指数表記)

フィールドの型の記録を変えるだけで、実際のデータは変更しません。シェープファイルはデータを文字列で保持して います。例えば、数値の場合「123」の文字列です。型が数値の場合、型を文字列に変更しても差し支えありませんが、

文字列の型を数値に変更する場合、あらかじめデータが数値の文字列になっていることを確認してください。

フィールド名の変更の「元に戻す」ことはできません。

3.4.

フィールド長変更

対象のシェープファイルのフィールド長を変更します。

「現在のフィールド長」の値はシェープファイル(.dbf)で定義されているフィールド長(バイト数)で、括弧内の数字は 実際のデータの最大のバイト数です。表の「変更後のフィールド長」に変更後のバイト数を入力してください。最大のバ イト数より小さい値を指定すると、データが失われます。新しいバイト数を入力した後、エンターキーを押してください。

フィールド長の最大値は255です。OKボタンで、確認のダイアログを表示し、フィールド長を変更します。フィールド

11 長の変更の「元に戻す」ことはできません。

3.5.

少数部の長さ変更

対象のシェープファイルのフィールドの少数部の長さ(少数点以下桁数)を変更します。

「現在の少数部の長さ」の値はシェープファイル(.dbf)で定義されている少数部の長さで、フィールドの型が「N

」か「F」の場合に表示します。括弧内の数字は実際の数値の最大の少数部の長さ(少数点以下桁数)です。表の「変更 後の少数部の長さ」に変更後の値を入力してください。新しい値を入力した後、エンターキーを押してください。OKボ タンで、確認のダイアログを表示し、少数部の長さを変更します。また、各フィールドの値の少数点以下の桁数が指定さ れた桁数より大きい場合、指定された桁数まで丸めます。変更したレコードについてはレポートパネルに表示します。少 数部の長さの変更の「元に戻す」ことはできません。

12

4. その他

4.1.

更新記録

【7.0.0 2012/05/24】

 最初のバージョン

【7.0.1 2012/06/04】

 メニュー「シェープファイルからXMLへ変換」に「標柱」に変換を追加。また、「砂防指定地」と「標柱」のシ ェープファイルの組を特定するため、入力シェープファイル名にルールを設定しました。

【7.0.2 2012/06/06】

 シェープファイルのフィールドについて、フィールド名や少数部の長さを変更できるようにしました。また、シ ェープファイルを保存できるようにしました。

 メニュー「シェープファイルからXML へ変換」のダイアログで「データ集合作成ツール名称」と「ツールのバ ージョン」が入力できるようにしました。

【7.0.3 2012/06/11】

 メニュー「シェープファイルからXMLへ変換」で、属性情報をセットしたCSVファイルがあれば、その属性情 報をXMLにセットするようにしました。

 メニュー「XMLからシェープファイルへ変換」で、シェープファイルと同じ名前のCSVファイルも出力するよ うにしました。CSVファイルにはXMLの属性情報をセットします。

【7.0.4 2012/12/11】

 メニュー「シェープファイルからXMLへ変換」で、XMLの属性について、変換設定表になければ、処理が止ま る問題を修正しました。また、その旨をレポートするようにしました。

【7.0.5 2012/12/18】

 メニュー「シェープファイルから XML へ変換」で、「SaboShiteichi」の「shiteiGaiyo」の「shiteiDate」が、

13 元データのシェープファイルにあると重複して出力される問題を修正しました。

 メニュー「シェープファイルからXMLへ変換」で、作成するXMLの「標柱」の点のIDを「pt001」「pt002」

…から「hypt001」「hypt002」…に変更しました。