You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

6.0 KiB

Raw Blame History Unescape Escape

鉴权服务器与报表能量显示迁移说明

更新时间：2026-06-25

这份文档记录两项未必已经提交到仓库的手工修改，后续迁移到另一个版本项目时按这里的内容对照修改。

1. 鉴权服务器地址

新的鉴权/API 服务器地址：

http://8.141.12.31:80/api/v1/

迁移时检查启动项目配置文件：

Txgy.EWS.Client.Start/App.config

确认 api_domain 使用新地址：

<add key="api_domain" value="http://8.141.12.31:80/api/v1/" />

登录接口仍按现有代码拼接：

{api_domain}login/login

也就是：

http://8.141.12.31:80/api/v1/login/login

注意：WPF 编译后运行时实际读取的是输出目录中的 Txgy.EWS.Client.Start.exe.config。如果只改源码 App.config，需要重新编译，确保输出配置同步更新。

2. 报表页能量显示

目标：在报表页面查询结果区域显示：

事件总数
中等能量事件数
总能量
平均能量
最大能量

涉及文件：

Txgy.EWS.Client.PageModule/ViewModels/ReportViewModel.cs
Txgy.EWS.Client.PageModule/Views/ReportView.xaml

2.1 ReportViewModel 增加绑定属性

在 SearchCount 属性附近增加三个属性：

private double _totalEnergy = 0;

public double TotalEnergy
{
    get { return _totalEnergy; }
    set
    {
        SetProperty(ref _totalEnergy, value);
    }
}

private double _averageEnergy = 0;

public double AverageEnergy
{
    get { return _averageEnergy; }
    set
    {
        SetProperty(ref _averageEnergy, value);
    }
}

private double _maxEnergy = 0;

public double MaxEnergy
{
    get { return _maxEnergy; }
    set
    {
        SetProperty(ref _maxEnergy, value);
    }
}

2.2 查询后更新能量统计

在 SearchEvents(...) 方法中，查询结果列表全部构建完成后，原来通常会有：

SearchCount = results.Count;
return results;

改成：

SearchCount = results.Count;
UpdateEnergyStats(results);
return results;

然后在 SearchEvents(...) 方法后增加：

private void UpdateEnergyStats(List<GridItemEventResult> results)
{
    if (results == null || results.Count == 0)
    {
        TotalEnergy = 0;
        AverageEnergy = 0;
        MaxEnergy = 0;
        return;
    }

    TotalEnergy = Math.Round(results.Sum(rs => rs.Energy), 2);
    AverageEnergy = Math.Round(results.Average(rs => rs.Energy), 2);
    MaxEnergy = Math.Round(results.Max(rs => rs.Energy), 2);
}

前提：ReportViewModel.cs 已经有 using System.Linq; 和 using System;。当前项目已有这两个引用。

2.3 ReportView.xaml 增加显示区域

原页面查询按钮区域下方已有“事件总数 / 中等能量事件”显示。迁移时可以把那段替换为下面这段，或者在原有区域后追加三个能量字段。

推荐替换片段：

<StackPanel Grid.Row="1"
            Grid.ColumnSpan="3"
            VerticalAlignment="Center"
            Orientation="Horizontal">
    <TextBlock VerticalAlignment="Center"
               Text="事件总数："
               FontSize="16" />
    <TextBlock VerticalAlignment="Center"
               d:Text="11142"
               Foreground="Black"
               Text="{Binding SearchCount}"
               FontSize="16" />
    <TextBlock Margin="10,0,0,0"
               Text="中等能量事件："
               FontSize="16" />
    <TextBlock d:Text="1000"
               Foreground="Black"
               FontSize="16"
               Text="{Binding MiddleEventCount}" />
    <TextBlock Margin="20,0,0,0"
               Text="总能量："
               FontSize="16" />
    <TextBlock Foreground="Black"
               FontSize="16"
               FontWeight="SemiBold"
               Text="{Binding TotalEnergy, StringFormat={}{0:F0}J}" />
    <TextBlock Margin="20,0,0,0"
               Text="平均能量："
               FontSize="16" />
    <TextBlock Foreground="Black"
               FontSize="16"
               FontWeight="SemiBold"
               Text="{Binding AverageEnergy, StringFormat={}{0:F0}J}" />
    <TextBlock Margin="20,0,0,0"
               Text="最大能量："
               FontSize="16" />
    <TextBlock Foreground="Black"
               FontSize="16"
               FontWeight="SemiBold"
               Text="{Binding MaxEnergy, StringFormat={}{0:F0}J}" />
</StackPanel>

如果目标版本页面布局空间不足，可以使用 WrapPanel 避免文字挤出：

<WrapPanel Grid.Row="1"
           Grid.ColumnSpan="3"
           VerticalAlignment="Center">
    <TextBlock Text="事件总数：" FontSize="16" />
    <TextBlock Width="60"
               Foreground="Black"
               FontWeight="SemiBold"
               Text="{Binding SearchCount}"
               FontSize="16" />
    <TextBlock Text="中等能量事件：" FontSize="16" />
    <TextBlock Width="60"
               Foreground="Black"
               FontWeight="SemiBold"
               Text="{Binding MiddleEventCount}"
               FontSize="16" />
    <TextBlock Text="总能量：" FontSize="16" />
    <TextBlock Width="80"
               Foreground="Black"
               FontWeight="SemiBold"
               Text="{Binding TotalEnergy, StringFormat={}{0:F0}J}"
               FontSize="16" />
    <TextBlock Text="平均能量：" FontSize="16" />
    <TextBlock Width="80"
               Foreground="Black"
               FontWeight="SemiBold"
               Text="{Binding AverageEnergy, StringFormat={}{0:F0}J}"
               FontSize="16" />
    <TextBlock Text="最大能量：" FontSize="16" />
    <TextBlock Width="80"
               Foreground="Black"
               FontWeight="SemiBold"
               Text="{Binding MaxEnergy, StringFormat={}{0:F0}J}"
               FontSize="16" />
</WrapPanel>

2.4 验证点

迁移后至少验证：

项目能通过 MSBuild 编译。
报表页点击“查询”后，事件总数 正常变化。
总能量 / 平均能量 / 最大能量 能随查询结果更新。
查询结果为空时，三个能量统计显示为 0J。

6.0 KiB Raw Blame History Unescape Escape