メインコンテンツまでスキップ

タグ登録 (読み取る値の指定)

[タグ] は PLC の メモリ 1 か所 に名前を付けたものです。PLC ごとにメモリアドレスの表記法が異なるため、ご使用の PLC 種類のページも併せて参照してください。

  • 三菱: D100、M50 のような形式
  • シーメンス: %DB1.DBW0 のような形式
  • LS: D00309 のような形式
  • OPC-UA: ns=2;s=Channel1.Device1.Tag1 のような形式

詳しい表記法は各 PLC ページの [PLC アドレス] 節にあります → PLC 種類別ガイド

入力項目​

タグ 1 行に次の情報を入力します。

欄入力内容
タグ名画面に表示される名前。日本語も可 (例: 펌프1 회전수)
PLC アドレスPLC マニュアルに記載されたアドレス表記 (例: D100)
データ形式Float, Integer, Boolean, String, Long, Double のいずれか
形式補助 (format)32-bit の場合は DW、実数なら REAL など (任意)
計算式単位変換などの後処理式 (任意)。詳細は 計算式の適用
説明メモ。画面に併せて表示されます

データ形式ガイド​

データ形式幅・符号用途例
Boolean1 ビットオン/オフ、ON/OFFポンプ稼働 / アラーム ON
Integer16-bit 符号あり整数 (負数を含む) — 最も一般的カウンタ、回転数
Long64-bit 符号あり大きな整数 (32-bit 超)累積生産量
Float32-bit 実数小数点を含む値温度、圧力、速度
Double64-bit 実数高精度な小数精密測定データ
String可変文字列バッチ名、レシピ名

符号・幅を 名前で明示 する精密型 (Kepware と同じ意味):

データ形式幅・符号用途
Short16-bit 符号ありInteger と同一 (明示的な名称)
Word16-bit 符号なし0~65535 カウンタ (負数なし)
DInt32-bit 符号あり32-bit 整数 (旧 Integer+DW の組み合わせを代替)
DWord32-bit 符号なし21 億(2^31) 超 の累積カウンタ — Integer で収集すると失敗していた値
QWord64-bit 符号なし符号なしの大型カウンタ
Byte8-bit 符号なしステータスバイト
既存タグの移行 (2026.07 動作変更)
  • S7 Integer: 符号なし(u16)として誤って読まれていたものを 符号あり(s16) を正式仕様として修正 — 負数が 65531 のように表示される問題を解消。符号なしが必要な場合は Word を使用してください。
  • S7 / MELSEC Long: 32-bit で読んでいたものを正式仕様の 64-bit に統一。従来 Long で 32-bit を読んでいたタグは DInt(符号あり) または DWord(符号なし) に変更してください。

配列タグ (Base[N])​

DInt[10] のように 要素型[個数] で登録すると、連続領域を 1 タグとして収集し JSON 配列文字列("[1,2,3]")として保存します。 対応ドライバ (2026.07 拡大): EIP + MELSEC / S7 / Modbus / LS。要素は数値型のみ実際に収集されます (String 配列は登録不可、Boolean/Byte 配列はドライバが未対応 — 値が空になります)。 ドライバ別の上限: Modbus 合計 125 ワード · LS 合計 64 ワード · MELSEC シリーズ別 (Q/L・iQ-R 960 / QnA 480 / A 32 ワード) · S7 ネゴシエート PDU − 19 バイト — 超過すると値が空になるため、N を減らすかタグを分割してください。配列タグは read 専用 です (write 未対応)。

形式補助 (format) ガイド​

PLC の同じアドレスでも、どう解釈するかによって異なる値になります。16-bit のメモリを 2 か所束ねて 32-bit として読む、4 か所を束ねて 64-bit 実数として読む、といった違いです。

対象の値데이터 형식형식 보조
16-bit 整数 (最も一般的)Integer(空欄)
16-bit 符号なし整数IntegerUI
32-bit 整数 (メモリ 2 か所)IntegerDW
32-bit 実数 (最も一般的な実数型)FloatREAL
64-bit 実数 (高精度)DoubleLREAL
1 ビット (オン/オフ)Boolean(空欄)
ワード内の特定ビットBooleanBIN[3] (ビット 3)
文字列 N 文字StringSTR[N] (例: STR[10])
値がおかしいとき

32-bit / 64-bit の値なのに形式補助を空欄にすると 16-bit として誤って読まれ、値が異常に小さくなったり大きくなったりします。その場合は format 欄に DW、REAL、LREAL などの値を入力してください。

高度なタグ設定 (Kepware 参照)​

タグには以下の 任意設定 を併せて保存できます (すべて未指定の場合は従来の動作のままです)。 現在はバックアップ/復元 JSON(/connect/restore) または REST で指定し、値はタグ行と一緒に保存されます。

設定値意味
byte_orderAB_CD BA_DC CD_AB DC_BA32/64-bit のバイト・ワードオーダー (未指定=プロトコル既定)
scaling_typelinear sqrt生値 → 工学単位への変換
raw_low/raw_high数値スケーリング入力(生値)範囲
scaled_low/scaled_high数値スケーリング出力(工学単位)範囲
clamptrue/false出力を scaled 範囲でクランプ
negatetrue/false符号反転
units文字列単位ラベル (例: degC)
client_accessR / RWR の場合、書き込み API が拒否されます (読み取り専用)
deadband数値前回値との変化量がこの値未満なら発行を省略
scan_divisor整数n サイクルごとに 1 回だけ読み取り (収集周期の倍数)

例 — 4~20mA の生値 0..4095 を 0..100% に線形変換し、微小変動を抑制:

{"tags":[{ "opc_id":"OPC_X", "tag_id":"TAG_PCT", "tag_name":"압력%",
  "data_type":"Float", "plc_address":"D100",
  "scaling_type":"linear", "raw_low":0, "raw_high":4095,
  "scaled_low":0, "scaled_high":100, "clamp":true, "deadband":0.5 }]}

計算式(fomula)との併用が可能です — スケーリング結果の上に計算式が適用されます。

CSV 一括登録(/ui/connect/csv)でも同じ設定を指定できます — 基本 9 列の後に任意列: RAW_TYPE, BYTE_ORDER, SCALING_TYPE, RAW_LOW, RAW_HIGH, SCALED_LOW, SCALED_HIGH, CLAMP, NEGATE, UNITS, CLIENT_ACCESS, DEADBAND, SCAN_DIVISOR, TAG_GROUP。 9 列の既存 CSV はそのまま動作します。JSON バックアップ/復元 はこの設定を常に含みます(未設定の項目はファイルから省略)。

登録方法​

方法 1 — PLC 登録フォームで併せて追加​

[接続追加] または [修正] 画面内にタグ入力表があります。[+ タグ追加] ボタンを押して行を増やし、1 行ずつ入力して [保存]。

方法 2 — 登録済みの PLC にタグのみ追加​

  1. [接続] メニュー → 左側で PLC をクリック
  2. 右側 [タグ一覧] 上の [タグ追加] ボタンをクリック
  3. 1 件ずつ追加。追加後すぐ、次の収集周期から値が入り始めます。

方法 3 — CSV 一括アップロード​

タグが数十個以上ある場合は [接続] 右上の [CSV 一括アップロード] が速いです。CSV 様式はアップロード画面からダウンロードできます。

正しく登録されたかの確認​

PLC をクリックすると右側 [タグ一覧] に登録したタグが表示されます。

カラム意味
タグ名 / アドレス / 形式登録した内容のまま
現在値直近に収集された値 (5 秒ごとに自動更新)
収集時刻その値が入った時刻
状態정상 / 오류

エラーが表示される場合は、PLC アドレス表記の誤記またはデータ形式の不一致の可能性が高いです。トラブルシューティング — 値がおかしい を参照してください。

タグの修正 / 削除​

  • タグ一覧の行をクリックすると修正フォームが開きます。
  • 行末の [削除] ボタンで 1 行ずつ削除します。

修正後すぐ、次の収集周期から新しい設定が適用されます。

よくある質問​

Q. PLC アドレスはどうやって調べますか?​

  • PLC プログラマ / 設備メーカーのマニュアルに「データマッピング表」がある場合が多いです。
  • PLC 作成ツール (GX Works、TIA Portal、XG5000 など) の「Watch table / モニタ画面」で使用中のアドレスを確認できます。
  • OPC-UA なら UA Expert のような無償クライアントでアドレスをクリック/コピーして取得するのが最も正確です。

Q. タグ ID はどう付けますか?​

ゲートウェイが自動で <connection-id>_TAG_<number> 形式で付与します。手動指定も可能ですが、英数字とアンダースコアのみを使用してください。

Q. 同じアドレスを 2 つのタグとして登録してもよいですか?​

可能です。同じ raw 値に異なる計算式を適用して単位だけを変え、2 通りで送信したい場合によく使われます (例: temperature raw + temperature_F 華氏変換)。

Q. 1 台の PLC にタグは何個まで登録できますか?​

数百個までは問題ありません。ただし収集周期内にすべて読み取れる必要があるため、PLC が応答できる時間を考慮してください。1 台の PLC のタグが 1000 個を超える場合は、PLC の負荷 / ネットワーク遅延も併せて監視することを推奨します。