RUKKENZH
Задать вопрос AI
栏目Объекты конфигурации 1С
参考手册《与银行往来函件附加文件》——技术说明
Язык статьи:🇷🇺 RU🇰🇿 KK🇬🇧 EN🇨🇳 ZH
Версия статьи:📘 Для бухгалтера⚙️ Для тех-специалиста

参考手册《与银行往来函件附加文件》——技术说明

适用于: 1С:Бухгалтерия для Казахстана, 版本 3.0.74.2 · 1C-Sapa 集团 — 1C 合作伙伴
СТ
Сапа Т.И. — Эксперт по 1С и бухгалтерскому учёту, преподаватель-практик

1. 标识

参数
对象类型 目录(Catalog)
名称 ПисьмоОбменСБанкамиПрисоединенныеФайлы
完整名称 Справочник.ПисьмоОбменСБанкамиПрисоединенныеФайлы
同义词 —(未设置;在界面中显示为与银行交换函件的"附加文件")
配置 哈萨克斯坦会计,3.0 版(3.0.74.2)
所有者 / 上下文 文档 ПисьмоОбменСБанками
子系统 库子系统"文件操作"(БСП)——附加文件机制

用途。 该目录存储在与银行电子文档流转框架下附加到"与银行交换函件"文档的文件。这是 БСП 的一种典型附加文件存储对象:在配置中,为每个所有者对象(此处为"与银行交换函件"文档)创建一个单独的附加文件目录。该机制支持版本管理、电子签名(ЭЦП)、加密,以及将内容存储在信息库中或外部存储卷上。

在实际应用中,当向与银行交换的函件附加银行对账单、付款委托书、银行回执、扫描件和客户端-银行 XML 文件时,会使用该对象。用户并非直接以目录列表的形式操作它,而是通过所有者文档的表单("附加文件")进行操作。

在 1С 中的位置:"电子交互"版块 → "附加文件(与银行的函件)"。 导航链接:e1cib/list/Справочник.ПисьмоОбменСБанкамиПрисоединенныеФайлы

附加文件存储属于服务性对象:通常不会将它们作为独立列表显示在命令界面中,而是从所有者文档的表单中调用。


2. 属性和表格部分

2.1 表头属性

名称 类型 必填性 用途
Автор 目录引用:外部用户 / 文件同步账户 / 用户 必填(ShowError) 创建文件的用户或账户。创建时自动填写。用于审计和访问权限划分。
ВладелецФайла 文档引用:ПисьмоОбменСБанками 不检查(DontCheck) 指向文件所附加到的所有者文档的引用。确定文件在系统中的存放位置。
ДатаМодификацииУниверсальная 日期时间(UTC) 不检查 文件最后一次修改的日期和时间,UTC 格式。用于同步和跟踪版本的时效性。
ДатаСоздания 日期时间 必填(ShowError) 文件记录的创建日期和时间。在对象首次保存时固定。
Зашифрован 布尔 不检查 文件已加密的标志。影响是否可在无加密密钥的情况下查看。
Изменил 目录引用:外部用户 / 文件同步账户 / 用户 不检查 最后修改文件的用户(不计入打开进行编辑的情况)。
ИндексКартинки 数值 不检查 文件图标索引——根据扩展名和状态在界面中的图形表示。
Описание 字符串 不检查 文件的文本描述 / 注释;由用户填写。
ПодписанЭП 布尔 不检查 存在电子签名的标志。通过 ЭЦП 子系统添加签名时设置。
ПутьКФайлу 字符串 不检查 存储卷上文件的相对路径(存储在文件系统中时)。自动生成。
Размер 数值 不检查 文件大小(字节)。上传时填写;用于控制磁盘空间和限制。
Расширение 字符串 不检查 文件扩展名("pdf"、"xml"、"zip"等)。上传时自动确定;影响打开方式。
Редактирует 目录引用:外部用户 / 文件同步账户 / 用户 不检查 占用文件进行编辑的用户。用于锁定并发编辑。

名称(标准属性)。 存储不带扩展名的文件名——用户借此在列表中识别文件。

此外,在 БСП 的典型附加文件存储中还存在属性 ТипХранилищаФайлов(在信息库中 / 在卷中)、Том(目录引用.ТомаХранилищаФайлов)和 ТекущаяВерсия(如果对象启用了版本管理)。它们在具体构建中是否存在因版本而异;在所提供的 evidence 中未列出这些属性。

2.2 文件内容的存储

文件的二进制数据不存储在目录属性中,而是单独存储:

  • 当存储类型为"在信息库中"时——存储在附加文件存储的信息寄存器中(二进制数据关联到元素引用);
  • 当存储类型为"在卷中"时——存储在磁盘上,路径来自属性 ПутьКФайлу,卷由目录 ТомаХранилищаФайлов 确定。

2.3 表格部分

该对象没有自己的应用表格部分。文件版本、电子签名和加密证书存储在文件操作子系统的辅助对象中(版本、签名和证书的信息寄存器),而不是存储在目录本身的表格部分中。


3. 表单

表单 用途
ФормаЭлемента 附加文件卡片:名称、描述、作者、日期、大小、扩展名、签名/加密标志;查看、编辑、保存到磁盘的命令。
ФормаСписка 附加到与银行交换函件的文件列表(通常作为附加文件表嵌入到所有者文档的表单中)。
选择表单 从其他上下文调用时从附加文件列表中选择文件。

在实际应用中,最终用户与文件操作子系统的通用表单交互(例如"ПрисоединённыеФайлы"、"ПросмотрФайла"、"РедактированиеРеквизитовФайла")——这些表单将该目录作为存储库,并提供上传、下载、查看、签名和版本管理功能。


4. 模块的关键过程

未附上该对象的 BSL 源代码 evidence——下面是 БСП 附加文件存储的典型处理器(按标准逻辑描述;签名和是否存在取决于构建 3.0.74.2 中的 БСП 版本)。

目录管理器模块:

  • ОбработкаПолученияДанныхВыбора —— 交互式选择时的文件过滤。
  • 用于获取所有者和存储参数的服务函数,供文件操作通用模块使用。

对象模块:

  • ПередЗаписью —— 固定作者/修改者、创建日期和通用修改日期,根据扩展名和状态(已签名/已加密/被占用)重新计算 ИндексКартинки
  • ПередУдалением —— 清除关联内容(信息库中的二进制数据或卷中的文件)以及从属的版本/签名记录。
  • ПроверкаЗаполнения —— 检查必填属性 АвторДатаСоздания

子系统通用模块(将此目录作为存储库使用):

  • РаботаСФайламиСлужебный / РаботаСФайлами —— 添加文件、创建版本、占用/释放以进行编辑、保存到磁盘。
  • ЭлектроннаяПодписьСлужебный —— 设置/验证 ЭЦП(属性 ПодписанЭП)。
  • ШифрованиеСлужебный —— 加密/解密内容(属性 Зашифрован)。

确切的路径和行号因版本而异;需根据具体构建的通用模块组成进行核实。


5. 过账和动账

该目录不进行过账,也不生成会计分录和累积寄存器的动账。 作为文件存储对象,它不参与经济业务的反映。

数据变更会导致向文件操作子系统的辅助信息寄存器写入:

  • 文件二进制数据存储寄存器(存储在信息库中时);
  • 文件版本寄存器(启用版本管理时);
  • 文件电子签名加密证书寄存器。

会计后果不由文件产生,而由所有者文档 ПисьмоОбменСБанками 及与之关联的银行文档产生。作为参考——正是这些文档生成动账,而非附加文件;银行模块中涉及的哈萨克斯坦会计科目表的典型科目:

所有者文档的操作 借方 贷方
收到买方向活期账户支付的款项 1030 "活期银行账户资金" 1210 "买方短期应收账款"
从活期账户向供应商付款 3310 "供应商短期应付账款" 1030 "活期银行账户资金"

(供参考,用于哈萨克斯坦 2026 年场景;附加文件目录本身不做这些分录。)


6. 关联对象和基于录入

  • 所有者文档: Документ.ПисьмоОбменСБанками —— 唯一的所有者,在属性 ВладелецФайла 中设置。
  • 作者用户: 目录 ПользователиВнешниеПользователиУчётныеЗаписиСинхронизацииФайлов(属性 АвторИзменилРедактирует)。
  • 存储卷: Справочник.ТомаХранилищаФайлов —— 当文件存储在信息库之外时。
  • 子系统: "文件操作"、"电子签名"、"加密"、"文件同步"。
  • 哈萨克斯坦电子文档流转: 文件可能包含 ЭДО 附件——ЭСФ(ИС ЭСФ)、СНТ,以及客户端-银行格式(XML 对账单、付款委托书)。

基于录入: 未提供——附加文件只能通过向所有者文档添加文件的机制创建(拖放、"添加 → 从磁盘 / 从扫描仪获取文件"),而不能通过基于录入命令创建。


7. 扩展点

  • 配置扩展: 通过目录扩展添加自定义属性(例如 ЭДО 附件类型、银行审核状态);重定义元素/列表表单。
  • 对象处理器: ПередЗаписьюПередУдалениемПроверкаЗаполнения —— 用于附加验证(控制扩展名、限制大小、发往银行的出站文件必须签名)。
  • Переопределяемый 后缀的 БСП 通用模块РаботаСФайламиПереопределяемый 及类似模块)—— 无需修改标准代码即可嵌入文件操作逻辑的常规接入点。
  • 基于目录引用的事件订阅 —— 用于与外部存储/杀毒扫描系统集成。
  • 访问限制(RLS): 通过属性 ВладелецФайла(函件文档)和 Автор —— 根据对所有者文档的权限设置文件可见性。

建议:通过文件操作子系统的可重定义模块来扩展行为,而不要修改标准目录——这样可在配置更新时保持兼容性。

Частые вопросы

此目录会生成会计分录吗?
不会。这是存储附加文件的对象;它不进行过账,也不产生累积寄存器的变动。记录仅进入文件处理子系统的辅助信息寄存器(二进制数据、版本、签名、加密)。分录由所有者文档"ПисьмоОбменСБанками"(银行交换信函)及相关银行文档生成。
为什么此目录没有用于版本和签名的自有表格部分?
在БСП(标准子系统库)中,文件版本、电子签名和加密证书不存储在目录的表格部分中,而是存储在"文件处理"子系统的单独辅助信息寄存器中。目录本身存储文件的元数据(表头属性)和指向内容的引用。
文件内容实际存放在哪里?
取决于存储设置:"在信息库中"——存放在二进制数据存储的信息寄存器中;"在卷中"——按ПутьКФайлу(文件路径)属性中的路径存放在磁盘上,卷由目录ТомаХранилищаФайлов(文件存储卷)指定。
可以基于其他对象录入附加文件吗?
不可以。不支持基于录入。文件仅通过附加到所有者文档"银行交换信函"的机制添加(拖放、从磁盘或从扫描仪添加)。
在改进时如何正确扩展对象的行为?
通过文件处理子系统的可重定义通用模块和配置扩展(附加属性、重定义表单、ПередЗаписью/ПередУдалением/ПроверкаЗаполнения(写入前/删除前/填写检查)处理程序)。最好不要直接修改标准目录——这有利于简化更新。

延伸阅读

Источники

Была ли статья полезна?
💼 Нужна помощь с 1С или учётом? Слава КВЦ — многолетняя практика в 1С в Казахстане. Изучите разложенный НК РК 2026 или спросите в чате BuhGPT — ответит за секунды.
标签:KZCatalogs