Мобильный штрихкод: контрольная цифра и прием только своего товара

Учебные задачи

Полный модуль своего автономного мобильного Пульта: мобильный штрихкод: контрольная цифра и прием только своего товара. Подготовка, действительные источники данных, отмена, границы контекста и контроль результата описаны отдельно.

Где и как запускать

Полный модуль управляемой формы Пульт собственного автономного мобильного приложения УчебноеМультимедиа85; здесь не выполнялся.

Подготовка

  1. Создать НОВУЮ отдельную конфигурацию УчебноеМультимедиа85 для автономного мобильного приложения8.5.1.1343; совместимость Не использовать. Не рабочую базу. Для опытов нужен свой Android/iOS и соответствующая мобильная платформа, не Windows desktop и не подключенный мобильный клиент.

  2. Конфигуратор → Обработки → УчебноеМультимедиа85 → Формы → Пульт: управляемая форма. Вставить ВЕСЬ модуль только одного урока. Его ПриОткрытии и ПередЗакрытием назначить событиям формы через конструктор. ПриОткрытии имеет Отказ; ПередЗакрытием — четыре аргумента Отказ, ЗавершениеРаботы, ТекстПредупреждения, СтандартнаяОбработка.

  3. Реквизиты формы: Согласие — Булево, начальное значение Ложь; Итог — Строка неограниченной длины, многострочное поле только просмотра. Для камеры/документов дополнительно Предпросмотр — Картинка и поле картинки с этим путем к данным.

  4. Создать команды СканироватьКод, действия с точно теми же именами и кнопки. При снятом Согласие новая операция не начинается; результат сканирования также не принимается без согласия.

  5. Для штрихкодового урока добавить РазрешенныйКод — Строка длины13 и поле ввода; до открытия сканера вписать цифры своей реальной упаковки. Для остальных уроков реквизит не нужен.

  6. Сохранить свою конфигурацию, проверить и обновить собственную базу (F7). Включить требуемую функциональность мобильного приложения — камеру/микрофон для выбранного урока — и развернуть только собственный учебный пакет на своем устройстве обычным для вашей мобильной платформы способом. Здесь сборка пакета, установка и F7 не выполнялись.

  7. На устройстве самостоятельно дать нужные разрешения ОС только перед своим опытом. Согласие на форме не заменяет разрешение ОС. Снимать только свою бумагу/упаковку, записывать свою короткую фразу; не чужие лица, разговоры, документы или экран.

  8. Весь модуль содержит проверенные ветви препроцессора: мобильные API только в МобильноеПриложениеКлиент, имя базы — только в МобильноеПриложениеСервер. Проверка базы локальная для автономного приложения, не сетевой сервер. API также существует у мобильного клиента, но этот конкретный стенд намеренно автономный.

  9. runtimeVerifiedScenarios=0. Проверена только установленная справка и исходный HTML/код. Камера, микрофон, голос, устройство, 1С и ОС-разрешения здесь не запускались; новых резервных копий не создано.

#Если МобильноеПриложениеКлиент Тогда
Перем СвойЗапуск, СвояОперация, СвояГотовность;
Перем СвойРазрешенныйКод;

&НаКлиенте
Процедура ПриОткрытии(Отказ)
    СвойЗапуск = Неопределено;
    СвояОперация = "";
    СвояГотовность = Ложь;
    Согласие = Ложь;
    Итог = "Установите согласие только перед собственным опытом";
    Попытка
        ПроверитьСвойМобильныйСтендНаСервере();
        Если ТипЗнч(СредстваМультимедиа) <> Тип("СредстваМультимедиа") Тогда
            ВызватьИсключение "Нужен реальный глобальный мобильный объект мультимедиа";
        КонецЕсли;
        СвояГотовность = Истина;
    Исключение
        Отказ = Истина;
        ВызватьИсключение;
    КонецПопытки;
КонецПроцедуры

&НаКлиенте
Процедура ПередЗакрытием(Отказ, ЗавершениеРаботы, ТекстПредупреждения, СтандартнаяОбработка)
    СтандартнаяОбработка = Истина;
    Если СвояОперация <> "" Тогда
        Отказ = Истина;
        ТекстПредупреждения = "Сначала завершите только свой опыт: " + СвояОперация;
        Если Не ЗавершениеРаботы Тогда
            Сообщить(ТекстПредупреждения);
        КонецЕсли;
        Возврат;
    КонецЕсли;
    СвояГотовность = Ложь;
    СвойЗапуск = Неопределено;
КонецПроцедуры

&НаКлиенте
Процедура ПроверитьСвоеСогласие()
    Если Не СвояГотовность Или Не Согласие Тогда
        ВызватьИсключение "Нужны открытое собственное окно и явное согласие на этот опыт";
    КонецЕсли;
КонецПроцедуры

&НаКлиенте
Функция НачатьСвойОпыт(Операция)
    ПроверитьСвоеСогласие();
    Если СвояОперация <> "" Тогда
        ВызватьИсключение "Не запускайте второй собственный опыт до завершения первого";
    КонецЕсли;
    СвойЗапуск = Новый УникальныйИдентификатор;
    СвояОперация = Операция;
    Итог = Операция;
    Возврат СвойЗапуск;
КонецФункции

&НаКлиенте
Функция ЭтоСвойОпыт(Запуск)
    Возврат СвояГотовность И СвойЗапуск <> Неопределено И Запуск = СвойЗапуск;
КонецФункции

&НаКлиенте
Процедура ЗавершитьСвойОпыт(Запуск)
    Если ЭтоСвойОпыт(Запуск) Тогда
        СвойЗапуск = Неопределено;
        СвояОперация = "";
    КонецЕсли;
КонецПроцедуры

&НаКлиенте
Процедура СканироватьКод(Команда)
    ПроверитьСвойКодEAN13(РазрешенныйКод);
    Запуск = НачатьСвойОпыт("Сканирование своего штрихкода");
    СвойРазрешенныйКод = РазрешенныйКод;
    Попытка
        Если Не СредстваМультимедиа.ПоддерживаетсяСканированиеШтрихКодов() Тогда
            ВызватьИсключение "Сканирование штрихкодов этим устройством не поддерживается";
        КонецЕсли;
        Чтение = Новый ОписаниеОповещения("СвойКодПрочитан", ЭтаФорма, Запуск);
        Закрытие = Новый ОписаниеОповещения("СвойСканерЗакрыт", ЭтаФорма, Запуск);
        СредстваМультимедиа.ПоказатьСканированиеШтрихКодов("Только свой учебный товар", Чтение, Закрытие, Неопределено);
    Исключение
        ЗавершитьСвойОпыт(Запуск);
        ВызватьИсключение;
    КонецПопытки;
КонецПроцедуры

&НаКлиенте
Процедура СвойКодПрочитан(ШтрихКод, Результат, Сообщение, ДополнительныеПараметры) Экспорт
    Результат = Ложь;
    Сообщение = "Чужой или завершенный собственный сеанс";
    Если Не ЭтоСвойОпыт(ДополнительныеПараметры) Тогда
        Возврат;
    КонецЕсли;
    Если Не Согласие Тогда
        Сообщение = "Согласие снято; собственный сканер закрывается";
        СредстваМультимедиа.ЗакрытьСканированиеШтрихКодов();
        Возврат;
    КонецЕсли;
    Если ТипЗнч(ШтрихКод) <> Тип("Строка") Или ШтрихКод <> СвойРазрешенныйКод Тогда
        Сообщение = "Этот код отсутствует в собственной учебной позиции";
        Возврат;
    КонецЕсли;
    Результат = Истина;
    Сообщение = "Собственный учебный товар принят один раз";
    Итог = "Получен настоящий код: " + ШтрихКод + "; никаких документов или регистров не записано";
    СредстваМультимедиа.ЗакрытьСканированиеШтрихКодов();
КонецПроцедуры

&НаКлиенте
Процедура СвойСканерЗакрыт(ДополнительныеПараметры) Экспорт
    ЗавершитьСвойОпыт(ДополнительныеПараметры);
КонецПроцедуры

&НаКлиенте
Процедура ПроверитьСвойКодEAN13(Код)
    Если ТипЗнч(Код) <> Тип("Строка") Или СтрДлина(Код) <> 13 Тогда
        ВызватьИсключение "Введите напечатанные13 цифр собственного реального штрихкода";
    КонецЕсли;
    Сумма = 0;
    Для Позиция = 1 По 13 Цикл
        Символ = Сред(Код, Позиция, 1);
        Если СтрНайти("0123456789", Символ) = 0 Тогда
            ВызватьИсключение "Собственный EAN13 содержит только цифры";
        КонецЕсли;
        Если Позиция <= 12 Тогда
            Четная = Позиция = Цел(Позиция / 2) * 2;
            Сумма = Сумма + Число(Символ) * ?(Четная, 3, 1);
        КонецЕсли;
    КонецЦикла;
    Остаток = Сумма - Цел(Сумма / 10) * 10;
    Контроль = ?(Остаток = 0, 0, 10 - Остаток);
    Если Число(Прав(Код, 1)) <> Контроль Тогда
        ВызватьИсключение "Не совпала настоящая контрольная цифра собственного EAN13";
    КонецЕсли;
КонецПроцедуры
#Иначе
&НаКлиенте
Процедура ПриОткрытии(Отказ)
    Отказ = Истина;
    Сообщить("Откройте свою отдельную автономную мобильную базу УчебноеМультимедиа85, не desktop или подключенный мобильный клиент");
КонецПроцедуры

&НаКлиенте
Процедура ПередЗакрытием(Отказ, ЗавершениеРаботы, ТекстПредупреждения, СтандартнаяОбработка)
    Отказ = Ложь;
    СтандартнаяОбработка = Истина;
КонецПроцедуры

&НаКлиенте
Процедура СканироватьКод(Команда)
    ВызватьИсключение "Этот собственный урок только для автономного мобильного приложения";
КонецПроцедуры
#КонецЕсли

&НаСервереБезКонтекста
Процедура ПроверитьСвойМобильныйСтендНаСервере()
#Если МобильноеПриложениеСервер Тогда
    Если ТранзакцияАктивна() Тогда
        ВызватьИсключение "Собственный опыт не запускается внутри чужой транзакции";
    КонецЕсли;
#Иначе
    ВызватьИсключение "Этот стенд требует локального сервера автономного мобильного приложения";
#КонецЕсли
КонецПроцедуры

Разбор по шагам

  1. Возьмите упаковку своего реального товара с EAN13 и вручную перенесите13 напечатанных цифр в реквизит РазрешенныйКод. Цифры4601234567893 — только пример корректной контрольной цифры, не готовое изображение штрихкода.

  2. Перед включением камеры проверить длину, только цифры и настоящую контрольную цифру EAN13: первые12 цифр с весами1/3, остаток по10, затем последняя цифра. Ведущий ноль не теряется, потому что код хранится строкой.

  3. Скопировать разрешенный код в переменную своего сеанса, чтобы последующее изменение реквизита не изменило критерий уже открытого сканирования.

  4. После проверки поддержки передать два описания оповещения с тем же GUID. ТипШтрихКода=Неопределено допускает все поддерживаемые форматы: проверяется значение кода, а не доказанная симвология EAN13.

  5. У callback сканирования четыре параметра. Результат и Сообщение — возвращаемые параметры без Знач: сначала отклонить, а принять только точное совпадение со своей учебной позицией и действующее согласие.

  6. На чужом коде вернуть Ложь и понятное сообщение. На своем вернуть Истина, показать фактическую строку и закрыть собственный сканер. В callback закрытия один аргумент с GUID; он освобождает только свой сеанс.

  7. Проверить чужую упаковку, свою упаковку, неверную контрольную цифру и пользовательское закрытие без сканирования. Никаких документов поступления, регистров или запросов к рабочей базе этот урок не создает.

Как проверить результат

  1. Будущий ручной запуск должен получить настоящий результат выбранного API на своем устройстве и пройти условия своего урока. Положительный флаг поддержки или отсутствие исключения само по себе не означает, что данные получены.

  2. Без согласия новая операция должна отказать. Отмена должна оставлять отмену, а ошибка запуска — ошибку; второе нажатие не должно подменять активный GUID собственного опыта.

  3. Проверьте отдельный отрицательный опыт по шагам урока: отсутствие голосового пакета, отмену захвата, чужой код или низкое качество/лишнюю страницу. Не подставляйте фиктивный объект или ожидаемые байты вместо результата платформы.

  4. После освобождения собственного сеанса форму можно закрыть. При собственном активном сеансе ПередЗакрытием должен предложить сначала завершить его; поздний callback другого GUID не должен изменить Итог.

  5. runtimeVerifiedScenarios=0. Все аппаратные результаты, ошибки и проверки здесь — условия будущей ручной приемки, а не выполненный тест1С.

Ожидаемый результат

Подготовлен самостоятельный мобильный урок с собственным сеансом и действительными результатами платформы; аппаратно здесь не запускался.

На что обратить внимание

  1. СредстваМультимедиа — глобальное readonly-свойство мобильного контекста. Не создавать этот объект через Новый, не передавать неизвестный ИсходныйОбъект и не переносить вызовы в серверный/desktop-код.

  2. Этот полный стенд рассчитан на автономное мобильное приложение. Серверная проверка имени конфигурации работает локально на устройстве; Метаданные.Имя не читается в мобильной клиентской ветви.

  3. Поддерживается... — проверка возможностей, не разрешений ОС, занятости камеры/микрофона, качества изображения или слышимости звука. Отказ ОС и отмена пользователя требуют отдельной проверки.

  4. Имена публичных callback связаны с настоящими ОписаниеОповещения и проверяются по GUID. Для аудио, текста, страницы, завершения серии и штрихкода сигнатуры различны; их нельзя заменять одним универсальным обработчиком.

  5. Код явно не сохраняет медиа, не вызывает HTTP, почту, печать или бизнес-запись. Платформа/ОС могут использовать свой временный кэш; очистка переменной не доказывает удаление этого кэша. Размер32МиБ проверяется после получения байтов и не обещает предотвратить их первоначальную аллокацию.

  6. Нормированная оценка сканирования не является OCR, распознанным текстом или гарантией юридической пригодности документа. Строгая политика>=7 каждого показателя — решение этого собственного примера.

  7. Callback остановки звука/текста не всегда означает окончательное завершение: уведомление может временно прервать звук с последующим возобновлением. В этих уроках владелец сеанса снимается явной собственной командой остановки, не предположением о причине callback.

  8. ПередЗакрытием имеет четыре аргумента. При ЗавершениеРаботы=Истина нельзя открывать окна или вызывать сервер: заполняется ТекстПредупреждения. Пользователь или ОС могут принудительно завершить приложение; отказ от обычного закрытия не гарантирует запрет этого. Всегда явно остановите свой микрофон/звук до выхода.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.