从表单导出数据

时间:2015-03-26 09:29:09

标签: django django-forms django-admin

我需要用户输入一些日期才能使用这些日期查询数据库,因此我按照these步骤进行操作,现在工作正常。我想要的是,除了显示响应中的数据之外,还能够将该数据导出到文件中。为此,我已经制作了表格,但我不知道如何继续。

我的问题是,我在哪里可以查阅有关如何从表单导出的文档?

视图

from django.shortcuts import render
from .forms import ContactForm

def filter_contracts(request):
    form = ContractForm(request.POST or None)
    contracts = None

    if request.method == 'POST':
        if form.is_valid():
                contracts = Contract.objects.filter(person__is_doctor=False,
                type_contract=Contract.FC,
                starting_date__gte=form.cleaned_data.get('starting_date'),
                ending_date__lte=form.cleaned_data.get('ending_date'))

    return render(request, 'your_template.html', {'form': form,
        'contracts': contracts})

形式

class ContractForm(forms.Form):

    starting_date    = forms.DateField()
    ending_date       = forms.DateField()

模板

{% extends "admin/base_site.html" %}
{% load i18n admin_urls admin_static admin_modify %}

{% block content %}
<form action="." enctype="db_personal/x-www-form-urlencoded" method="POST">>
    <ul>
        {{ form.as_ul }}
    </ul>
    {% csrf_token %}
    <button type="submit">Search</button>
    <br> 
    <hr>
    {% if contracts %}
    <table border ="1" cellspacing="0">
        <th>Person</th>
        <th>Contract type</th>
        <th>Starting date</th>
        <th>Ending date</th>
        {% for contract in contracts %}
        <tr>
            <td>{{ contract.person }}</td>
            <td>{{ contract.type_contract }}</td>
            <td>{{ contract.starting_date }}</td>
            <td>{{ contract.ending_date }}</td>
        </tr>
        {% endfor %}
    </table>
    {% endif %}
</form>
{% endblock %}

1 个答案:

答案 0 :(得分:2)

如果要将查询集结果作为HTML之外的其他内容返回,只需让您的视图以您选择的相应格式返回数据 - 这可以是csv,xml,json,yaml或纯文本。

请参阅Django文档中有关如何导出csv数据的示例:

Django文档还有一个页面如何导出PDF:

在您的视图中 - 处理完表单并查询数据库后 - 您应该设置响应的内容类型,以便浏览器知道它所期望的数据类型。您的格式化数据将进入响应正文。大多数浏览器只能显示HTML或纯文本,可能只显示XML,但只能将其他任何内容作为文件下载到用户的计算机上。

处理&#34;下载&#34;的示例代码按钮

第1步

forms.py中,添加其他表单以处理&#34;下载&#34;按钮:

from django import forms

class ContractForm(forms.Form):
    starting_date    = forms.DateField()
    ending_date       = forms.DateField()

class DownloadForm(forms.Form):
    starting_date = forms.CharField(widget=forms.HiddenInput)
    ending_date = forms.CharField(widget=forms.HiddenInput)

此表单包含2个隐藏字段 - 适用于starting_dateending_date。我们将根据初始搜索查询参数填充这些字段。

第2步

views.py中,添加代码以呈现DownloadForm(作为按钮):

from django.shortcuts import render
from .forms import ContractForm, DownloadForm

def filter_contracts(request):
    form = ContractForm(request.POST or None)
    contracts = None
    download_form = None

    if request.method == 'POST':
        if form.is_valid():
            starting_date = form.cleaned_data.get('starting_date')
            ending_date = form.cleaned_data.get('ending_date')
            contracts = Contract.objects.filter(person__is_doctor=False,
                                                type_contract=Contract.FC,
                                                starting_date__gte=starting_date,
                                                ending_date__lte=ending_date)
            # Create the DownloadForm instance here so you can pass it in the
            # context dict.
            download_form = DownloadForm(initial={
                'starting_date': starting_date,
                'ending_date': ending_date
            })

    return render(request, 'your_template.html',
                  {
                      'form': form,
                      'contracts': contracts,
                      'download_form': download_form
                  })

在实例化DownloadForm时,视图会将starting_dateending_date设置为表单的初始参数,因此当模板呈现时,它将在隐藏字段中包含查询参数。 (您可以使用浏览器进行确认。)

第3步

现在,修改模板以添加Download按钮表单(这是您在上一步中添加到视图中的DownloadForm实例):

{% extends "admin/base_site.html" %}
{% load i18n admin_urls admin_static admin_modify %}

{% block content %}

<form action="." enctype="db_personal/x-www-form-urlencoded" method="POST">
    <ul>
        {{ form.as_ul }}
    </ul>
    {% csrf_token %}
    <button type="submit">Search</button>
    <br> 
    <hr>
    {% if contracts %}
    <table border ="1" cellspacing="0">
        <th>Person</th>
        <th>Contract type</th>
        <th>Starting date</th>
        <th>Ending date</th>
        {% for contract in contracts %}
        <tr>
            <td>{{ contract.person }}</td>
            <td>{{ contract.type_contract }}</td>
            <td>{{ contract.starting_date }}</td>
            <td>{{ contract.ending_date }}</td>
        </tr>
        {% endfor %}
    </table>
    {% endif %}
</form>

{% if download_form %}
<form action="{% url 'download_data' %}"  method="POST">
    {% csrf_token %}
    {{ download_form.as_p }}
    <p>
        <input type="submit" class="btn" name="submit" value="Download" />
    </p>
</form>
{% endif %}

{% endblock %}

请注意,下载按钮的表单action使用名为download_data的已命名网址。您必须向urls.py添加新网址规则才能处理下载表单提交(请参阅下一步)。

第4步

urls.py添加新规则以处理下载表单提交。这将映射到我们要创建的新视图,以CSV格式返回所请求的数据:

from django.conf.urls import patterns, url

from .views import filter_contracts, download_data

urls = patterns(
    # url prefix
    '',

    # view to render search form
    url(r'^contracts/$', filter_contracts, name='search_contracts'),

    # view to handle data download
    url(r'^contracts/download/$', download_data, name='download_data')
)

您必须根据已设置的内容调整网址配置规则。以上只是一个指南和示例。

第5步

现在,在views.py中添加几个新视图来处理下载按钮提交和获取数据:

def get_csv_data(starting_date, ending_date):
    """
    Prepare data in csv format for download.
    * This is called by ``download_data`` to perform the query.
    * Do your query here and format the results as CSV using a csv
      writer or manually.
    * For this example, we're using some dummy data.
    """
    data = []
    num = 10
    for n in xrange(num):
        person = 'Person {}'.format(n + 1)
        type_contract = 'Some contract'
        start_date = starting_date
        end_date = ending_date
        data.append(', '.join([start_date, end_date, person, type_contract]))
    return '\n'.join(data)

def download_data(request):
    """
    Process a request to download data.
    * POST must contain 'starting_date' and 'ending_date'.
    """
    from django.http import HttpResponse

    try:
        assert request.method == 'POST'
        form = DownloadForm(request.POST)
        assert form.is_valid()
        starting_date = form.cleaned_data.get('starting_date')
        ending_date = form.cleaned_data.get('ending_date')
        assert starting_date and ending_date
        contracts = get_csv_data(starting_date, ending_date)
        assert contracts
    except AssertionError:
        error = 'Your request has some problems.'
        contracts = error

    attachment = 'contract_data.csv'
    response = HttpResponse(content_type='text/csv')
    response['Content-Disposition'] = 'attachment;filename="{}"'.format(attachment)
    response.write(contracts)
    return response

上面的get_csv_data函数只是准备一些虚拟数据进行测试的一个例子。您应该将数据库查询代码放在那里以获取所需的查询集,然后将数据格式化为CSV。 (示例函数手动格式化虚拟数据,但您应该使用csv模块来准备数据 - 请参阅本答案开头的Django示例链接。)

<强>摘要

基本理念是:

  • 当您从查询中呈现合同搜索结果时,您只需向页面添加其他DownloadForm实例。这仅显示为Download按钮,但它包含starting_dateending_date的隐藏字段。
  • 当用户点击Download按钮时,表单会提交到名为download_data的新视图,该视图会检查request.POST字典并提取starting_date和{{ 1}}。然后,它准备查询集数据并以CSV格式呈现。
  • ending_date视图会将响应作为附件返回,内容类型为download_data。用户的浏览器会自动将其作为下载文件处理。

代码中有最小的错误和安全检查,但这应该可以帮助您入门。