如何以编程方式创建django ViewFlow进程

时间:2015-02-26 04:02:41

标签: python django workflow django-viewflow

概要

我正在开发一个学习Django的Web应用程序(python 3.4& Django 1.6.10)。 Web应用程序具有复杂且经常更新的工作流程。我决定集成Django-Viewflow库(https://github.com/viewflow/viewflow/),因为它似乎是处理工作流的一种非常方便的方式,而不是将工作流逻辑与应用程序模型结合在一起。

在这种情况下,我创建了一个工作流程,使用Django-Viewflow库收集作者信息和版权。每次将作者添加到书籍时都应启动工作流程。

我的问题

该文档提供了逐步指导,以集成端到端的工作流解决方案(前端和后端)。我的问题是我很难以编程方式控制工作流程(特别是从Book模型)。

申请说明

我有一个与作者有多对多关系的书模型(核心模型)。

对myApp / models.py

class Book(models.Model):
    title = models.CharField(max_length=100)
    authors = models.ManyToManyField(Author)
    publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField()

工作流程组件是:

myFlow / models.py

from viewflow.models import Process

class AuthorInvitation(process)     
    consent_confirmed = models.BooleanField(default=False)
    signature = models.CharField(max_length=150) 

myFlow / flows.py

from viewflow import flow
from viewflow.base import this, Flow
from viewflow.contrib import celery
from viewflow.views import StartProcessView, ProcessView
from . import models, tasks

class AuthorInvitationFlow(Flow):
    process_cls = models.AuthorInvitation

    start = flow.Start(StartProcessView) \
        .Permission(auto_create=True) \
        .Next(this.notify)

    notify = celery.Job(tasks.send_authorship_request) \
        .Next(this.approve)

    approve = flow.View(ProcessView, fields=["confirmed","signature"]) \
        .Permission(auto_create=True) \
        .Next(this.check_approve)

    check_approve = flow.If(cond=lambda p: p.confirmed) \
        .OnTrue(this.send) \
        .OnFalse(this.end)

    send = celery.Job(tasks.send_authorship) \
        .Next(this.end)

    end = flow.End()

问题

如何以编程方式控制工作流程(激活,确认步骤,重做步骤,取消流程......)?我试图深入研究图书馆的代码。似乎class activate包含正确的方法,但不确定整体应该如何协调。

提前致谢!

3 个答案:

答案 0 :(得分:12)

Flows还有两个额外的Start内置任务

StartFunction - 当函数调用某处时启动流程:

@flow_start_func
def create_flow(activation, **kwargs):
    activation.prepare()
    activation.done()
    return activation

class FunctionFlow(Flow):
    start = flow.StartFunction(create_flow) \
        .Next(this.end)

# somewhere in the code
FunctionFlow.start.run(**some_kwargs)

StartSignal - 开始关于django信号接收的流程:

class SignalFlow(Flow):
    start = flow.StartSignal(some_signal, create_flow) \      
        .Next(this.end)

您可以在this viewflow test suite中检查它们的使用情况和剩余的内置任务。

要手动处理任务状态,首先应该从数据库中获取任务,激活它,然后调用任何激活方法。

task  = MyFlow.task_cls.objects.get(...)
activation = task.activate()
if  activation.undo.can_proceed():
    activation.undo()

任何激活转换都有.can_proceed()方法,可帮助您检查,是否处于允许转换状态的任务。

答案 1 :(得分:1)

我需要能够手动或以编程方式启动流实例。基于上面对StartFunction的引用,我最终得到的模型如下所示:

class MyRunFlow(flow.Flow):
    process_class = Run

    start = flow.Start(ProcessCreate, fields=['schedule']). \
        Permission(auto_create=True). \
        Next(this.wait_data_collect_start)
    start2 = flow.StartFunction(process_create). \
        Next(this.wait_data_collect_start)

请注意,重要的一点是process_create具有Process对象,并且此代码必须通过字段规范以ProcessCreate编程方式设置手动表单提交所执行的相同字段:< / p>

@flow_start_func
def process_create(activation: FuncActivation, **kwargs):
    #
    # Update the database record.
    #
    db_sch = Schedule.objects.get(id=kwargs['schedule'])
    activation.process.schedule = db_sch # <<<< Same fields as ProcessCreate
    activation.process.save()
    #
    # Go!
    #
    activation.prepare()
    activation.done()
    return activation

请注意activation内的flow_start_func子类是FuncActivation,它具有prepare()和save()方法。 kwargs来自运行调用,类似于:

start_node = <walk the flow class looking for nodes of type StartFunction>
activation = start_node.run(schedule=self.id)

答案 2 :(得分:0)

手动启动:

from viewflow import flow
from viewflow.base import this, Flow
from .models import CIE
from viewflow import frontend
from django.utils.decorators import method_decorator

@frontend.register
class CIE(Flow):
    process_class = CIE
    start = flow.StartFunction(this.create_flow).Next(this.end)
    end = flow.End()

    @method_decorator(flow.flow_start_func)
    def create_flow(self, activation):
        activation.prepare()
        activation.done()
        return activation

之后公开rpc:

from modernrpc.core import rpc_method
from flow.flows import CIE

    @rpc_method
    def start():
        CIE.start.run()