ApacheOFBiz的相关介绍以及使用总结（三）

Ofbiz中还提供了一些基础性服务，可以直接用来使用，下面就简单介绍说明一下。

 

ofbiz邮件发送服务

 

ofbiz中提供发送邮件相关功能：sendMailFromScreen

 

context.get(“userLogin”)，可以拿到当前登录用户的所有信息，其中的属性 userLoginId用户登录ID，可以用于获取用户登录的相应信息。

 

 

 

发送邮件的过程中出现了错误，提示进行连接[e-mail]，怀疑是由于连接的问题。

 

可以参考页面：

 

https://localhost:8443/webtools/control/main

 

来实现我们的页面内容及其形式。

 

邮件发送服务

 

邮件发送服务的基本设置，需要修改配置文件：framework/common/config/general.properties，

 

# -- general default 'fromEmailAddress' can be overridden in: EmailTemplateSetting
defaultFromEmailAddress=[e-mail]
#defaultFromEmailAddress=[e-mail]

# -- The default domainname used in the notification emails links
# as 'baseUrl' and 'baseSecureUrl' are set in the url.properties file. 

# -- mail notifications enabled (Y|N)
mail.notifications.enabled=Y

# -- redirect all mail notifications to this address for testing
#mail.notifications.redirectTo=

# -- the default mail server to use
mail.smtp.relay.host=smtp.mxhichina.com: [e-mail]
#mail.smtp.relay.host=smtp.xxx.com

# -- SMTP Auth settings
mail.smtp.auth.user=[e-mail]
mail.smtp.auth.password=xxx@

#mail.smtp.auth.user=[e-mail]
#mail.smtp.auth.password=xxx

# -- Additional Required Fields needed for Gmail and other non traditional smtp servers
# -- These added fields also work for Yahoo business mail for instance
# -- Gmail smtp port can be either 465 or 587
mail.smtp.port=25

 

 

由于阿里提供的邮箱不能支持，因此暂时选择使用163的邮箱来进行邮件发送（在注释中）。

 

可以通过ofbiz中的“服务引擎工具->运行任务”来进行邮件发送的测试：

 

 

 

发送邮件的服务名称为：sendMail，提交任务完成后，会启动发送邮件的过程：

 

 

 

此时，需要提供的参数主要有：sendFrom, sendTo, subject, body。

 

如果服务器设置得没有问题，发送邮件就会成功，页面中会有如下的提示：

 

 

 

 

如何在我们自己的服务中调用sendMail服务

 

我们在自己的服务中如何调用sendMail服务，可以自定义一个服务，跟以前一样，类似如下的方式：

 

public static Map<String, Object> sendNotifyEmail(DispatchContext dispatchContext, Map<String, Object> sendMailContext) {
        LocalDispatcher dispatcher = dispatchContext.getDispatcher();

        sendMailContext.put("sendFrom", "[e-mail]");
        sendMailContext.put("sendTo", "[e-mail]");
        sendMailContext.put("subject", "Test to xxx");
        sendMailContext.put("body", "bodyUrl");
        Map<String, Object> sendMailResult;
        try {
            sendMailResult = dispatcher.runSync("sendMail", sendMailContext);
        } catch (GenericServiceException e) {
            Debug.logError(e, module);
            return ServiceUtil.returnError(e.getMessage());
        }

        return Collections.emptyMap();
    }

 

 

核心就是使用 dispatcher.runSync(“sendMail”, sendMailContext)，同步地调用发送邮件服务。

 

如何定时调用sendMail服务

 

如果需要定时调用发送邮件服务，可以使用“服务引擎工具->任务计划”：

 

新建一个任务计划，后续需要继续添加服务需要的参数：

 

 

 

就可以每天执行一次，直到执行到结束日期，或计数次数为止。

 

任务提交后，就可以在任务列表中查看刚才新建的服务：

 

 

 

定时的任务执行完成后，就可以在任务列表中看到其状态。

 

 

 

Ofbiz中的参照实现

 

一般在选择学员时，为了关联相应的数据，我们采用的是使用 drop-down方式，这样能够保证数据能够关联成功，但是如果学员数据比较多，这种方式就变得不可取了。

 

而ofbiz中已经提供了相应的了参照实现，其具体形式为：

 

 

通过阅读源代码，可以找到其中使用的参照类型：

 

<lookup target-form-name="LookupEmplPosition"/>

 

其中的target-form就是在对话框中显示的表单数据，定义在LookupForms.xml中：

 

<form name="LookupEmplPosition" type="single" target="LookupEmplPosition"
        header-row-style="header-row" default-table-style="basic-table">
        <auto-fields-entity entity-name="EmplPosition" default-field-type="hidden"/>
        <field name="emplPositionId" title="${uiLabelMap.HumanResEmplPositionId}"><text-find/></field>
        <field name="statusId">
            <drop-down allow-empty="true">
                <entity-options description="${description}" key-field-name="statusId" entity-name="StatusItem"></entity-options>
            </drop-down>
        </field>
        <field name="emplPositionTypeId">
            <drop-down allow-empty="true">
                <entity-options description="${description}" key-field-name="emplPositionTypeId" entity-name="EmplPositionType"></entity-options>
            </drop-down>
        </field>
        <field name="partyId"><lookup  target-form-name="LookupPartyName"/></field>
        <field name="budgetId"><lookup  target-form-name="LookupBudget"/></field>
        <field name="budgetItemSeqId"><lookup  target-form-name="LookupBudgetItem"/></field>
        <field name="noConditionFind"><hidden value="Y"/><!-- if this isn't there then with all fields empty no query will be done --></field>
        <field name="submitButton" title="${uiLabelMap.CommonFind}" widget-style="smallSubmit"><submit button-type="button"/></field>
    </form>

 

 

可以找出其中的target＝”LookupEmplPosition”，在controller.xml中找到对应的request-map，来确定其基本位置：

 

<request-map uri="LookupEmplPosition">
    <security auth="true" https="true"/><response name="success" type="view" value="LookupEmplPosition"/>
</request-map>

 

 

对应的view-map：

 

    <view-map name="LookupEmplPosition"  type="screen" page="component://humanres/widget/LookupScreens.xml#LookupEmplPosition"/>

 

 

找到对应的Screen，突然发现ofbiz默认每个模块都会有对应LookupScreens.xml，说明这还是一种比较通用的需求。

 

<screen name="LookupEmplPosition">
        <section>
            <actions>
                <property-map resource="HumanResUiLabels" map-name="uiLabelMap" global="true"/>
                <set field="title" value="${uiLabelMap.HumanResLookupEmplPositionByName}"/>
                <set field="queryString" from-field="result.queryString"/>
                <set field="viewIndex" from-field="parameters.VIEW_INDEX" type="Integer" default-value="0"/>
                <property-to-field resource="widget" property="widget.form.defaultViewSize" field="viewSizeDefaultValue"/>
                <set field="viewSize" from-field="parameters.VIEW_SIZE" type="Integer" default-value="${viewSizeDefaultValue}"/>
                <set field="entityName" value="EmplPosition"/>
                <set field="searchFields" value="[emplPositionId, partyId, emplPositionTypeId]"/>
            </actions>
            <widgets>
                <decorator-screen name="LookupDecorator" location="component://common/widget/CommonScreens.xml">
                    <decorator-section name="search-options">
                        <include-form name="LookupEmplPosition" location="component://humanres/widget/forms/LookupForms.xml"/>
                    </decorator-section>
                    <decorator-section name="search-results">
                        <include-form name="ListEmplPositions" location="component://humanres/widget/forms/LookupForms.xml"/>
                    </decorator-section>
                </decorator-screen>
            </widgets>
        </section>
    </screen>

 

 

查询后的结果还需要能够设置到调出参照之前的表单中，例如下面的 雇员职位编号，就有这个功能，其表现形式为一个大按钮：

 

 

 

可以查看到该按钮是一个hyberlink:

 

<field name="emplPositionId" widget-style="buttontext">
            <hyperlink also-hidden="false" target-type="plain" description="${emplPositionId}" target="javascript:set_value('${emplPositionId}')"/>
        </field>

 

 

这可以帮助我们在选择对应的按钮之后，将设置的值返回回去，填充对应的表单。

 

Ofbiz中导出excel/pdf文件 

<!--?xml version="1.0" encoding="UTF-8" standalone="no"?-->

在原有的ofbiz程序中，已经有了相关导出excel文件的示例，可以参考其实现，其导出格式为csv文件。

 

“设备”管理中的“场所管理应用程序”：

 

https://localhost:8443/facility/control/ViewFacilityInventoryByProduct?facilityId=WebStoreWarehouse

 

参考其中的功能：打印，导出，导出所有的应用程序。

 

比如打印这个功能：

 

 

<request-map uri="ListGlAccountOrgCsv.csv">
        <security https="true" auth="true"/>
        <response name="success" type="view" value="ListGlAccountOrgCsv"/>
    </request-map>

 

 

type仍然为view，其value为ListGlAccountOrgCsv，

 

在view-map查找这个属性，可以看到其中的设置为：

 

 

<view-map name="ListGlAccountOrgPdf" type="screenfop" page="component://accounting/widget/GlSetupScreens.xml#ListGlAccountOrgPdf" content-type="application/pdf" encoding="none"/>
    <view-map name="ListGlAccountOrgCsv" type="screencsv" page="component://accounting/widget/GlSetupScreens.xml#ListGlAccountOrgCsv" content-type="text/csv" encoding="none"/>

 

 

可以注意到其中不仅可以支持csv文件，还可以支持pdf。

 

在具体的GlSetupScreens.xml文件中，可以看到csv的写法：

 

<screen name="ListGlAccountOrgCsv">
        <section>
            <actions>
                <property-map resource="CommonUiLabels" map-name="uiLabelMap" global="true"/>
                <property-map resource="AccountingUiLabels" map-name="uiLabelMap" global="true"/>
                <set field="organizationPartyId" from-field="parameters.organizationPartyId"/>
            </actions>
            <widgets>
                    <include-form name="ListGlAccountOrgCsv" location="component://accounting/widget/GlSetupForms.xml"/>           
            </widgets>
        </section>
    </screen>

 

 

此外，其中pdf的写法：

 

<screen name="ListGlAccountOrgPdf">
        <section>
            <actions>
                <property-map resource="CommonUiLabels" map-name="uiLabelMap" global="true"/>
                <property-map resource="AccountingUiLabels" map-name="uiLabelMap" global="true"/>
                <set field="organizationPartyId" from-field="parameters.organizationPartyId"/>
                <entity-condition entity-name="GlAccountOrganizationAndClass" list="glAccountOrgAndClassList">
                    <condition-expr field-name="organizationPartyId" from-field="organizationPartyId"/>
                    <order-by field-name="glAccountId"/>
                </entity-condition>
            </actions>
            <widgets>
                <platform-specific>
                    <xsl-fo>
                        <html-template location="component://accounting/webapp/accounting/reports/ChartOfAccount.fo.ftl"/>
                    </xsl-fo>
                </platform-specific>
            </widgets>
        </section>
    </screen>

 

 

可以注意的是，pdf是根据ftl后缀名的文件来进行的，也就是说需要写一个freemarker文件来根据html的样式来导出对应格式的文件。

 

关于csv文件，以及pdf文件的链接地址写法：

 

<link text="${uiLabelMap.AccountingExportAsCsv}" style="button" target="ListGlAccountOrgCsv.csv">
                            <parameter param-name="organizationPartyId"/>
                        </link>
                        <link text="${uiLabelMap.AccountingExportAsPdf}" style="button" target="ListGlAccountOrgPdf.pdf" target-window="_BLANK">
                            <parameter param-name="organizationPartyId"/>
                        </link>

 

 

 

如果是csv文件，直接下载；如果是pdf文件，声明在另一个blank窗口打开该文件