新朗华ERP系统简明用户手册

新朗华ERP系统　　简明用户手册北京朗华世纪科技发展有限公司www.langhua.cn2006年11月北京朗华世纪科技发展有限公司　　　　新朗华ERP系统简明用户手册版权声明：　　新朗华ERP系统是北京朗华世纪科技发展有限公司在中国推广Apache OFBiz(简称OFBiz)项目所用的中文名称。本文档内容主要译自OFBiz网站的OFBiz Basic Production Setup Guide。本文档采用LGPL版权协议，北京朗华世纪保留本翻译的版权。北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册目录1.编写本文档的目标2.安装OFBiz时需要收集的信息3.常用术语和信息OFBiz管理程序OFBiz的其它术语4.安装步骤环境搭建安装OFBiz安装数据库加载种子数据配置OFBiz■缓存设置■调试工具设置■安全设置■URL和端口设置■端口、缺省值■SSL证书设置■货币、本地语言设置■电子邮件服务器设置■安装一个根Web应用运行OFBiz性能监控和优化5.业务安装过程公司公用信息设置■公司联系方式场所（仓库/仓储）设置站点设置店铺设置■店铺设置■店铺角色设置■促销设置■产品目录设置■站点设置■营业税设置■店铺货运设置•UPS在线费率估算•UPS XPCI整合•USPS在线费率估算北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册■店铺支付设置•支付处理详单•PayPal支付设置•CyberSource支付设置■电子邮件设置■网上调查设置■通用设置替代目录、种类和产品设置■目录设置■种类设置■产品设置•添加新产品内容•添加产品价格6.POS机设置步骤北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册编写本文档的目标　　在成为企业信息自动化的优秀开发框架和平台的同时，OFBiz还提供了许多不需要大量定制即可使用的杰出应用。然而，毕竟这是一个企业级软件，所以它包含了非常多的配置选项、设置和数据结构，需要你在一定程度上掌握。　　本文档的目的是帮助你在实际的电子商务应用中安装OFBiz。这里不会涉及讨论、决策或配置选项，而仅仅是OFBiz实际应用中所必需的那些基本设置的概述。　　有关安装的更详细的信息参见Undersun咨询公司提供的OFBiz“配置、部署和维护”文档。关于开发，我们推荐Undersun咨询公司的OFBiz培训录像和参考资料。　　本文档是一系列要遵循的使用说明。当然，你也可以把它作为参考手册。　　注意：我们推荐你在开始做任何操作或修改前先阅读整个本文档。边阅读本文档、边操作文件和网页会有更好的直观感受，更容易了解OFBiz看起来是什么样的、该怎么做。当然你也可以跳过本文档，但是相信花上半个小时研究一下本文档会节省你大量的时间。　　请留意本文档中使用的格式规范：　　方括号[[ ]]中的文本代表了一个OFBiz应用的浏览器标签。　　本文档的作者提供了很多专家建议或深入观察。这些内容用下列方式标识：　　专家建议：这里的一些文字需要你特别注意！　　本文档使用\${ofbiz install dir}表示OFBiz的安装起始目录（或称根目录）。这个标志后面通常会带有要讨论的文件或目录的路径名。　　OFBiz应用管理器的网页工具有单独的页面名称或表名称标题，页面名称和标题会用背景色高亮显示：这是一个页面北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册安装OFBiz时需要收集的信息1.技术信息●要部署的主机/域名（以及端口，如果不用80、443的话）●Web服务器设置：直接用Tomcat/Jetty，还是通过Apache，或者使用其它（单独的）应用服务器？●要使用哪一个数据库？数据库是安装在远程服务器上了还是在本地？2.公司会员（会员管理­ 查找­ 概述；会员Id: company）●名称●客户服务●电话号码●电子邮件地址●关联的通信地址3.仓储场所（场所管理­ 全部场所­ 场所）●每个场所的名称（如网上商店库房，或加州仓库，或伯班分销中心）●电话号码●运输和收货通信地址（名称）4.电子邮件设置(general.properties)●SMTP服务器(中继主机)●SMTP用户名(如果需要的话)●SMTP密码(如果需要的话)北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册通用术语和信息OFBiz“管理”应用程序　　OFBiz提供了一组管理应用程序，构成了OFBiz的后台管理功能。这些应用程序不是面向客户或公众的，而是让管理员管理OFBiz使用的。缺省情况下，管理应用程序使用标准的URL网址、通过内置的OFBiz安全服务访问。　　本文档中参考的管理应用程序包括：　　“目录管理”访问：http://localhost:8080/catalog/control/main　　“会员管理”访问：http://localhost:8080/partymgr/control/main　　更多Web工具或OFBiz架构工具在“Web工具”应用程序中：http://localhost:8080/webtools/control/main　　注意：OFBiz会自动根据登录情况在非安全和安全页面间转换。因此，当你初次访问上述管理应用程序时，你可以使用http。　　一旦你登录到任何OFBiz管理应用程序，在页面的上半部分会有一排标签，点击这些标签你就可以很方便地从一个应用程序切换到另一个，或者在其它窗口或浏览器标签页中打开。其它OFBiz术语　　在OFBiz中，“会员”是指一个单独的实体，可以是一个人或一家公司或一个家庭，甚至是一群朋友。换言之，会员可以代表一个个体（一个人）或一组会员，包括许多个体和其它组(一个会员组)。　　“实体引擎”是指嵌入的OFBiz数据库访问引擎。OFBiz中还包括了其它的“引擎”如服务引擎。这些引擎构筑了OFBiz逻辑和过程的服务导向的结构。北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册安装步骤环境搭建1.检查/安装Java SDK(要求使用1.4系列的完整的SDK，而不仅是JRE)2.检查/安装SVN客户端专家建议：如果你想仅安装OFBiz的二进制发布版，你不需要SVN客户端。3.检查/安装ant (1.6或更新)安装OFBiz1)如果你要使用OFBiz的一个开发过程中的版本，根据 的说明检出最新代码或你想要的稳定版本。2)在ofbiz主目录(你安装了OFBiz的那个目录)下使用“ant”编译。安装数据库　　缺省情况下OFBiz包含并配置了一个内嵌的Java数据库Derby。这个数据库过去称为Cloudscape，然后被IBM收购，改为遵从DB2规范，然后发布为开源数据库。这是一个很好的数据库，你可以用它来演示、测试、开发，甚至在小型实际应用中使用。　　专家建议：我们通常不推荐您在实际应用中使用Derby，因为它并不容易管理和优化，在性能上不如其它主流数据库。Derby是一个轻量级的Java数据库。　　专家建议：OFBiz可以使用很多数据库，无论是商业的还是开源的。我们通常推荐使用开源数据库如Postgres、MySQL的MaxDB或MySQL的近期的版本。使用什么数据库是一个重要的决定，可能会影响到后面的许多实情。如果你对数据库没有偏好，我们建议你在拍板前与有经验的咨询顾问讨论一下都有哪些数据库可以选择。1.如果你决定不使用嵌入的Derby数据库，请检查/安装你选择的数据库。2.如果需要，请把正确的JDBC驱动程序放入：${ofbiz install dir}/framework/entity/lib/jdbc替换其中旧的或不正确的驱动程序版本北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册3.从缺省的Derby数据库安装实体引擎以便使用其它数据库。在${ofbiz install dir}/framework/entity/config/entityengine.xml文件中：修改现在的数据源(靠近文件的结尾)，或通过复制一个样例数据源并指定一个新的不重复的名称创建一个新数据源●如果使用缺省的OFBiz交易管理和连接池，更新inline­jdbc标签中的数据URI(jdbc­uri)、用户名(jdbc­username)和密码(jdbc­password)。●如果你要在你的数据库中使用一个指定的库名称，那么请在datasource标签中设置(添加)schema­name属性。●找到靠近文件开始的name=”default”的delegator标签，把group­map标签中的datasource­name属性值改为你修改或创建的那个数据源。　　专家建议：如果你正在使用一个外部的应用服务器或要设置高级的实体引擎配置，请参阅《实体引擎配置指南》或其它在线文档。如果你要深入使用OFBiz，强烈推荐Undersun咨询公司的培训录像。加载种子数据　　要加载种子数据，只需要通过ant运行OFBiz安装程序，或者用java命令运行ofbiz.jar文件。缺省情况下安装程序会加载“种子”和“演示”数据文件，这些文件在entityengine.xml以及每个组件的ofbiz­component.xml中定义。在命令行中在ofbiz安装主目录下运行下面的两个命令之一即可执行缺省的安装程序：ant run­install 或者java ­jar ofbiz.jar ­install　　注意：你能选择只加载基本的“种子”数据而不加载“演示”数据。要做到这一点，运行下面的命令：java ­jar ofbiz.jar ­install ­readers=seed　　专家推荐：对于小型应用的安装我们建议加载演示数据，然后修改它，而不是从头开始创建全部数据。　　对于大型应用，我们推荐你创建自己配置的种子数据，可以从演示的种子数据开始，也可以全部从头开始。这些种子数据能够添加到安装数据文件的“ext”集合中，安装程序会引用ofbiz­component.xml文件中属性reader­name=ext的entity­resource标签。要加载seed和ext，可以运行下面的命令：北京朗华世纪科技发展有限公司　新朗华ERP系统简明用户手册java ­jar ofbiz.jar ­install ­readers=seed,ext　　种子数据包括一个ID为admin的会员，以及它所关联的、具有不同权限的一组用户登录帐户。请注意下列配置的修改：1.在实际系统上应把与admin会员相关的所有用户登录帐户的密码从缺省值改掉。2.admin的缺省密码是ofbiz，flexadmin和demoadmin也用的是这个密码。　　1这个帐户是为POS系统使用的，因此新的密码仅使用数字，这令POS终端使用起来很容易。　　专家建议：admin这个会员太重要了，所以一定要确定修改了它的密码，还有其它一些会员你应该检查和修改与它们相关联的用户的密码，这些用户包括ltdadmin、externaluser，如果加载了演示数据(缺省情况)，那么还要检查用户DemoBuyer、DemoRepAll和DemoRepStore(通过https://localhost:8080/ordermgr/control/login登录)。配置OFBiz缓存设置${ofbiz insall dir}/base/config/cache.properties　　如果来自SVN，那么这个文件被配置为适合开发使用，会频繁地重新载入资源。　　对于实际系统，应该把这个文件最后一段的那些缓存过期时间全部用#注释掉。需要注释的缓存设置以minilang.、script.、webapp.、widget.和template.开头。调试工具设置${ofbiz install dir}/base/config/debug.properties　　这个文件用于启用/禁用不同的日志级别，并用于设置Log4J的日志级别和输出配置。对于大多数实际系统，可以直接使用缺省的配置。