Работа со справочниками в ПО AllegroClient-prof под андроид

Общее описание работы со справочниками в ПО AllegroClient-prof.

Для работы со справочниками в ПО AllegroClient-prof под андроид используется база данных SQLite.

База данных имеет наименование — «allegroDb». В базе содержится перечень готовых таблиц для хранения справочной информации.

Перечень таблиц и их наименование:

Справочник «ШтрихКоды» — «barCodes»
Справочник «Номенклатура» — «nomenclature»
Справочник «Контрагенты» — «contractors»
Справочник «Склады» — «warehouses»
Справочник «Ячейки» — «storageСells»
Справочник «Короба» — «boxes»
Справочник «ТипыЦен» — «priceTypes»

Структура таблиц и перечень полей таблиц:

Все таблицы база данных имеют одинаковую структуру.

Перечень полей и наименование: ·

code – тип String·
name– тип String·
attribute1– тип String·
attribute2– тип String·
attribute3– тип String

Загрузка справочников из 1С

Загрузка справочников в клиентское приложение осуществляется по беспроводной сети wi-fi. Протокол обмена используется такой же, как для режима работы on-line, и логика загрузки реализуется во внешней обработке в общем модуле (там же, где реализована логика работы в режиме on-line) .

Для загрузки справочников используются следующие события:

ЗагрузкаШтрихКодов
ЗагрузкаНоменклатуры
ЗагрузкаКонтрагентов
ЗагрузкаСкладов
ЗагрузкаЯчеек
ЗагрузкаКоробов
ЗагрузкаТиповЦен

Данные загружаются частями по 9000 строк, т.е. если справочник имеет список более 9000, то событие по загрузке справочника будет выполняться несколько раз.

В параметр «Данные» передается последняя загруженная строка справочника с полями разделенными символом «;».

Последняя загруженная строка является маркером, опираясь на который, можно загрузить следующие не загруженные строки справочника. Для перехода к загрузке следующего справочника (или пропуска загрузки определенного справочника) используется ключевое слово «NEXTCATALOG».

Пример использования:

Загрузка справочников

Для загрузки справочников нужно выбрать пункт меню «Загрузка справочников» и загрузить справочники.

Работа с данными справочников

Для работы с таблицами справочников используется JavaScript. Обзор по работе с JavaScript представлен в данной статье: Выполнение кода на клиенте.

Для работы с данными таблиц можно использовать произвольный код поддерживаемый JavaScript. Для получения ссылки на базу данных необходимо использовать статическую переменную — Main.dbAllegro. Для упрощения поиска данных в справочниках предусмотрены предопределенные функции.

AllegroModule. GetAllTableRows – формирует список строк всего справочника, поля в строке разделены символом «;». В параметре необходимо указать наименование таблицы (справочника).

public static List GetAllTableRows(String TableName)

AllegroModule. GetTableRows – формирует список найденных строк по значению в колонке, поля в строке разделены символом «;». В параметрах необходимо указать наименование таблицы (справочника), номер колонки (нумерация с 0) , по которой нужен поиск и значение поиска.

public static List GetTableRows(String TableName, int NumberColumn,String _value)

AllegroModule. GetTableRows – формирует список найденных строк по значениям в колонках, поля в строке разделены символом «;».В параметрах необходимо указать наименование таблицы (справочника), и сформировать HashMap (структура) в которой указывается номер колонки(нумерация с 0) и значение поиска. Таким образом, можно указать множественные значения поиска по нескольким значениям в колонках.

public static List GetTableRows(String TableName, Map filters)

Пример использования: