1. 标识
| 参数 | 值 |
|---|---|
| 对象类型 | 目录(Catalog) |
| 名称 | ДоговорыКонтрагентовПрисоединенныеФайлы |
| 全名 | Справочник.ДоговорыКонтрагентовПрисоединенныеФайлы |
| 同义词 | 「附加文件(往来单位合同)」 |
| 配置 | 哈萨克斯坦会计,3.0 版(3.0.74.2) |
| 文件所有者 | Справочник.ДоговорыКонтрагентов |
用途。 标准子系统库(BSP)「文件处理」子系统的服务性(技术性)目录。存储附加到「往来单位合同」目录元素上的文件:合同、补充协议、验收单、规格书及其他随附文档的电子扫描件。目录的每个元素即一个附加文件及其元数据(作者、日期、大小、扩展名、签名和加密标识)。用户间接使用该目录——通过往来单位合同卡片中的「附加文件」命令;它不会直接显示在命令界面的分区中。
此类附加文件会为每个启用了文件处理功能的所有者目录自动创建。往来单位、物料及其他配置对象也存在类似对象。
在哪里查找(导航链接): e1cib/list/Справочник.ДоговорыКонтрагентовПрисоединенныеФайлы——打开所有文件的服务性列表;在常规工作中使用合同表单中的「附加文件」命令。
2. 属性与表格部分
2.1 表头属性(来自 evidence)
| 名称 | 类型 | 必填性 | 用途 |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи | ShowError(必填) | 最初上传文件的用户。作者归属控制与审计。 |
| ВладелецФайла | СправочникСсылка.ДоговорыКонтрагентов | DontCheck | 文件所附加到的往来单位合同。确保与核心核算对象的关联。 |
| ДатаМодификацииУниверсальная | 日期(日期时间) | DontCheck | 文件最后修改的日期/时间(UTC)。用于同步和跟踪版本时效性。 |
| ДатаСоздания | 日期(日期时间) | ShowError(必填) | 最初上传的日期/时间。用于时间顺序核算和排序。 |
| Зашифрован | 布尔 | DontCheck | 文件由证书加密的标识。决定打开前是否需要解密。 |
| Изменил | СправочникСсылка.Пользователи | DontCheck | 最后修改文件或其元数据的用户。审计与版本控制。 |
| ИндексКартинки | 数值 | DontCheck | 文件图标在界面图像集合中的索引(按扩展名)。 |
| Описание | 字符串 | DontCheck | 对文件内容/用途的任意文本描述。 |
| ПодписанЭП | 布尔 | DontCheck | 至少存在一个有效电子签名的标识。 |
| ПутьКФайлу | 字符串 | DontCheck | 文件在存储卷上的路径(用于「磁盘卷」存储);在数据库存储时不填写。 |
| Размер | 数值 | DontCheck | 文件大小(字节)。用于控制容量和上传限制。 |
| Расширение | 字符串 | DontCheck | 文件扩展名(pdf、docx、jpg …)。决定类型、打开程序和图标。 |
| Редактирует | СправочникСсылка.Пользователи | DontCheck | 占用文件进行编辑的用户(防止同时编辑的锁定)。 |
2.2 BSP 附加文件的典型属性
除 evidence 中所列外,BSP 附加文件目录还标准包含若干确保版本管理和内容存储的属性:
| 名称 | 类型 | 用途 |
|---|---|---|
| Наименование | 字符串(主字段) | 不含扩展名的文件名——显示在列表中。 |
| ТипХранилищаФайлов | ПеречислениеСсылка.ТипыХраненияФайлов | 存储方式:在信息库中或在磁盘卷中。 |
| Том | СправочникСсылка.ТомаХраненияФайлов | 存储卷(当类型为「磁盘卷」时)。 |
| ТекущаяВерсия | СправочникСсылка.…ВерсииПрисоединённыхФайлов | 指向文件活动版本的引用(启用版本管理时)。 |
| ЗагруженВБазу | 布尔 | 文件内容已放入值存储属性中的标识。 |
| ХранилищеФайла | 值存储 | 文件的二进制数据(存储在信息库中时)。 |
版本管理服务属性的确切集合取决于内置于 3.0.74.2 中的 BSP 版本——需在具体交付版本中核实。
2.3 表格部分
该目录没有表格部分。文件是原子实体:目录的一个元素对应一个附加文件。版本和电子签名的数据被放入独立对象(版本寄存器、数字签名信息寄存器),而非表格部分。
3. 表单
附加文件服务性目录通常不重写自身表单——工作通过 BSP「文件处理」子系统的通用表单进行:
| 表单 | 类型 | 用途 |
|---|---|---|
| ОбщаяФорма.ПрисоединённыеФайлы | 列表表单 | 附加到具体合同的文件列表。通过「附加文件」命令打开。命令:添加、打开、编辑(占用/释放)、保存更改、版本、电子签名、加密。 |
| ОбщаяФорма.ПросмотрФайла / КарточкаФайла | 元素表单 | 查看和编辑文件元数据:描述、作者、日期、大小、版本、签名。 |
| ОбщаяФорма.ФормаВыбораФайлов / ДобавлениеФайлов | 服务性 | 从磁盘上传文件并创建目录元素的对话框。 |
| 列表表单(自动) | 列表表单 | 通过导航链接 e1cib/list/… 自动生成的列表,用于服务/管理访问。 |
如果在具体交付版本中表单确实在目录级别被重写——其用途与上述所列一致;需按 3.0.74.2 的元数据组成核实。
4. 模块关键过程
evidence 中未附独立的 BSL 代码。对于附加文件服务性目录,主要逻辑不在对象模块中实现,而在 BSP 文件子系统的通用模块中(РаботаСФайлами、РаботаСФайламиСлужебный、РаботаСФайламиСлужебныйКлиент、РаботаСФайламиСлужебныйВызовСервера)。此类对象的典型处理程序和逻辑点:
- МодульМенеджера.ПриПолученииФормы / ПередОткрытием——将自身表单替换为 BSP 通用表单。
- МодульОбъекта.ПередЗаписью——填充服务字段:
ДатаМодификацииУниверсальная、Изменил、ПодписанЭП/Зашифрован标识,重新计算Размер。 - МодульОбъекта.ПередУдалением——在删除存储于信息库外的元素时,清理磁盘卷中的内容(删除物理文件)。
- 通用模块
РаботаСФайламиСлужебный——方法ДобавитьФайл、ОбновитьВерсиюФайла、ЗанятьФайл/ОтпуститьФайл,版本、电子签名和加密的处理;正是它们创建和修改该目录的元素。 - 编辑锁定处理程序——设置/取消
Редактирует属性,以排除多个用户同时修改文件。
不列出具体的
路径:行号——未提供模块源代码的 evidence;此处列出的是 BSP 附加文件特有的标准处理程序。
5. 过账与登记
该目录不是文档,也不过账——它不生成寄存器和会计分录。这对该类对象至关重要:附加文件存储的是电子文档,而非经济生活事实。
所生成的数据具有核算-技术性质,由文件子系统创建,而非过账机制:
- 将内容写入值存储(存储在信息库中时)或将物理文件写入磁盘卷;
- 将版本写入附加文件版本的服务性寄存器/目录;
- 将电子签名信息写入 BSP 数字签名信息寄存器。
会计含义(按哈萨克斯坦标准科目表的分录)不产生于文件,而产生于关联的所有者文档。作为参考——这些分录由所附文件所属合同的销售/入库文档生成,例如:
| 所有者文档操作 | 借 | 贷 |
|---|---|---|
| 向购买方销售(收入) | 1210 | 6010 |
| 计提应缴增值税(税率 16%) | 1210 | 3130 |
| 结转商品成本 | 7010 | 1330 |
| 购买方付款至活期账户 | 1030 | 1210 |
| 从供应商收到商品 | 1330 | 3310 |
此类合同的电子文档(ИС ЭСФ 中的 ЭСФ、СНТ)由专门的配置对象开具;附加文件本身仅存储其电子副本/扫描件。所有者文档中的所有税额均按哈萨克斯坦 2026 年规范计算(增值税 16%、ИПН 10%/15%、ОПВ 10%、ОПВР 3.5%、ВОСМС 2%、ОСМС 3%、СО 5%、社会税 6%;МРП 4 325 ₸、МЗП 85 000 ₸),但它们与文件目录本身无关。
6. 关联对象与基于录入
所有者(必填关联):
Справочник.ДоговорыКонтрагентов——通过属性ВладелецФайла设定;确定文件所属的合同。
BSP 文件子系统的相邻对象:
Справочник.ПользователиНаборыФайлов/ 附加文件版本寄存器——存储版本历史;РегистрСведений.ЭлектронныеПодписиФайлов(电子签名信息)——用于ПодписанЭП属性的签名数据;Справочник.ТомаХраненияФайлов——用于「磁盘」存储的存储卷;Перечисление.ТипыХраненияФайлов——存储方式;Справочник.Пользователи——属性Автор、Изменил、Редактирует。
基于录入。 该目录不使用「基于录入」机制——元素仅通过往来单位合同表单中的「附加文件」命令(添加/上传/扫描)以及 BSP 编程方式创建。
7. 扩展点
- 文件上传/保存——通过通用模块
РаботаСФайлами*重写(借助配置扩展),但需谨慎:这是 BSP 代码,会随平台库一起更新。 - 附加属性和信息——文件服务性目录通常被排除在带附加属性的对象组成之外;如有需要,任意标记存储在
Описание属性中。 - BSP 事件处理程序——订阅附加文件写入事件,用于日志记录/与外部电子文档流转、ИС ЭСФ、СНТ 集成。
- 配置扩展——在不解除配置支持的情况下,向附加文件列表表单添加自定义属性/命令。
- 访问限制(RLS)——文件访问继承所有者对象(往来单位合同)的权限;在 BSP「文件处理」访问组配置文件中设置。
在进行改造时请注意,该目录是 BSP 标准子系统的一部分:直接更改其结构会使更新复杂化。首选通过扩展和文件子系统的标准集成点进行。
