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

PeopleSoft人力资源管理系统AWE介绍AWE简介AWE框架介绍AWE相关Record介绍AWE相关对象详解AWE部分过程介绍绩效审批流的特点内容概要AWE起源：AWE与WORKFLOW区别AWE的特点以良好的数据结构实现工作流定义和工作流实例的数据库表存储。而不是通过文件方式存储。以预定义事件执行触发后台操作。用面向对象思想封装核心逻辑，让用户有机会继承并完善相关操作。提供了OnLine配置界面。AWE简介AWE框架介绍API用户触发AWEDataBaseEventHandlerEventHandlerextends调用8.49PToolsAWE相关Record表名描述PTAFAW_TXN审批事物处理注册表PTAFAW_TXN_LVL交易级别表PTAFAW_TXN_LBL级别关键字段标签表EO_TRANSACTIONS事物交易表PTAFAW_TXN_CFG配置事物处理表PTAFAW_NOTIFY通知事件表PTAFAW_NOT_USER通知用户列表PTAFAW_PRCS审批处理定义PTAFAW_STAGE审批处理阶段PTAFAW_PATH审批处理路径PTAFAW_STEP审批处理步骤PTAFCRTA审批标准定义PTAFCRTA_REC用户输入审批标准定义PTAFUSER_LIST用户列表定义PTAFAW_STEPINST审批实例步骤状态（保存每一个审批实例的每个步骤的状态）PTAFAW_USERINST当前和历史审批步骤审批用户列表PTAFAW_IDS审批计数器（记录某些关键数字字段的当前值）AWE相关对象详解在AWE的相关事务中要用到的一类需求就是头表。头表是记录事务的最高一级记录。他上面的数据行和事务有着一对一的对应关系。换句话说，一个被提交的事务对应的在头表中只有一行记录。在HCM中自带的所有的审批过程都是使用头行审批。头表中一般包含一个用于标识工作流状态的字段。比如：WF_STATUS。此字段跟AWE事物没有关系。HeaderRecord交叉引用表简单的来说是一个记录，包含有PTAFAW_XREF_SBR以及HeadRecord的关键字段。交叉引用表仅仅是有AWE来使用，不参与事务处理。应用程序不需要从该记录中获取任何的值，并且要注意的是不能对该表中的记录进行update操作，AWE通过该表将自身和事务进行关联（Thread_id，Prcs_id,Defn_id）。

CrossReferenceRecordTAFAW_IDS是一个种子记录，用来创建AWE的一些关键数字类型字段的值。例如：交叉引用表中包含有一个数字类型的字段PTAFTHREAD_ID，该值是为每一个新实例化的事务创建的。引擎会使用PTAFAW_IDS.PTAFAWCOUNTER字段，查找到相关的值，并根据下个事务进行递增。stepinst以及userinst中的数字字段。AWE后台表，不需要关注。绝对不允许对该表中的记录进行update操作

PTAFAW_IDSPTAFAW_IDSAWE是根据一些特定的或者预定义的事件设计的。引擎允许对PS应用程序类进行继承扩展，来满足自身应用的需要。EventHandlerclassexpRpt_EvtHndlrextendsHMAF_AWE:Wrapper:ApprovalEventHandler; methodOnProcessLaunch(&appInstAsPTAF_CORE:ENGINE:AppInst); methodOnStepReassign(&userinstAsPTAF_CORE:ENGINE:UserStepInst,&origApproverAsstring); methodOnStepComplete(&stepinstAsPTAF_CORE:ENGINE:StepInst); methodOnStepPushback(&userinstAsPTAF_CORE:ENGINE:UserStepInst); methodOnFinalHeaderDeny(&appinstAsPTAF_CORE:ENGINE:AppInst);EventHandler

methodOnHeaderDeny(&userinstAsPTAF_CORE:ENGINE:UserStepInst); methodOnHeaderApprove(&appinstAsPTAF_CORE:ENGINE:AppInst); methodOnLineDeny(&userstepAsPTAF_CORE:ENGINE:UserStepInst); methodOnLineApprove(&appinstAsPTAF_CORE:ENGINE:AppInst,&threadAsPTAF_CORE:ENGINE:Thread); methodOnError(&stepinstAsPTAF_CORE:ENGINE:StepInst);EventHandlerMethodOnHeaderApprove&MyHdrRec=CreateRecord(Record.PWRD_PERF_HDR);&MyHdrRec.PWRD_PERF_ID.Value=&PERF_ID;&MyHdrRec.SelectByKeys();&MyHdrRec.Status.Value=“A”;&MyHdrRec.Update();End-Method;EventHandler特定访问类：同事件处理类一样，特定访问类允许每一个应用程序对核心的逻辑进行扩展。通过创建一个特定访问类，你可以控制什么时候一个用户被允许编辑审批路径和参与人。AdhocAcessClassclassadHocAccessextendsPTAF_MONITOR:ADHOC_OBJECTS:adhocAccessLogicBasemethodadhocAccess();methodallowInsert(&opridAsstring,&stepBeforeAsPTAF_CORE:ENGINE:StepInst,&stepAfterAsPTAF_CORE:ENGINE:StepInst)Returnsboolean;methodallowDelete(&opridAsstring,&StepAsPTAF_CORE:ENGINE:StepInst)Returnsboolean;methodallowNewPath(&opridAsstring,&stageAsPTAF_CORE:ENGINE:StageInst)Returnsboolean;end-class;AdhocAcessClass线程类用来控制在状态监视器上展示的内容。通过扩展线程类可以修改默认的组框标题,链接文本等。必须为同一个ApproverManagerThreadClassClassthreadDescrextendsPTAF_MONITOR:MONITOR:threadDescrBasemethodthreadDescr();methodgetThreadDescr(&keysAsarrayofField)Returnsstring;methodgetWorklistDescr(&recApplicationAsRecord)Returnsstring;methodgetUserName(&OprIdasString)Returnsstringend-class;ThreadClass假如要想用户通过使用邮件协作框架收取到的邮件内直接对事务进行审批，便要通过EmailApprovalsFormGeneratorClass来实现参考EmailCollaborationFramework开发手册，怎样构造returnEFM()方法EmailApproverFormGeneratorClass审批用户信息试图：用来展示参与工作流的人员的附加信息。当一个独立参与工作流审批的用户显示在审批状态监视器上时，只是展示了一个OPRID。通过定义一个视图，用户通过选择参与者的OPRID，AWE将会将视图中列出的相关信息展示出来。系统视图：HR_SS_APRNM: SELECTA.OPRID,B.EMPLID,B.LAST_NAME,B.FIRST_NAME FROMPSOPRDEFNA,PS_PERSON_NAMEB WHEREA.EMPLID=B.EMPLIDApproverUserInfoViewAWE通过配置事务处理触发一个邮件通知，此邮件通知通过已经设定好的邮件模板以及相关参数进行构造。EmailTemplatesEmailTemplates当你想绑定参数到一个邮件模板时，必须创建一个SQL对象。

此SQL对象只允许返回一条记录。%1:URL%2:SQL对象返回的第一列%3:SQL对象返回的第二列EmailTemplateSQLObjectSELECTA.EMPLID,B.NAME,E.DESCR,D.NAME,A.WF_STATUSFROMPS_PWRD_PERF_HDRA,PS_PERSON_NAMEB,PSOPRDEFNC,PS_PERSON_NAMED,PS_EO_TRANSACTIONSEWHEREA.EMPLID=B.EMPLIDANDA.ORIGINATORID=C.OPRIDANDC.EMPLID=D.EMPLIDANDA.TRANSACTION_NAME=E.TRANSACTION_NAMEANDA.PWRD_PERF_ID=:1EmailTemplateSQLObject%2%3用户列表定义：用户列表主要用来定义系统在运行时应该将工作流转给谁。用户列表是一段逻辑语句，允许的定义有Role，SQL，Query,AppClass。Role:在运行的时候系统将会返回该角色下的所有用户SQL:该SQL语句中一定要包含OPRID字段Query:和SQL对象一样，需要包含OPRID字段AppClass:类中的GetUsers()方法用来返回一个包含有OPRID的字符串类型的数组UserListDefinitionUserListDefinitionRegisterTransactioin（注册事物处理）将审批事物和HCMTransactionName进行关联跟委派有关系WorkflowTransaction（工作流事物处理）配置事务处理:配置事务处理组件用来选择并定义谁来触发通知，谁来收取通知和通知内容的元素ConfigureTransaction（配置事物处理）ConfigureTransaction（配置事物处理）设置处理定义：在设置处理定义页面，将会为一个事务维护一到多个处理定义。可以为每个处理定义多个阶段，路径，和步骤。另外，还可以为定义一些约束条件，通过这些约束条件，AWE将会自动检测哪个处理，哪条路径，哪个步骤被用到审批规则中。有两种方式告诉AWE流程从那个审批处理开始： 设置LaunchManager类的definition参数 不设置LaunchManager类的definition参数SetupProcessDefinitions设置LaunchManager类的definition参数&MyLaunchManager=CreateLaunchManager(&AprPrcsId,&HeaderRecObject,&Oprid)&MyLaunchManager.Definition=&MyAprDefnId;&MyLauchManager.DoSubmit()SetupProcessDefinitions不设置LaunchManager类的definition参数&MyLaunchManager=CreateLaunchManager(&AprPrcsId,&HeaderRecObject,&Oprid)/*Donotsetthedefinitionpropertyaswasdoneabove*/&MyLaunchManage.DoSubmit()SetupProcessDefinitions&MyLaunchManager=CreateLaunchManager(&AprPrcsId,&HeaderRecObject,&Oprid); &MyLauchManager.DoSubmit();DoSubmit调用系统预定义方法执行事务处理匹配，生成所有的审批阶段、审