在本节的内容中，我们将会继续以职位管理系统为例，来逐步讲解一些DjangoAdmin的高级功能。

数据分页展示

首先，我们需要在已有的项目中创建一个interview的应用。

  1. python3 manage.py startapp interview

接下来，我们定义models.py文件如下：

  1. from django.db import models
  2. from django.contrib.auth.models import User
  4. from jobs.models import DEGREE_TYPE
  6. # 第一轮面试结果
  7. FIRST_INTERVIEW_RESULT_TYPE = ((u'建议复试', u'建议复试'), (u'待定', u'待定'), (u'放弃', u'放弃'))
  9. # 复试面试建议
  10. INTERVIEW_RESULT_TYPE = ((u'建议录用', u'建议录用'), (u'待定', u'待定'), (u'放弃', u'放弃'))
  12. # HR终面结论
  13. HR_SCORE_TYPE = (('S', 'S'), ('A', 'A'), ('B', 'B'), ('C', 'C'))
  15. class Candidate(models.Model):
  16.     # 基础信息
  17.     userid = models.IntegerField(unique=True, blank=True, null=True, verbose_name=u'应聘者ID')
  18.     username = models.CharField(max_length=135, verbose_name=u'姓名')
  19.     city = models.CharField(max_length=135, verbose_name=u'城市')
  20.     phone = models.CharField(max_length=135, verbose_name=u'手机号码')
  21.     email = models.EmailField(max_length=135, blank=True, verbose_name=u'邮箱')
  22.     apply_position = models.CharField(max_length=135, blank=True, verbose_name=u'应聘职位')
  23.     born_address = models.CharField(max_length=135, blank=True, verbose_name=u'生源地')
  24.     gender = models.CharField(max_length=135, blank=True, verbose_name=u'性别')
  25.     candidate_remark = models.CharField(max_length=135, blank=True, verbose_name=u'候选人信息备注')
  27.     # 学校与学历信息
  28.     bachelor_school = models.CharField(max_length=135, blank=True, verbose_name=u'本科学校')
  29.     master_school = models.CharField(max_length=135, blank=True, verbose_name=u'研究生学校')
  30.     doctor_school = models.CharField(max_length=135, blank=True, verbose_name=u'博士生学校')
  31.     major = models.CharField(max_length=135, blank=True, verbose_name=u'专业')
  32.     degree = models.CharField(max_length=135, choices=DEGREE_TYPE, blank=True, verbose_name=u'学历')
  34.     # 综合能力测评成绩，笔试测评成绩
  35.     test_score_of_general_ability = models.DecimalField(decimal_places=1, null=True, max_digits=3, blank=True,
  36.                                                         verbose_name=u'综合能力测评成绩')
  37.     paper_score = models.DecimalField(decimal_places=1, null=True, max_digits=3, blank=True, verbose_name=u'笔试成绩')
  39.     # 第一轮面试记录
  40.     first_score = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True, verbose_name=u'初试分',
  41.                                       help_text=u'1-5分，极优秀: >=4.5，优秀: 4-4.4，良好: 3.5-3.9，一般: 3-3.4，较差: <3分')
  42.     first_learning_ability = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True,
  43.                                                  verbose_name=u'学习能力得分')
  44.     first_professional_competency = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True,
  45.                                                         verbose_name=u'专业能力得分')
  46.     first_advantage = models.TextField(max_length=1024, blank=True, verbose_name=u'优势')
  47.     first_disadvantage = models.TextField(max_length=1024, blank=True, verbose_name=u'顾虑和不足')
  48.     first_result = models.CharField(max_length=256, choices=FIRST_INTERVIEW_RESULT_TYPE, blank=True,
  49.                                     verbose_name=u'初试结果')
  50.     first_recommend_position = models.CharField(max_length=256, blank=True, verbose_name=u'推荐部门')
  51.     first_interviewer_user = models.ForeignKey(User, related_name='first_interviewer_user', blank=True, null=True, on_delete=models.CASCADE, verbose_name=u'面试官')
  53.     first_remark = models.CharField(max_length=135, blank=True, verbose_name=u'初试备注')
  55.     # 第二轮面试记录
  56.     second_score = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True, verbose_name=u'专业复试得分',
  57.                                        help_text=u'1-5分，极优秀: >=4.5，优秀: 4-4.4，良好: 3.5-3.9，一般: 3-3.4，较差: <3分')
  58.     second_learning_ability = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True,
  59.                                                   verbose_name=u'学习能力得分')
  60.     second_professional_competency = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True,
  61.                                                          verbose_name=u'专业能力得分')
  62.     second_pursue_of_excellence = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True,
  63.                                                       verbose_name=u'追求卓越得分')
  64.     second_communication_ability = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True,
  65.                                                        verbose_name=u'沟通能力得分')
  66.     second_pressure_score = models.DecimalField(decimal_places=1, null=True, max_digits=2, blank=True,
  67.                                                 verbose_name=u'抗压能力得分')
  68.     second_advantage = models.TextField(max_length=1024, blank=True, verbose_name=u'优势')
  69.     second_disadvantage = models.TextField(max_length=1024, blank=True, verbose_name=u'顾虑和不足')
  70.     second_result = models.CharField(max_length=256, choices=INTERVIEW_RESULT_TYPE, blank=True, verbose_name=u'专业复试结果')
  71.     second_recommend_position = models.CharField(max_length=256, blank=True, verbose_name=u'建议方向或推荐部门')
  72.     second_interviewer_user = models.ForeignKey(User, related_name='second_interviewer_user', blank=True, null=True, on_delete=models.CASCADE, verbose_name=u'二面面试官')
  73.     second_remark = models.CharField(max_length=135, blank=True, verbose_name=u'专业复试备注')
  75.     # HR终面
  76.     hr_score = models.CharField(max_length=10, choices=HR_SCORE_TYPE, blank=True, verbose_name=u'HR复试综合等级')
  77.     hr_responsibility = models.CharField(max_length=10, choices=HR_SCORE_TYPE, blank=True, verbose_name=u'HR责任心')
  78.     hr_communication_ability = models.CharField(max_length=10, choices=HR_SCORE_TYPE, blank=True,
  79.                                                 verbose_name=u'HR坦诚沟通')
  80.     hr_logic_ability = models.CharField(max_length=10, choices=HR_SCORE_TYPE, blank=True, verbose_name=u'HR逻辑思维')
  81.     hr_potential = models.CharField(max_length=10, choices=HR_SCORE_TYPE, blank=True, verbose_name=u'HR发展潜力')
  82.     hr_stability = models.CharField(max_length=10, choices=HR_SCORE_TYPE, blank=True, verbose_name=u'HR稳定性')
  83.     hr_advantage = models.TextField(max_length=1024, blank=True, verbose_name=u'优势')
  84.     hr_disadvantage = models.TextField(max_length=1024, blank=True, verbose_name=u'顾虑和不足')
  85.     hr_result = models.CharField(max_length=256, choices=INTERVIEW_RESULT_TYPE, blank=True, verbose_name=u'HR复试结果')
  86.     hr_interviewer_user = models.ForeignKey(User, related_name='hr_interviewer_user', blank=True, null=True, on_delete=models.CASCADE, verbose_name=u'HR面试官')
  87.     hr_remark = models.CharField(max_length=256, blank=True, verbose_name=u'HR复试备注')
  89.     creator = models.CharField(max_length=256, blank=True, verbose_name=u'候选人数据的创建人')
  90.     created_date = models.DateTimeField(auto_now_add=True, verbose_name=u'创建时间')
  91.     modified_date = models.DateTimeField(auto_now=True, null=True, blank=True, verbose_name=u'更新时间')
  92.     last_editor = models.CharField(max_length=256, blank=True, verbose_name=u'最后编辑者')
  94.     class Meta:
  95.         db_table = 'candidate'
  96.         verbose_name = '应聘者'
  97.         verbose_name_plural = '应聘者'
  99.     def __str__(self):
  100.         return self.username

可以看到，这个Candidate对象中包括了大量的属性字段。

同时，我们在Candidate类内，又定义了一个Meta类，其中包含db_table、verbose_name和verbose_name_plural三个属性。

这些其实也都是Django框架内定义的一些特殊变量，分别表示对应的数据库表的名称，数据库表在Web页面上显示的名称，数据库表的复数形式。

__str__是Python3的类中的一个特殊含义的函数，它表示将对象转换成str类型时，得到的string字符串的值。

下面，我们定义admin.py文件如下：

  1. from django.contrib import admin
  2. from interview.models import Candidate
  4. # 候选人管理类
  5. class CandidateAdmin(admin.ModelAdmin):
  6.     exclude = ('creator', 'created_date', 'modified_date')
  7.     list_display = (
  8.         'username', 'city', 'bachelor_school','get_resume', 'first_score', 'first_result', 'first_interviewer_user', 'second_score',
  9.         'second_result', 'second_interviewer_user', 'hr_score', 'hr_result', 'hr_interviewer_user',)
  11. admin.site.register(Candidate, CandidateAdmin)

同时，我们还需要在全局settings.py的INSTALL_APPS中增加interview这个应用。

接下来，我们需要初始化数据库：

  1. python3 ./manage.py makemigrations
  2. python3 ./manage.py migrate

此时，再次进入admin管理页面，可以点击”应聘者” +号来添加一个用户。

DjangoAdmin高级用法 - 图1

在添加应聘者页面中，你应该会看到有一个巨大无比的表单，这个表单看起来就非常的令人头痛，我们需要对这个表单进行分组和优化管理来使得大家在使用过程中没有那么痛苦。

我们需要扩展admin.py文件，在CandidateAdmin类中增加fieldsets属性，示例如下：

  1. from django.contrib import admin
  2. class CandidateAdmin(admin.ModelAdmin):
  3.     fieldsets = (
  4.         (None, {"fields": ("userid", "username", "email")}),
  5.         ("第一轮面试", {"fields": ("first_score", "first_advantage")}),
  6.         ("第二轮面试", {"fields": ("second_score", "second_advantage")}),
  7.         ("第三轮面试", {"fields": ("hr_score", "hr_advantage")}),
  8.     )

其中，fieldsets是表示字段分组的方式，本身是一个元组，元组中的每一个元素表示一个字段块。

每个fieldset又是由一个元组组成，元组的第一个元素表示分组名称，第二个元素是一个字典信息，包含一个fields字段，里面是属于当前块的字段。

此时，我们已经将所有字段都进行了分组显示，但是查看表单，我们会发现像用户名这种输入内容很短的字段，也需要占用一行，导致整体页面过长，这种显示方法并不合适。

因此，我们需要再次进行优化，将多个字段合并至同一行。

例如，我们希望将username和email合并成为一行：

  1. from django.contrib import admin
  2. class CandidateAdmin(admin.ModelAdmin):
  3.     fieldsets = (
  4.         (None, {"fields": ("userid", ("username", "email"))}),
  5.         ("第一轮面试", {"fields": ("first_score", "first_advantage")}),
  6.         ("第二轮面试", {"fields": ("second_score", "second_advantage")}),
  7.         ("第三轮面试", {"fields": ("hr_score", "hr_advantage")}),
  8.     )

Ps: 我们只需要将”username”, “email”再次用一个元组进行包围即可。

扩展命令行支持批量导入数据

虽然我们对管理页面进行了各种优化，但是仍然存在着大量的输入字段，因此从Web页面逐个添加用户仍然有着较大的成本。

因此，我们需要能够支持通过excel进行大量的数据导入，接下来，我们需要扩展admin工具来支持批量的excel数据导入。

在Django框架中，有一个management commands的机制，它可以扩展命令行功能来满足个性化的需求。

首先，我们首先需要创建management/commands目录，并在该目录下创建import_candidates.py文件：

  1. import csv
  2. from django.core.management import BaseCommand   # 命令行扩展的基类
  3. from interview.models import Candidate
  6. class Command(BaseCommand):
  7.     help = '从一个CSV文件的内容中读取候选人列表，导入到数据库中'  # 帮助信息
  8.     def add_arguments(self, parser):
  9.         # 接收一个--path的参数
  10.         parser.add_argument('--path', type=str)
  12.     def handle(self, *args, **kwargs):   # handle函数编写具体的处理逻辑
  13.         path = kwargs['path']
  14.         with open(path, 'rt', encoding="gbk") as f:
  15.             reader = csv.reader(f, dialect='excel', delimiter=';')
  16.             for row in reader:
  17.                 candidate = Candidate.objects.create(
  18.                     username=row[0],
  19.                     city=row[1],
  20.                     phone=row[2],
  21.                     bachelor_school=row[3],
  22.                     major=row[4],
  23.                     degree=row[5],
  24.                     test_score_of_general_ability=row[6],
  25.                     paper_score=row[7]
  26.                 )
  27.                 print(candidate)

此时，我们只需要执行如下命令即可实现批量上传数据：

  1. python manage.py import_candidates --path /path/to/your/file.csv

列表支持筛选和查询

当我们导入大量的候选人后，我们会发现从候选人列表中查询指定特征的候选人变的非常难，因此，我们需要对候选人列表支持搜索、过滤和排序。

这些功能都可以借助Django的Admin的相关配置来快速实现，下面我们来看看应该怎么做把！

依旧是修改admin.py文件中的CandidateAdmin类，增加如下属性：

  1. class CandidateAdmin(admin.ModelAdmin):
  2.     # 右侧筛选条件
  3.     list_filter = ('city','first_result','second_result','hr_result','first_interviewer_user','second_interviewer_user','hr_interviewer_user')
  5.     # 支持通用查询字段
  6.     search_fields = ('username', 'phone', 'email', 'bachelor_school')
  8.     ### 列表页默认排序字段
  9.     ordering = ('hr_result','second_result','first_result')

可以看到，我们可以：

  1. list_filter增加筛选条件
  2. search_fields增加可搜索条件
  3. ordering添加字段默认排序规则