SelectedProduct – выбранная позиция товара, содержит информацию о товаре, его упаковке, количестве и различных дополнительных полях, извлеченных из штрихкода или заданных каким-то другим способом. Позволяет выбирать, отображать товар и его свойства, когда он был выбран.
Именно этот объект используется при занесении строк товара в документ (смотрите действия «Прямая запись в документ», «Запись данных в буфер», «Запись буфера в документ»).
Кем заполняется
Обычно эта переменная появляется как результат работы действия выбора товара и содержит конкретный итоговый выбранный сканированием или из списка товар (поле Product) вместе с конкретной упаковкой (Packing) и количеством (Quantity). Значение количества по умолчанию равно 1, если оно не было извлечено из штрихкода по шаблону.
Другие варианты заполнить SelectedProduct с помощью функции товара Pack(…).
Product.Pack() – возвращает упакованный товар в базовой упаковке с количеством 1.
Product.Pack(qty) – возвращает упакованный товар в базовой упаковке с количеством qty (заменяется в шаблоне на значение или шаблон значения).
Product.Pack(packingId, qty) – возвращает упакованный товар в упаковке с кодом packingId (замените в шаблоне) с количеством qty (заменяется в шаблоне на значение или шаблон значения).
Например, мы хотим заполнить SelectedProduct на основе строки документа, выбранной нами из списка в переменную ВыбраннаяСтрока.
Тогда действие присваивания
SelectedProduct=ВыбраннаяСтрока.Product.Pack(ВыбраннаяСтрока.PackingId, ВыбраннаяСтрока.DeclaredQuantity)
создаст и заполнит SelectedProduct объектом с товаром, указанным в строке, в той же упаковке, и количеством, равным заявленному количеству в строке.
Создание SelectedProduct на основе неизвестного товара будет выглядеть так:
SelectedProduct=UnknownProduct.Pack()
Как используется
SelectedProduct используется действиями «Прямая запись в документ» и «Запись данных в буфер» как исходные данные для их работы. Эти действия считают, что именно в SelectedProduct содержатся выбранный пользователем товар с упаковкой, дополнительными полями и его количество. Соответственно, отсутствие заполненного SelectedProduct в сессии приведет эти действия к ошибке выполнения.
Кроме этого, именно SelectedProduct обычно используется для отображения на экране информации о текущих выбранных данных в действиях, которые обычно идут между сканированием товара и его занесением в документ: ввод количества, редактирование дополнительных полей и т.п.
Например, выражение
{SelectedProduct.ОтображаемоеИмя} {SelectedProduct.КолвоВДокументе:Сканировано (0) }{SelectedProduct.Packing.Name}
заданное в шапке ввода количества будет отображать имя, количество и упаковку отсканированного товара для которого собственно пользователю и предлагает ввести количество.
Основные поля
Имя свойства объекта |
Описание |
Примеры |
---|---|---|
Product |
Позиция номенклатуры (товар) которая была выбрана. |
SelectedProduct.Product |
Packing |
Упаковка товара в которой исчисляется выбранный товар. |
SelectedProduct.Packing |
Quantity |
Введенное количество в заданном типа упаковки. |
SelectedProduct.Quantity |
QuantityInBasePacking |
Введенное количество в базовых упаковках. |
SelectedProduct.QuantityInBasePacking |
RegistrationDate |
Дата регистрации. |
SelectedProduct.RegistrationDate |
ExpiredDate |
Дата срока годности. |
SelectedProduct.ExpiredDate |
Дополнительные поля строки |
Дополнительные поля строки могут быть заведены в каждом типе документа. |
SelectedProduct.ОтображаемоеИмя |