基于 oracle 的 flask 项目（三）——生成报表

摘要：本文主要讲解如何生成不同需求的报表。项目描述第一个页面，以和为关联，查询出本月职工的关联客户及客户的资产余额。建立上个月的虚字段。，二是利用函数来对初始化数据进行赋值的操作。提示注意的语法。权限为的用户只显示本人的相关信息。

曾经，因为对 sqlalchemy 不熟悉，固执的抛弃之，直接引入原生的 cx_Oracle 来生成报表，但是经过一堆的“上下文等”错误后，我幡然悔悟，还是回到了 sqlalchemy 的怀抱来。
认真学习 sqlalchemy，你会发现意想不到的惊喜。本文主要讲解如何生成不同需求的报表。

第一个页面，以 OusiStaff.phone 和 OusiGuest.staff_phone 为关联，查询出本月职工的关联客户及客户的资产余额。

第二个页面，以 OusiStaff.phone 和 OusiGuest.staff_phone 为关联，查询出每个职工所有关联的客户的本月资产、上月资产及本月管户资产增额。

具有管理员权限的员工可以看到本部门下面所有员工的相关信息，非管理员权限的员工只能查看自己的相关信息。

查询功能留给下一章详细讲解。

不在赘述。详情请下载代码查看。

第一个页面使用sqlalchemy查询比较简单，关键点是：

区分权限。

联表查询。

建立上个月的虚字段。

分页显示。

查询嵌套。

views.py 内容：

@show.route("/01", methods = ["GET", "POST"])
@login_required
def _01():
    g1 = aliased(OusiGuest) # 重复用到该数据库，需要设置别名。
    g2 = aliased(OusiGuest) # 重复用到该数据库，需要设置别名。
    page = request.args.get("page", 1, type=int) # 分页
    if current_user.role == "admin": # 区分权限
        database = db.session.query(OusiStaff.department, OusiStaff.name.label("staff_name"), OusiStaff.phone,
                                    OusiStaff.role,
                                    g1.name.label("guest_name"), g1.month, g1.balance,
                                    func.nvl(db.session.query(g2.balance).filter(
                                        g1.name == g2.name,
                                        func.to_date(g2.month, "yyyy-mm") == func.add_months(
                                            func.to_date(g1.month, "yyyy-mm"), -1)
                                    ), 0).label("last_balance")
                                    ).filter(
            OusiStaff.phone == g1.staff_phone, current_user.department == OusiStaff.department,
            g1.month == date.today().strftime("%Y-%m")
        ).order_by(g1.name).group_by(OusiStaff.department, OusiStaff.name.label("staff_name"), OusiStaff.phone,
                                     OusiStaff.role,
                                     g1.name.label("guest_name"), g1.month, g1.balance)
    else:
        database = db.session.query(OusiStaff.department, OusiStaff.name.label("staff_name"), OusiStaff.phone,
                                    OusiStaff.role,
                                    g1.name.label("guest_name"), g1.month, g1.balance,
                                    func.nvl(db.session.query(g2.balance).filter(
                                        g1.name==g2.name,
                                        func.to_date(g2.month, "yyyy-mm")==func.add_months(
                                            func.to_date(g1.month, "yyyy-mm"), -1)
                                    ), 0).label("last_balance")
                                    ).filter(
            OusiStaff.phone==g1.staff_phone, current_user.phone==g1.staff_phone,
            g1.month==date.today().strftime("%Y-%m")
            ).order_by(g1.name).group_by(OusiStaff.department, OusiStaff.name.label("staff_name"), OusiStaff.phone,
                                    OusiStaff.role,
                                    g1.name.label("guest_name"), g1.month, g1.balance)
    data = database.paginate(page, per_page=current_app.config["OUSI_POSTS_PER_PAGE"], error_out=False)

    return render_template("show/01.html", data=data)

其实，以上内容就是利用 sqlalchemy 的联表查询问题，将 OusiStaff 和 OusiGuest 以 phone 值为关联进行查询，然后将结果显示出来。

其中的难点一是利用 func.to_date 和 func.add_months 对上个月这个时间进行关联查询（凡是数据库支持的函数，在 sqlalchemy 中都可以使用 func 加函数名来操作。），二是利用 func.nvl 函数来对初始化数据进行赋值 0 的操作。 具体的 sqlalchemy 语法，请参见代码。

提示： 注意 sqlalchemy 的语法。 func.nvl(db.session.query(g2.balance).filter(g1.name==g2.name, func.to_date(g2.month, "yyyy-mm")==func.add_months(func.to_date(g1.month, "yyyy-mm"), -1)), 0).label("last_balance") ，这语句的主要是为了实现查询上个月的余额，如果查询不到，通过 oracle 的 nvl 函数设置为 0 。

权限为 admin 的用户显示本部门下所有员工的相关信息。

权限为 general 的用户只显示本人的相关信息。

第二页使用 sqlalchemy 查询稍微复杂点，关键点除了第一个页面的要求外还有：

使用 func.sum 对相关字段进行相加运算。

用到了子查询。

views.py 内容：

@show.route("/02", methods = ["GET", "POST"])
@login_required
def _02():
    page = request.args.get("page", 1, type=int)
    g1 = aliased(OusiGuest)
    g2 = aliased(OusiGuest)
    if current_user.role == "admin":
        sbq = db.session.query(OusiStaff.department, OusiStaff.role, OusiStaff.name.label("staff_name"),
                               g1.staff_phone, g1.name.label("guest_name"), g1.month, g1.balance,
                               func.nvl(db.session.query(g2.balance).filter(
                                   g1.name==g2.name,
                                   func.add_months(func.to_date(g1.month, "yyyy-mm"), -1) == func.to_date(g2.month,
                                                                                                          "yyyy-mm")
                                                                             ), 0).label("last_balance")).filter(
            OusiStaff.phone==g1.staff_phone,
            OusiStaff.department==current_user.department
        ).group_by(OusiStaff.department, OusiStaff.role, OusiStaff.name.label("staff_name"),
                               g1.staff_phone, g1.name.label("guest_name"), g1.month, g1.balance).subquery()
        database = db.session.query(sbq.c.department, sbq.c.role, sbq.c.staff_name, sbq.c.staff_phone,
                                    sbq.c.month, func.count(sbq.c.guest_name).label("members"),
                                    func.sum(sbq.c.balance).label("balance"), func.sum(sbq.c.last_balance).label("last_balance")).
            filter(sbq.c.month==date.today().strftime("%Y-%m")).group_by(sbq.c.department, sbq.c.role,
                                                                         sbq.c.staff_name, sbq.c.staff_phone,
                                                                         sbq.c.month)
    else:
        sbq = db.session.query(OusiStaff.department, OusiStaff.role, OusiStaff.name.label("staff_name"),
                               g1.staff_phone, g1.name.label("guest_name"), g1.month, g1.balance,
                               func.nvl(db.session.query(g2.balance).filter(
                                   g1.name == g2.name,
                                   func.add_months(func.to_date(g1.month, "yyyy-mm"), -1) == func.to_date(g2.month,
                                                                                                          "yyyy-mm")
                               ), 0).label("last_balance")).filter(
            OusiStaff.phone == g1.staff_phone,
            OusiStaff.phone == current_user.phone
        ).group_by(OusiStaff.department, OusiStaff.role, OusiStaff.name.label("staff_name"),
                   g1.staff_phone, g1.name.label("guest_name"), g1.month, g1.balance).subquery()
        database = db.session.query(sbq.c.department, sbq.c.role, sbq.c.staff_name, sbq.c.staff_phone,
                                    sbq.c.month, func.count(sbq.c.guest_name).label("members"),
                                    func.sum(sbq.c.balance).label("balance"),
                                    func.sum(sbq.c.last_balance).label("last_balance")). 
            filter(sbq.c.month == date.today().strftime("%Y-%m")).group_by(sbq.c.department, sbq.c.role,
                                                                           sbq.c.staff_name, sbq.c.staff_phone,
                                                                           sbq.c.month)
    data = database.paginate(page, per_page=current_app.config["OUSI_POSTS_PER_PAGE"], error_out=False)

    return render_template("show/02.html", data=data)

注意 query 的字段以及 group_by 里分组查询的字段。

权限为 admin 的用户显示本部门下所有员工的相关信息。

权限为 general 的用户只显示本人的相关信息。

源码下载

下节更精彩，将实现搜索查询功能，又是一堆 sqlalchemy 语句。