如何在报表中使用多级JSON
尽管FastReport.Net为我们提供了一个插件供报表设计者用作JSON文件的数据源,但它也并不是对所有人都合适的。此插件适用于表示单独表的单级数据。如果数据具有多个嵌套级别,则必须尝试其他解决方案。
例如,使用Newtonsoft.Json库——在它的帮助下,您可以从JSON获取数据,从中创建列表并在代码报告中注册它。
让我们来看一个例子。我们要创建一个WinForms应用程序。在NuGet Manager的帮助下,安装Newtonsoft.Json包。在参考“Reference”中,添加指向库FastReport.dll的链接。
假设我们有商店经营的销售数据。所有这些数据都在一个文件中,但事实上它们是三个不同的实体:商店,店长,导购。这将是我们这个例子的json文件:
{ "Shops": [{ "Name": "First shop", "Managers": [{ "Name": "John", "Phone": "45443446343", "Sales": [{ "GoodId": "1", "Amount": "3" }, { "GoodId": "2", "Amount": "5" }, { "GoodId": "3", "Amount": "2" } ] }, { "Name": "Boris", "Phone": "8787964387", "Sales": [{ "GoodId": "15", "Amount": "8" }, { "GoodId": "12", "Amount": "2" }, { "GoodId": "13", "Amount": "2" } ] } ] }, { "Name": "Second shop", "Managers": [{ "Name": "Julia", "Phone": "5555555555", "Sales": [{ "GoodId": "1", "Amount": "30" }] }, { "Name": "Helen", "Phone": "8787964387", "Sales": [{ "GoodId": "2", "Amount": "8" }, { "GoodId": "3", "Amount": "26" }, { "GoodId": "1", "Amount": "2" } ] } ] } ] }
要反序列化此数据,我们需要具有与JSON中的字段对应的属性对象。
当然,如果JSON文档具有非常深的嵌套,那么它可能会非常累人。因此,这里有一个优秀的Web服务//json2csharp.com/。您只需将有效的json放在输入字段中,按“Generate”按钮,然后获取现成的C#类。对于我们的json文档,将生成以下一组类:
public class Sale { public string GoodId { get; set; } public string Amount { get; set; } } public class Manager { public string Name { get; set; } public string Phone { get; set; } public List<Sale> Sales { get; set; } } public class Shop { public string Name { get; set; } public List<Manager> Managers { get; set; } } public class RootObject { public List<Shop> Shops { get; set; } }
让我们为它们创建一个单独的Sales.cs文件。
在表单中添加一个按钮。对于click事件,我们将创建一个处理程序:
private void RunBtn_Click(object sender, EventArgs e) { var json = JsonConvert.DeserializeObject<RootObject>(File.ReadAllText(@"Sales.json")); Report report = new Report(); report.RegisterData(json.Shops,"Shops"); report.Design(); }
如您所见,这里我们使用Newtonsoft.json库将json反序列化为RootObject,它具有属性Shops,这是一个商店列表。我们在报告中将此列表注册为数据源。并启用报表设计器“report designer”。使用单个按钮运行我们的应用程序并单击它。此时报表设计器显示空白报表。选择报告数据源:
根据此数据,创建报告模板:
如您所见,数据表“Data band”有一个子表,而该子表又有一个子数据表。
这些数据表上的数据根据数据源中的层次结构排列。运行报表:
这样,我们在Master-Detail报告中就获得了相关数据。我们不需要在表之间创建特殊关系来获取依赖关系。在JSON中大量嵌套数据的情况下,最好使用我们以上考虑的方法。