Relova — リモートマシンコネクタ
外部データベース、スプレッドシート、またはAPIを接続し、その行をiTenance内でライブマシン、部品、サプライヤーとして使用します。データのインポートやコピーは不要です。
RelovaはiTenanceを、お客様が既に運用しているシステム（ERP、SCADAヒストリアン、レガシー資産台帳、共有スプレッドシートなど）にリンクし、そこから選択された行を通常のiTenanceレコードとして表示します。データがお客様のテナントにコピーされることはありません。すべての画面はソースを読み込むため、常に最新の情報が表示されます。Relovaの接続は設計上読み取り専用であり、Relovaが接続先のシステムに書き戻すことはありません。
Relovaと一括インポートのどちらを選ぶべきか？
どちらも外部データを取り込みます。ソースが変化し続けるかどうかで選択してください。
一括インポートを使用する場合…
- 一度限りのファイル（サプライヤーリスト、初期資産台帳）がある場合。
- レコードを完全に編集可能なiTenanceデータにしたい場合。
- ソースが変更されないか、変更された場合に再インポートすることに問題がない場合。
Relovaを使用する場合…
- ソースが自動的に更新されるライブシステム（ERP、ヒストリアン、MES）である場合。
- 再アップロードなしで機械の測定値やステータスを反映させたい場合。
- リモートの状態（温度、稼働時間、故障フラグ）に基づいて作業指示を自動的に発行したい場合。
開始する前に
- Relovaリモートマシンモジュールがプランでアクティブになっている必要があります。設定 → モジュール、またはアカウントオーナーにお問い合わせください。
- 設定の管理権限が必要です — Relovaは設定下にあります。
- ソース接続の詳細（ホスト、ポート、データベース名、読み取り専用のユーザー名とパスワード）を用意してください。可能であれば、ソースに専用の読み取り専用アカウントを作成してください。
- ソースが自身のネットワーク内からの接続のみを受け入れる場合、それに到達できるホストへのSSHアクセスを用意してください（Relovaはそれを介してトンネルできます）。
ステップ1 — Relovaを開く
設定 → Relovaに移動します。概要タブには、接続、エラー、モジュールマッピング、仮想参照の4つのカウンターと、接続のリストが表示されます。タイトル下のタブストリップ（概要 · 接続 · マッピング · トリガー）で画面を移動します。
ステップ2 — 接続を追加する
接続タブを開き、新しい接続（右上、「+」ボタン）をクリックします。フォームに入力します:
- 接続名 — 認識しやすいラベル、例：「本番ERP」。
- データベースドライバー — MySQL / MariaDB、PostgreSQL、SQL Server、Oracle、SAP HANA、またはCSV / Excelファイル、またはREST API。フォームの残りの部分はこれに合わせて変更されます。
- ホスト、ポート、データベース、スキーマ — ソースのネットワークアドレス。ポートはドライバーから事前に入力されます。
- ユーザー名 / パスワード — 読み取り専用の認証情報。これらは保存前に暗号化され、二度と表示されません。編集時にパスワードを空白のままにすると、現在のパスワードが保持されます。
- スキーマキャッシュ — Relovaがテーブルと列のリストを再読み込みするまでに再利用できる時間（秒単位）。300（5分）が良いデフォルトです。0はキャッシュを無効にします。
- クエリモード — 仮想はすべてのビューでソースを読み込みます（最新）。スナップショットは、より高速なリストのために短期間のキャッシュコピーを保持します。オンデマンドは、誰かがレコードを開いたときにのみ読み込みます。
SSHトンネル（オプション）
ソースがプライベートネットワーク内からのみ到達可能な場合、SSHトンネルをオンにします。SSHホスト、ポート、ユーザーを指定し、秘密鍵（推奨）またはパスワードを貼り付けます。SSHホストを空白のままにすると、データベースホスト自体を介してトンネルします。
CSV / Excelソース
ファイルドライバーの場合、サーバー上のファイルへの絶対パスを指定し、区切り文字を選択します。ファイルはそのまま読み取られます — サーバーが常にアクセスできる場所（同期フォルダーなど）に配置してください。
接続ステータス
- 接続済み — 前回のチェックは成功しました。
- 劣化 — 到達可能ですが、低速または警告を返しています。
- エラー — 前回のチェックは失敗しました。接続を開いて原因を確認し、修正後に接続をテストを使用してください。
- 無効 — オフにしました。再有効化するまで、マッピングされたレコードは解決されません。
各行には、テスト、編集、有効化/無効化、削除があります。接続を削除すると、そのマッピングと生成されたすべての仮想参照も削除されます。
ステップ3 — ソースの参照（オプションですが便利です）
接続行からスキーマブラウザ（データベースアイコン）を選択します。接続を選択すると、Relovaは左側にそのテーブルを一覧表示します。テーブルをクリックすると、その列（名前、型、null許容、キー）が表示され、データプレビューをクリックすると最初の行が表示されます。これを使用して、ステップ4で必要となる正確なテーブル名と列名を見つけます。更新はスキーマを再読み込みし、キャッシュをクリアします。
ステップ4 — テーブルをモジュールにマッピングする
ここでは、リモート行がiTenanceレコードになります。マッピングタブを開き、新規マッピングをクリックします。
- 接続とソーステーブル — このマッピングにどのリモートテーブルが供給されるか。
- マッピング名 — 例：「ERP資産」。
- ターゲットモジュール — 機器/設備、部品、在庫、サプライヤー、場所。これにより、行が何になるかが決まります。
- 事業所 — マッピングを1つの事業所に限定するか、開いたままにするか。このマッピングから発行された作業指示書は、この事業所に登録されます。
- リモートキー列 — 各リモート行を一意に識別する列（通常は
id）。Relovaはこれを使用して、同期間で参照を安定させます。
列マッピング
入力したいフィールドごとにマッピングを追加をクリックします。ローカルフィールド（例：machine_name）と、それを供給するリモート列を選択します。*マークの付いたフィールドは必須です。これらがマッピングされるまで、モジュールはレコードを受け入れません。すべての必須フィールドがカバーされている場合、パネルに表示されます。
表示フィールド
レコードのスナップショットに表示されるべき列（リストやリモートレコードページに表示される値）にチェックを入れます。これは、人々が実際に確認する必要があるものに限定してください。
静的デフォルトと結合
デフォルト値を使用して、適切なリモートソースがない必須のローカル列を埋めます。例えば、固定のlocation_idや、このマッピングからのすべての行を1つのiTenanceマシンに固定するmachine_idなどです。データベースビューなしで関連するリモートテーブルから列をプルするには、結合を使用します。
同期動作
仮想 — 常にライブ。スナップショットキャッシュ — 設定したキャッシュTTL（分）で各行をキャッシュします。オンデマンド — 開かれたときにのみ読み取ります。変更検出列（例：updated_at）を追加すると、Relovaはテーブル全体ではなく、最後の同期以降に変更された行のみをフェッチできます。
リモートレコードとの共存
- リモートマシンは、リストや表示ページでは他のマシンと同様に見えますが、小さなバッジでリモートであることが示されます。
- ソースから取得されるフィールド（名前、モデル、シリアル番号、測定値）はiTenanceでは読み取り専用です。レコード上のソースから更新は最新の値をプルします。
- ローカルのみの関係 — 場所、メーカー、カテゴリ、事業所 — は関係を編集で設定され、iTenanceに保持されます。同期によって上書きされることはありません。
- リモートマシンに対しても、通常通り作業指示書の発行、タスクの追加、ダウンタイムの記録が可能です。
ステップ5 — 作業指示書を自動的に発行する（トリガー）
トリガータブを開き、新規ルールをクリックします。トリガーはマッピングの同期された行の1つのフィールドを監視し、値が条件を満たした瞬間に作業指示書を開きます。
- マッピングを監視 — どのマッピングの行を監視するか（これにより、作業指示書が登録される事業所も設定されます）。
- 名前 — このルールの目的、例：「ベアリング過熱」。
- フィールド — 同期されたスナップショットからの列（マッピングの表示フィールドからの候補については入力を開始）、例：
temperature。 - 演算子 — 上昇 / 下降 / 等しい / より大きい / テキストを含む / いずれか / 変化あり など。
- 値 — 比較する数値またはテキスト。「いずれか」はリストを受け取ります。「変化あり」は値を必要としません。
- 優先度 — 作成される作業指示書に割り当てられる優先度（低 / 通常 / 高 / 緊急）。
- クールダウン — ルールが発動後に静止する分数。これにより、しきい値付近を変動する値が重複を大量に作成するのを防ぎます。1440 = 1日。
- タイトル / 説明テンプレート — 作業指示書の文言。
{column_name}でリモート値を挿入します。例：ベアリング警告: {machine_name}で{temperature}°C。空白のままにすると、適切なデフォルトが適用されます。
セキュリティと分離
- 常に読み取り専用。Relovaは読み取り以外のステートメントをブロックします。INSERT、UPDATE、DELETE、またはソーススキーマの変更はできません。
- 認証情報は暗号化されます。保存時には、他のアプリケーションデータとは別のキーで暗号化され、ブラウザに返されることはありません。
- アウトバウンドリクエストは保護されています。Relovaは、オペレーターが明示的にホストを許可リストに追加しない限り、内部/ループバックアドレス範囲への接続を拒否します。これにより、内部インフラストラクチャへの接続が阻止されます。
- すべての接続、マッピング、およびリモート参照は、テナントのスコープ内にあります。あるテナントが別のテナントのRelovaデータを参照または照会することはできません。
- 行制限とクエリタイムアウトはすべてのパススルー読み取りに適用されるため、不正なマッピングによって無制限の結果セットが引き出されることはありません。
トラブルシューティング
接続テストがすぐに失敗する。
ホスト/ポートが間違っているか、ソースファイアウォールがiTenanceサーバーを許可していません。同じネットワークからデータベースクライアントで詳細を確認し、ソースがプライベートな場合はSSHトンネルを追加してください。
接続テストは問題ないが、リストが空である。
マッピングに必要なフィールドがカバーされていないか、ソースのテーブル名が間違っています。スキーマブラウザと照らし合わせてステップ4を再確認し、プレビューを使用してください。
「必要なフィールドはまだマッピングされていません」と表示される。
デフォルト値のないNOT-NULLローカル列がマッピングされていません。リモート列をそれにマッピングするか、デフォルト値を設定してください。
値が古いように見える。
マッピングがスナップショットモードになっています。キャッシュTTLを短くするか、変更検出列を追加するか、仮想に切り替えてください。レコード上でソースから更新を使用してください。
中央ドメインのRelovaに何も表示されない。
Relovaは常にテナントワークスペースから機能します。中央のサインインドメインではなく、通常のテナントアドレスから開いてください。