1. 识别信息
| 参数 | 值 |
|---|---|
| 对象类型 | 文档(Documents) |
| 名称 | ЭлектронноеПисьмоИсходящее |
| 完整名称 | Документ.ЭлектронноеПисьмоИсходящее |
| 同义词 | —(在标准配置中未设置同义词;界面中显示为"电子邮件发件") |
| 配置 | 哈萨克斯坦会计,3.0 版,版本 3.0.74.2 |
| 子系统 | "交互"(管理电子邮件及与交易对手的沟通) |
| 查找位置 | "标准子系统"版块 →"电子邮件发件"。导航链接:e1cib/list/Документ.ЭлектронноеПисьмоИсходящее |
用途。 该文档用于直接在 1C 中创建、编辑和发送电子邮件。它是与交易对手、合作伙伴及内部用户交互管理子系统的组成部分。该文档与电子邮件账户集成,支持基于其他交互(会议、电话通话、来件邮件)创建邮件、处理附件和模板、管理发送状态以及保存通信历史。销售、采购、会计等部门的员工以及管理者使用它进行正式沟通。通过 RLS(Row-Level Security,行级安全)机制,邮件的访问权限受限于负责人、作者和账户所有者。
重要提示:这是一个沟通类文档,而非核算类文档。它不参与税务和会计核算,不涉及增值税金额(哈萨克斯坦自 2026 年起为 16%)、月度计算指标(MRP,4 325 ₸)或会计科目表中的科目。邮件只能以附件形式包含核算和电子文档(例如发票的打印形式、ЭСФ、СНТ),但其本身不生成任何分录和金额。
2. 表头属性与表格部分
2.1 表头属性
| 属性 | 类型 | 用途 |
|---|---|---|
УчетнаяЗапись |
СправочникСсылка.УчетныеЗаписиЭлектроннойПочты | 以其名义发送邮件的账户。正是它的地址会被填入"发件人"字段 |
Тема |
字符串 | 邮件主题(Subject) |
Важность |
ПеречислениеСсылка.ВажностьИнтернетПочтовогоСообщения | 优先级:低 / 普通 / 高 |
ТекстПисьма |
字符串(无限制) | 纯文本形式的邮件正文 |
HTMLТекстПисьма |
值存储 / 字符串 | HTML 格式的邮件正文(当格式为 HTML 时) |
ФорматТекстаПисьма |
ПеречислениеСсылка.ТипыТекстовПочтовыхСообщений | 格式:纯文本 / HTML |
Отправлено |
布尔值 | 成功发送标识(影响状态和编辑锁定) |
ДатаОтправления / ДатаПолучения |
日期 | 实际的发送日期和时间 |
Размер |
数字 | 含附件的邮件大小(字节) |
ИдентификаторСообщения |
字符串 | 用于关联通信链的 Message-ID |
ОсновнаяТемаВзаимодействия(主题对象) |
ЛюбаяСсылка | 通信的主题对象——交易对手、合同、订单等(通过"ПредметыПапкиВзаимодействий"寄存器) |
Автор |
СправочникСсылка.Пользователи | 邮件创建者 |
Ответственный |
СправочникСсылка.Пользователи | 交互负责人(用于 RLS) |
УдалятьПослеОтправки |
布尔值 | 用于临时邮件的服务标志 |
ЗапланированноеВремяОтправки |
日期 | 延迟发送的时间(场景 3.5) |
ИнтернетЗаголовки |
值存储 | RFC-822 服务头 |
2.2 表格部分
| 表格部分 | 关键列 | 用途 |
|---|---|---|
Получатели |
Контакт(任意引用)、Адрес(字符串,email)、Представление(字符串)、ГруппаПолучателя(枚举:收件人 / 抄送 / 密送) |
邮件收件人列表。一行对应一个 email。分组决定该地址进入"收件人""抄送"还是"密送" |
ДополнительныеРеквизиты |
Свойство、Значение |
附加属性和特性(БСП 的"属性"机制) |
附件(文件)不存储在表格部分中,而是存储在与所属文档关联的单独的已附加文件目录 ЭлектронноеПисьмоИсходящееПрисоединенныеФайлы 中。嵌套邮件(场景 3.7)以 .eml 格式的附加文件形式存储。
需在具体版本中核实:在不同版本的 БСП 中,"Получатели"表格部分的列构成以及是否存在用于抄送/密送的单独表格部分可能有所不同——在 3.0.7x 中,收件人通常通过同一表格部分内的
ГруппаПолучателя字段来区分。
3. 表单
| 表单 | 用途 |
|---|---|
ФормаДокумента |
主表单——撰写邮件:收件人、主题、文本(HTML/纯文本)、附件、"发送""转发"按钮、处理模板及确认联系人 |
ФормаСписка |
发件邮件列表(通过 e1cib/list/Документ.ЭлектронноеПисьмоИсходящее 打开) |
| 选择表单 | 在选取到关联对象时从列表中选择邮件 |
此外还使用了"交互"子系统的通用表单:收件人联系人确认表单(场景 3.6)、消息模板处理表单(场景 3.4)、账户选择表单。
4. 模块的关键过程
从 evidence 中提取了以下处理器(消息文本按代码原文引用,release 3.0.68.1;在 3.0.74.2 中逻辑保持不变):
| 模块 / 过程 | 功能 |
|---|---|
Форма.ФормаДокумента → ОтправитьВыполнить |
发送邮件。检查账户是否可用于发送。当 НайденныеСтроки.Количество() = 0 时提示"所选邮箱不可用于发送邮件。" |
Форма.ФормаДокумента → ОтправитьПереслатьВыполнить |
转发/发送,并检查是否有收件人。当 СписокПолучателей.Количество() = 0 时提示"请至少指定一个邮件收件人。" |
Форма.ФормаДокумента → ПоказатьПредупреждениеОНеобходимостиВвестиАдресЭлектроннойПочты |
检查收件人 email 是否填写,提示"请输入电子邮件地址" |
МодульОбъекта(服务器上下文) |
构建邮件对象;当在服务器上错误调用客户端方法时可能出现"在客户端上对对象的调用无效。" |
此类对象的典型处理器(通用逻辑,非来自 evidence):
ОбработкаЗаполнения— 在基于其他对象录入时填充(从交易对手替换收件人、主题、通信主题对象)。ПередЗаписью/ПриЗаписи— 固定发送状态、更新交互主题对象寄存器、重新计算大小。- 表单处理器
ПриСозданииНаСервере、ПриОткрытии— 初始化默认账户、准备收件人和附件列表。
支持的场景(来自 evidence): 从零创建邮件(3.1)、回复来件(3.2)、转发(3.3)、按模板创建(3.4)、延迟发送(3.5)、确认收件人联系人(3.6)、添加附件和嵌套邮件(3.7)。
5. 过账与分录
该文档不过账,也不生成任何分录——在元数据中 register_records = []。它不会在核算范围的会计、累计和信息寄存器中创建记录。
由此可见:
- 该文档不生成哈萨克斯坦会计科目表的分录(此处不涉及 1210"买方短期应收账款"、1030"活期账户资金"、1330"商品"、3310"应付供应商账款"、3130"应缴增值税"、6010"销售收入"、7010"销售成本"等科目)。
- 该文档不计算金额、税率和税款(增值税 16%、个人所得税、强制养老金缴款、强制社会医疗保险等)。
- 该文档的全部"动作"就是通过账户的 SMTP 服务器发送邮件消息这一事实,以及与交互主题对象的服务性关联(通过"交互"子系统的信息寄存器
ПредметыПапкиВзаимодействий/СостоянияВзаимодействий)。
如果邮件用于向交易对手发送核算或电子文档(发票、通过 ИС ЭСФ 的 ЭСФ、СНТ),那么这些文档的生成及其过账/上传由相应的核算对象(销售、ЭСФ、СНТ)负责,而非邮件。邮件仅作为附件承载它们。
6. 关联对象与基于对象录入
基于发件邮件录入——通常邮件本身是基于其他对象录入的结果,而非源对象。典型源对象(创建"回复"/"转发"/"撰写"邮件):
| 源对象 | 替换的内容 |
|---|---|
Документ.ЭлектронноеПисьмоВходящее |
收件人(来自来件的发件人)、带"Re:"/"Fwd:"前缀的主题、引用文本、通信主题对象 |
Справочник.Контрагенты / Партнеры |
联系人的 Email、交互主题对象 |
Справочник.Пользователи、联系人 |
收件人地址 |
| 其他交互(会议、电话通话、已计划的交互) | 通信主题对象、参与者 |
关联对象:
Справочник.УчетныеЗаписиЭлектроннойПочты— 以谁的名义、通过哪个 SMTP 发送。Справочник.ЭлектронноеПисьмоИсходящееПрисоединенныеФайлы— 附件。- "交互"子系统的寄存器:主题对象、状态、文件夹、待发送项。
Документ.ЭлектронноеПисьмоВходящее— 通信链的另一半(通过ИдентификаторСообщения/ 主题对象关联)。
7. 扩展点
- 配置扩展(无需脱离支持): 为文档和表单添加属性/列,重写
ФормаДокумента表单的处理器(ОтправитьВыполнить、ОтправитьПереслатьВыполнить),添加自定义命令(例如"附加 ЭСФ""附加 СНТ")。 - БСП 的程序接口: 模块
Взаимодействия、РаботаСПочтовымиСообщениями、РаботаСПочтовымиСообщениямиКлиент— 可重写的邮件生成和发送过程。 - "属性"机制(
ДополнительныеРеквизиты表格部分)——在不修改元数据的情况下扩展邮件的特性构成。 - 消息模板(
Справочник.ШаблоныСообщений)——针对实施任务对邮件文本进行类型化(发票报价、欠款通知)。 - 已附加文件 — 通过文件处理子系统与外部存储(卷、S3)集成。
- 交换规则 / 业务流程 — 从业务流程和任务中触发发送邮件。
需在具体版本 3.0.74.2 中核实:
Взаимодействия*模块的导出过程的确切构成因版本而异——在重写之前,请与配置的当前语法助手核对。
