集团级预置职责数据导入开发指南.docVIP

集团级预置职责数据导入开发指南 版本 维护人 维护时间 相关文档 备注 V60 陈伟 2011-5-26 集团级预置职责数据导入开发指南 背景 集团级预置数据，需要在集团启用时将预置数据导入到数据库中，但每个集团的预置数据其主键应该不同，因此不能用通用的基准库导出SQL脚本的方式预置。本文档将说明以CSV文本记录预置数据并在集团启用时导入数据的方法及开发步骤。 需要注意，通过本方法导入预置数据，要求被导入数据必须有相应的元数据实体。 开发步骤 创建模块预置数据目录 在nchome\resources目录有一个predata目录，用于存放预置数据的注册信息及数据文件。各模块需要在该目录下创建自己模块的目录。注意，模块目录的名称必须是dap_dapsystem表中注册过的模块编码（systypecode），且目录名应该小写。如果注册的模块名在dap_dapsystem. systypecode中查询不到、则不能将该目录下的预置数据导入数据库。 注册数据文件路径 在模块目录下，增加一个*.ini文件，其文件名为组织类型的元数据ID，对于预置职责来说，其组织类型为集团，因此文件名应为GROUPORGTYPini。 ini注册文件的每行注册一个要导入数据的实体。每行的左侧为要导入的实体的元数据ID。每行的右侧为要导入的实体对应的数据文件的路径，该文件的路径是相对于当前模块目录的。中间用等号“=”连接。以“#”开关的行是注释行。 如\resources\predata\dem\ GROUPORGTYPini文件中定义了两个要导入的实体“职责”实体和“职责-功能-关联表”实体。第一行中“da66f038-f7d7-4f61-8bbf-9f3e1be27b38”为“职责”实体的元数据ID，“/rbac/resp.csv”为职责预置数据文件的路径。 预置数据的导入是按.ini文件中的注册顺序执行的，因此如果预置数据之间存在依赖关系，则需要将被依赖的实体注册在靠前的位置、依赖实体注册在靠后的位置。如“职责”实体先注册、“职责-功能-关联表”实体后注册。 示例参见“\resources\predata\dem\GROUPORGTYPini”。 准备预置数据文件 预置数据文件以.csv格式保存。预置数据文件可以直接存放在模块目录下，也可以存放在自定义的目录下，目录名可以自由定义，支持多级目录。*.csv文件的文件名可以自由定义。 预置数据文件*.csv的格式与excel导入的文件格式要求相同，即第1行第1列的值为元数据实体编码+各字段的编码，后面的字段为各字段的显示名。除要导入实体自身的主键外，其余引用档案的字段（包括上级实体字段）均设置为档案的编码；枚举字段的值均设置为枚举的显示名；UFBoolean字段的值设置为“Y”或“N”；预置数据文件的格式可以通过excel导入工具中的“导出格式”功能实现。 预置数据文件也有一些与excel导入数据时不同的要求。 首先，本方法目前不支持主子实体导入。主子实体应分为两个实体，数据存放在两个csv文件中。预置职责时，就是把“职责”和“职责-功能-关联表”分为两个数据文件导入的。 其次，本方法要求.csv文件中必须有主键列，每行都必须有主键。虽然导入数据库后，同一行预置数据在不同的集团中会有不同的主键，但我们仍需要其有一个预置的主键来为后继的多语言外挂方案提供数据定位的功能。 第三，预置csv数据文件中，如果存在多语字段，则预置的列中只能存在不带后缀的字段。如name字段是多语字段，在数据库表中有name、name2、name3……name6，在预置数据文件中只应包含name列，不应包含nameX列。并且所有多语字段的值均统一设置为“~”，即预置数据的多语字段的值均应为空，其真正的值应通过多语外挂方案存放在多语目录下，详见下节说明。 具体示例见“\resources\predata\dem\rbac\resp.csv”和“\resources\predata\dem\rbac\respfunc.csv”。 准备多语外挂文件 为了支持多语种，本方法采用了与预置脚本相同的多语文件外挂方案，它要求在每个模块目录下必须存在一个“dbml”目录用于存在多语文件。“dbml”目录下存放语种目录，每个语种一个目录，语种目录的目录名称必须等于语种编码（小写），如出厂预置的简体中文多语文件应放在“simpchn”目录下。 多语文件也采用.csv文件格式，每个语种目录下可自行创建多语文件或下级目录、支持多级目录、对文件名和目录名无要求，但同一数据库表的多语文件应放在同一文件中。 存放多语信息的.csv文件格式与预置脚本多语外挂文件相同。第一行为表名、第二行第一列为主键字段