SAGE x3培训资料-安装、维护与开发

目录安装、维护与开发声明本文所含信息代表了SAGE 公司在本文发布时的观点。因为SAGE 必须响应不断变化的市场条件，这些信息不应被视为SAGE 方面的承诺，同时SAGE 也不能保证本文发布之后其他任何信息的准确性。本文档仅供参考。SAGE 对本文档中的信息不提供任何形式的（包括明示或暗示的）保证。版权用户有责任遵守所有适用的版权法。在版权法所赋予权利的前提下，未经SAGE 明确的书面许可，任何人不得将本文复制、存储或引入可检索系统，或是以任何形式或通过任何方式（电子、机械、影印、录制或其他方式）传播本文的任何部分。商标本文主题可能涉及SAGE 的专利、专利申请、商标、版权或其它知识产权。除非获得SAGE明确的书面许可，否则提供本文档并不代表许可您使用这些专利、商标、版权或其它知识产权。目 录1 系统安装51.1环境要求51.2.1硬件环境51.2.2软件环境51.2.3远程环境71.2安装步骤71.2.1安装MS SQL Server数据库环境71.2.2安装Oracal数据库环境81.2.3C/S架构161.2.4B/S架构421.3卸载步骤421.4系统补丁421.4.1标准补丁421.4.2客户化程序421.5系统升级431.6系统迁移431.6.1 Folder导入431.6.2 Folder导出451.6.3Folder置零461.6.4Folder生成462 系统维护472.1用户权限472.1.1用户设置482.1.2权限设置4用户功能设置4功能权限4用户菜单设置50数据访问码502.1.3 口令更改512.2数据导入/出512.2.1模版设置512.2.2导出模版522.2.3拷贝模版522.2.3 导入数据532.2.4 导出数据532.3备份和恢复542.4翻译552.4.1 表翻译552.4.2 描述翻译562.4.3文本翻译562.4.4 屏幕翻译562.5数据同步572.6系统监控572.6.1工作流程监控572.6.2在线用户监控582.6.3批次服务监控592.6.4打印服务监控593 开发593.1 表结构更改593.1.1 新建其他表593.1.2 已有表的变更603.1.3 本地菜单的变更623.1.4 业务代码Activity Codes623.1.5 数据库批量更新643.2 屏幕设置653.2.1 基本概念653.2.2 参数设置663.2.3 对象设置673.3 窗口设置673.4 查询设置683.5 报表设置691系统安装1.1环境要求1.2.1硬件环境1.2.2软件环境1. 检查您的操作系统中是否包含最新版本的 : Microsoft .NET Framework Microsoft Visual J# .NET如果没有以上组件，请先安装它们. (在光盘上的 “FREECOMPONENTS”目录下)图表 1图表 22. 在服务器上创建一个本地用户（例如：Adonix）:路径：控制面板 管理工具 计算机管理 本地用户和组步骤：新建用户Adonix 将Adonix加入管理员组 3. 此用户必须隶属于系统管理组“Administrators”并在本地安全策略中赋予以下权限 : 以操作系统方式操作 作为服务登录图表 31.2.3远程环境1.2安装步骤1.2.1安装MS SQL Server数据库环境X3需要在非空实例名的MS SQL Server环境下创建帐套数据库，因此要注意不要创建默认实例，且要设定登录方式为混合登录，并设定admin密码。以MS SQL 2000版本为例，以上2点如下图。1) 实例名不能为空，例如“Adonix” ：图表 42) 选择“混合模式”：图表51.2.2安装Oracal数据库环境 安装数据库以Oracal 9i版本为例的Oracal数据库安装步骤如下。1) 插入安装光盘，点击“Install/Deinstall Products”按钮，开始安装 Oracle 9i 数据库 。图表 5图表 72) 指定Oracle主目录名和全路径 ：图表 83) 选择 “Oracle 9i Database” :图表 94) 选择 “标准版” :图表 105) 选择 “只安装软件” :图表 66) 开始安装，点击“安装”:图表 安装Patch Oracle 1) 指定 Oracle 主目录进行更新 :图表 82) 在安装Patch 前必须先更新 OUI （Oracle Universal Installer）至版本8.0 :图表 93) 点击“安装”更新OUI :图表 104) OUI更新完毕后，选择Oracle 9iR2,“下一步”继续 :图表 115) 在安装 Oracle Patch之前，需要停止所有的Oracle服务。如果没有这样做，会跳出一个警告提示。在点击“重试”按钮前，停止警告框中指定的服务 :图表 126) 配置 Oracle 9i 监听程序 :图表 18图表 19图表 13图表 14图表 15图表 167) 修改安装路径下的SQLNET.ORA文件内的参数。 %ORACLE_HOME%networkadminSQLNET.ORASQLNET.AUTHENTICATION_SERVICES=(NONE)图表 17图表 181.2.3C/S架构安装ADXADMIN 服务1) 打开光盘上X3V145ADONIX installation V140 路径下的index.htm页面，选择英语国家的国旗进入安装提示页面。图表 19.1图表 20.22) 点击页面上的链接，或者直接运行“ADXADMIN”文件夹下的 setup.exe 安装 Adonix Runtime :(安装文件路径：ADXADMINsetup.exe)图表 213) 指定Adonix Runtime的安装路径 (例: D:AdonixV14ADXADMINRuntime) :图表 224) 单击“Next” Service name和port（必须大于等于1801）是可以更改的，如用Default ：图表 235) 单击“Next”，出现更新services file的对话框，这里用Default如下图 ：图表 246) 单击“Next” 会出现修改C:WINDOWSsystem32DRIVERSETCSERVICES file成功的提示 :图表 257) 单击“确定”，出现安装程序安装的过程 :图表 268) 最后安装成功， 出现如下图 :图表 279) 安装成功后，要保证ADXADMIN服务启动，如下图 :（如何进入服务：点击“开始”-“运行”，输入“services.msc”）图表 2安装Solution Components (Include: Base, Process Server, Application)1) 在网页上点击链接，或者由路径：ADXAPPLICATIONSetup.exe直接运行安装文件单击“Next”,出现如下界面：选择安装语言。图表 292) 进入欢迎界面，点击“Next”。图表 303) 指定一个Solution名称(例如：X3V145) :图表 314) 单击“Next”,选择需要安装的组件 (基于不同的数据库选择 Base Oracle 或者 Base Sal Server) :图表 325) 继续单击“Next”，直到看到如下界面，选择参考Folder :图表 336) 单击“Next”，安装直到 :图表 34图表 3安装 Documentation1) 运行安装文件，出现下图(安装文件路径： ADXDOCsetup.exe) :图表 362) 单击“Next”, 出现如下图 :图表 373) 单击“Next”, 出现如下图 :图表 384) 单击“Next”, 出现如下图完成安装:图表 3安装 Consule1) 先决条件 : Microsoft .NET Framework Visual J# .NET2) 运行Console安装文件(安装文件路径：ADXCONSOLEsetup.exe) :图表 403) 单击“Next”，出现下图 :图表 414) 单击“Next”,直到完成安装 :图表 4配置 Consule1) 双击图标，启动Console ：图表 43 2) 更改界面语言设置Default为France，如图点击Console-preference :图表 44 进入配置界面，在interface标签下的Fran*更改为English 如图：图表 45点击“ok”后退出console, 重新启动界面语言将转换为英文。3) 点击增加一个solution :图表 46输入solution的名称和描述创建一个新的Solution ID 和描述，点击“OK”继续 ：图表 47图表 484) 点击“Load a database component”配置并创建数据库 ：图表 49然后点击“New”，输入已经安装过数据库组建的Server Name进行数据库配置图表 50图表 51图表 52数据库的一些默认参数将会显示，您可以定义它们 ： 其中有几个必须定义的参数：Oracle 或者 SQL SID,DBMS installation path, . 点击“Advanced parameters”可以显示所有参数。 定义好参数后点击窗口下方的“Save”保存配置，然后点击“Data”创建数据库图表 53图表 54选择“Total configuration”开始创建数据库图表 55确定后继续，直到完成图表 56如果创建过程中发生错误，需要从 Parameter 和 Trace 页签中查看更多信息。数据库创建成功后，状态将从“IDEL”变化成“ACTIVE”图表 575) 点击“Load an application component”配置 Adonix Application :图表 58图表 59图表 60图表 616) 点击“Load a main process server component”配置X3 main runtime :图表 62图表 63图表 64指定 Adonix Service 端口号和License文件的实际存放路径：图表 65点击“Save”保存参数后，点击“Application”按钮生效配置 ：图表 66配置完成后，Application 和 Runtime的状态从“IDEL”变为“ACTIVE”状态。图表 677) “在线帮助”的配置 ：选择“Linked Servers”页签，点击左下方的“Add”按钮。图表 68选择 DOCX3进行配置 :图表 69进行参数配置 :图表 70 Client user format Compressed format(CHM) : 如果您只使用C/S结构的话。 Expanded format(HTML) : Web方式。 Documentation access path(帮助文档路径) 图表 71 点击“Access test Client”可以测试帮助文档的路径是否正确 点击“Configure”生效设置1.2.4B/S架构1.3卸载步骤1.4系统补丁由 开发/工具/补丁/整合补丁进入，选择补丁路径，点击“成功”按钮。1.4.1标准补丁1.4.2客户化程序1. 在X3服务器上创建一个临时目录。把文件DTASIA001.dat复制到这个目录中。 2. 使用admin登录到X3参考文件夹。进入开发/工具/补丁/整合补丁patch Integration。 在“补丁文件文件夹”中输入完成的输入补丁文件的路径和文件名。例如：X:/tempDir/DTASIA001.datX:/是创建临时目录的驱动器， tempDir 是临时目录的名称。你也可以右键单击“补丁文件文件夹”输入框，以调用标准的X3文件选择程序。选中“整合补丁”和“提示覆盖”。 在文件夹选择列表中，选择你想要应用这个补丁的文件夹。在列表中移除任何你不想要更新的文件夹。请务必包括X3参考文件夹，除非这个补丁只是为了在单一文件夹中进行测试。1.5系统升级1.6系统迁移1.6.1 Folder导入把帐套的相关文件拷贝到X3Runtime的安装路径的Folder文件夹下面。例：“D:AdonixV14V14LIYAFolders ”。1 进入Console平台，点击 ID图标， 选择Folder页签。2 点击右下角“Import”按钮，选择要被导入的folder，点击 OK 按钮。3 程序开始导入数据。1.6.2 Folder导出将Folder下的帐套文件和X3_pub文件夹下的帐套信息文件拷贝到目的文件夹。例如：1.6.3 Folder置零将文件夹置零功能可以将帐套中的业务数据全部删除，但是各种系统参数和基础档案全部会被保留。路径：开发/工具/目录/将文件夹置零1.6.4 Folder生成进入X3 folder中，由目录/ 目录打开帐套生成界面。点击左边的已有记录，然后修改目录代码，输入参考目录代码和复制目录代码作为此新帐套的源帐套。2系统维护2.1用户权限2.1.1用户设置由路径参数/用户/用户打开用户窗口，点击“新建”按钮新建一条有默认值的记录。输入登录名、菜单权限、功能权限代码。Step 1: From the pathParameter/ User/ User open Users Window, click new button to open a new record with default value. 2.1.2权限设置用户功能设置从路径参数/用户/用户功能设置打开功能设置窗口，在此可新建、修改、删除用户功能代码。每个代码的具体功能在功能设置菜单下完成。点击右下的“”按钮，可以进入功能设置窗口。Open the Function Window from the path Parameters/ Users/ User Functional Profile, click new button to open a new record with default value, you can authorize the default sites and accusable reports. This profile code can be used in the users define window. 功能权限路径 参数/用户/功能设置，打开功能设置。选择已存在的功能编码，点击右下“”按钮，再点击“”按钮，可按照模块附加功能权限。Parameters/ Users/ Function Profile. 用户菜单设置此功能是创建树状菜单，它可以与用户相连，比如可以为公司的采购员定义菜单，授权他们仅与采购相关的菜单访问权限。从行记录的右键菜单“来源/目标”进入或者推出菜单层次。路径：参数/用户/用户菜单设置This function allows you create and manage application menu tree structures that can be linked to a user, so that user will be provided with the specific menu profile. For example, menus can be defined for persons managing a companys purchase, providing access to virtually only purchasing functions.The path is Parameters/ Users/ Menu Profile.数据访问码访问代码（Access Code）被用来保护信息是否可读、可写、可执行。就类似在屏幕、报表、字段上挂了一把锁，当用户被赋予了访问代码，就可以打开这把锁。用户所有的访问码在用户信息中定义。These access codes are the codes that are used to protect the information or the functions, in read, write and execution mode (when the context permits it). In this case, these codes act a bit like a lock placed on a field in a screen, in a transacti on, in a report or in a database record. Following on from this, by defining for each user, it is possible to access protected information in this way (thus they have the key available allowing them to open the lock). This is defined in the user record: The rights to read, write and/or execution can then be assigned to a user. An All access codes tick box makes it possible for certain users to have access to all information protected by access codes.The path is Parameters/ Users/access code.2.1.3 口令更改以某用户登陆进入功能/用户/更改口令，输入新密码。2.2数据导入/出2.2.1模版设置由参数/应用/导入导出模版进入，设置模版。可以删除不要导出的字段，或者增添需要导出的字段。2.2.2导出模版打开功能 / 导入导出 / 导出，填入模版号，指定文件路径，不勾选按时间顺序，点击成功按钮，导出模版。2.2.3拷贝模版点击“复制”按钮，输入目的路径，将本模版拷贝到别的Folder中。2.2.3 导入数据开发 / 功能 / 导入导出 / 导入,指定要导出的表，和导入的文件夹名。2.2.4 导出数据开发 / 功能 / 导入导出 / 导出,指定要导出的表，和导出的文件夹名。2.3备份和恢复由开发 / 工具/ 备份恢复 进入界面，可以将现有帐套的数据进行备份、还原。2.3.1 备份选择要备份的帐套和要导出的表，点击“成功”按钮，导出数据。2.3.2 恢复由开发 / 工具/ 备份恢复 / 导入数据选择要恢复的帐套、表名，点击“成功”按钮。2.4翻译2.4.1 表翻译由翻译 / 表翻译进入界面，可以将多个表内字段的文本描述信息翻译成其他文字。完成后，点击“文本更新”按钮，系统会完成屏幕更新。2.4.2 描述翻译由参数 / 描述翻译进入界面，可以将其他表、其他参数表等表的字段文本描述信息翻译成其他文字。完成后，点击“文本更新”按钮，系统会完成屏幕更新。2.4.3文本翻译翻译 / 文本翻译进入界面，可以将多个表内字段的文本描述信息翻译成其他文字。完成后，点击“保存”按钮，系统会完成屏幕更新。2.4.4 屏幕翻译翻译 / 画面翻译进入界面，可以将屏幕的文本描述信息翻译成其他文字。完成后，点击“保存”按钮，系统会完成屏幕更新。2.5数据同步2.6系统监控2.6.1工作流程监控此功能允许按不同的条件查询工作流监控器的日志文件。当特定的事件发生时，会被记录进日志文件。有了这些事件记录，工作流规则功能象日志文件的内容一样，被用于设置触发器事件和条件。路径功能/工作流程监视器This function allows you to inquire on the Workflow Monitor log file, according to different criteria. This log file is loaded when specific events occur in the software. To have these events tracked, the Workflow Rule function is used to set up the triggering events and conditions, as well as the log files content. 2.6.2在线用户监控此功能被用来查看服务器上不同的任务进程、用户。默认当前进程所在的服务器的全部任务，单身可以输入其他服务器的IP或者机器名，以显示它们的进程。可以通过点击“现行进程”行记录的右键菜单“进程结束”来强行结束此用户的进程。路径开发/ 工具/检验/用户监控器。This function is used to view the different Adonix tasks in process on the server. By default, the current process server tasks are displayed, but any server accessible via the network that has a software connection process with the same service numb er can be accessed.2.6.3批次服务监控此功能用来查看已安装的X3的特性参数。如果机器字段为空，表示默认链接的服务器。也可输入其他服务器的IP或者机器名，以显示他们的特性。路径开发/ 工具/检验/服务监控器。2.6.4打印服务监控3 开发3.1 表结构更改3.1.1 新建其他表Step 1：由开发/数据和参数/其他表的定义打开界面，新增一个其他表，此表可以用来存储任意字段的值列表或者附加信息，如：税率级别、付款条件、统计组的值列表等。Step 2: 由开发/数据和参数/其他表打开其他表，在新建的表中加入值列表。3.1.2 已有表的变更1 由开发/数据和参数/表打开表，可插入列或在最后新增列，ADI型需要指定相关的字段，可引用自定义的其他表。表字段的数据类型：详见 开发/数据和参数/数据类型.类型类型说明A文本类型D日期类型L长整型ADI关联到某字段CRY系统默认的类型。BPRBPSNUM 字段，可引用到商业伙伴列表。（默认activity code 是CFG）。Step 2 新建成功后，进行屏幕审核，改变相关的屏幕设置。审核后的product屏幕：3.1.3 本地菜单的变更由开发/数据和参数/本地菜单（Messages）进入，更改菜单名。3.1.4 业务代码Activity Codes业务代码的功能如下：1 标志字典（表，索引，标签，屏幕区域或字段）中活动、不活动的元素。2 影响表中字段的大小。 3 确定字段和对参数开放的屏幕区域的大小。4 标识为本地化开发的元素，如这些元素以K开头的业务码标识。5 标识客户、特殊元素：这些元素以X、Y、Z开头的业务码标识。这样，在升级的时候，或者打补丁的时候，这些标识都会被永远保留下来。6 业务码的值在帐套管理中被定义；只有独立的码才能输入；关联其他业务码的号码以功能的值或输入的、以前计算的代码来升