工作框架各种使用整理---服务状态变更数据

<moqui.basic.StatusFlow statusFlowId="Zc3plDefault_Product" statusTypeId="Product" description="Default status flow for 3pl services across entire system."/>
    <moqui.basic.StatusFlowItem statusFlowId="Zc3plDefault_Product" statusId="ProductOpen" isInitial="Y"/>
    <moqui.basic.StatusFlowItem statusFlowId="Zc3plDefault_Product" statusId="ProductOnShelf"/>
    <moqui.basic.StatusFlowItem statusFlowId="Zc3plDefault_Product" statusId="ProductOffShelf"/>
    <moqui.basic.StatusFlowItem statusFlowId="Zc3plDefault_Product" statusId="ProductClosed"/>
    <moqui.basic.StatusFlowTransition statusFlowId="Zc3plDefault_Product" statusId="ProductOpen" toStatusId="ProductOnShelf" transitionName="Process"/>
    <moqui.basic.StatusFlowTransition statusFlowId="Zc3plDefault_Product" statusId="ProductOnShelf" toStatusId="ProductOffShelf" transitionName="Process"/>
    <moqui.basic.StatusFlowTransition statusFlowId="Zc3plDefault_Product" statusId="ProductOffShelf" toStatusId="ProductClosed" transitionName="Process"/>

<service verb="update" noun="ProductStatus">
        <in-parameters>
            <parameter name="productId" required="true"/>
            <parameter name="statusId" required="true"/>
            <parameter name="placedDate" type="Timestamp"/>
        </in-parameters>
        <out-parameters><parameter name="oldStatusId"/><parameter name="statusChanged" type="Boolean"/></out-parameters>
        <actions>
            <entity-find entity-name="mantle.product.Product" list="productList">
                <econdition field-name="productId" from="productId"/></entity-find>
            <set field="updateMap" from="[productId:productId, statusId:statusId]"/>
            <if condition="placedDate != null">
                <script>updateMap.put('placedDate', placedDate)</script>
            </if>
            <service-call name="update#mantle.product.Product" out-map="context" in-map="updateMap"/>
        </actions>
    </service>

<service verb="get" noun="ProductFieldChangeAuditLog">
        <in-parameters>
            <parameter name="productId"/>
            <parameter name="fieldName" default-value="statusId"/>
        </in-parameters>
        <out-parameters>
            <parameter name="auditLogList" type="List"><parameter name="auditLog" type="Map">
                <parameter name="oldValueText"/><parameter name="newValueText"/><parameter name="changedDate"/><parameter name="changeByUserId"/>
            </parameter></parameter>
        </out-parameters>
        <actions>
            <!--TODO: do more authorization checking -->

            <entity-find entity-name="moqui.entity.EntityAuditLog" list="auditLogList">
                <econdition-object field="[changedEntityName:'mantle.product.Product', changedFieldName:fieldName, pkPrimaryValue:productId]"/>
                <select-field field-name="oldValueText"/>
                <select-field field-name="newValueText"/>
                <select-field field-name="changedDate"/>
                <select-field field-name="changedByUserId"/>
            </entity-find>
        </actions>
    </service>

以上即为服务状态变更以及变更状态记录查询的方法。

在Moqui中如果要使用AutidLog来记录首先要将enable_audit_log=true

<?xml version="1.0" encoding="UTF-8"?>
<entities xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:noNamespaceSchemaLocation="http://moqui.org/xsd/entity-definition-2.0.xsd">
    <extend-entity entity-name="Product" package="mantle.product">
        <field name="statusId" type="id" enable-audit-log="true"/>
    </extend-entity>
</entities>

update模式用于传递所有的主键或自己期望的非主键字段。如果实体有一个statusID字段并且传入的statusId和字段值不同，那么服务会自动返回原始值放在oldStatusId出参中，无论何时实体有一个statusId字段，服务都还将返回一个boolean类型的statusChanged参数，如果状态和数据库的原始值不一样那么该字段为true反之为false，实体自动服务会通过检查匹配的moqui.basic.StatusFlowTransition存在记录，去执行有效的状态变化。如果没有有效的状态变化，那么服务将返回一个错误。