<set field="notApplied" value="${bsh:org.ofbiz.accounting.invoice.InvoiceWorker.getInvoiceNotApplied(invoice)}" type="Double"/>

警告:你必须使用type=""来转换你的结果类型,否则的话,它将返回字符串类型.

* 如何在minilang中调用Java程序
你可以在minilang中插入一段beanshell代码,类似于 applications/ecommerce/script/org/ofbiz/ecommerce/customer/CustomerEvents.xml的示例:

        <call-bsh><![CDATA[
            String password = (String) userLoginContext.get("currentPassword");
            String confirmPassword = (String) userLoginContext.get("currentPasswordVerify");
            String passwordHint = (String) userLoginContext.get("passwordHint");
            org.ofbiz.securityext.login.LoginServices.checkNewPassword(newUserLogin, null, password, confirmPassword, passwordHint, error_list, true, locale);
        ]]></call-bsh>

  在beanshell脚本中可以访问在minilang中所有的变量

* 清除 与 刷新的比较
  <clear-field field-name="foo"/> 设置它为null. 这可以是一个类的属性或是集合中的一个值
  <refresh-value value-name="foo"/> 从数据库中重新获得foo的值. foo必须是一个GenericValue.

* 如何设置一个布尔值
 我无法找到任何例子,但是我这样做是成功的:

 <set field="orderAvailableCtx.countNewReturnItems" value="true" type="Boolean"/>

 我想minilang使用type=""中的类型与value中的值的做为构造调用.猜想在某天我看到这些代码时能证明我是对的...

本文档译自ofbiz 4.0 cookbooks,本人翻译,欢迎转载,请注明出处.

  <alias entity-alias="OI" name="quantity" function="sum">
      <complex-alias operator="-">
          <complex-alias-field entity-alias="OI" field="quantity" default-value="0"/>
          <complex-alias-field entity-alias="OI" field="cancelQuantity" default-value="0"/>
      </complex-alias>
  </alias> 

   SELECT SUM(COALESCE(OI.QUANTITY,'0') - COALESCE(0I.CANCEL_QUANTITY)) AS QUANTITY在结果集包含默认值是一个好的习惯,否则如果有一项为null,那么最终相减的结果就也为null了.
  操作符可以为任何你当前使用数据库所支持的SQL操作符,比如算术运算符+, -, * 和/ 或者字符串连接符 ||.

  你可以增加function=""标签来完成在complex-alias-field中的min, max, sum, avg, count, count-distinct, upper 及lower集合运算.  示例, 以上的定义可以用另一种方法表示为:

  <alias entity-alias="OI" name="quantity">
      <complex-alias operator="-">
          <complex-alias-field entity-alias="OI" field="quantity" default-value="0" function="sum"/>
          <complex-alias-field entity-alias="OI" field="cancelQuantity" default-value="0" function="sum"/>
      </complex-alias>
  </alias>

   即为SELECT (SUM(COALESCE(OI.QUANTITY,'0')) - SUM(COALESCE(OI.CANCEL_QUANTITY,'0'))) AS QUANTITY查询结果集

* 我讨厌OFBiz的实体引擎,我要自己的JDBC连接!
  好的,以下是你获得JDBC连接的方法: 

import org.ofbiz.entity.jdbc.ConnectionFactory;

String helperName = delegator.getGroupHelperName("org.ofbiz");    // gets the helper (localderby, localmysql, localpostgres, etc.) for your entity group org.ofbiz
Connection conn = ConnectionFactory.getConnection(helperName); 
Statement statement = conn.createStatement();
statement.execute("SELECT * FROM PARTY");
ResultSet results = statement.getResultSet();

//  通过普通JDBC 的结果集来操作

//Alternatively, you can use the SQLProcessor like this:

SQLProcessor sqlproc = new SQLProcessor(helperName);
sqlproc.prepareStatement("SELECT * FROM PARTY");
ResultSet rs1 = sqlproc.executeQuery();

ResultSet rs2 = sqlproc.executeQuery("SELECT * FROM PRODUCT");

 你可以查看framework/webtools/webapp/webtools/WEB-INF/actions/entity/EntitySQLProcessor.bsh了解它的使用

在以下网址你可以获得相关JavaDoc的内容:
http://www.opentaps.org/javadocs/version-1.0/framework/api/org/ofbiz/entity/jdbc/SQLProcessor.html
http://www.opentaps.org/javadocs/version-1.0/framework/api/org/ofbiz/entity/jdbc/ConnectionFactory.html

  *** 请先考虑以下内容: 你放弃数据库的无关性意味着你在某些方法将无法与框架或其它程序集成.你确定你要这么做吗?

获得更好的做法,请访问 http://www.opentaps.org/docs/index.php/Using_the_Query_Tool

* 关于时间比较方法的一些警告

在你用 GREATER_THAN比较一个 Timestamp类型数据时, 你有可能获得相同的时间数据: 

delegator.findByAnd("XXX", UtilMisc.toList(new EntityExpr("fromDate", EntityOperator.GREATER_THAN, "2007-12-31 23:59:59.998")));

 有可能包含fromDate=2007-12-31 23:59:59.998的数据.  (此种情况发生于PostgreSQL 8.1并且GenericDAO 类生成的SQL代码是'FROM_DATE > ' so 所以我也不明白发生这个问题的原因.) 所以确保安全的方法是, 增加1秒到需要比较的时间中然后使用 GREATER_THAN_EQUAL_TO方法  

delegator.findByAnd("XXX", UtilMisc.toList(new EntityExpr("fromDate", EntityOperator.GREATER_THAN_EQUAL_TO, "2008-01-01 00:00:00.998")));

* 警告: 在空集合中使用EntityOperator.IN

请小心如果使用EntityOperator.IN去判断一个非空集合在一个空集合中的包含项,你有可能获得一个语法错误: 在Derby或者其它一些不为人知的数据库中可能会出错.
所以建议你能在使用EntityOperator.IN之间,通常执行UtilValidate.isNotEmpty方法来判断一下结果集是否为空

* 警告: delegator.getNextSubSeqId 不能确保唯一性

很多实体有很多合成的主键.示例OrderItem's 主键是orderId + orderItemSeqId.  InventoryItemDetail's 主键是inventoryItemId +inventoryItemSeqId.  通常, delegator.getNextSubSeqId 通常是获得一个序列值,但是在多线程的访问下有可能无法确保生成的值的唯一性.  此段内容在 http://issues.apache.org/jira/browse/OFBIZ-1636 中有相关文档记录.

当前, 如果有可能多个线程尝试同时写入实体组合键时,可以使用delegator.getNextSeqId来替代getNextSubSeqId.  (此问题不会发生于OrderItem, 因为它只使用单线程写入, 但有可能发生于 InventoryItemDetail, 它使用多线程来创建库存记录项.)
 

* 如果为有效期间创建条件?

我们提供了一组非常有用的方法EntityUtil.getFilterByDateExpr ,它能返回一个EntityConditionList根据有效期间来筛选一个结果集. 

* 如何在大数据结果集下工作

如果你检出一个大的数据结果集,你应当使用EntityListIterator通过迭代方式读取数据,而非List.
示例,如果你使用:

List products = delegator.findAll("Product");

你可能获得一个"java.lang.OutOfMemoryError".  这是由于你通过findAll, findByAnd, findByCondition等方法来获得一个大的内存数据结果集导致内存溢出.  在这种情况下, 应该使用EntityListIterator迭代方式来读取你的数据. 这个示例应改写成:

productsELI = delegator.findListIteratorByCondition("Product", new EntityExpr("productId", EntityOperator.NOT_EQUAL, null), UtilMisc.toList("productId"), null);

注意获得EntityListIterator的方法只用通过条件, 所以你需要将你的条件重写为EntityExpr (在此次情况下,productId是主键字段不可能为空的, 所以将返回所有Proudct实例,)或 EntityConditionList.

此方法参数中包含检出的字段(这里为productId)以及排序字段(这里不需要,所以赋了null)

你可以传递一个null作为EntityCondition参数来获得所有结果.然后这不一定在所有数据库下都能正常工作!  在maxdb及其它不常用的数据库下时你要小心使用这些高级功能.

* 如何使用EntityListIterator

当我们通过EntityListIterator迭代访问数据时, 通常是这样:

while ((nextProduct = productsELI.next()) != null) {
.
    // operations on nextProduct
}

在EntityListIterator 中使用 .hasNext()方法是一种不经济的做法.

在你完成你的操作后,要记得关闭此迭代

productsELI.close();

* 如何查询无重结果集

当前只能通过list iterator方法并指定EntityFindOptions参数,示例如下:

    listIt = delegator.findListIteratorByCondition(entityName, findConditions, 
            null, // EntityConditions参数
            fieldsToSelectList, 
            fieldsToOrderByList,  
            
            //关键部分.  第一个true表示"specifyTypeAndConcur"
            // 第二个true指完是一个滤重查询.  显然在实体引擎中只能通过这个方法来进行滤重查询
            new EntityFindOptions(true, EntityFindOptions.TYPE_SCROLL_INSENSITIVE, EntityFindOptions.CONCUR_READ_ONLY, true));

  <entity-condition entity-name="${entityName}" list-name="${resultList}" distinct="true">
     <select field="${fieldName}"/>
     .

* 如何进行一个大小写不敏感的查询(即不分大小写)

你需要查询条件表达式两边均转为大写,示例:

andExprs.add(new EntityExpr("lastName", true, EntityOperator.LIKE, "%"+lastName+"%", true));

     (来源org.ofbiz.party.party.PartyServices)

* 如何将EntityListIterator转换成List

  使用EntityListIterator.getCompleteList() 及getPartialList 方法

* 如何自动获得下一个ID值

  在minilang 中使用 <sequence-id-to-env ...> 或在Java中通过delegator.getNextSeqId(...) 获得 .  id序列存放于SequenceValueItem中.

* 关于ID值的一些警告

  不要在种子/演示数据中使用10000做为数据的ID,当系统尝试自动创建数据时,它们都将尝试10000,这将导致一个键值冲突错误.

* 如何从一个明细项中获得序列ID
  
  有些实体,比如拥有itemSeqId 的InvoiceItem(发票明细项) and OrderItem(订单明细项).此项通常在你处一次为item生成GenericValue 时自动生成ID,之后向delegator要求生成项目的seq Id:

  GenericValue orderItem = delegator.makeValue("OrderItem", orderItemValues);
  delegator.setNextSubSeqId(orderItem, "orderItemSeqId", ORDER_ITEM_PADDING, 1);

o 定义菜单

<menu-item name="DataSource" title="${uiLabelMap.DataSource}"><link target="FindDataSource"/></menu-item>

 name属性用于标识菜单项。
 title属性用于菜单显示名称，也可是uiLabelMap
 link指定菜单项的跳转URI

o 使得指定的菜单高亮
 在屏幕组件的<screen>-<actions>段中加入

<set field="headerItem" value="reports"/>

 value值为已定义过的要加亮的菜单项
 
o 根据条件选择是否显示菜单项
  在<menu-item>节点中使用 <condition>项:

     <condition><not><if-empty field-name="userLogin"/></not></condition>
     <condition><if-empty field-name="userLogin"/></condition>

o 使用CSS样式表
  在<menu-item>节点中使用以下属性
    align-style="" 定义对齐方式
    widget-style="" 定义菜单项在未选中时的样式
    selected-style="" 定义菜单项在选中时的样式

o 右对齐菜单项
  使用align-style="col-right" 来启用 "col-right" CSS样式
  注意这个样式将把第一个菜单项放到最右边，第二个放在第一个的左边，依次类推

本文档译自ofbiz 4.0 cookbooks,本人翻译,欢迎转载,请注明出处.

2. OFBiz日志文件
OFBiz创建较多日志文件并将它们存储于logs/目录（在opentaps-0.9或更早版本中）或framework/logs/（在opentaps-0.9之后版本），文件有：
 - ofbiz.log.? - 记录所有OFBiz生成日志信息。此文件将在满时自动循环创建新文件，即ofbiz.log是当前日志文件，ofbiz.log.1是较早些时间的日志文件，ofbiz.log.2是比ofbiz.log.1更早时间的日志文件，以此类推。
 - console.log - 记录所有OFBiz在控制台界面运行显示的内容。也有可能无效。
 - access_log.? - 类似于Apache httpd日志格式记录所有服务请求。很漂亮但对调试没有什么用处。

大多数据时间，你可以通过ofbiz.log或console.log来查询调试信息。因为它们有很多内容，所以你最好使用一个可以翻页与进行查找的编辑器来打开这些日志文件。

3、查找日志信息
Java日志信息最容易查找。它们的日志信息中通常有类名与行号生成：

111770[PaymentGatewayServices.java:776:INFO ] (Capture) Invoice [#10110] total: 38.54

Minilang方法日志中的类名均为Log.java，如：

112499[                Log.java:103:INFO ] Finished quickShipEntireOrder:\nshipmentShipGroupFacilityList=[[shipmentId=10120, facilityId=WebStoreWarehouse, shipGroupSeqId=00001]]\nsuccessMessageList=[Created shipment with ID [10120] for ship group ID [00001] for facility ID [WebStoreWarehouse]]

如果你在beanshell中直接使用输出，你输出的内容将显著的显示于日志文件中：

2006-07-19 13:46:26,373 [  ServiceDispatcher.java:450:DEBUG] [[Sync service finished- total:0.027,since last(Begin):0.027]] - 'ecommerce / getProductCategoryAndLimitedMembers'
parentCategory = TABLE-LINENS-SOLIDS 
2006-07-19 13:46:26,874 [      PriceServices.java:802:INFO ] PromoPrice and ProductPriceAction had null amount and no default price was available, using list price: 2.0 for product with id 15899

如果你在beanshell中使用调试方法，你将在日志中得到如下信息：

2006-07-19 13:46:26,373 [  ?:?] parentCategory = TABLE-LINENS-SOLIDS

你可以为那些无法发现日志信息的minilang或beanshell代码中加入自己的信息输出。

所有freemarker，screen-widget或form widget输出的信息将直接显示在你的浏览器屏幕上。除非这些控件崩溃否则不会显示任何日志信息。

4. 增加你自己的日志信息
在Java中增加你自己的日志信息，请使用OFBiz Debug类(org.ofbiz.base.util.Debug)中的调试方法，如logInfo，logWarning, logError...
 示例：   Debug.logInfo("Now processing invoice " + invoiceId, module);

在beanshell中增加日志信息，同样使用Debug方法，但在内容中忽略如""这样内容。

在freemarker中增加日志信息，只需要显示你打算跟踪的变量，如：

   ${invoice}  <#-- 将显示 invoice 的一般属性值-->
   ${invoice.invoiceId}  <#-- 将显示invoice.invoiceId属性值 -->

在minilang中增加日志信息，使用<log >指令并输入你的值，比如在freemarker中：

   ${invoice}  <#-- will display the entire GenericValue invoice -->
   ${invoice.invoiceId}  <#-- will display the invoiceId field of invoice -->

通常level节点属性用于设置日志级别，如："info", "warning", "error"，对应于Debug中的同名方法。

5. 何时需要重启OFBiz

你在做如下更改时需要重新启动OFBiz服务器：
- Java文件（记得要重新编译）
- 配置/.properties文件
- entitymodel或entitygroup XML定义文件
- 服务或secas XML文件
- JPublish XML文件

你在进行以下修改时无需重新启动OFBiz服务器：
- freemarker FTL模版
- beanshell BSH模版
- Screens XML文件
- Forms XML文件
- 控制器XML文件（注意：在opentaps-0.8和OFBiz 3.x及更早版本中，你在更改控制器时需要重启）
但有可能你需要在浏览器中清除缓存。
 

6. 常见错误及其含义：

Cannot locate service by name (captureBillingAccountPayment)

   * 此服务 (captureBillingAccountPayment) 在所有 services.xml 定义中都找不到.
Cannot find service location (org.ofbiz.order.order.OrderServices)
   * 说明在services XML定义点上指向的资源不存在.  如果这是一个minilang或beanshell服务，即服务引擎无法找到此文件。如果这是一个Java服务，则说明在classpath中无法查找到这个类。

Service method does not exist (com.opensourcestrategies.financials.invoice.InvoiceServices.setInvoiceDueDate(org.ofbiz.service.DispatchContext, java.util.Map))

   * 含义是在某个services.xml指定的这个服务不存在对应的Java方法。通常发生于你在修改了Java文件后忘记再次编译它来使新增的方法生效。

java.lang.IllegalArgumentException: Could not get next sequenced ID for sequence name: Party (Could not get next sequenced ID for sequence name: Party).   

   * 系统无法取得实体的下一个自动ID，通常发生于数据库断开情况。

ERROR: insert or update on table "inventory_item" violates foreign key constraint "inv_item_facility"

   * 在"inventory_item"表的插入/修改操作时违犯"inv_item_facility"外键约束。

Error calling event: org.ofbiz.webapp.event.EventHandlerException: Service invocation error (Commit transaction failed)

   * 这是一个非常令人讨厌的错误信息。通常它意味着你访问的服务所触发的ECA链服务中有一个服务失败，于是导致全部的操作失败。服务引擎无法为你进一步跟踪，所以你需要进入log文件中进一步查找错误原因。访问你的logs/ofbiz.log 或logs/console.log文件去了解触发错误的根本原因。

Unable to bind UserTransaction/TransactionManager to JNDI

   * 这是在opentaps 0.8/0.9及OFBiz的pre-Geronimo版本在Linux系统下可能会发生的一个问题.  解决方法可以在以下网址中找到:  
     http://lists.ofbiz.org/pipermail/users/2004-June/004094.html

Message: The entity name must immediately follow the '&' in the entity reference.
org.xml.sax.SAXParseException: The entity name must immediately follow the '&' in the entity reference.

   * 这是一个 XSL:FO 错误并意味着你在文本中使了字符'&'，比如说你在描述或地址中使了这个字符。 XSL:FO 使用xml属性格式，所以你需要确认你在文本字段后放置?xml。

1、 安装JDK 1.5或以上版本，设置好JAVA_HOME

2、 安装MySQL 5.0或以上版本

3、 在http://www.eclipse.org/downloads/下载最新Eclipse版本，我下的是3.4.1版的Eclipse IDE for Java EE Developers，并解压至工作目录（我解压至"C:\\"，即工作目录为"C:\\eclipse"）

4、 启动Eclipse，通过点击Help菜单中的Software Updates...启动Software Updates向导界面，新建subclipse远程站点，远程下载地址为http://subclipse.tigris.org/update_1.0.x，勾选下载安装Subclipse Plugin后点击Intasll按钮安装

    

检出代码：

1、 在新建…向导对话框中选择从SVN中检出项目

2、 在SVN检出位置URL框中输入：http://svn.apache.org/repos/asf/ofbiz后点击Next。

3、 选择文件夹"branches"release4.0后点击Finish。

数据库配置 [可以参考我写的opentaps 1.0.2安装(mysql)一文]：

1、 通过mysql命令行来创建obfiz运行所需数据库，为了方便识别，我们这里就用ofbiz来做数据库吧。

mysql> create database ofbiz;

       mysql> exit

2、 编辑ofbiz目录中的framework/entity/config/entityengine.xml文件，使其能正确连接到你的mysql数据库中（注意其中的ofbiz-user与ofbiz-password，把它们改成你实际的数据库连接用户名与密码）。

将其中的<delegator name="default"...> 段中的"datasource-name"从原来的"local" 改为 "localmysql"

编辑<datasource name="localmysql"...> 段内容，修改"jdbc-uri"为"jdbc:mysql://127.0.0.1/ofbiz?autoReconnect=true"；修改"jdbc-username"/ "jdbc-password"为你的mysql连接用户名/密码，修改character-set="gbk"，collate="gbk_bin",示例如下:

 1 <delegator name="default" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" distributed-cache-clear-enabled="false">
 2
 3        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>
 4
 5    </delegator>
 6
 7    <delegator name="default-no-eca" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" entity-eca-enabled="false" distributed-cache-clear-enabled="false">
 8
 9        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>
10
11    </delegator>
12
13    <delegator name="test" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main">
14
15        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>
16
17    </delegator>
18
19    <delegator name="other" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main">
20
21        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>        
22
23   </delegator>
24
25…
26
27

 1<datasource name="localmysql"
 2
 3            helper-class="org.ofbiz.entity.datasource.GenericHelperDAO"
 4
 5            field-type-name="mysql"
 6
 7            check-on-start="true"
 8
 9            add-missing-on-start="true"
10
11            check-pks-on-start="false"
12
13            use-foreign-keys="true"
14
15            join-style="ansi-no-parenthesis"
16
17            alias-view-columns="false"
18
19            drop-fk-use-foreign-key-keyword="true"
20
21            table-type="InnoDB"
22
23            character-set="gbk"
24
25            collate="gbk_bin">
26
27        <read-data reader-name="seed"/>
28
29        <read-data reader-name="demo"/>
30
31        <read-data reader-name="ext"/>
32
33        <inline-jdbc
34
35                jdbc-driver="com.mysql.jdbc.Driver"
36
37                jdbc-uri="jdbc:mysql://127.0.0.1/ofbiz?autoReconnect=true"
38
39                jdbc-username="ofbiz-user"
40
41                jdbc-password="ofbiz-password"
42
43                isolation-level="ReadCommitted"
44
45                pool-minsize="2"
46
47                pool-maxsize="20"/>
48
49

   3、 系统初始化

在命令行窗口下，进入ofbiz根目录后运行

ant run-install

系统开始安装，等大约15-30分钟后，系统提示安装完成。

启动ofbiz：

有两种方式可以启动ofbiz：

1、 双击根目录下的startofbiz.bat启动

2、 在eclipse中用鼠标右键点击build.xml，在右键菜单中选择Run As->Ant Build…在弹出的构建对话框中targets选项卡中勾选run后点击run

    

访问ofbiz：

打开浏览器访问：https://localhost:8443/webtools/control/main点击屏幕右方的Login链接后进行登录，登录后就可以访问你希望的功能特性，系统默认帐号为admin/ofbiz，拥有所有权限。
    

本人原创文章，欢迎转载，转载请注明出处！

opentaps现在在国内应用面不象sugarcrm/vtigercrm这些企业应用那样普遍，我想很大程度是由于JavaEE应用的逻辑结构严谨与复杂度决定其不象PHP应用那样容易拆分按需阅读切入。了解一个JavaEE的应用需要先了解其构造的框图、分层结构、每层实现的技术方式以及采用的技术。对于OFBiz这样一个野心极大要囊括几乎所有企业应用层面的项目，想要掌握它就更难上加难了，也许我们可以选择简单开始，先从文档的中文化与由简入繁的练习中开始了解这个庞大的开源项目。

闲话少说，我们先从opentaps的安装开始，让我们能够在自己的机器上跑起opentaps开始，也许你一直在寻找的企业应用已经全部在此喽！

准备工作：
1、安装JDK 1.5或以上版本，并在系统中设置好JAVA_HOME及相关PATH
2、安装MYSQL 5.0或以上版本
3、安装ANT1.7或以上版本，并在系统中设置好ANT_HOME及相关PATH
4、从以下地址下载opentaps 1.0.2二进制版本
http://nchc.dl.sourceforge.net/sourceforge/opentaps/opentaps-1.0.2-all-platforms.zip

开始安装：
1、通过mysql命令行来创建opentaps所需数据库，为了方便识别，我们这里就用opentaps来做数据库吧。
mysql> create database opentaps;

2、将下载的opentaps-1.0.2-all-platforms.zip解压至你的工作目录。

3、编辑opentaps目录中的framework/entity/config/entityengine.xml文件，使其能正确连接到你的mysql数据库中。
3.1 将其中的<delegator name="default"...> 段中的"datasource-name"从原来的"local" 改为 "localmysql"
3.2 编辑<datasource name="localmysql"...> 段内容，修改"jdbc-uri"为"jdbc:mysql://127.0.0.1/opentaps?autoReconnect=true"；修改"jdbc-username"/ "jdbc-password"为你的mysql连接用户名/密码，修改character-
set="gbk"，collate="gbk_bin",示例如下:

    <delegator name="default" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" distributed-cache-clear-enabled="false">
        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>
    </delegator>
    <delegator name="default-no-eca" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" entity-eca-enabled="false" distributed-cache-clear-enabled="false">
        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>
    </delegator>

    <delegator name="test" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main">
        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>
    </delegator>
    <delegator name="other" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main">
        <group-map group-name="org.ofbiz" datasource-name="localmysql"/>        
    </delegator>




    <datasource name="localmysql"
            helper-class="org.ofbiz.entity.datasource.GenericHelperDAO"
            field-type-name="mysql"
            check-on-start="true"
            add-missing-on-start="true"
            check-pks-on-start="false"
            use-foreign-keys="true"
            join-style="ansi-no-parenthesis"
            alias-view-columns="false"
            drop-fk-use-foreign-key-keyword="true"
            table-type="InnoDB"
            character-set="gbk"
            collate="gbk_bin">
        <read-data reader-name="seed"/>
        <read-data reader-name="demo"/>
        <read-data reader-name="ext"/>
        <inline-jdbc
                jdbc-driver="com.mysql.jdbc.Driver"
                jdbc-uri="jdbc:mysql://127.0.0.1/opentaps?autoReconnect=true"
                jdbc-username="opentaps"
                jdbc-password="opentaps-password"
                isolation-level="ReadCommitted"
                pool-minsize="2"
                pool-maxsize="20"/>

4、进行系统初始化
在命令行窗口下，进入opentaps根目录后运行
ant run-install
系统开始安装，等大约15-30分钟后，系统提示安装完成。

启动opentaps
双击运行opentaps目录下的startofbiz.bat命令即可，请注意控制台输入默认输出至log下的ofbiz.log中，所以无法从控制台中判断系统是否启动完成，一般需等待两到五分钟。也可以将输出改回至console。

访问opentaps
打开浏览器访问：http://localhost:8080/
点击你希望访问的功能特性，系统默认帐号为
admin/ofbiz，拥有所有权限。

 本人原创文章，欢迎转载，转载请注明出处！

在CRM应用中有一个核心应用是将线索/潜在客户转化成客户。在opentaps中的CRM应用，潜在客户是在[线索]中做为线索创建的。一个线索是一个公司里的一个联络人且不能拥有更多的相关联络信息。在你进行线索筛选后，例如进行了电话跟进，你可以标记此线索有效。这时，当线索变成客户，你可以将线索转换成客户客户和一个联络人。你也可以为这个客户客户建立更多的联系人信息。

注意如果你有关于同一家公司客户的多个线索时，系统允许你建立它们为不同的线索，而把它们转换成一个客户客户。线索转换屏幕允许你选择一个已经存在的客户客户。

这里没有关于什么样的线索可以转换成一个客户客户的正式要求——你可以按照你自己的应用需求来进行调整。

技术性备注：做为一个客户、线索或客户，一个参与者必须拥有“Account”, “Contact”,或 “Prospect” 的PartyRole并需要与另一个参与者有一个PartyRelationship。因此，不满足此要求的OFBiz参与者是不能做为一个account, lead, 或contact的。同样，一个客户客户是一个OFBiz的PartyGroup，线索和联系人是一个OFBiz Person。

客户

在0.9.1版本之前，客户所有者默认是可以管理客户组，但不能为此客户创建机会。因此，在你创建一个客户后，你除了无法创建机会外可以做任何事。创建一个客户组，且你在此组上有拥有完整的用户（读/写）使用权限时，你可以创建机会。

在0.9.1版本之后，客户所有者可以为其创建机会。

每个客户可以拥有一个父级客户，父级客户可以在[创建客户]或在修改时输入。

客户列表根据客户名称排序。

联系人

在联系人创建后，联系人可以通过客户主页面上[新联系人]菜单或是联系人主页面上的[新客户]方式来加入到客户上。

联系人列表根据联系人的姓/名排序。

线索

线索是一个原始状态的联系人/客户信息。当一个线索进行转换后，将后生成一个联系人与客户。

线索可以拥有父级对象。此父级对象应是一个已存在的客户。

线索默认会被分配给线索创建者。

当你进行一个线索识别后，点击[线索识别]来标识它已经通过“识别”。

当你转换一个线索，你将被带到一个屏幕并被询问是做为一个新建客户还是一个已存在的客户的联系人。如果此线索的公司已经被建立，选择已存在的客户。否则，保持此字段为空。线索中关于联络人的信息将会被转换成一个联系人。如果选择了一个已存在的客户，线索将转换成它的联系人。如果未选择已存在的客户，将会基于线索中的公司信息创建一个新的客户，线索信息将成为此客户的一个联系人。

线索在转换成联系人/客户时必须拥有公司名称才会转换成功。

注意：如果你在转换线索时选择了一个已存在的客户，这时线索中的所有公司信息将会丢失。这包括：“公司名称”、“年营业额”、“行业”…

在拥有关联机会的线索进行转换时，关联机会同将会自动转换成目标客户、联系人的机会信息。

如果你根据线索生成了一个新的客户，线索中的联系信息（地址、电话、电邮）自动转换成客户中的联系信息。如果你基于一个已存的客户进行转换线索，则线索中的联系信息不会拷贝到客户中。

线索在未识别或转换前可以被删除（示例：还处于“新建”或“被分配”状态）。在0.9.1版本前，你不能删除任何拥有关联活动（事件或任务，如电子邮件）的线索。

线索列表可以根据线索中的公司名称、姓、名的任一项排序

合并线索/联系人/客户

从0.9.1版本开始，你可以将重复的线索/联系人/客户进行合并。使用左边的快捷菜单中[合并___]链接并输入从-和至- 线索/联系人/客户的partyId。页面将会要求你进行确认，在你确认合并操作后，

合并特性中来源的线索/联系人/帐户信息可能不支持过多的数据。

机会

当机会刚建立时，阶段是用于表明机会成功的概率，成功概率可以在以后进行修改，但是当它更新到一个新的阶段，概率就会自动更新至新阶段的概率。估计结束日期是用于提供机会未来预期情况。

一个机会只能在来源于一个帐户但可以关联多个联系人。

在编辑/更新机会时，你必须属于其所属帐户组，在帐户上创建机会时，你一定有权限更新此帐户。更新机会要求你填写更改备注。

在版本0.9.1，机会可以在线索识别后创建一个机会。当线索转换后，机会将同时关联于帐户与联系人。

注意机会的“预测关闭日期”实际上存储做为一个日期-时间（Java中的Timestamp类型），

机会阶段的概率存储于SalesOpportunityStage.defaultProbability字段

案例

案例必须创建关联于至少一个帐户或联系人。一个案例可以有多个联系人或帐户关例，虽然现在没有与之关联的接口。

“我的案例”显示所有分配给你的帐户或联系人相关的案例。它默认分配给用户权限是：如果你被分配一个帐户，而它有关联的案例，那这个案例就属于你。

更新案例时，你需要拥有相关的帐户/联系人权限。

将案例关闭需要特别的权限。

发送电子邮件

在帐户，联系人或线索的联系人信息屏幕中，你可以点击任何的电子邮件，将弹出一个发送邮件的屏幕。你可以输入另一个电子邮件地址或查询机会/案例。当你完成时，你可以点击[发送]邮件或[保存以后发送]。[保存以后发送]将把电子邮件保存为收件人的一个待办活动。在成功发送后，电子邮件将保存为活动历史的一部分。

如果电子邮件地址不是收件人参与者的电子邮件地址，你将获得一个错误。

注意[文本]和[超文本]按钮将切换电子邮件MIME格式为文本与超文本，但当前超文本编辑器还没有整合进来。因此，如果你打算使用超文本格式邮件时，直接通过粘贴或编写html格式内容。已计划提供一个整合浏览器的超文本编辑器。

筛选接收的电子邮件

在opentaps0.9.1，CRM/SFA应用可以筛选你接收的电子邮件，将它们保存为系统的通讯活动，且将它们关联到你的用户、联系人、帐户或线索上。配置此功能，首先应按照“Configuration and Setup”进行邮件容器的配置。接着编辑此文件

hot-deploy/crmsfa/servicedef/smcas.xml

把用于接收邮件的主机信息改正确后，重启你的服务，系统将开始览视你的主机并且保存新的电子邮件。它将根据邮件的来源电子邮件地址尝试匹配你的帐户/线索/联系人，根据接收人/抄送电子邮件地址匹配你的CRM用户。

在接收到一封新的电子邮件时，它将在系统中记录为一个通讯事件（CommunicationEvent）。如果来源电子邮件地址匹配了一个参与者电子邮件地址（帐户、线索或联系人），它将被记录为来源于参与者。如果接收邮件地址匹配另一个参与者的电子邮件地址，它将被记录为发送给该参与者的电子邮件。（技术备注：CRM/SFA应用使用OFBiz storeIncomingEmail服务，当使用WorkEffort调用和关联收件人做为WorkEffort的参与者）

新电子邮件做为关联于参与者（帐户、线索、联系人）和接收者（用户）的一个待办活动创建。当你登录至CRM/SFA应用时，你将可以在“待办活动”列表中查看到你收到的邮件且在发件人（帐户/线索/联系人）的“待办活动”中查看到它。你可以点击这个活动查看电子邮件，这将把它标记为开始，当你完成时将把它标记为结束（技术备注：CRM/SFA应用将把电子邮件的通讯事件CommunicationEvent在你开始活动时标记为待办“Pending”，结束时标记为完成“Complete”）

未关联到任何参与者的电子邮件将保存在系统中。你可以使用参与者管理应用来进行手工筛选。在[Party]>[Comm]查询类型为“自动电子邮件”状态为“未知参与者”的通讯事件。然后编辑它们关联至系统用户，标记它们为“完成”。

活动

这里有两种活动类型：任务和事件。事件用于显示在日历中的会议。任务是电话、电子邮件或不显示在日历中的普通任务。在你初次登录时可以在“我的起始页”中显示待办活动列表，它们包括事件与任务。

事件可以通过日程（点击时间图标）或帐户、联系人、线索、案例、机会屏幕两种方式创建。任务只能在后者或任务列表中创建，因为它们是不在日历中显示的。

当你创建一个活动时（任务或事件），你可以输入计划的起始日期/时间和持续的期间。如果用户在此期间将会忙于处理此事，则点击“忙”或“离开”。如果有另一个任务或事件已经在使用此时段并标记为“忙”或“离开”，将会产生一个错误信息。如果你坚持要使用此时估，点击“忽略日程冲突”。当你更新事件时，你一样需要设置“忽略日程冲突”如果它与已存在的事件时间冲突。

记录一件已发生过的活动时。这些活动将会创建做为完成的，用户也会要求输入实际的开始与结束时间。

为计划某事创建一个新的活动，事件或任务时，用户输入计划开始时间和结束日期。原状态为“计划”的事件可以为“已确认”。当确认后，你可以在事件中加入参与者并通过发送邮件邀请他们。加入一个参与者自动确认他们。邀请他们发送发送电子邮件。输入的备注将被包含在其中，而且这个电子邮件将包含两个链接：接入与拒绝。

如果参与者已经在相同时段置“忙”于另一个事件或任务，他们是无法加入到事件中。如果未设置状态，则此段时间被假设为可用。

当你拥有自己的事件时，你可以在发生期间内（开始至结束时间）内把它标记不“已完成”。

还有一个任务创建为“已计划”时，当用户准备开始此活动，更新任务至“已开始”且输入开始时间。如果未输入时间，系统将记录当前时间做为开始时间。类似地，当用户准备标记它完成时（“已完成”），如果未输入时间，系统将记录当前时间做为完成时间。

至于一封电子邮件，当你点击[发送电子邮件]系统将记录它作为开始时间。当你点击[发送]，系统记录它作为结束时间。如果你保存以后发送，此活动将不会记录它为完成直至你实际发送此邮件。

当查看活动时，你将在上面查看到活动的详细内容，在中间的关联的活动参与者（帐户/联系人/线索/组成员）、如果这是封电子邮件，电子邮件在下方。注意OFBiz设计为允许每个work effort中允许多个通讯事件，但我们在活动中只显示其中的一个。这个概念稍微有点落后：在OFBiz，你创建work effort作为“项目”并与很多电子邮件并进行关联。在这里，work effor用于分离的“任务”，如发送一个电子邮件。你可以创建work effort作为项目，但它可以分离成调用子任务。它在Workeffor Manager中支持，但在CRM/SFA中没有这样的用法。

当你记录电话或电子邮件时，“呼入/呼出”标志参与者是主动方还是被动方。

参与者列表显示任务或事件的参与者（帐户/联系人/线索），当前只有日程拥有者（如活动的创建人）可以更新参与者可用状态及增加/删除他们。未来版本可能会改变这点限制。

查询活动将显示那些已完成的活动或任务列表。

当事件被取消，它将不再显示于日历中。

预测

销售预测使用机会概率和数据来计算在未来时间段的预期销售额。预测来源于机会的计算，每个销售员预测基于自己的客户机会和线索相关联的机会计算。与其相关的任何客户和已确认的线索可以用于计算预测。因此，所有销售员销售预测合计将超过整个公司的销售预测，因为很多销售员拥有相同的客户，为了获得公司的预测，每次只一个增加销售经理而且每个客户和线索只计算一次。

所有销售员可以创建自己的预测和输入他的销售定额。只有销售经理可以创建组/销售区域的预测。当前每个销售员只能创建自己的预测。

创建你自己的预测，选择[创建预测]并选择相应的季度来创建。只有未关闭的季度，即在还未到结束日期的季度可用于创建预测。

你将会被要求输入此季度的按月销售定额。当你完成后，点击[创建]。你的销售定额将输入进系统且按月/季度的预测将会被创建军。每个月的销售预测计算基于：
1． 成交金额=此月状态为“已关闭”机会金额累计
2． 最好金额=预计在此月关闭的机会金额累计，不管当前的阶段
3． 预测金额=所有高于最低概率的机会金额*概率的累计金额。最低门槛定义于crmsfa.properties配置文件中.

季度预测是基于月度预测的累计。

查看任何的预测需要特别的权限。否则，你只能查看你自己的预测。

如果你拥有查看别人预测的权限，点击[查询预测]可以查询其它人的预测。你可以根据组成员或时间段来进行查询。查询的预测是按季度的。

默认的，只有销售经理或管理员可以修改已存在的预测。修改一个预测，点击预测的月份，输入修改后的定额，填写更改备注，然后点击[修改]。此月和季度的预测值将会被修改。

每当预测被修改，旧的版本将会被保存为历史。当查看预测时，你可以查看整个的预测修改历史（包括旧版本的修改日期与定额、最好预期和预期）

当一个时间段正式关闭或已结束，对应的预测不允许再修改。

如果在一个时间段已创建一个预测，当新的机会创建或已存在的机会更新时，它将自动更新。与该机会相关的客户/线索相关的预测成员将会自动更新。如果机会预计关闭日期被移至一个新的时间段，受影响的预测将会更新。然而如果机会移动到一个未建预测的时间点时，新的预测将会自动建立。

报价

报价部分允许你为自己的客户查看和创建报价。关键特性包括根据报价名称、类别、状态查询报价；创建报价；根据报价创建订单。注意这些屏幕同样是“订单管理”中的报价屏幕的一部分。
报价的重要功能包括：
• [查询报价] –查询报价信息
• [查看报价] – 查看报价的摘要信息
• [报价] – 管理报价的表头信息，包括客户与仓库
• [报价细项] – 增加/删除报价项和修改它们的价格
• [创建订单] – 根据报价内容创建订单

订单

订单部分允许你在CRM/SFA应用中查询订单或创建新订单。

0.9.x版本的订单页是基于OFBiz订单管理导入的，可以在“General Overview”中查看相应的详细文档。

1.0.x及之后版本的订单页重写支持订单的输入和查询。你可以在此页中为客户创建和查询订单。

“我的订单”页用于显示当前登录用户的订单。

你可以客户详细信息屏幕中的订单页中使用快速创建订单，或直接使用[创建订单]链接来创建一个新的订单。

如果你使用快速创建订单，你必须输入客户、订单名称，和要求发货日期。你可以输入一个产品id，系统将会加入数量为1.0此产品进入你的订单。

注意在订单管理中“要求发货日期”与“发出日期”是相同的。它不是订单管理中的“要求发货日期”。那个字段在现阶段不支持。

当你输入所有的订单项目后，点击[完成订单]。你将查看到一个要求你为每个订单项选择发货目的地与方式的屏幕。在你确认后，系统将自动创建多组分离的目的地与发货方式的发货组。

其它的订单项屏幕与订单管理中的相同。

订单项产品仓库配置于config/crmsfa.properties文件中。当前CRM订单项系统支持每个订单项只来源于一个产品仓库。这次不支持产品目录。

市场

市场页准备用于不同的市场相关的功能。当前只有系统中的调查列表及允许你查看这些调查反馈的结果。

服务调查

这里有一个独立的web应用用于发送客户调查、投票。当前，这是一个非常简单的web应用可以用于显示调查，收集反馈然后向客户答谢。

你可以在内容管理中创建调查，然后通过以下地址访问它：
http://www.mysite.com/surveys/control?surveyId=${surveyId}
其中${surveyId}是你的调查在内容管理中的ID
你可以通过crmsfa/webapp/surveys/子目录中的文件来定制它。

OFBiz

你可以通过crmsfa.properties中的“crmsfa.tab.ofbiz.show”参数来启用/禁用显示返回至OFBiz链接，如果启用，你将在标签页中查看到OFBiz的链接。

如果你打算为你的用户设置访问OFBiz应用权限，请查看Security Documentation了解更详细的内容。

技术备注：同其它应用整合

报价，订单和市场页实际上是重用订单管理与内容管理（调查）中的屏幕，它们是这样做的：
1. 在CRM/SFA应用中创建装铈页面
2. 在web.xml中设置对应应用main-decorator-location 参数，这样这些屏莫在CRM/SFA应用中调用时，它们将使用CRM/SFA中的屏幕样式来替代原来的样式显示。
3. 从原来的controller.xml中复制相关的view- 和 request-maps到 CRM/SFA应用中的controller.xml
4. 在订单项中，原来订单管理中客户的链接是链接至Party Manger的，而在CRM/SFA中应将参数修改至客户页面。

本文档译自opentaps v0.9 manual,本人翻译,欢迎转载,请注明出处.

CRM/SFA设计用于销售代表、销售经理、客户服务代码管理公司中销售和客户服务的应用，它的主要功能点是：
• 跟踪销售情报
• 识别销售线索并将此转换成客户
• 跟踪客户联系
• 输入和跟踪商机开始到结束的生命周期
• 管理客户销售报价
• 创建和查看客户/联系人销售订单
• 生成销售预测
• 管理客户案例子 (客服请法语)
• 发送电子邮件
• 管理活动和工作，包括会议、电话、电子邮件
• 跟踪市场活动如：客户调查

创建新用户

创建新用户需要在Party Manager中操作，点击[Party] > [Create]创建一个新的参与者。至少为其分配一个以下角色：“Account manager”, “Account Rep”, “CSR”。注意每个用户可以拥有其它的角色如“Employee”、但只有以上三个角色用于CRM/SFA应用，下一步创建一个用户登录并且为其分配安全组：SALES_MANAGER, SALES_REP, 或 SALES_REP_LIMITED, 或 CSR

注意：在party manager中的角色与CRM/SFA中的角色是不同的，在party manager，角色仅定义为一些人或组面对另一些人或组时的身份。在CRM/SFA中，角色意味在客户销售关系中的分演的角色，而且它也暗指着一组对应的权限。

如果用户忘记自己密码，可以通过“忘记密码”功能将新密码邮至原来预设的个人邮件地址中。

用户概况

在CRM/SFA应用界面中的顶部[概况]链接位居用户名与[登出]按钮之间。点击此链接可访问用户概况页面，你可以在此页面中修改用户名称，修改密码，增加联系方式信息（如：电邮、邮政地址、电话等）。注意你不可能在这里更改用户登录信息（这只能在Party Manager中操作）。此页还可以查看用户过往的访问历史。

我/我的团队

从0.9.1版本开始，你可以在[我的帐号]的右边看到[我的团队帐户],如果你点击我的帐户，你的登录将被配置为只查看你的个人信息而非使用团队帐号。这个功能工作于线索、联系人、案例、机会。

帐号组

CRM/SFA应用中的帐号组是通常用于工作于同一组角色和权限组合的团队， 一个组在它建立时可以被分配一个帐号。接着，帐号组管理员或帐号所有者可以重新分配组成员或他们的责任，这样很大程度不同于“军事单位”组，通常那些组是一直拥有固定的领导、成员的。

为了创建一个组，你需要使用Party Manger。在[Party] > [Create] >> [Create New Party Group]并给你的组命名。然后在[Roles]处分配一个[Account Team]角色给它。然后在[Relationships]处加上你的组成员。以下信息项必段输入：
• 组PartyId
• 组成员角色 (Account Manager, Account Rep, 或 CSR), 基于早先创建的用户所分配的角色.
• “Is a” 字段必须设置为“Assigned To”
• 组角色应该设置为 “Account Team”
• 设置起时日期
• Party Relationship Security 必须是你的组安全权限.  在 Party Manager, 一长串安全组将会显示，选择一个与CRM/SFA 应用相关的安全组.  (查看 “Security Documentation.”)
联系信息

系统允许你为每个人/组建立多重的联络方式信息，你的帐号、线索、联系人都可以根据你的需求输入任意多的电话号码、地址、电子邮件地址。每个联络信息都需要标识出它的用途。

当你使用[创建联系人]、[创建线索]、[创建帐号]，系统将基于你的表单输入创建以下联系信息：
• 地址信息将被做为“一般信函地址”与“一般收货地址”
• 电话号码将做为“主电话号码”
• 电子邮件将做为“主电子邮件地址”
• 网站地址将做为“主网站地址”

但你在创建联系信息时，你应当创建电子邮件作为主电子邮件地址及地址做为一般收货地址。主电子邮件地址将用于发送自动通知邮件。一般收货地址用于订单发货。

电话号码和电子邮件在所列帐号、线索、联系人的主电子邮件和主电话号码。

你可以点击任何的列在联络系统中的电子邮件地址来发送电子邮件，查看下面的“发送电子邮件”

备注

在CRM/SFA应用中，很多东西可以创建和保存备注。备注菜单通常在屏幕的下方。

本文档译自opentaps v0.9 manual,本人翻译,欢迎转载,请注明出处.

CRM/SFA应用很大程度不同于其它的OFBizBiz应用，OFBIZ应用设计为一组可以整合在一起适合各种商业活动的进程，CRM/SFA应用设计为支持角色/活动的全部活动在CRM应用中，这样子，它将带来与其它应用的很多不同点

1.CRM/SFA的商业逻辑粒度小于其它OFBiz，而且通常会调用很多其它应用中的action。如当创建一个帐户时，CRM/SFA应用将调用另一个OFBiz服务创建Party、PartyGroup、PartyRole、PartyRelationship等等

2.在OFBiz其它应用中高度抽象的数据模型在这里表达成更传统直观的概念。示例，“Party”被表达成为account ,lead, contact, team, 或 team member,  它们拥有不同的用户界面和业务逻辑。

3.OFBiz的“WorkEffort”面向用户时表达为“Activity”,而且只是事件和业务可作为“Activity”,其它的 “WorkEffort”例如制造产品过程在CRM/SFA中不显示出来。

4.它拥有PartyRelationship.securityGroupId定义多个参与者之间权限的不同的安全模型（示例，组成员A是否有权访问B帐户？）它使用了不同的安全方法（查看“Security Documentation”了解详细信息）

用户界面原则

CRM/SFA应用有一个不同于其它OFBiz应用的界面原则。简单来说，此原则就是 建立一个容易让用户明白和使用的界面，好过让用户不停的思考如何使用。

示例，“work effort”是一个OFBiz中的a task, a project, an event, 或a manufacturing production step,在OFBiz的WorkEffort应用中让用户自己创建它时选择对应的实例选项，而在这里，WorkEffort被分离在不同的人机界面上显示各自的特性。

大多数使用者，不会想“我打算创建一个work effort在参与者X和Y之间”，他们通常想“我为参与者X和Y在明天上午建立一个约会”。这样CRM/SFA应用提供创建约会界面并加入参与者X和Y，在此界面启动约会及完成它。

所以这意味着有些在OFBiz中允许的操作在CRM/SFA界面中不再被允许。示例，在OFBiz创建一个“EVENT”类型的work effor时可把它关联到货运或产品制作过程。这些信息在OFBiz的work effort中是可见字段，尽管work effort在event中并无这些关联字段。另一面，在CRM/SFA中界面看不到这些字段

这样的功能减少带来的是操作的易于理解，且也让一些日常的操作减少不必要的步骤。

另一个UI原则是将很多分离的步骤合而为一个操作步骤。最好的例子是当你创建一个联系人时，你可以在一个屏幕内输入所有联系人信息，而系统会自动的根据信息创建参与者、联系信息及关联项，将很多分离在不同OFBiz中的应用合而为一。

 
最后，我们打算避免用户点击回退、向前去查看信息，所以太多数屏幕都把信息显示在同一个屏幕里，而不是提供很多的信息标签

编码约定

另外，创建CRM/SFA应用，我们还有一些与其它不同的编码约定：
1.强制要求将视图与数据准备分离，我们限制视图层如freemaker页/XML只承担展现数据功能。这样意味着在form组件中不会存在”action”标签。

2.在屏幕组件定义中，使用beanshell脚本比<entity-one> XML操作更好。

3.Minilang脚本在一个方法中不要超过十行。使用java来编写复杂的商业逻辑。不要在minilang中使用<or>、<and>及计算。

4.保证代码块简捷。一般的，如果你的方法超过两百行，建议你考虑如何重构它。

5.为你的代码加上注释。描述你编码的目的和结果，而不仅是你做了什么。示例，如果你编写了如下代码
 invoiceId=null;
不要注释写成：//设置InvoiceId为null
而应该写成：//invoiceId应该为空，否则服务不会创建一个新的发票

6.使用较长的变量/方法名称，如：computeForecastParentPeriod，而不是一个很短无意义的名称。

7.使用意指你所调用的实体对象的变量名，而不仅是一个缩略的变量名。 示例，如果你获得一个orderItems集合，变量名不要仅叫做”item”——可以叫它们”orderItems”或”nextOrderItem”，诸如此类。如果你获得一个OrderPaymentPreference实体，不要命名为“payments”，因为Payment实体同你命名的这个对象不是同一个东西。

8.在FTL、表单组件、beanshell和Java服务中使用java来帮助将复杂的逻辑进行分离。

9.将代码分离在应用的不同目录中，将表单、屏幕组件XML文档放在widgets目录中，将JAVA包放在src/目录下，FTL放在webapp/crmsfa/，BSH脚本放在webapp/crmsfa/WEB-INF/actions/中…

10.在服务XML中加了相关注释指出需注意的事项或此服务可能发生的意外

本文档译自opentaps v0.9 manual,本人翻译,欢迎转载,请注明出处.