go語言中使用excel template生成報表

最近要實現一個生成excel的報表服務，具體要實現的報表樣子大概如下(暫時忽略樣式):

 

功能描述

如上圖所示，要實現這樣一個報表每一個sheet中按照周去展示，每一周中顯示對應的日、周、月、未執行的服務，並且標上執行人，而且對於不同時期的版本要記錄不同的sheet

如果對應程序的角度，每個sheet中要循環周數據，每一周中對應的服務要各自循環輸出每一個項目，對於單個excel文件要循環輸出多個sheet。

循環套循環…，考慮到如果有這樣一個模板文件支持特定標識符的內嵌，然后程序可以根據這些標識符輸出對應的excel，功能就實現了。

 

功能實現

在github中發現了這樣一個repo, github.com/ivahaev/go-xlsx-templater 的go語言實現庫

 

Simple .xlsx (Excel XML document) template based document generator using handlebars.

Takes input .xlsx documents with mustache sippets in it and renders new document with snippets replaced by provided context.

Thanks to github.com/tealeg/xlsx and github.com/aymerick/raymond for useful libs

 

可以看到里邊用到了 tealeg/xlsx 和  aymerick/raymod 這兩個包，第一個是go語言實現的excel庫，第二個是對於template的解析

具體的介紹可以去這兩個包對應的repo中了解，這里就不在描述了。

 

使用方式也很簡單

1. 預加載模板

2. 渲染(拷貝)

3. 輸出文件

doc := xlst.New()
doc.ReadTemplate("./template.xlsx")
doc.Render(ctx) 4 doc.Save("./report.xlsx")

要實現文中開始描述的報表功能還需要修改package的源碼，主要解決的問題是

• 當前的代碼template包不支持一個數據集合輸出多個sheet，當前支持的是按照模板文件中的sheet分別渲染。
• 當excel模板中cell設置了文字換行和高度自動適應時，輸出的excel報表中文字會被遮蓋。
• 不支持打印分隔符

// RenderMultipleSheet 輸出多個sheet
func (m *Xlst) RenderMultipleSheet(options *Options ,in ...InParam) error {
	if options == nil {
		options = new(Options)
	}
	report := xlsx.NewFile()
	//TODO: 模板中只考慮單個sheet
	for si, sheet := range m.file.Sheets {
		for idx,item:=range in{
			ctx := getCtx(item.In, si)
			if item.SheetName==""{
				report.AddSheet(fmt.Sprintf("Sheet%d",idx))
			}else{
				_,e:=report.AddSheet(item.SheetName)
				if e!=nil{
					fmt.Errorf("%+v",e)
				}
			}
			l:=len(report.Sheets)
			fmt.Printf("%d",l)
			cloneSheet(sheet, report.Sheets[idx])
			err := renderRows(report.Sheets[idx], sheet.Rows, ctx, options)
			if err != nil {
				return err
			}

			for _, col := range sheet.Cols {
				report.Sheets[idx].Cols = append(report.Sheets[idx].Cols, col)
			}
		}

	}
	m.report = report
	return nil
}

//xlst
// 高度自適應修改
//to.SetHeight(from.Height)

打印分隔符的支持，我參考了 360EntSecGroup-Skylar/excelize包的實現(對應 InsertBreakPage)，將打印分隔符相關的struct xml字段和方法遷移到了 tealeg/xlsx 庫中，東拼西湊的感覺。

 

type Sheet struct {
	Name        string
	File        *File
	Rows        []*Row
	Cols        []*Col
	MaxRow      int
	MaxCol      int
	Hidden      bool
	Selected    bool
	SheetViews  []SheetView
	SheetFormat SheetFormat
	AutoFilter  *AutoFilter
	// 加入 分頁符
	RowBreaks       *XlsxBreaks
	ColBreaks       *XlsxBreaks
}

 

我的模板文件:

 

結束語

 

開源社區有很多優秀的package，可能某個特定的package對自己所需要的功能實現的還不夠完整，那就自己嘗試着去改吧,這個過程也有助於自己去熟悉go語言。

 

 

For what it's worth,It's never too late.

 

 

轉載請標明出自:go語言中使用excel template生成報表