- Дополнительные печатные формы

- Заполнение реквизитов - Комментарий в документе 1С
diadoc · May 21, 2021 · 77443dc · 77443dc
2 parents 015940c + e4f13be
commit 77443dc
Show file tree

Hide file tree

Showing 17 changed files with 129 additions and 35 deletions.
diff --git a/docs/source/Functions_PM.rst b/docs/source/Functions_PM.rst
@@ -16,6 +16,8 @@
   ПолучитьТекстЗапросаДляСпискаПакетовНаОтправкуПоМассивуВидовПакетов <func/pm/Poluchit'TekstZaprosaDlyaSpiskaPaketovNaOtpravkuPoMassivuVidovPaketov>
   ПослеОтправкиПакета <func/pm/Posle_Otpravki_Paketa>
   ПослеПодготовкиПакета <func/pm/PoslePodgotovkiPaketa>
+  ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме <func/pm/ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме>
+  ЗаполнитьРеквизитыДокумента <func/pm/ЗаполнитьРеквизитыДокумента>
 
 
 Входящие документы
@@ -66,3 +68,4 @@
   ПослеОбработкиЛентыСобытий <func/pm/Posle_Obrabotki_Lenty_Sobytiy>
   ПослеУстановкиСтатусаДокумента <func/pm/Posle_Ustanovki_Statusa_Dokumenta>
   ПечатнаяФормаДокумента <func/pm/PechatnayaFormaDocumenta>
+  ОбновитьКомментарийДокументаУчета <func/pm/ОбновитьКомментарийДокументаУчета>
diff --git a/docs/source/func/pm/Podgotovit'ElektronnyyDokument.rst b/docs/source/func/pm/Podgotovit'ElektronnyyDokument.rst
@@ -4,7 +4,7 @@
 
 **Синтаксис:**
 
-    ПодготовитьЭлектронныйДокумент(<Результат>, <ВидДокументаРазвернутый>, <ДополнительныеПараметры>)
+    ПодготовитьЭлектронныйДокумент(<Параметры>)
 
 **Описание:**
 

diff --git a/docs/source/func/pm/Podgotovit'Paket.rst b/docs/source/func/pm/Podgotovit'Paket.rst
@@ -4,7 +4,7 @@
 
 **Синтаксис:**
 
-    ПодготовитьПакет(<ВидПакетаРазвернутый>, <СтрокаСписка>, <Пакет>)
+    ПодготовитьПакет(<Параметры>)
 
 **Описание:**
 
@@ -14,6 +14,6 @@
 
 * **ВидПакетаРазвернутый** (тип Структура)- реквизиты вида пакета из функции :doc:`ПолучитьТаблицуИспользуемыхПакетов <../../func/pm/Poluchit'TablitsuIspol'zuyemykhPaketov>`.
 * **СтрокаСписка** (тип Структура) - структура, соответствующая строке из интерфейса списка пакетов для отправки.
-* **Пакет** (тип Структура :doc:`Пакет <../../objects/Paket>`) - структура, которая содержит основные сведения о пакете и его составе.
+* **Пакет** (тип Структура :doc:`Пакет <../../objects/Пакет>`) - структура, которая содержит основные сведения о пакете и его составе.
 
 Пример использования: :doc:`Как подготовить пакет документов для отправки <../../proc/pm/Podgotovka_Paketa_Dlya_Otpravki>`
diff --git a/...nc/pm/Poluchit'TekstZaprosaDlyaSpiskaPaketovNaOtpravkuPoMassivuVidovPaketov.rst b/...nc/pm/Poluchit'TekstZaprosaDlyaSpiskaPaketovNaOtpravkuPoMassivuVidovPaketov.rst
@@ -26,7 +26,7 @@
 
 **Параметры:**
 
-* **МассивВидовПакетов** (тип Массив) — строковые значения внутренних идентификаторов видов пакетов, определенный ранее в функции ПолучитьТаблицуИспользуемыхПакетов..
+* **МассивВидовПакетов** (тип Массив) — строковые значения идентификаторов видов пакетов, определенный ранее в событии :doc:`ПолучитьТаблицуИспользуемыхПакетов <Poluchit'TablitsuIspol'zuyemykhPaketov>`.
 * **ПараметрыЗапроса** (тип Структура) — список параметров, которые передаются в запрос при выполнении.
   С помощью метода структуры "Вставить", дополняется новыми, если они используются в запросе.
 

diff --git a/docs/source/func/pm/Provesti_Analiz_Dokumenta.rst b/docs/source/func/pm/Provesti_Analiz_Dokumenta.rst
@@ -31,4 +31,7 @@
 * **ТипОшибкиВалидации** - произвольный текст, отображаемый в списке, для классификации ошибок
 * **КонтентОтвета** - ОбъектXDTO, соответствующий титулу покупателя (для формализованных документов) или отказу в подписи. Именно такой ответ будет отправлен на сервер Диадока, если заполнено поле "ДействиеВДД".
 
-Пример использования: :doc:`Как обработать входящий пакет документов <../../proc/pm/Obrabotka_Vkhodyashchikh_Paketov>`
+
+.. note::
+
+  Не используется в модуле с версии 4.3.0
diff --git a/docs/source/func/pm/ЗаполнитьРеквизитыДокумента.rst b/docs/source/func/pm/ЗаполнитьРеквизитыДокумента.rst
@@ -0,0 +1,20 @@
+
+ЗаполнитьРеквизитыДокумента
+===========================
+
+**Синтаксис:**
+
+    ЗаполнитьРеквизитыДокумента(<Параметры>)
+
+**Описание:**
+
+    Вызывается при формировании списка документов на отправку, когда включена настройкой модуля "Показывать содержимое пакета на отправку".
+    Используется для заполнения основных данных по каждому документу в списке без построения контента.
+
+    Заполняется структура из параметров Документ.Реквизиты
+
+**Параметры:**
+
+* **Документ** - :doc:`структура документа <../../objects/Документ>`, реквизиты которого необходимо заполнить
+
+Пример использования: :doc:`Как подготовить пакет документов для отправки <../../proc/pm/Podgotovka_Paketa_Dlya_Otpravki>`
diff --git a/docs/source/func/pm/ОбновитьКомментарийДокументаУчета.rst b/docs/source/func/pm/ОбновитьКомментарийДокументаУчета.rst
@@ -0,0 +1,22 @@
+
+ОбновитьКомментарийДокументаУчета
+=================================
+
+**Синтаксис:**
+
+    ОбновитьКомментарийДокументаУчета(<Параметры>)
+
+**Описание:**
+
+      Дополняет поле "Комментарий" в документе 1С текстом из параметра.
+
+      Текущее значение комментария не заменяется, а текст присоединяется в начало значения поля.
+      При этом производится поиск на наличие такого текста. Если найден, то повторно не производится запись.
+
+**Параметры:**
+
+* **Документ** - :doc:`структура документа <../../objects/Документ>`, реквизиты которого необходимо заполнить.
+* **ДокументОбъект** - ссылка на объект 1С, в который надо добавить комментарий. Заполняется при создании документа.
+* **Комментарий** - текстовое значение, которое будет добавлено в документ.
+
+Пример использования: :doc:`Дополнительные возможности <../../proc/pm/Dopolnitel'nyye_Vozmozhnosti>`
diff --git a/docs/source/func/pm/ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме.rst b/docs/source/func/pm/ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме.rst
@@ -0,0 +1,24 @@
+
+ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме
+====================================================
+
+**Синтаксис:**
+
+    ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме(<Параметры>)
+
+**Описание:**
+
+    Дозаполняет в структуре документа на отправку:
+
+    - метаданные
+    - имя файла
+    - двоичные данные сформированной печатной формы в хранилище контента
+    - признак запроса подписи
+
+**Параметры:**
+
+* **ВнешняяПечатнаяФорма** - ссылка на дополнительную печатную форму в 1С, которую надо сформировать. Берется из настроек документа для организации или контрагента.
+* **Документ** - :doc:`структура документа <../../objects/Документ>`, которую надо дозаполнить данными печатной формы для отправки
+* **ИдентификаторКоманды** - соответствует необходимой команде в дополнительной печатной форме 1С
+
+Пример использования: :doc:`Как подготовить пакет документов для отправки <../../proc/pm/Podgotovka_Paketa_Dlya_Otpravki>`
diff --git a/docs/source/image/Добавление_печатки.png b/docs/source/image/Добавление_печатки.png
diff --git a/docs/source/image/Код_доп_печатки.png b/docs/source/image/Код_доп_печатки.png
diff --git a/docs/source/image/Код_запонение_реквизитов.png b/docs/source/image/Код_запонение_реквизитов.png
diff --git a/docs/source/image/Код_комментарий.png b/docs/source/image/Код_комментарий.png
diff --git a/docs/source/image/Комментарий.png b/docs/source/image/Комментарий.png
diff --git a/docs/source/objects/Документ.rst b/docs/source/objects/Документ.rst
@@ -2,12 +2,7 @@
 Структура "Документ"
 ====================
 
-Используется в модуле с версии 4.0. На текущий момент доступна в ряде событие подключаемого модуля:
-
-* :doc:`ВыполнитьТребуемоеДействие <../func/pm/Vypolnit'_Trebuyemoye_Deystviye>`
-* :doc:`ПровестиАнализДокумента <../func/pm/Provesti_Analiz_Dokumenta>`
-* :doc:`НайтиСопоставлениеДокумента <../func/pm/Nayti_Sopostavleniye_Dokumenta>`
-* :doc:`ПолучитьЗаполненныйОбъектДокумента1С <../func/pm/Poluchit'_Zapolnennyy_Obyekt_Dokumenta_1S>`
+Используется в модуле с версии 4.0.
 
 *Элементы:*
 

diff --git a/docs/source/proc/pm/Dopolnitel'nyye_Vozmozhnosti.rst b/docs/source/proc/pm/Dopolnitel'nyye_Vozmozhnosti.rst
@@ -171,3 +171,19 @@
 	      |
 	      |СГРУППИРОВАТЬ ПО
 	      |	ВТ_Документы.Связь1";
+
+
+Заполнение комментария в документе 1С
+-------------------------------------
+
+Через настройки в организации есть возможность заполнять определенный комментарий в документе 1С, который был отправлен из базы, или в документе, который отражает входящий электронный документ (после создания или сопоставления).
+
+.. image:: /image/Комментарий.png
+  :scale: 100%
+
+В событии :doc:`ОбновитьКомментарийДокументаУчета <../../func/pm/ОбновитьКомментарийДокументаУчета>` определяется способ заполнения и записи в документ 1С, переданный в ПМ.
+
+Пример заполнения комментария с датой отправки:
+
+.. image:: /image/Код_комментарий.png
+  :scale: 100%
diff --git a/docs/source/proc/pm/Obrabotka_Vkhodyashchikh_Paketov.rst b/docs/source/proc/pm/Obrabotka_Vkhodyashchikh_Paketov.rst
@@ -248,26 +248,9 @@
 Анализ документов
 -----------------
 
-Выполнение анализа вызывается при нажатии на кнопку **Анализ выбранных документов** в меню "Действия".
+Выполнение анализа вызывается при нажатии на кнопку *Анализ и обработка → Выполнить анализ*.
 
-Для описания какого-либо процесса проверки входящих электронных документов используется процедура :doc:`ПровестиАнализДокумента <../../func/pm/Provesti_Analiz_Dokumenta>`.
-
-Например, можно проверить наличие сопоставленных документов 1С и получить массив выявленных ошибок.
-
-::
-
-      Если ТипДокумента = "xmltorg12"
-          ИЛИ (ТипДокумента = "universaltransferdocument" И (ФункцияДокумента = "invoiceandbasic" ИЛИ ФункцияДокумента = "basic")) Тогда
-
-          Если НЕ ЗначениеЗаполнено(Документ1С) Тогда
-              Ошибки.Добавить("Не найдена накладная №: " + СтруктураДанных.НомерДокумента + " от " + Формат(СтруктураДанных.ДатаДокумента, "ДФ=dd.MM.yyyy") + " на сумму " + Формат(СтруктураДанных.СуммаДокумента, "ЧДЦ=2"));
-          КонецЕсли;
-
-      КонецЕсли;
-
-После выполненного анализа каждого документа, в процедуре :doc:`ПослеАнализаПакета <../../func/pm/Posle_Analiza_Paketa>` выполняется основная логика обработки действий, определенных в предыдущей процедуре.
-
-Вызов анализа по пакетам происходит при нажатии на кнопку **Анализ выбранных пакетов** в меню "Действия".
+В процедуре :doc:`ПослеАнализаПакета <../../func/pm/Posle_Analiza_Paketa>` выполняется логика обработки действий для каждого документа пакета.
 
 Например, заполнение структуры ответа на входящий документ в зависимости от определенного действия (подписать, отказать в подписи и т.п.).
 

diff --git a/docs/source/proc/pm/Podgotovka_Paketa_Dlya_Otpravki.rst b/docs/source/proc/pm/Podgotovka_Paketa_Dlya_Otpravki.rst
@@ -66,11 +66,6 @@
 
 Определение комбинаций этих характеристик ("видов документов"), которые будут использованы в пакетах на отправку, происходит в функции :doc:`ПолучитьТаблицуИспользуемыхВидовДокументов <../../func/pm/Poluchit'TablitsuIspol'zuyemykhVidovDokumentov>`
 
-В списке на отправку есть возможность просмотра сразу по документам, без свертки в вид пакета. Для переключения режима надо зайти в настройки модуля: *Расширенные настройки → Документы → Показывать содержимое пакета на отправку*.
-
-.. image:: /image/Список_развернутый.png
-  :scale: 100%
-
 **Хранение:**
 
 Когда хранение на объектах Диадока:
@@ -222,3 +217,36 @@
   КонецЕсли;
 
 Если идентификатор настройки редактирования заполнен, то модуль не будет выполнять валидацию контента шаблона.
+
+Отправка дополнительной печатной формы
+--------------------------------------
+
+В настройках организации / контрагента есть возможность к виду документа привязать отправку дополнительных печатных форм.
+
+.. image:: /image/Добавление_печатки.png
+  :scale: 100%
+
+С такой настройкой при формировании пакета, в составе которого есть УПД, в пакет будет добавляться еще и внешняя печатная форма, как отдельный неформализованный документ.
+
+Влиять на формирование такого документа можно в событии :doc:`ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме <../../func/pm/ПодготовитьЭлектронныйДокументПоВнешнейПечатнойФорме>`.
+Например, можно переопределить документ, на основании которого формируется печатная форма.
+
+Пример подготовки печатной формы:
+
+.. image:: /image/Код_доп_печатки.png
+  :scale: 100%
+
+Заполнение реквизитов документов в списке на отправку
+-----------------------------------------------------
+
+В списке документов на отправку возможно два режима просмотра: по пакетам или развернуто по документам пакета. Регулируется настройкой модуля *Расширенные настройки → Документы → Показывать содержимое пакета на отправку*.
+
+.. image:: /image/Список_развернутый.png
+  :scale: 100%
+
+Для заполнения списка необходимо определить дату, номер и сумму каждого документа пакета. Способ их определения без заполнения контента определяется в событии :doc:`ЗаполнитьРеквизитыДокумента <../../func/pm/ЗаполнитьРеквизитыДокумента>`.
+
+Пример заполнения полей:
+
+.. image:: /image/Код_запонение_реквизитов.png
+  :scale: 100%