9. Path サービス

client.path() でアクセスします。資産またはタグの階層パス(サイト > 区域 > ライン > 設備)を一度の呼び出しで照会できます。

9.1 メソッド一覧

メソッド	戻り値の型	HTTP	エンドポイント
getByAsset(asset_id)	PathResponseV5 または null	GET	/api/v5/path/asset/{id}
getByTag(tag_id)	PathResponseV5 または null	GET	/api/v5/path/tag/{id}

9.2 PathResponseV5 DTO

フィールド	説明
site_id / site_name	所属サイト
area_id / area_name	区域
line_id / line_name	ライン
equipment_id / equipment_name	設備

レスポンスはサイトから始まります。企業はインストールごとに一つであるため、パスには含めません。

資産タイプによって、一部のフィールドは null の場合があります（例：Areaのみの資産は line_*、equipment_* がすべて null）。

9.3 使用例

設備の全パス

import plantpulse.api.v5.dto.response.PathResponseV5;

PathResponseV5 path = client.path().getByAsset("EQUIPMENT_000001");
if (path != null) {
    System.out.printf("%s > %s > %s > %s%n",
        path.getSite_name(),
        path.getArea_name(),
        path.getLine_name(),
        path.getEquipment_name());
}

出力例：

대전 1공장 > 조립구역 > 1라인 > CNC #1

タグの資産パス

PathResponseV5 tagPath = client.path().getByTag("TAG_EDGE_00303_90007");
if (tagPath != null) {
    System.out.println("태그가 부착된 설비: " + tagPath.getEquipment_name());
    System.out.println("라인: " + tagPath.getLine_name());
}

パス文字列作成ユーティリティ

static String formatPath(PathResponseV5 p) {
    if (p == null) return "(경로 없음)";
    StringBuilder sb = new StringBuilder();
    if (p.getSite_name()      != null) sb.append(p.getSite_name());
    if (p.getArea_name()      != null) sb.append(" > ").append(p.getArea_name());
    if (p.getLine_name()      != null) sb.append(" > ").append(p.getLine_name());
    if (p.getEquipment_name() != null) sb.append(" > ").append(p.getEquipment_name());
    return sb.toString();
}

9.4 活用シナリオ

シナリオ — アラーム発生資産のパス表示

import plantpulse.api.v5.dto.response.AlarmResponseV5;

for (AlarmResponseV5 a : client.alarm().list(20)) {
    // AlarmResponseV5 에 tag_location 필드가 이미 있지만
    // 더 구조화된 경로가 필요하면 Path 서비스로 재조회
    if (a.getTag_id() != null) {
        PathResponseV5 path = client.path().getByTag(a.getTag_id());
        System.out.printf("[%s] %s @ %s%n",
            a.getPriority(),
            a.getDescription(),
            formatPath(path));
    }
}

次のステップ

• Asset サービス — 資産階層の直接操作
• Alarm サービス — アラーム発生資産の追跡