如何进行基于R12 Business Event+Workflow的分析

这篇文章将为大家详细讲解有关如何进行基于R12 Business Event+Workflow的分析，文章内容质量较高，因此小编分享给大家做个参考，希望大家阅读完这篇文章后对相关知识有一定的了解。

今天做了个Business events + Workflow 的例子，记录一下。

功能描述：

当表中新增一条INVOICE信息，自动触发Business events, 然后调用Workflow，发Notification 给审批者审批。

主要目的是测试Business events 的功能，学习一下。

测是测通了，但做完后，发觉并没有了解Business events的优势，因为这样的功能，完全可以在记录新增时直接调用Workflow来处理，感觉系统标准的Business events也无非是在某个操作完成后，触发一个Events，来完成后继的操作，就算有延迟处理（Defer）的功能，似乎我们也可通过database job 来实现，订阅（Subscriptions）功能也似乎可以写Package来实现不同的业务逻辑的分支处理。

如果有TX看到我的困惑，请不吝赐教！

下面是例子的详细步骤。

1．  建立客户化表

Notification的定义如下：

注意Performer的定义，即为接收人

上传Workflow并注册至系统

Event subscription 的定义

注意，Phase 定义在100以下的为即时处理

注意： PL/SQL Rule Function 里为客制化的程序，用来完成Event 信息的保存和Event的初始化

Workflow Type 里既为上面开发的Workflow, Process 为里面唯一的 create or replace package body c_customer_invoice_pkg is

  --用来生成测试数据及调用Events

  procedure insert_data is

    l_invoice_id number;

  begin

    select c_apps.c_customer_invoice_s.nextval into l_invoice_id from dual;

    --Insert 数据
    --3137为我的user id，此为测试方便，直接用。

    insert into c_apps.c_customer_invoices_all

      (invoice_id,

       invoice_date,

       invoice_amount,

       submit_id,

       submit_date,

       approval_id,

       approval_date,

       approval_memo,

       approval_status)

    values

      (l_invoice_id, sysdate, 1000, 3137, sysdate, null, null, null, null);

    commit;

    --调用过程启动Event

    raise_event(l_invoice_id, 3137);

  end insert_data;

  --用来启动Event

  PROCEDURE raise_event(pi_invoice_id in NUMBER, pi_submit_id in NUMBER) is

    l_parameter_list wf_parameter_list_t := wf_parameter_list_t();

    l_parameter_t    wf_parameter_t := wf_parameter_t(null, null);

    l_event_key      NUMBER;

    l_event_data     varchar2(300);

    l_message varchar2(10);

  BEGIN

    --用invoice id 做为event key

    l_event_key := pi_invoice_id;

    --定义event的参数  

    l_parameter_t.setName('INVOICE_ID');

    l_parameter_t.setVALUE(pi_invoice_id);

    l_parameter_list.extend;

    l_parameter_list(1) := l_parameter_t;

    l_parameter_t.setName('SUBMIT_ID');

    l_parameter_t.setVALUE(pi_submit_id);

    l_parameter_list.extend;

    l_parameter_list(2) := l_parameter_t;

    --启动  

    wf_event.raise(p_event_name => 'oracle.apps.c_apps.invoice.approval',

                   p_event_key  => l_event_key,

                   --p_event_data => l_event_data,

                   p_parameters => l_parameter_list);

    commit;

    l_parameter_list.DELETE;   

  END raise_event;

  --此过程设置在Subscription的rule function中,用来往表中写入Event信息  

  FUNCTION rule_function(p_subscription in RAW,

                         p_event        in out NOCOPY WF_EVENT_T)

    return varchar2 is

    l_rule            VARCHAR2(20);

    l_parameter_list  wf_parameter_list_t := wf_parameter_list_t();

    l_parameter_t     wf_parameter_t := wf_parameter_t(null, null);

    i_parameter_name  l_parameter_t.name%type;

    i_parameter_value l_parameter_t.value%type;

    i                 pls_integer;

    l_invoice_id l_parameter_t.value%type;

    l_submit_id  l_parameter_t.value%type;

  BEGIN

    if p_event.geteventname() = 'oracle.apps.c_apps.invoice.approval' then

      --获取Event的参数

      l_parameter_list := p_event.getParameterList();

      if l_parameter_list is not null then

        i := l_parameter_list.FIRST;

        --获取参数的值

        while (i <= l_parameter_list.LAST) loop

          i_parameter_name  := null;

          i_parameter_value := null;

          i_parameter_name  := l_parameter_list(i).getName();

          i_parameter_value := l_parameter_list(i).getValue();

          if i_parameter_name is not null then

            if i_parameter_name = 'INVOICE_ID' then

              l_invoice_id := i_parameter_value;

            elsif i_parameter_name = 'SUBMIT_ID' then

              l_submit_id := i_parameter_value;

            end if;

          end if;

          i := l_parameter_list.NEXT(i);

        end loop;

      end if;

      --写入Event表

      insert into c_apps.c_customer_invoice_events

        (event_id,

         event_name,

         event_key,

         event_data,

         event_date,

         invoice_id,

         submit_id)

      values

        (c_apps.c_customer_invoice_event_s.nextval,

         p_event.getEventName,

         p_event.getEventKey,

         p_event.getEventData,

         sysdate,

         l_invoice_id,

         l_submit_id);

      --调用系统标准的Event rule

      l_rule := wf_rule.default_rule(p_subscription, p_event);

    end if;

    return('SUCCESS');

  EXCEPTION

    WHEN OTHERS THEN

      wf_core.context('c_customer_invoice_pkg',

                      'rule_function',

                      p_event.geteventname(),

                      p_subscription);

      wf_event.seterrorinfo(p_event, 'ERROR');

      RETURN 'ERROR';

  END rule_function;

  --用于Workflow,取得submit/approval的人员信息及发票信息

  PROCEDURE get_submit_info(itemtype  IN VARCHAR2,

                            itemkey   IN VARCHAR2,

                            actid     IN NUMBER,

                            funcmode  IN VARCHAR2,

                            resultout OUT NOCOPY VARCHAR2) is

    l_invoice_id     NUMBER;

    l_invoice_amount NUMBER;

    l_invoice_date   date;

    l_orig_system wf_roles.orig_system%TYPE := 'PER';

    l_submit_id           NUMBER;

    l_submit_name         wf_roles.NAME%TYPE;

    l_submit_display_name wf_roles.display_name%TYPE;

    l_approval_id           NUMBER;

    l_approval_name         wf_roles.NAME%TYPE;

    l_approval_display_name wf_roles.display_name%TYPE;

  begin

    IF (funcmode <> wf_engine.eng_run) THEN

      resultout := wf_engine.eng_null;

      RETURN;

    END IF;

    l_invoice_id := wf_engine.getitemattrnumber(itemtype => itemtype,

                                                itemkey  => itemkey,

                                                aname    => 'INVOICE_ID');

    l_submit_id := wf_engine.getitemattrnumber(itemtype => itemtype,

                                               itemkey  => itemkey,

                                               aname    => 'SUBMIT_ID');

    wf_directory.GetRoleName(p_orig_system    => l_orig_system,

                             p_orig_system_id => l_submit_id,

                             p_name           => l_submit_name,

                             p_display_name   => l_submit_display_name);

    wf_engine.setitemattrtext(itemtype => itemtype,

                              itemkey  => itemkey,

                              aname    => 'SUBMIT_NAME',

                              avalue   => l_submit_name);

    wf_engine.setitemattrtext(itemtype => itemtype,

                              itemkey  => itemkey,

                              aname    => 'SUBMIT_DSP_NAME',

                              avalue   => l_submit_display_name);

    wf_directory.GetRoleName(p_orig_system    => l_orig_system,

                             p_orig_system_id => l_submit_id,

                             p_name           => l_approval_name,

                             p_display_name   => l_approval_display_name);

    wf_engine.setitemattrnumber(itemtype => itemtype,

                                itemkey  => itemkey,

                                aname    => 'APPROVAL_ID',

                                avalue   => l_submit_id);

    wf_engine.setitemattrtext(itemtype => itemtype,

                              itemkey  => itemkey,

                              aname    => 'APPROVAL_NAME',

                              avalue   => l_approval_name);

    wf_engine.setitemattrtext(itemtype => itemtype,

                              itemkey  => itemkey,

                              aname    => 'APPROVAL_DSP_NAME',

                              avalue   => l_approval_display_name);

    select invoice_amount, invoice_date

      into l_invoice_amount, l_invoice_date

      from c_apps.c_customer_invoices_all

     where invoice_id = l_invoice_id;

    wf_engine.setitemattrnumber(itemtype => itemtype,

                                itemkey  => itemkey,

                                aname    => 'INVOICE_AMOUNT',

                                avalue   => l_invoice_amount);

    wf_engine.SetItemAttrDate(itemtype => itemtype,

                              itemkey  => itemkey,

                              aname    => 'INVOICE_DATE',

                              avalue   => l_invoice_date);

    resultout := 'COMPLETE';

  EXCEPTION

    when others then

      wf_core.context('C_CUSTOMER_INVOICE_PKG',

                      'get_submit_info',

                      itemtype,

                      itemkey,

                      TO_CHAR(actid),

                      funcmode,

                      SQLERRM);

      raise;

  end get_submit_info;

  --用于Workflow的审批分支

  PROCEDURE invoice_approval(itemtype  IN VARCHAR2,

                             itemkey   IN VARCHAR2,

                             actid     IN NUMBER,

                             funcmode  IN VARCHAR2,

                             resultout OUT NOCOPY VARCHAR2) is

    l_invoice_id    NUMBER;

    l_approval_memo c_apps.c_customer_invoices_all.approval_memo%TYPE;

    l_approval_id   NUMBER;

  begin

    IF (funcmode <> wf_engine.eng_run) THEN

      resultout := wf_engine.eng_null;

      RETURN;

    END IF;

    l_invoice_id := wf_engine.getitemattrnumber(itemtype => itemtype,

                                                itemkey  => itemkey,

                                                aname    => 'INVOICE_ID');

    l_approval_id := wf_engine.getitemattrnumber(itemtype => itemtype,

                                                 itemkey  => itemkey,

                                                 aname    => 'APPROVAL_ID');

    l_approval_memo := wf_engine.getitemattrtext(itemtype => itemtype,

                                                 itemkey  => itemkey,

                                                 aname    => 'APPROVAL_MEMO');

    UPDATE c_apps.c_customer_invoices_all

       SET approval_id     = l_approval_id,

           approval_date   = sysdate,

           approval_memo   = l_approval_memo,

           approval_status = 'Y'

     WHERE invoice_id = l_invoice_id;

    resultout := 'COMPLETE';

  EXCEPTION

    when others then

      wf_core.context('C_CUSTOMER_INVOICE_PKG',

                      'invoice_approval',

                      itemtype,

                      itemkey,

                      TO_CHAR(actid),

                      funcmode,

                      SQLERRM);

      raise;

  end invoice_approval;

  --用于Workflow的拒绝分支

  PROCEDURE invoice_reject(itemtype  IN VARCHAR2,

                           itemkey   IN VARCHAR2,

                           actid     IN NUMBER,

                           funcmode  IN VARCHAR2,

                           resultout OUT NOCOPY VARCHAR2) is

    l_invoice_id    NUMBER;

    l_approval_memo c_apps.c_customer_invoices_all.approval_memo%TYPE;

    l_approval_id   NUMBER;

  begin

    IF (funcmode <> wf_engine.eng_run) THEN

      resultout := wf_engine.eng_null;

      RETURN;

    END IF;

    l_invoice_id := wf_engine.getitemattrnumber(itemtype => itemtype,

                                                itemkey  => itemkey,

                                                aname    => 'INVOICE_ID');

    l_approval_id := wf_engine.getitemattrnumber(itemtype => itemtype,

                                                 itemkey  => itemkey,

                                                 aname    => 'APPROVAL_ID');

    l_approval_memo := wf_engine.getitemattrtext(itemtype => itemtype,

                                                 itemkey  => itemkey,

                                                 aname    => 'APPROVAL_MEMO');

    UPDATE c_apps.c_customer_invoices_all

       SET approval_id     = l_approval_id,

           approval_date   = sysdate,

           approval_memo   = l_approval_memo,

           approval_status = 'N'

     WHERE invoice_id = l_invoice_id;

    resultout := 'COMPLETE';

  EXCEPTION

    when others then

      wf_core.context('C_CUSTOMER_INVOICE_PKG',

                      'invoice_reject',

                      itemtype,

                      itemkey,

                      TO_CHAR(actid),

                      funcmode,

                      SQLERRM);

      raise;

  end invoice_reject;

end c_customer_invoice_pkg;

最后在PL/SQL中执行

BEGIN

   c_customer_invoice_pkg.insert_data;

end;

查看Event表，记录生成，进入系统，发现Notification已经收到，可以正常审批！

关于如何进行基于R12 Business Event+Workflow的分析就分享到这里了，希望以上内容可以对大家有一定的帮助，可以学到更多知识。如果觉得文章不错，可以把它分享出去让更多的人看到。