PeopleSoft应用技术系列——AWE——中级

AWE介绍

AWE简介 AWE框架介绍 AWE相关Record介绍 AWE相关对象详解 AWE部分过程介绍





绩效审批流的特点

AWE起源： AWE与WORKFLOW区别 AWE的特点
◦ 以良好的数据结构实现工作流定义和工作流实例的数据库表存储。 而不是通过文件方式存储。 ◦ 以预定义事件执行触发后台操作。 ◦ 用面向对象思想封装核心逻辑，让用户有机会继承并完善相关操作。 ◦ 提供了OnLine配置界面。

AWE通过配置事务处理触发一个邮件通知，此邮件通知通 过已经设定好的邮件模板以及相关参数进行构造 。

当你想绑定参数到一个邮件模板时，必须创建一个SQL对 象。

此SQL对象只允许返回一条记录。
%1: URL %2: SQL对象返回的第一列



%3: SQL对象返回的第二列
%2 SELECT A.EMPLID , %3 ,E.DESCR , ,A.WF_STATUS FROM PS_PWRD_PERF_HDR A ,PS_PERSON_NAME B ,PSOPRDEFN C ,PS_PERSON_NAME D ,PS_EO_TRANSACTIONS E WHERE A.EMPLID = B.EMPLID AND A.ORIGINATORID = C.OPRID AND C.EMPLID = D.EMPLID AND A.TRANSACTION_NAME = E.TRANSACTION_NAME AND A.PWRD_PERF_ID = :1



TAFAW_IDS是一个种子记录，用来创建AWE的一些关键 数字类型字段的值。 例如：交叉引用表中包含有一个数字类型的字段 PTAFTHREAD_ID，该值是为每一个新实例化的事务创建 的。引擎会使用PTAFAW_IDS.PTAFAWCOUNTER字段， 查找到相关的值，并根据下个事务进行递增。 stepinst以及userinst中的数字字段。 AWE后台表，不需要关注。绝对不允许对该表中的记录进 行update操作
通知事件表
通知用户列表 审批处理定义 审批处理阶段 审批处理路径 审批处理步骤 审批标准定义 用户输入审批标准定义 用户列表定义 审批实例步骤状态（保存每一个审批实例的每个步骤的 状态） 当前和历史审批步骤审批用户列表 审批计数器（记录某些关键数字字段的当前值）

在AWE的相关事务中要用到的一类需求就是头表。头表是 记录事务的最高一级记录。他上面的数据行和事务有着一 对一的对应关系。换句话说，一个被提交的事务对应的在 头表中只有一行记录。在HCM中自带的所有的审批过程 都是使用头行审批。


用户列表定义：用户列表主要用来定义系统在运行时应该 将工作流转给谁。用户列表是一段逻辑语句，允许的定义 有Role，SQL，Query, App Class。 Role:在运行的时候系统将会返回该角色下的所有用户 SQL:该SQL语句中一定要包含OPRID字段 Query:和SQL对象一样，需要包含OPRID字段 App Class:类中的GetUsers()方法用来返回一个包含有 OPRID的字符串类型的数组

AWE是根据一些特定的或者预定义的事件设计的。引擎允 许对PS应用程序类进行继承扩展，来满足自身应用的需要。
class expRpt_EvtHndlr extends HMAF_AWE:Wrapper:ApprovalEventHandler;
method OnProcessLaunch(&appInst As PTAF_CORE:ENGINE:AppInst);
method OnHeaderDeny(&userinst As PTAF_CORE:ENGINE:UserStepInst); method OnHeaderApprove(&appinst As PTAF_CORE:ENGINE:AppInst); method OnLineDeny(&userstep As PTAF_CORE:ENGINE:UserStepInst);

不设置LaunchManager类的definition 参数 &MyLaunchManager = Create LaunchManager (&AprPrcsId, &HeaderRecObject, &Oprid) /*Do not set the definition property as was done above*/ &MyLaunchManage.DoSubmit()
PTAFAW_NOTIFY
PTAFAW_NOT_USER PTAFAW_PRCS PTAFAW_STAGE PTAFAW_PATH PTAFAW_STEP PTAFCRTA PTAFCRTA_REC PTAFUSER_LIST PTAFAW_STEPINST PTAFAW_USERINST PTAFAW_IDS

必须为同一个ApproverManager
Class threadDescr extends PTAF_MONITOR:MONITOR:threadDescrBase method threadDescr();
method getThreadDescr(&keys As array of Field) Returns string;


审批用户信息试图：用来展示参与工作流的人员的附 加信息。当一个独立参与工作流审批的用户显示在审 批状态监视器上时，只是展示了一个OPRID。通过定 义一个视图，用户通过选择参与者的OPRID，AWE将 会将视图中列出的相关信息展示出来。 系统视图：HR_SS_APRNM:
SELECT A.OPRID, B.EMPLID, ST_NAME, B.FIRST_NAME FROM PSOPRDEFN A, PS_PERSON_NAME B WHERE A.EMPLID = B.EMPLID

特定访问类：同事件处理类一样，特定访问类允许每 一个应用程序对核心的逻辑进行扩展。通过创建一个 特定访问类，你可以控制什么时候一个用户被允许编 辑审批路径和参与人。
class adHocAccess extends PTAF_MONITOR:ADHOC_OBJECTS:adhocAccessLogicBase method adhocAccess ();
Method OnHeaderApprove &MyHdrRec = CreateRecord(Record.PWRD_PERF_HDR) ; &MyHdrRec.PWRD_PERF_ID.Value = &PERF_ID ; &MyHdrRec.SelectByKeys() ; &MyHdrRec.Status.Value = “A”; &MyHdrRec.Update() ; End-Method;
method allowInsert(&oprid As string, &stepBefore As PTAF_CORE:ENGINE:StepInst, &stepAfter As PTAF_CORE:ENGINE:StepInst) Returns boolean; method allowDelete(&oprid As string, &Step As PTAF_CORE:ENGINE:StepInst) Returns boolean;
用 户
触发AWE
API
DataBas e
调用 Event Handler
extends Event Handler
表名 PTAFAW_TXN PTAFAW_TXN_LVL PTAFAW_TXN_LBL EO_TRANSACTIONS PTAFAW_TXN_CFG
描述 审批事物处理注册表 交易级别表 级别关键字段标签表 事物交易表 配置事物处理表
method allowNewPath(&oprid As string, &stage As PTAF_CORE:ENGINE:StageInst) Returns boolean; end-class;

线程类用来控制在状态监视器上展示的内容。 通过扩展线程类可以修改默认的组框标题 ,链接文 本等。
method OnLineApprove(&appinst As PTAF_CORE:ENGINE:AppInst, &thread As PTAF_CORE:ENGINE:Thread);
method OnError(&stepinst As PTAF_CORE:ENGINE:StepInst);







&MyLaunchManager = Create LaunchManager (&AprPrcsId, &HeaderRecObject, &Oprid) ; &MyLauchManager.DoSubmit(); DoSubmit调用系统预定义方法执行事务处理匹配，生 成所有的审批阶段、审批路径和审批步骤。 DoSubmit调用系统预定义方法判断审批用户，生成下 一个审批用户记录。 DoSubmit执行Event Handler中的OnProcessLancher 方法。 DoSubmit调用预定义方法匹配邮件模版，生产邮件内 容。启动后台 邮件发送程序。 ···
method OnStepReassign(&userinst As PTAF_CORE:ENGINE:UserStepInst, &origApprover As string); method OnStepComplete(&stepinst As PTAF_CORE:ENGINE:StepInst); method OnStepPushback(&userinst As PTAF_CORE:ENGINE:UserStepInst); method OnFinalHeaderDeny(&appinst As PTAF_CORE:ENGINE:AppInst);