django下載Excel，使用django-excel插件

　　由於目前的資料多是使用pandas或xlwt庫實現的。其實沒有那么的麻煩，因為django有相對應的插件django-excel。

　　該插件是依賴於pyexcel庫寫的。不過，不用專門安裝pyexcel庫，因為在安裝django-excel時會自動將pyexcel裝上。由於pyexcel是一個大庫，且在使用django-excel時不用考慮pyexcel的使用方法，所以就不再此介紹太多了。在此，還是要多說一句，pyexcel的功能也是很強大的，可以實現數據的可視化，目前已開發出了與flask、django等web框架的對應插件，比如今天介紹的django-excel。

　　django-excel是一款支持上傳和下載excel文件的插件，並可以將excel文件以網頁的形式展現出來，也可以將數據存入數據庫。由於，筆者也是剛接觸該插件，而且開發需求目前僅為下載功能，所以本篇只介紹其下載的功能。（注：實現下載功能，部署的服務器無需安裝office）

1、 安裝

　　pip install django-excel

　　安裝時會自動安裝pyexcel-io、pyexcel、pyexcel-webio

　　pyexcel-xlsx需另外單獨安裝。否則在下載時會報：OSError: No content, file name. Nothing is given的錯誤。

2、 支持django的版本

　　目前已支持到django2.1.1版本。所以，使用目前django最新版的開發者也不用擔心了，因為它支持。

3、 實現下載

　　該插件支持的數據格式很多，array（二維數組）、字典、數據庫的表（單張或多張）、django的ORM查詢結果（query sqt）等等。可以生成的文件類型：csv、tsv、csvz、tsvz、xls、xlsx、xlsm、ods。

包名	支持的文件格式	依賴	Python版本
pyexcel-io	csv, csvz , tsv, tsvz		2.6, 2.7, 3.3, 3.4, 3.5, 3.6 pypy
pyexcel-xls	xls, xlsx(只讀), xlsm(只讀)	xlrd, xlwt	同上
pyexcel-xlsx	xlsx	openpyxl	同上
pyexcel-ods3	ods	pyexcel-ezodf, lxml	2.6, 2.7, 3.3, 3.4 3.5, 3.6
pyexcel-ods	ods	odfpy	同上

 

 

 

 

 

 

 

 

 

上表是生成對應文件格式所需安裝的包。

　　如果是要使用二維數組生成excel文件，則需return django_excel.make_response_from_array(二維數組名, 生成的文件類型, status=200)。二維數組每一行代表Excel中相應的行。

　　如果想要使用字典生成excel文件，則需return django_excel.make_response_from_dict(字典名, 文件類型， status=200)。鍵名為列名，鍵值為數據。

　　如果想要使用數據庫的表（單張）生成excel文件，則需return django_excel.make_response_from_a_table(表名, 文件類型， status=200)

　　如果想要使用數據庫的表（多張）生成excel文件，則需return django_excel.make_response_from_tables(表名列表, 文件類型status=200)

　　如果想要使用查詢集合生成excel文件，則需return django_excel.make_response_from_query_sets(查詢集合名, 所需列對應字段（列表類型）,文件類型， status=200)。所需列對應字段的列表里的順序為Excel列名的順序，且列表里的元素必須為model里的變量名。

　　所有函數的通用參數包含file_name 和sheet_name，分別為文件名和Excel的工作薄名。

　　注意，不論是數據庫表還是查詢集合，都不能包含外鍵否則會報錯，而且只能通過頁面的跳轉實現下載，不能通過ajax請求，否則不會下載。

eg:

models.py

class django_test_1(models.Model):
    abc = models.CharField(max_length=20,db_column='測試')

 

views.py

import django_excel as excel

def download_excel(request):

    data_excel =django_test_1.objects.all()

    column_names = ["abc"]

    return excel.make_response_from_query_sets(data_excel,column_names, "xlsx",status = 200 ,sheet_name='測試',file_name='測試文件')

 

這是Xsan自己編寫的函數，將pandas中的dataframe數據轉換成django-excel中的sheet參數

# 將dataform轉換成django-excel下載是的sheet
def dataframe_to_down_excel_data(dataframe, row_name=None):
    '''
    dataframe:需要生成Excel的數據，dataframe類型
    row_name：自定義Excel列名，默認是dataframe的列名
    '''
    if row_name == None:
        row_name = list(dataframe.columns)
    sheet = dataframe.values
    sheet = sheet.tolist()
    sheet.insert(0,row_name)
    return sheet

 

生成下載多sheet文件，可以通過make_response_from_book_dict。

import django_excel as excel

def download_excel(request):
    book_dict = {
        'sheet1': [[1,2,3,4],
                     [3,4,5,6],
                     [2,4,5,6]],
        'sheet2': [[7,87,9,9],
                   [3,5,7,8,99]]
    }
　　file_names = '下載'
   return excel.make_response_from_book_dict(book_dict,"xlsx", status=200, file_name=file_names)

其中，sheet1，sheet2為sheet名。

以上僅為筆者目前的見解，沒有寫全。如果感興趣可以直接閱讀其官方文檔：http://django.pyexcel.org/en/latest/