# fsys.openXml.editor 库模块帮助文档 ## fsys.openXml.editor 成员列表 # 现有 Office Open XML 包的受控替换与另存；不重建未知内容。 ### fsys.openXml.editor.open() # [返回对象:openXmlEditorObject](#openXmlEditorObject) ### fsys.openXml.editor.open(path,options) # 打开编辑会话；输入只读，含数字签名的包拒绝。读取限额同 open；失败 null,err。 ## openXmlEditorObject 成员列表 # ### openXmlEditorObject.applyParts(parts) # 原子新增/替换/删除部件；{name,data,contentType} 新增时须指定内容类型，{name,remove=true} 删除。自动更新内容类型；不自动维护部件关系或语义，不允许删除主文档/包根关系。全部校验后提交内存；失败无部分修改。 ### openXmlEditorObject.changedParts() # 返回显式改动的部件名称数组。 ### openXmlEditorObject.close() # 关闭源 ZIP，可以重复调用；之后不再读写。 ### openXmlEditorObject.getContentType(name) # 取得现有部件内容类型。 ### openXmlEditorObject.getMainPart() # 定位原包主文档。 ### openXmlEditorObject.getRelationships(sourcePart="字符串参数") # 读取当前关系；内部目标须存在，外部不访问。 ### openXmlEditorObject.listParts() # 当前现有部件清单；返回普通表数组。 ### openXmlEditorObject.path # 源包完整路径。 ### openXmlEditorObject.readPart(name) # 优先读取修改后的数据，未修改时读取原始部件并校验 CRC。 ### openXmlEditorObject.readXml() # [返回对象:msXmlNodeObject](#msXmlNodeObject) ### openXmlEditorObject.readXml(name) # 返回当前部件的独立 MSXML DOM；修改后须显式 setXml，不会自动写回。 ### openXmlEditorObject.save(outputPath,options) # 另存新包，默认不覆盖；即使 overwrite=true 也禁止覆盖源件/可识别别名。未修改部件的解压内容保持原字节，逐件 CRC 检查并重新压缩，不要求 ZIP 容器字节一致。失败不提交半成品，成功返回完整路径；不是压缩数据 raw-copy，无限大文件不受支持。 ### openXmlEditorObject.setPart(name,data) # 替换现有部件字节串，不自动新增类型/关系；成功 true，失败 null,err。 ### openXmlEditorObject.setParts(parts) # 批量替换现有部件；每项 name,data；先全部校验再提交内存修改，失败不部分修改。buffer 按当前字节复制。 ### openXmlEditorObject.setXml(name,node) # UTF-8 序列化 MSXML 文档根节点并替换现有部件；失败 null,err。