Действие «Выбор номенклатуры» выполняет очень важную функцию: указывает программе тот самый товар, для которого будут вводиться количества и пр. Одно и то же действие отвечает за любой способ выбора товара. Способы могут быть следующими:
- Сканирование ШК товара;
- Ввод ШК товара вручную;
- Ввод кода или артикула товара;
- Выбор товара из списка;
- Поиск товара по базе на основании ШК, кода или артикула, указанного в переменной сессии.
Действие выбора номенклатуры поддерживает наиболее вероятные сценарии выбора товара. В нем есть настройки отображения списка для выбора товара из списка. Есть настройки для реакции на неверный ввод.
Скриншоты
Использование действия «Выбор номенклатуры»
Рассмотрим несколько сценариев использования действия выбора номенклатуры:
Сканирование штрихкода товара и возможность ввода с клавиатуры
По умолчанию действие выбора номенклатуры показывает на экране мобильного терминала большое поле ввода для сканирования штрихкода, текст в заголовке окна и текст прямо над полем ввода. Это позволяет сканировать и распознавать штрихкоды, вводить тот же самый штрихкод с клавиатуры, а также вводить артикул или код товара, по которому он будет идентифицирован.
Выбор товара по ручному вводу артикула
По умолчанию действие выбора номенклатуры распознает товары не только по штрихкоду, но также и по артикулу и уникальному коду товара (например, коду товара в 1С). Для того, чтобы выбрать товар путем ручного ввода артикула на терминале сбора данных ничего дополнительно программировать или настраивать не нужно.
Выбор товара из списка По умолчанию свойство «Позволять выбор из списка» выставлено в «Да», поэтому если ввести вместо штрихкода «0» и Enter, то на экран ТСД будет выведен список всех товаров по базе. В том случае, если требуется сразу отобразить список товара, следует выставить «Да» в свойстве «Сразу показывать список товаров». Как только исполнение операции достигнет такого действия, на экране сразу же будет выведен список товаров для выбора. Состав выводимого списка управляется свойствами из группы «Данные» и свойством «Ограничивать товарами документа» из группы «Главные настройки поиска и выбора товаров». Два самых распространенных вариантов списка — это полный список всех товаров и список только тех товаров, что присутствуют в документе. Обоих можно добиться одним только свойством «Ограничивать товарами документа». Если оно выставлено в «Нет», то список окажется полным, в противном случае в списке будут только товары по накладной. Для настройки отображения списка существует свойство «Формат позиций окна выбора из списка». Свойство принимает текстовый шаблон отображения позиции номенклатуры. Каждая позиция в списке — это пара «товар + упаковка», поэтому для обращения к номенклатуре и её упаковке в шаблоне используются пути «Item.Product» и «Item.Packing». Например, шаблон с форматированием <Blue>{Item.Packing.Barcode} — {Item.Packing.Marking}</Blue> {Item.Product.Name:(0:E12)} выведет на экран то, что изображено на скриншоте. |
Распознавание товара по штрихкоду, артикулу или коду
Иногда необходимо найти в справочнике товар по заранее известному коду или артикулу, который указан где-то в документе, в переменной или просто равен «12345», допустим.
Для решения этой задачи в действии выбора номенклатуры предусмотрены свойства «Переменная штрихкода товара» и «Обработать штрихкод из сессии». «Переменная штрихкода товара» используется для хранения штрихкода. При сканировании товара туда попадает сканированный штрихкод. При выборе товара из списка туда чаще всего попадает «0» (т.к. для вызова списка в окне штрихкода вводится «0»). Это происходит по факту выбора, и если ничего выбрано или сканировано не было, то переменная не трогается.
Однако, если выставить в «Да» свойство «Обработать штрихкод из сессии», то действие выбора номенклатуры заглянет в переменную еще до начала выбора. Вместо ожидания ввода пользователя будет произведен автоматический поиск номенклатуры на совпадение штрихкода, кода или артикула со строкой, хранящейся в указанной переменной.
Например, можно поместить в переменную «МойТовар» значение «001» и затем выставить «Переменная штрихкода товара» = «{МойТовар}», «Обработать штрихкод из сессии» = «Да». В этом случае действие выбора номенклатуры будет искать в справочнике товар, соответствующий строке «001». Как и при обычном сканировании товара, результат поиска может быть таким:
- Товар не был найден — издается громкий звук ошибки;
- Был найден единственный товар — он кладется в сессию в переменную «SelectedProduct», а исполнение переходит либо к действию, указанному в свойстве «При удачном выборе», либо просто к следующему действию в дереве (если свойство пустое);
- Найдено несколько товаров — в зависимости от значения свойства «Автоматический выбор первого товара из списка» на экран либо выводится список найденных, либо выбирается первый же найденный товар и всё происходит как в пункте 2.
Следовательно, для полностью автоматического выбора заранее известного товара по его штрихкоду, коду или артикулу, необходимо выставить «Переменная штрихкода товара» = «{<Какая-то моя переменная>}», «Обработать штрихкод из сессии» = «Да», «Автоматический выбор первого найденного товара» = «Да».
Входные параметры
Параметры, которые может использовать действие (всегда, или в каком то определенном режиме).
Параметр |
Значение |
Описание |
---|---|---|
{ScannedBarcode} |
Строка |
Штрихкод товара для поиска, если включен режим «Обработать штрихкод из сессии». |
Результат работы
Параметр |
Значение |
Описание |
---|---|---|
{SelectedProduct} |
Товар с упаковкой |
Найденный товар с упаковкой, количеством и дополнительными полями. |
{ScannedBarcode} |
Строка |
Отсканированный для поиска штрихкод. |
{EAN128} |
Объект |
Специальный объект EAN128, создаваемый при обработке штрихкода соответствующего типа. |
Настройки действия
Полный список свойств данного действия следующий:
.Главное
Свойство |
Значение |
Описание |
---|---|---|
Имя |
Имя действия |
Должно быть заполнено для задания на него переходов. Имя можно не указывать. В этом случае на такое действие нельзя задать явного перехода по какому-либо событию или условию. |
Главные настройки поиска и выбора товара
Свойство |
Значение |
Описание |
---|---|---|
Автоматический выбор первого найденного товара |
Да | Нет |
Определяет, следует ли автоматически выбирать первый же найденный товар. Да — выбрать и перейти к следующему действию. Нет — вывести список товаров для ручного выбора. |
Игнорировать базовый штрихкод товара |
Да | Нет |
Если Да, то поиск будет учитывать только штрихкоды упаковок, но не штрихкоды товаров. |
Игнорировать политику ввода кол-ва |
Да | Нет |
Игнорировать политику учета товара, даже если она у товара выставлена. |
Обработать штрихкод из сессии |
Да | Нет |
Определяет, использовать ли переменную для хранения штрихкода не для того, чтобы занести туда результат, а для того, чтобы взять оттуда штрихкод на распознавание. Эта возможность позволяет выбрать известный товар в автоматическом режиме без запроса к пользователю. |
Ограничивать товарами документа |
Да | Нет |
Признак, того, что справочник продуктов при поиске и отображении ограничивается позициями, присутствующими в документе. |
Переменная штрихкода товара |
Строка |
Имя переменной сессии, используемой для хранения введенного штрихкода товара. По-умолчанию 'ScannedBarcode', если задать пустое значение (null), штрихкод в сессии сохранен не будет. |
Смена регистра штрихкода |
Без изменения | К верхнему регистру | К нижнему регистру |
Задает тип изменения регистра символов введенного штрихкода. |
Данные
Свойство |
Значение |
Описание |
---|---|---|
Источник списка товаров |
Шаблоны источника |
Позволяет создать с помощью шаблонов источник, в котором содержится список товаров для выбора и поиска. Поддерживаются типы — Product и ProductCollection. |
Интерфейс
Свойство |
Значение |
Описание |
---|---|---|
Звук при переходе по ошибке |
Да | Нет |
Определяет, будет ли проигран звуковой сигнал при переходе по ошибке, если товар не найден в справочнике. |
Полноэкранный режим |
Зависит от старшего | Да | Нет |
Определяет выводить ли окно действия в полноэкранном режиме (без верхних и нижних панелей, меню и т.д.). |
Полноэкранный режим (значение) |
Да | Нет |
Отображает будет ли действие выводиться в полноэкранном режиме с учетом указания на полноэкранный режим для родительских действий и типа документа. |
Текст в верхней части окна |
Строка |
Информационный текст, отображаемый в заглавии страницы при выполнении действия могут применяться шаблоны. |
Текст в самом окне |
Строка |
Вступительный текст. |
Интерфейс для киоск-режима
Свойство |
Значение |
Описание |
---|---|---|
Без визуальных элементов |
Да | Нет |
Действие открывается вообще без каких-либо визуальных элементов управления, кроме фона. Обычно применяется совместно с простановкой фонового изображения на микрокиосках. |
Относительный или абсолютный путь к файлу фонового изображения. | ||
Фоновое изображение во время поиска |
Относительный или абсолютный путь к файлу изображения, сменяющего фон во время поиска товара. |
Общее
Свойство |
Значение |
Описание |
---|---|---|
Время бездействия |
Время в секундах |
Время бездействия, после которого будет выполнен переход на другое действие. |
Переход по бездействию |
Отмена действия | Возврат на одно действие | Завершить документ | Прервать работу с документом | Возврат документа | или переход к любому выбранному действию из списка |
Куда будет выполнен переход по бездействию. |
Окно выбора из списка
Свойство |
Значение |
Описание |
---|---|---|
Автоматический выбор единственного товара из списка |
Да | Нет |
Определяет, следует ли автоматически выбирать товар из списка товаров при вводе в качестве штрихкода «0», если в списке всего один товар. Да — выбрать и перейти к следующему действию. Нет — вывести в списке наименование товара для подтверждения выбора. |
Заголовок окна выбора товара из списка |
Строка |
Текст, выводимый в заголовке окна со списком товаров. |
Позволять выбор из списка по «0» |
Да | Нет |
Признак того, разрешено ли отображение списка товаров для выбора с помощью введения «0» в качестве штрихкода. |
Сразу показывать список товаров |
Да | Нет |
Включает режим выбора продукта без штрихкода, из списка. Для вывода онлайн справочника ДОЛЖНО быть выставлено древовидное отображение товаров. |
Формат позиций окна выбора из списка |
|
Задает формат отображения позиций для окна выбора товара. Может быть задано шаблоном с форматированием. |
Тексты сообщений об ошибках
Свойство |
Значение |
Описание |
---|---|---|
Если товар не найден (текст сообщения об ошибке) |
Строка |
Текст ошибки на случай, если товар не найден. Может быть задан с форматированием. |
Управление
Свойство |
Значение |
Описание |
---|---|---|
Если товар найден |
Имя действия |
Действие, на который произойдет переход в случае удачного выбора товара. |
Если товар не найден |
Имя действия |
Действие, на которое произойдет переход в случае, если товар не найден. |
Управление отменой по Escape и стеком отмен
Свойство |
Значение |
Описание |
---|---|---|
Запомнить на стеке |
Да | Нет |
Флаг, указывающий, следует ли сохранять состояние сессии перед выполнением данного действия. Позволяет организовывать правильные алгоритмы отмены выполнения действий. |
Отмена действия по Escape |
Отмена действия | Возврат на одно действие | Завершить документ | Прервать работу с документом | Возврат документа | или переход к любому выбранному действию из списка |
Тип отмены действия. Действие, на который произойдет переход в случае нажатия Esc. |
Ячейки и палеты
Свойство |
Значение |
Описание |
---|---|---|
Выбирать палету сканированием |
Да | Нет |
Может ли по введенному штрихкоду, помимо поиска товара, производиться и поиск палеты. |
Выбирать ячейку сканированием |
Да | Нет |
Может ли по введенному штрихкоду, помимо поиска товара, производиться и поиск ячейки. |
Перейти по выбору палеты |
Имя действия |
Действие, на который произойдет переход в том случае, если сканированный штрихкод оказался штрихкодом палеты. |
Перейти по выбору ячейки |
Имя действия |
Действие, на который произойдет переход в том случае, если сканированный штрихкод оказался штрихкодом ячейки. |
Переменная хранилища |
Имя переменной |
Имя переменной, которая будет использована для хранения сканированной
|
Текст выбора палеты |
Строка |
Текст сообщения, отображаемый в том случае, если сканированный штрихкод оказался штрихкодом палеты. |
Текст выбора ячейки |
Строка |
Тест сообщения, отображаемого при удачном распознавании штрихкода как штрихкода ячейки (см. Выбирать ячейку сканированием). |