Data Convert Support File Format
HamingBirdではCSVとADIFをサポートします。
CSV：コンマセパレーションバリューファイル
Text Editorでも編集可能でExcelでも読み込むことが出来るファイル形式です。
CSV FileはKonma Separation Valueの略で内容は文字列をコンマで
区切っているだけなので、順番と項目の紐付け情報が別途必要になります。
HamingBirdはこの情報を別途定義し変換時に参照する方法を採用しています。
アプリによって異なる並びも定義次第で変換可能になります。
また、Excelで利用する場合先頭に項目タイトルがあると便利なので
項目タイトルを追加する機能も有ります。
ADIF：アプリケーション間でDataの授受するためのファイル形式です。
ADIF.orgのサイトで書式が定義されています。
項目名と内容が一対の形式なので取り扱いが簡単です。
ADIFには2種類あります。
拡張子がADIはADIF独特のフォーマットです。
拡張子がADXはXML形式に準拠したフォーマットです。
HamingBirdはADI/ADX両方のフォーマットに対応します。
ADIFの読み込みはフォーマット自動認識ですが、
書き出しの場合は予めどちらかの指定が必要です。
FT8は通信LogをADIFで出力します。
HamingBirdはこのADIF Fileを読み込んでLogファイルに反映します。
Data Convert Button
データコンバーターの起動ボタン
Select And Convertの[LogData Action]ボタンをクリックすると
Data Conversion Formが起動します。
このDialog Formは指定のRecord DataをADIF File、CSV Fileに書き出したり
ADIF File、CSV FileをLog Dataに書き込む処理を行います。
同一形式のLogDataを追加したり任意の一部を切り出したりする機能が有ります。
Record DataをADIF、CSV Fileに書き出す場合は事前に対象となる
Recordを指定しておきます。（Log Viewerで行の選択）
ADIF Fileを取り込む場合は事前の準備はありません。
CSV Fileは対象のアプリ毎に並び順が異なるので、予め
CSV Fileを取り込む場合はCSV Format(Dataの並び順)の指定が必要です。
同様に書き出す処理にも相手に合わせたCSV Formatが必要になります。
LogData(DB Data)が対象の操作ではCopy Outの処理に予め対象のRecordを
選定しておく必要が有ります。
Processing Contents
操作は半Wizard形式に成っています。
上から順番に処理パラメータを設定します。
１・Import ADIF File
ADIF Fileを読み込んでLog Fileに反映します。
２・ADIF File Export
Log Fileから指定のRecordをADIF Fileに書き出します。
３・Import CSV File
CSV Fileを指定のFormatで読み込んでLog Fileに反映します。
４・CSV File Export
Log Fileから指定のRecordを指定のFormatでCSV Fileに書き出します。
５．Addition DB Data
Log DataにLog Dataを追加します。
（追加できるのは同じFormatのLog Dataに限ります。）
６．DB Data Copy Out
Log Dataの選択されたDataを別名のLog Dataに書き出します。
Import ADIF File（ADIF Fileの読み込み）
ADIF Fileを読み込むと内容はは”TEMPORARY"に表示されます。
Event Logには操作状況や
処理の結果などを表示します。
[>> Import ADIF File] はADIF Fileを読み込む処理を行います。
ADIF読み込み手段のアクションが縦に一連表示されます。
処理は上から下に順に操作して行います。
１・Loading ADIF File
読み込み対象のADIF FileをFile Load Dialogが開くので指定します。
FileはTEMPORARYにも読み込まれますので、
この時、データの並び順を確認してください。
TEMPORARYをダブルクリックすると大きな表示に切り替わるので
日付と時刻から並び順を把握します。
＊ ADIF FileはADI形式とADX形式がありますが自動判別します。
２・Processing Direction
データの読み出し順序を指定します。
ADIF Fileが生成されるアプリ側は新しいRecordが一番最後に書かれる
のが普通なので、このままファイルの先頭から読み込めばRecordの
生成も古い順にできますが、ADIFを生成するアプリ側の都合で
順序が反転しているとLog File Recordの順序が逆転してしまいます。
ADIF Fileを読み込むとTEMPORARYエリアに一旦書き出しますので
順序を確認することが出来ます。
クリックすると方向を指示するDialogを表示しますので
Forward（先頭から読み込み）
Reverse（末端から読み込み）を選択します。
３・Time Conversion
ADIFの基本仕様では日時はUTCで表記します。
クリックするとUTC Convert?のDialogが表示されるので
YES/NOを選択してください。
HamingBirdではLocal Timeなので基本的には[YES]でUTC => LocalTime
の変換を選択してください。
４・Execute Import Work
変換処理を実行します。
処理結果は”Event Log”に表示されます。
５・Reset
一連のパラメータを初期化します。
閉じた状態にしても同様に初期化します。
NOTE
”TEMPORARY”はファイルに書き出すことが出来ます。
HamingBirdではLogDataの並び順は日時で行っています。
ADIF File Export（ADIF Fileへの書き出し）
[>> ADIF File Export] はLogDataをADIF Fileに変換して書き出します。
ADIF Fileへの書き出しアクションが縦に一連表示されます。
処理は上から下に順に操作して行います。
※ 変換処理に先立って対象のRecordを選択状態にする必要があります。
１・ADX or ADI Format
書き出しADIF FileのFormatを選択します。
クリックすると選択用のDialogを表示するので[ADI]/[ADX]を選択します。
この設定でFileの拡張子が決まるので必ずFile名の指定より前に行ってください。
２・Export File Name Setup
書き出し先のファイル名を設定します。
３・Time Conversion
ADIFの基本仕様では日時はUTCで表記します。
HamingBirdではLocal Timeで処理していますので基本的に変換が必要です。
クリックするとUTC Convert？のDialogが表示されるので
YES/NOで選択してください。
（受け先のアプリの仕様で確認してください）
４・Execute Import Work
変換処理を実行し成功すれば指定のファイル名でADIF Fileを生成します。
同時にTEMPORARYに生成されたADIF Fileが表示されます。
処理結果は”Event Log”に表示されます。
５・Direction sorting
ADIFのデータの並びを入れ替えることが出来ます。
並び順が予定と異なってしまった場合にこのボタンで順序を入れ替えます。
６・Reset
一連のパラメータを初期化します。
閉じた状態にしても同様に初期化します。
NOTE
ADIFのデータ並び順はRecord選択の並び順で上から処理します。
Import CSV File（CSV Fileの読み込み）
CSV Type Editor / Selector
[>> Import CSV File] はCSV Fileを読み込んでLogDataに追加します。
CSV File読み込みのためのアクションが縦に一連表示されます。
処理は上から下に順に操作して行います。
１・Loading CSV File
読み込み対象のCSV FileをFile Load Dialogが開くので指定します。
２・Select CSV file Format
CSV Type Editor / SelectorのDialogが開くので
CSV Define ListからCSV Formatを選択します。
（CSV Dataの並び順の定義）
[Edit]ボタンで編集することが出来ます。
３・Time Conversion
HamingBirdではLocal Timeで管理していますので
UTCへの変換が必要な場合はここで指定します。
クリックするとUTC Convert？のDialogが表示されるので
YES/NOで選択します
YES：UTC → Local Timeに変換します。
４・Processing Direction
データの読み出し順序を指定します。
CSV Fileを読み込むとTEMPORARYエリアに一旦書き出しますので
順序を確認することが出来ます。
確認の上で読み込み順序を
Forward（先頭から読み込み）
Reverse（末端から読み込み）を選択します。
５・Execute Import Work
変換処理を実行します。
処理結果は”Event Log”に表示されます。
６・Reset
一連のパラメータを初期化します。
閉じた状態にしても同様に初期化します。
”TEMPORARY”はファイルに書き出すことが出来ます。
CSV File Export（CSV Fileへ書き出し）
CSV Type Editor / Selector
[>> CSV File Export] はLogDataをCSV Fileに書き出します。
CSV Fileへの書き出しアクションが縦に一連表示されます。
処理は上から下に順に操作して行います。
※ 先立って対象のRecordを選択状態にする必要があります。
１・Select CSV file Format
クリックするとCSV FormatのDialog Formが表示されるので
書き出しCSV FileのFormatを選択します。
２・Export File Name Setup
Save File Dialogが開きますので書き出し先のFile Nameを決めます。
３・Time Conversion
HamingBirdではLocal Timeで管理していますので
UTCへの変換が必要な場合はここで指定します。
クリックするとUTC Convert？のDialogが表示されるので
YES/NOで選択します。
YES：Local Time → UTCに変換します。
４・Execute Export Work
変換処理を実行します。
TEMPORARYに生成されたCSV Fileが表示されます。
処理結果は”Event Log”に表示されます。
５・Direction sorting
CSV Fileのデータの並びを入れ替えることが出来ます。
並び順が予定と異なってしまった場合にこのボタンで順序を入れ替えます。
６・Reset
一連のパラメータを初期化します。
閉じた状態にしても同様に初期化します。
NOTE
１）CSV Fileのデータ並び順はRecord選択の並び順で上から処理します。
２）”さよなら手書き”（ソースネクスト）を使ってQSL Cardを作っています。
CSV File Export の”CSV Type Setting”で
内容を設定します。
Addition DB Data（LogFileの結合）
[>> Addition DB Data] は別のLogDataを読み込んで既存のLogDataに追加します。
別に作ったLogFile(DB Data)を結合することが出来ます。
処理は上から下に順に操作して行います。
１・Select DB File
クリックするとファイルを指定するDialogが表示されるので結合したいLogFileを
指定します。
２・Execute Addition Data
指定されたDB Data(LogFile)を現在開いているLogFileに追加します。
６・Reset
一連のパラメータを初期化します。
閉じた状態にしても同様に初期化します。
NOTE
追加できるLogDataはHamingBirdで生成されたLogFileに限ります。
他のファイルはCSVかADIFに変換して取り込む必要が有ります。
DB Data Copy out（LogFileの指定RecordをLogFileとして書き出し）
[>> DB Data Copy out] はLogDataの指定部分をLogDataとして書き出します。
現在開いているLogFileの指定されたRecord（行）をコピーして書き出します。
処理は上から下に順に操作して行います。
＊ 予めコピーしたいRecord（行）を選択状態にしておきます。
１・Output FileName Setup
クリックするとファイルを指定するDialogが表示されるので書き出し先
LogFile名を指定します。（既存のFile名をしていると上書きします。）
２・Execute Copy Out Procedure
指定されたRecord（行）のDataを指定されたDB Fileに書き出します。
６・Reset
一連のパラメータを初期化します。
閉じた状態にしても同様に初期化します。
NOTE
書き出しLogFileはHamingBirdの形式になります。
Select CSV Format（CSV Fileの書式設定）
CSV Type Selector Mode 起動時
起動時に選択されている
Formatが有効です。
変換処理の段階で選択を参照しますので
処理が終了するまで閉じないでください。
CSV Type Editor Mode {Edit]ボタン後
Arrangement（並び順の設定）
１・移動したい項目をクリックすると”⇒”を表示し移動対象になります。
２・並び順を移動したい方向に▲▼をクリックして場所を移動します。
左記の例では”Time”の位置を変えています。
このDialogを閉じると更新内容が保存されます。
CSV Type Editor / Selector
CSV関係の処理で[Select CSV Formt]ボタンをクリックすると表示します。
このDialogは起動時はSelectorとして機能しますが、[Edit]ボタンをクリック
すると編集機能(Editor)に切り替わります。
CSV Define List (Max 10)：
CSV 定義の名称です。最大10種設定できます。
✓で選択します。（編集対象、Format選択、削除対象）
ADD：新しく定義を追加します。（名称設定用のDialogが出ます。）
DEL：✓の定義を削除します。
（Standerdは削除できません）
□ With Title：
CSVの先頭にタイトルを付ける場合✓を入れます。
例：（Titleなし）
JS2HXS,金本,2022/03/10,10:20:00,・・・・
JT2SOS,金原,2024/03/12,15:10:00,・・・・
JK1QRZ,杉原,2024/10/12,13:15:00,・・・・
例：（Titleあり）
CALL,NAME,QSODATE,QSOTIME・・・・←タイトルが付きます
JS2HXS,金本,2022/03/10,10:20:00,・・・・
JT2SOS,金原,2024/03/12,15:10:00,・・・・
JK1QRZ,杉原,2024/10/12,13:15:00,・・・・
Date：
日付のFormatを設定します。
YYYY/MM/DD、YY/MM/DD、YYYYMMDD、YYMMDD
✻ 時刻は”HH:mm:ss”形式の固定です。
Frequency：
周波数の表記（単位）を設定します。
MHz、KHz、Hz
Encording：
文字のエンコードを選択します。
