Assembly v 5.9.1 (24.08.24)

adslbarxatov · Aug 24, 2024 · 911a591 · 911a591
1 parent 692c467
commit 911a591
Show file tree

Hide file tree

Showing 12 changed files with 159 additions and 383 deletions.
diff --git a/.github/workflows/Release.yaml b/.github/workflows/Release.yaml
@@ -16,7 +16,7 @@ jobs:
 # Константы, используемые далее по тексту
     env:
       PROJ: ${{ github.event.repository.name }}
-      TAG: '5.9'
+      TAG: '5.9.1'
 
     steps:
 # Проверка состава репозитория (без анализа, как может показаться)

diff --git a/.release/KassArray.apk b/.release/KassArray.apk
diff --git a/.release/KassArray.exe b/.release/KassArray.exe
diff --git a/.release/KassArrayDB.dll b/.release/KassArrayDB.dll
diff --git a/.release/KassArrayFN.exe b/.release/KassArrayFN.exe
diff --git a/.release/KassArrayLL.dll b/.release/KassArrayLL.dll
diff --git a/.release/KassArray_ru_ru.html b/.release/KassArray_ru_ru.html
@@ -0,0 +1,146 @@
+<html charset='utf-8'>
+
+<head>
+<title>Инструмент сервис-инженера контрольно-кассовой техники KassArray: руководство пользователя | KassArray</title>
+</head>
+
+<body>
+
+<h1 id="kassarray--">Инструмент сервис-инженера контрольно-кассовой техники KassArray: руководство пользователя</h1>
+<p><strong>ƒ</strong>  RD AAOW FDL; 23.04.2024; 2:46</p>
+
+<h2 id="kassarray">Общие сведения об инструменте KassArray</h2>
+<p>Инструмент позволяет:</p>
+<ul>
+<li>просматривать и сохранять / отправлять на печать <em><strong>инструкции по работе с ККТ</strong></em>;</li>
+<li>просматривать расшифровки <em><strong>кодов ошибок ККТ</strong></em>;</li>
+<li>определять <em><strong>срок жизни ФН</strong></em> в соответствии параметрами пользователя, от которых он зависит;</li>
+<li>определять <em><strong>корректность регистрационного номера ККТ</strong></em> и <em><strong>генерировать его</strong></em> при необходимости;</li>
+<li>определять <em><strong>соответствие моделей ККТ версиям ФФД</strong></em>;</li>
+<li>получать <em><strong>настройки операторов фискальных данных</strong></em> (ОФД) по их ИНН или названиям;</li>
+<li>получать <em><strong>описания и признаки обязательности TLV-тегов</strong></em> для различных ФФД;</li>
+<li>получать описания <em><strong>команд нижнего уровня</strong></em>;</li>
+<li>вручную (без использования внешней клавиатуры) <em><strong>программировать текстовые данные в ККТ</strong></em>, имеющих только цифровую клавиатуру;</li>
+<li>автоматически <em><strong>определять модели ККТ и фискальных накопителей</strong></em> (ФН) по их заводским номерам, а также регионы РФ по кодам ИНН;</li>
+<li>просматривать <em><strong>распиновки кабелей</strong></em> ККТ – ПК, ККТ – ДЯ и ККТ – Принтер;</li>
+<li>определять <em><strong>типы штрих-кодов</strong></em> и разбирать их содержимое (включая DataMatrix маркируемых товаров);</li>
+<li>дополнительно: получать разложения и представления чисел в системах счисления с основаниями 2, 10 и 16;</li>
+<li>дополнительно: преобразовывать коды Unicode в символам и наоборот;</li>
+<li>дополнительно: преобразовывать двоичные данные в текст и обратно.</li>
+</ul>
+
+<br/>
+<br/>
+<p>Windows-версия инструмента также может быть добавлена в автозапуск при установке; при запуске системы она остаётся свёрнутой
+в значок в трее. По нажатию на этот значок он может быть повторно вызван или свёрнут обратно.</p>
+<p>Для приложения доступны функции «Поверх всех окон» (Windows) и «Режим сервис-инженера» (все версии). Последний переводит приложение
+в режим полной функциональности и открывает опции, которые не должны быть доступны оператору или кассиру
+(например, команды нижнего уровня или работу с ФН). Соответствующие флажки доступны на последней вкладке.</p>
+<br/>
+<br/>
+<br/>
+
+<h2 id="kassarray-1">Модуль чтения и обработки данных ФН для KassArray (только Windows)</h2>
+<p>Модуль предназначен для чтения и обработки фискальных данных (ФД) из фискального накопителя (ФН).
+Далее представлено полное описание функционала приложения.</p>
+
+<br/>
+<br/>
+<p>Доступные функции:</p>
+<p><strong>1. Чтение данных из ФН</strong> с помощью физического или виртуального COM-порта и аппаратного адаптера.</p>
+
+<p><strong>2. Формирование выгрузок архивов ФН в формате</strong> <code>.fnc</code> в соответствии с Приложением №2 к приказу
+ФНС России «Форматы фискальных документов, обязательные к использованию» для версий ФФД <code>1.05</code> и <code>1.2</code>. Выгрузка в ФФД <code>1.1</code>
+также реализована, но находится в тестировании и может работать некорректно.</p>
+
+<p><strong>3. Обработка фискальных данных</strong>:</p>
+<ul>
+<li>Получение полного состояния и всех регистрационных данных ФН;</li>
+<li>Получение отдельного документа ФН;</li>
+<li>Получение контрольной ленты за отдельную смену;</li>
+<li>Получение полного фискального (посменного) отчёта;</li>
+<li>Получение посменного отчёта по диапазону дат;</li>
+<li>Прямой запрос счётчиков ФН (для ФФД <code>1.1</code> и выше);</li>
+<li>Расчёт гросс-итогов по данным фискальных документов (для файлов и ФФД <code>1.05</code>);</li>
+<li>Прямое чтение документов за определённую дату и расчёт сменных итогов.</li>
+</ul>
+
+<p><strong>4. Сохранение архива ФН в файл</strong> в форматах:</p>
+<ul>
+<li>Двоичных данных (<code>.fsd</code>). Это внутренний формат программы, который не может быть использован
+при перерегистрации или снятии ККТ с учёта в личном кабинете ФНС. Однако он доступен для последующего открытия и статистической обработки в программе.</li>
+<li>Табличных данных (<code>.csv</code>, доступен для обработки в Microsoft Office Excel).</li>
+</ul>
+
+<p><strong>5. Выполнение обмена с ОФД</strong> с параметрами подключения, получаемыми автоматически по данным последней
+регистрации / перерегистрации, или с параметрами, соответствующими выбранному ОФД. Обмен включает:</p>
+<ul>
+<li>Передачу фискальных документов;</li>
+<li>Передачу уведомлений о реализации маркированного товара;</li>
+<li>Обновление ключей проверки кодов маркировки.</li>
+</ul>
+
+<p><strong>6. Выполнение операций записи в ФН</strong>:</p>
+<ul>
+<li>Открытие смены;</li>
+<li>Закрытие смены;</li>
+<li>Закрытие архива ФН;</li>
+<li>Сброс МГМ (для технических целей).</li>
+</ul>
+<p>Первые три задачи могут быть выполнены с применением текущей даты или даты последнего документа ФН (для ФН с истекшим сроком жизни).</p>
+
+<p><strong>7. Чтение и статистическая обработка выгрузок архивов ФН</strong> в форматах <code>.fnc</code> и <code>.fsd</code>.</p>
+
+<p><strong>8. Формирование выгрузки уведомлений о реализации маркированного товара</strong> (при работе в автономном режиме)
+в формате <code>.fnm</code> в соответствии с Приложением 2 к приказу
+ФНС России «Форматы фискальных документов, обязательные к использованию» для версии ФФД <code>1.2</code> (<em><strong>находится в тестировании</strong></em>).</p>
+
+<p><strong>9. Кэширование имеющихся файлов</strong> <code>.fnc</code> и быстрый доступ к любому из них с помощью поиска по ИНН, заводским номерам,
+РНМ или наименованиям пользователей.</p>
+
+<br/>
+<br/>
+<p>Чтение может быть выполнено четырьмя способами:</p>
+<ul>
+<li><em><strong>Полное чтение архива</strong></em>. По его завершении становятся доступными все функции обработки данных.</li>
+<li><em><strong>Прямое чтение ФН</strong></em>. В этом случае доступны только функции чтения статуса ФН и содержимого отдельного документа.</li>
+<li><em><strong>Формирование выгрузки .fnc с последующей её загрузкой</strong></em>. Работает аналогично первому варианту, но набор
+реквизитов документов будет неполным, т.к. в файлах выгрузок они хранятся в ограниченном составе.</li>
+<li><em><strong>Прямое чтение документов из ФН за указанную дату</strong></em>. Данный способ позволяет сформировать сменные
+итоги без полного считывания ФН. Аналитика при этом останется недоступной.</li>
+</ul>
+
+<p>Независимо от варианта и настроек чтения состояние ФН запрашивается в максимально полном виде. Количество видимых регистраций
+и перерегистраций может быть ограничено последней (актуальной), если выбрана соответствующая опция.</p>
+
+<br/>
+<br/>
+<p>Детализация чтения может быть:</p>
+<ul>
+<li><em><strong>Полной</strong></em>. При этом из ФН считываются все TLV-теги (в том числе – неизвестные приложению с представлением
+в шестнадцатеричной форме) и квитанции подтверждения ОФД. Может занимать продолжительное время.</li>
+<li><em><strong>Неполной</strong></em>. Из ФН считываются только известные приложению TLV-теги. По скорости не отличается от предыдущего варианта.</li>
+<li><em><strong>Краткой</strong></em>. При этом считываются только суммовые счётчики, временны́е метки, номера, фискальные признаки
+документов и состояния отправки ОФД. Выполняется быстрее полного считывания примерно в два раза.</li>
+</ul>
+
+<br/>
+<br/>
+<p>Работа программы протестирована на всех моделях ФН из реестра ФНС.
+При соблюдении производителями существующего аппаратного протокола чтения данных работа с будущими моделями ФН также будет возможна.
+Однако выгрузка в формате <code>.fnc</code> требует дополнительных исследований, в связи с чем модуль может не поддерживать эту функцию
+для новейших моделей ФН.</p>
+
+<p>Для выполнения операций с ФН требуется наличие одного из следующих аппаратных адаптеров:</p>
+<ul>
+<li>COM-UART переходник для подключения ФН к разъёму COM (RS-232) компьютера.</li>
+<li>USB-VCOM-UART переходник для подключения к разъёму USB компьютера. В этом случае потребуется установить драйвера устройства;
+инструкции и ссылки для их установки предоставляются производителями таких переходников.</li>
+</ul>
+
+<p>Обращаем внимание, что срок действия каждого релиза модуля ограничен с целью устранения устаревающих версий и обеспечения
+его постоянного соответствия актуальным изменениям в ФФД. Срок указан в информационном окне, появляющемся при каждом запуске приложения. По его истечении
+останутся доступными функции анализа ранее считанных данных. Для работы с новыми данными необходимо будет получить актуальный экземпляр приложения.</p>
+
+</body>
+</html>
diff --git a/.release/Release.md b/.release/Release.md
@@ -1,4 +1,4 @@
-_Изменения для v 5.9_:
+_Изменения для v 5.9.1_:
 - Добавлена серия ЗН ФН `73814408` (Ин36-4);
 - Добавлено распознавание флага корректной поддержки частичной продажи со стороны ФН;
 - Добавлена новая айдентика;

diff --git a/Changes.log b/Changes.log
@@ -1,6 +1,6 @@
 KassArray: лог изменений
 
-Версия 5.9:
+Версия 5.9.1:
 • Добавлена серия ЗН ФН 73814408 (Ин36-4);
 • Добавлено распознавание флага корректной поддержки частичной продажи со стороны ФН;
 • Добавлена новая айдентика;

diff --git a/src/android/AndroidManifest.xml b/src/android/AndroidManifest.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.RD_AAOW.TextToKKT"
-	android:installLocation="internalOnly" android:versionCode="601537" android:versionName="5.8.7">
+	android:installLocation="internalOnly" android:versionCode="601539" android:versionName="5.9.1">
 
 	<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="34" />
 

diff --git a/src/android/App.xaml.cs b/src/android/App.xaml.cs
@@ -133,7 +133,8 @@ public App ()
 			// Переход в статус запуска для отмены вызова из оповещения
 			AndroidSupport.AppIsRunning = true;
 
-			// Общая конструкция страниц приложения
+			#region Общая конструкция страниц приложения
+
 			MainPage = new MasterPage ();
 
 			uiPages.Add (ApplyPageSettings (new HeadersPage (), "HeadersPage",
@@ -182,6 +183,8 @@ public App ()
 				RDLocale.GetDefaultText (RDLDefaultTexts.Control_AppAbout),
 				uiColors[aabPage][cBack], true));
 
+			#endregion
+
 			AndroidSupport.SetMasterPage (MainPage, uiPages[hdrPage], uiColors[hdrPage][cBack]);
 
 			#region Страница «оглавления»
@@ -428,9 +431,6 @@ public App ()
 			AndroidSupport.ApplyLabelSettings (uiPages[aabPage], "HelpHeaderLabel",
 				RDLocale.GetDefaultText (RDLDefaultTexts.Control_AppAbout),
 				RDLabelTypes.HeaderLeft);
-			/*AndroidSupport.ApplyLabelSettings (uiPages[aabPage], "HelpTextLabel",
-				RDGenerics.GetEncoding (RDEncodings.UTF8).
-				GetString (RD_AAOW.Properties.Resources.KassArray_ru_ru_dph), RDLabelTypes.SmallLeft);*/
 			Label htl = AndroidSupport.ApplyLabelSettings (uiPages[aabPage], "HelpTextLabel",
 				AndroidSupport.GetAppHelpText (), RDLabelTypes.SmallLeft);
 			htl.TextType = TextType.Html;
@@ -1016,10 +1016,7 @@ await AndroidSupport.ShowMessage (AppSettings.NoExtendedModeMessage,
 		/// </summary>
 		protected override void OnSleep ()
 			{
-			/*// Переключение состояния
-			if (!allowService.IsToggled)
-				AndroidSupport.StopRequested = true;*/
-
+			// Переключение состояния
 			AndroidSupport.AppIsRunning = false;
 
 			// Сохранение настроек
@@ -1979,6 +1976,7 @@ private void ConvNumberAdd_Click (object sender, EventArgs e)
 				}
 
 			convNumberField.Text = ((uint)res).ToString ();
+			AndroidSupport.HideKeyboard (convNumberField);
 			}
 
 		private void ConvCode_TextChanged (object sender, EventArgs e)
@@ -1995,6 +1993,7 @@ private void ConvCodeAdd_Click (object sender, EventArgs e)
 
 			string[] res = DataConvertors.GetSymbolDescription (convCodeField.Text, (short)(plus ? 1 : -1));
 			convCodeField.Text = res[2];
+			AndroidSupport.HideKeyboard (convCodeField);
 			}
 
 		// Копирование символа в буфер
@@ -2020,6 +2019,7 @@ private void ConvertHexToText_Click (object sender, EventArgs e)
 			convTextField.Text = DataConvertors.ConvertHexToText (convHexField.Text,
 				(RDEncodings)(AppSettings.EncodingForConvertor % encodingModesCount),
 				AppSettings.EncodingForConvertor >= encodingModesCount);
+			AndroidSupport.HideKeyboard (convTextField);
 			}
 
 		// Преобразование текста в hex-данные
@@ -2028,6 +2028,7 @@ private void ConvertTextToHex_Click (object sender, EventArgs e)
 			convHexField.Text = DataConvertors.ConvertTextToHex (convTextField.Text,
 				(RDEncodings)(AppSettings.EncodingForConvertor % encodingModesCount),
 				AppSettings.EncodingForConvertor >= encodingModesCount);
+			AndroidSupport.HideKeyboard (convHexField);
 			}
 
 		// Очистка вкладки преобразования данных