23785 примеры логирования

docs/Admin manuals/Конструктор документов/index.md

@@ -422,13 +422,13 @@ if @formName='EmployeeStatementForm' AND ( @ColumnName = '#bDate#' OR @ColumnNam
 #Master_MyCompanyFSS#  |  своя организация: номер ФСС
 #Master_MyCompanyFullName#  |  полное наименование своей организации
 #Master_MyCompanyGAccountant#  |  ФИО Гл. бухгалтера, |
-#Master_MyCompanyGAccountantAccusative#  |  ФИО Гл. бухгалтера в Вин. падеже, | 
-#Master_MyCompanyGAccountantDative#  |  ФИО Гл. бухгалтера в Дат. падеже, | 
-#Master_MyCompanyGAccountantGenitive#  |  ФИО Гл. бухгалтера в Род. падеже, | 
-#Master_MyCompanyGAccountantProf#  |  должность Гл. бухгалтера, | 
+#Master_MyCompanyGAccountantAccusative#  |  ФИО Гл. бухгалтера в Вин. падеже
+#Master_MyCompanyGAccountantDative#  |  ФИО Гл. бухгалтера в Дат. падеже
+#Master_MyCompanyGAccountantGenitive#  |  ФИО Гл. бухгалтера в Род. падеже
+#Master_MyCompanyGAccountantProf#  |  должность Гл. бухгалтера
 #Master_MyCompanyGAccountantProfAccusative#  |  должность Гл. бухгалтера в Вин. падеже
-#Master_MyCompanyGAccountantProfDative#  |  должность Гл. бухгалтера в Дат. падеже, | 
-#Master_MyCompanyGAccountantProfGenitive#  |  должность Гл. бухгалтера в Род. падеже, | 
+#Master_MyCompanyGAccountantProfDative#  |  должность Гл. бухгалтера в Дат. падеже
+#Master_MyCompanyGAccountantProfGenitive#  |  должность Гл. бухгалтера в Род. падеже
 #Master_MyCompanyINN#  |  своя организация: ИНН
 #Master_MyCompanyKPP#  |  своя организация: КПП
 #Master_MyCompanyLegalAddressText#  |  своя организация: юридический адрес
@@ -444,6 +444,7 @@ if @formName='EmployeeStatementForm' AND ( @ColumnName = '#bDate#' OR @ColumnNam
 #Master_Position#  |  должность пользователя создателя документа
 #Master_PositionDative#  |  должность пользователя создателя документа в дательном падеже
 #Master_PositionGenitive#  |  должность пользователя создателя документа в родительном падеже
+#Master_PrintedText#  | содержательная часть во входящем документе, исходящем документе, орд, служебной записке
 #Master_Recipient# | получатель служебной записки из табличной части "Кому"
 #Master_ReplyNumber#  |  в ответ на входящий - номер документа
 #Master_ReplyDate#  |  в ответ на входящий - дата документа
@@ -731,7 +732,7 @@ if @formName='EmployeeStatementForm' AND ( @ColumnName = '#bDate#' OR @ColumnNam
 
 ![Операции](media/noOperachii1.png)
 
-* Скрыть кнопку **<Копировать>** - скрывается кнопка "Операции" в панели инструментов в **универсальных документах** и **доверенностях на конструкторе**;
+* Скрыть кнопку **<Копировать>** - скрывается кнопка "Копировать" в панели инструментов в **универсальных документах** и **доверенностях на конструкторе**;
 
 ![Копирование](media/noCopy1.png)
 

docs/Admin manuals/Контур.Доверенности/index.md

@@ -0,0 +1,229 @@
+# Контур.Доверенности
+
+## Описание 
+ 
+ **Контур.Доверенности** - программный продукт от фирмы "Контур", который необходим для регистрации доверенностей с Центральным Распределенным Реестром ФНС, далее именуемое как ЦПРР ФНС.
+
+ Плюс МЧД в том что есть возможность проверить подлинность, валидность и верификацию подписи. 
+
+ На данной платформе имеется 2 вида площадок **_Тестовая_** и **_Продуктивная_**  для МЧД доверенностей:
+
+ - **Тестовая** - это форма, которая имеет внутреннее сообщение МЧД доверенностей между контрагентами. 
+ - **Продуктивная** - это форма, которая имеет прямой доступ к ЦПРР ФНС, то есть место где регистрируются все МЧД доверенности формата b2b.
+
+Продуктивная прощадка имеет настройки конфигурации (конфиги) на каждую организацию. Для каждой организации в конфиги прописывается **путь** и уникальный **ключ**. Числом обозначается номер организации в реестре. 
+
+![Puctires](media/screen-2.png)
+
+Для сервиса обмена с Контур.Доверенности должен быть отдельный пользователь с правами администратора, который должен быть указан в конфигурации, в разделе сервиса. 
+
+![Puctires](media/screen-1.1.png)
+
+![Puctires](media/screen-1.png)
+
+А в разделе "Интерграции" необходимо прописать маршруты для каждой организации. Идентификаторы организаций можно найти при помощи программы Postman, при запросе всех организаций.
+
+![Puctires](media/screen-3.1.png){ width=70% }
+![Puctires](media/screen-3.png){ width=70% }
+
+- **"shortName"** - имя организации 
+- **id** - ключ, он же часть маршрута для обращения по API к Контур.Доверенности
+
+## Настройка интеграции с Контур.Доверенности 
+
+Чтобы данный сервис начал работать на сайте необходимо произвести некоторые настройки. Такие как **"Подключение сервиса"**, **"Настройка продакшена JSON"** и **"Создание view"**. 
+
+### *Подключение сервиса*
+
+Для корректной работы с платформой Контур.Доверенности необходимо в первую очередь настроить подключение сервиса.  
+
+Для подключения необходимо установить **web-service "ecosoft-lexema8-integration-service"**. После чего добавить в **package.json** в раздел **devDependencies** - _"ecosoft-lexema8-integration-service": "0.0.1"_.
+
+
+
+### *Настройка продакшена JSON*
+
+Чтобы подключить продакшен JSON необходимо прописать в **production.json** на проекте в раздел **application**. В конфигурации документа имеется APIKEY далее именуемое как API-ключ.
+
+??? Пример "Пример настроек в продакшене"
+
+    ``` JSON
+     integration: {
+      protocol: 'http',
+      host: 'integration_service',
+      port: 3205,
+      route: '/api/v2.0/integration',
+      script: 'ecosoft-lexema8-integration-service',
+      routes: {
+        kontur: {
+          type: 'group',
+          routes: {
+            1: {
+              url: 'https://m4d-api-staging.testkontur.ru',
+              headers: {
+                'X-KONTUR-APIKEY': 'gp264zd9-233x'
+               }
+             }
+           }
+         }
+       }
+     }
+    ```
+
+Далее необходимо прописать в **index.js** на проекте в разделе **Services**:
+
+??? Пример "Пример **index.js**"
+
+    ```JSON
+     konturM4D: {
+       Ctor: KonturM4DService,
+       args: {
+         organizationId: '7k4f0d-1l9t-3s62',
+         withCOrg: true
+       }
+     }
+    ```
+
+И сделать там же импорт **KonturM4DService**
+
+??? Пример "Пример импорта"
+
+     ```JSON
+        import { KonturM4DService } from 'ecosoft-lexema8-docflow-documents-lib'
+     ```
+
+Далее нужно добавить столбцы **StatusKontur**, **DocCode**, **DocSubtype**, **DocType** во вьюшку _dfd.UniversalDocument_.
+
+В обязательном порядке необходимо создать роли **empowermentrevocation_write** и **empowermentrevocation_read**, включить их в роли, которые смогут отзывать доверенности. Так же создать роль **empowerment_admin**.
+
+Добавить _Настройку документа_ указанную в [примере](http://ecm-demo.dev.lan/#/view/DocflowDocumentSettingsForm/37). Создать [подтип](http://ecm-demo.dev.lan/#/view/DocumentSubtypeForm/219) документа и создать к нему [конструктор](http://ecm-demo.dev.lan/#/view/DocumentConstructorForm/369). 
+
+После чего создать маршрут в документе и добавить в **units.json** скрипт:
+
+??? Пример "Пример скрипта **units.json**"
+ 
+    ```JSON
+    {
+        "key": "EmpowermentRevocationRegistry",
+        "caption": "Отзыв доверенностей",
+        "form": ["EmpowermentRevocationRegistry", "ecosoft-lexema8-docflow-documents-lib"]
+      },
+      {
+        "key": "EmpowermentRevocationForm",
+        "caption": "",
+        "form": ["EmpowermentRevocationForm", "ecosoft-lexema8-docflow-documents-lib"]
+      }
+    ```
+
+
+После его изменить в **_production.js_**: 
+
+??? Пример "Пример замены сервиса"
+
+    Необходимо сервис:
+
+    ```JSON
+            kontur: {
+                    url: 'https://m4d-api-staging.testkontur.ru',
+                    headers: {
+                    'X-KONTUR-APIKEY': 'cq951ld6-121r'
+                }
+                }
+    ```
+
+    Поменять на: 
+
+    ```JSON
+                kontur: {
+                        type: 'group',
+                        headers: {
+                            'X-KONTUR-APIKEY': 'cq951ld6-121r'
+                        },
+                        routes: {
+                        1: 'https://m4d-api-staging.testkontur.ru/v1/organizations/4a7fb5b7-8f6b-4a68-8f5e-0ff45c3fd0a6'
+                            // , COrg филиала: 'https://m4d-api-staging.testkontur.ru/v1/organizations/id организации в контуре'
+                        }
+                        }
+    ```
+ 
+Далее необходимо изменить в **index.js (demo/source)**:
+
+??? Пример "Пример изменений в **index.js (demo/source)**"
+    Изменить конфигурации данного сервиса:
+ 
+    ```Json
+        konturM4D: {
+        Ctor: KonturM4DService,
+        args: { organizationId: '1t3kf2s0-0d3a }
+        },
+    ```
+    На настройки приведенные ниже: 
+
+    ```JSON
+            konturM4D: {
+                Ctor: KonturM4DService ,
+                args: {withCOrg: true}
+                }
+    ```
+
+
+## Работа с Контур.Доверенности
+
+На проекте должен быть настроен подтип МЧД со служебным наименованием **_MachineReadablePowerOfAttorney_**. Так же в шаблоне маршрута должно быть подписание КЭПом руководителя. 
+### _Доверитель и доверительные лица_
+
+В Карточке контрагента на вкладке **"Доверенность"** указать _"Лицо без доверернности"_, как правило лицом без доверенности является Генеральный Директор, то есть тот кто имеет право подписывать именно КЭПом юридического лица. Заполняя форму документа доверенности МЧД, по умолчанию заполняется сотрудник указанный как лицо без доверенности, в поле **"Лицо без доверенности (доверитель)"**.
+
+### _Сведения о полномочиях_
+
+**Полномочия** могут быть человекочитаемые и машиночитаемые.  
+
+- **Человекочитаемые** - это полномочия которые заказчик вносит вручную в справочник полномочий. 
+
+- **Машиночитаемые** - это полномочия, загруженные из справочника МинЦифры (Министерство Цифрового развития, связи и массовых коммуникаций Российской Федерации).
+  
+Чтобы загрузить эти доверенности необходимо в реестре **"Справочник полномочий"** нажать кнопку _"Загрузить перечень из файла"_. Прежде всего необходимо на сайте ГосУслуг скачать excel-файл с переченью полномочий, после чего нажать на кнопку  _"Загрузить перечень из файла"_ и тогда система загрузит все недостающие полномочия в реестр. Справочник находиться в [этом](https://esnsi.gosuslugi.ru/classifiers/9532/data?pg=1&p=1) ресурсе.
+
+![Picturies](media/screen-5.png)
+
+При загрузке полномочий актуализируется записи в справочнике, то есть закрываются не действующие и добавляются новые.
+
+Подсправочник **"Группа полномочий"** необходим, чтобы выстроить иерархическое дерево при выборе полномочий в документе "Доверенность" в разеделе "Сведения о полномочиях". 
+
+В **"Группах полномочий"** необходимо настроить для каждого проекта "Разделы групп", то есть это группа с определенным названием и NSI ID подтягивается при загрузке справочника полномочий в поле карточки полномочия NSI ID. При загрузке справочника полномочий МинЦифры, новые полномочия загружаются согласно указанных групп NSI ID.   
+
+![Picturies](media/screen-6.png)
+![Picturies](media/screen-6.1.png)
+
+
+
+При запуске сайта, в реестре доверенностей необходимо загрузить "Исторические доверенности", которые закгружаются по кнопке **"Загрузить из Контура"** находящиеся в панели управления.
+
+![Picturies](media/screen-7.png)
+
+При нажатии кнопки **"Загрузить из Контура"** Лексема обратиться к ЦПРР ФНС через API по текущей организации с запросом доверенностей которых в Лексеме еще нет. И загрузит как саму карточку доверенности так и хml-файл с описанием этой доверенности.
+
+После регистрации документа и подписания доверенности КЭПом во вложении создается xml-файл, пример вложения указан на скрине ниже: 
+
+![Picturies](media/screen-8.png)
+ 
+В названии xml-файла имеется идентификатор который берется из раздела МЧД в доверенности. Так же этот идентификатор используется для проверки в ЦПРР ФНС. Произвести проверку доверенности можно в [сервисе ФНС](https://m4d.nalog.gov.ru/emchd/check-status). 
+
+После завершения маршрута документ возвращается инициатору со _"Статусом в реестре ФНС"_ - **"Зарегестрировано"** и можно дальше работать с документом в тех системах, которые необходимы. 
+
+### _Ошибка операции по регистрации доверенности_
+
+В форме "Настройка заданий для планировщика" имеется задача _Уведомление об ошибках регистрации МЧД или отзыва_ которая необходима для того чтобы система оповещала пользователя о ошибке регистрации МЧД. 
+
+Если вернется статус _"Ошибка регистрации"_ необходимо в программе Postman отправить запрос по текущей доверенности. Для этого необходимо знать id доверенности, узнать ее можно следующий путём.  
+Необходимо в базе данных сделать запрос на необходимую доверенность, после чего в колонке **"KonturOperationId"** взять значение по доверенности которая пришла с ошибкой и ввести в Postman в строку **GET** запрос. Postman отправит запрос по текущей доверенности, где будет иметься подраздел **error** с описанием проблемы в строке _"massage"_.
+
+С примером ознакомиться можно на скрине ниже:
+
+![Picturies](media/screen-10.png)
+
+Если работник увольняется, система автоматически отзывает доверенность, то есть создается документ _"Отзывот доверенности"_ и запускается по маршруту. "Отзыв доверенности" сразу направляется Генеральному Директору на подпись КЭП. После подписания отзыва Генеральным Директором, документ отправляется в Контур.Доверенности на регистрацию в ЦПРР ФНС. В результате регистрации этой операции статус доверенности в ЦПРР становится _"Отозван"_.  
+В самом отзыве доверенности формируется собственный "id операции", то есть этот id осуществил отзыв той доверенности, которая лежит в "Связках". 
+
+![Picturies](media/screen-9.1.png)
+

docs/Admin manuals/Логи приложения/index.md

@@ -22,7 +22,7 @@
 * Доп.условие выборки - в данном поле возможно указать условия выборки логов, например фильтрация только по логину, либо по определенному сервису, либо исключить из выборки какой то определенный сервис;
 * Выборка - из выпадающего списка возможно выбрать по какому условию отфильтровать табличную часть. Настраивается с помощью формы [Настройки выборок для логов приложения](#настройки_выборок_для_логов_приложения).
 
-**Примеры:**
+**Примеры выборки по логированию:**
 
 * выбрать логи по логину: `"CUser" = 'DriverAuto'`,
 
@@ -70,6 +70,27 @@
 * `lexema-dss` – для работы с ОЭП выпускаемыми клиентом;
 * `preview` – предназначен для конвертации файлов в файлы в формате pdf, которые можно просматривать в элементе управления ```FilePreview```.
 
+#### Примеры результатов логирования
+
+- **Неудачная авторизация пользователей.** В **Доп.условие выборки** указывается: `"Message" ilike '%Неверный логин или пароль%'`
+
+![alt text](media/image-11.png)
+
+- **Изменение ролей для пользователя.** В **Доп.условие выборки** указывается: `"Message" ilike '%Изменение ролей для пользователя%'`
+
+![alt text](media/image-12.png)
+
+- **Блокирование пользователей.** В **Доп.условие выборки** указывается: `"Message" ilike '%Пользователь заблокирован. %'`
+
+![alt text](media/image-13.png)
+
+- **Выпуск сертификата пользователю.** В **Доп.условие выборки** указывается: `"Message" ilike '%create certificate complete%'`.
+
+- **Логи по сертификатам.** В **Доп.условие выборки** указывается: `"Details" = 'Логирование операций с сертификатом'`. В логирование записываются данные по выпуску и отзыву сертификата
+
+![alt text](media/image-14.png)
+
+
 ### Вкладка "Коллектор"
 
 На данной вкладке история событий приложения.
@@ -144,6 +165,12 @@
 		"Details" = 'Логирование операций с сертификатом'
 		```
 
+#### Примеры логирования:
+
+- Авторизация пользователей. В **Доп.условие выборки** указывается: `"EventType" = 'session: start'`
+
+![alt text](media/image-10.png)
+
 ## Форма "Управление пользователями"
 
 **Описание**

docs/Admin manuals/Настройка СЭД для администраторов/index.md

@@ -24,6 +24,12 @@
 **incomingdocument_write**  |  для возможности редактирования документа.
 **master_registrar** | позволяет назначать вручную регистрационный номер и дату регистрации документа.
 
+Возможно использовать [вычисляемые атрибуты](../Конструктор документов/#вычисляемые_атрибуты)
+
+#Master_PrintedText# - содержательная часть
+#Master_ReplyNumber# - в ответ на входящий - номер документа
+#Master_ReplyDate# - в ответ на входящий - дата документа
+
 ## Исходящие документы
 
 [Исходящие документы](https://ecm-user-manuals.readthedocs.io/ru/latest/User%20manuals/%D0%98%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D0%B9%20%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82/) - это оформление документов, которые написаны в индивидуальном порядке или в ответ на входящий документ.
@@ -35,6 +41,11 @@
 **outgoing_registrar**  |  позволяет зарегистрировать документ.
 **master_registrar**  |  позволяет вручную назначать регистрационный номер и дату регистрации документа.
 
+Возможно использовать [вычисляемые атрибуты](../Конструктор документов/#вычисляемые_атрибуты)
+
+#Master_PrintedText# - содержательная часть
+#Master_WhoseName# - на чье имя (Ф.И.О.) в исходящем документе
+
 Имеется константа:
   
 **Авторегистрация_ИсхДок** - автоматическое присваивание номера исходящего документа на этапе "Зарегистрировать".

docs/Admin manuals/Настройка внутрисистемных уведомлений/index.md

@@ -30,7 +30,7 @@
 
 Откроется новая форма.
 
-![Новое задание](media/newTask.png)
+![Новое задание](media/2024-12-03.png)
 
 ### Вкладка "Настройки"
 
@@ -62,6 +62,8 @@
 
 **Email копия** - указывается электронная почта кому необходимо дополнительно направить уведомление. Добавление несколько получателей производится аналогично как добавление основных получателей.
 
+**Email скрытая копия** - указывается электронная почта кому необходимо дополнительно направить скрытое уведомление. Получателе не будет видно в письмо в спике адресатов. Добавление несколько получателей производится аналогично как добавление основных получателей.
+
 **По вопросу** - указывается тема уведомления.
 
 **Документ** - указывается наименование документа для отображения в системе.