Дополнительные таблицы Mobile SMARTS

Дополнительная таблица представляет собой “плоский” набор данных, строки таблицы содержат поля простых типов (числа, строки, булевы). Структура данных дополнительных таблиц создается и редактируется с помощью Панели управления Mobile SMARTS. Разработчик конфигурации может создавать произвольные дополнительные таблицы. В таблице кроме полей, которые содержат данные, могут быть заданы вычислимые поля (значения вычислимых полей определяется путем операций над значениями других полей), для вычислимых полей задается Шаблон значения. Таблица может как загружаться на терминал, так и хранится на сервере (в случае серверной базы Mobile SMARTS).

Например, таблица Контрагенты используется для хранения списка сторонних организаций, на терминале при работе с документом Приемки пользователь может выбирать организацию, от которой пришел товар. В таблице Остатки хранятся остатки товаров в разрезе складов, привязка к номенклатуре выполняется с помощью поля ИдНоменклатуры.

Дополнительные таблицы

Для работы с дополнительными таблицами используется объект TableAccessor [ДоступКТаблице], с помощью функций этого объекта можно выгружать данные в таблицу, читать данные, добавлять и удалять строки таблицы. Для получения объекта TableAccessor [ДоступКТаблице] следует использовать функцию GetTableAccessor [ПолучитьДоступКТаблице] из StorageConnector [Соединение]. Перед вызовом GetTableAccessor [ПолучитьДоступКТаблице] должно быть установлено подключение к базе данных Mobile SMARTS с помощью SelectCurrentApp [УстановитьПодключениеСБазойСМАРТС].

Объект TableAccessor [ДоступКТаблице] имеет следующие функции:

Пример выгрузки

C#:

	var connector  = new Cleverence.Warehouse.StorageConnector(); // Создаем экземпляр  объекта  соединения   

	 // Выполняем подключение  к базе Mobile  SMARTS 

	 connector.SelectCurrentApp("михаил-пк:10501/d7c15f54-fd05-4811-8f6d-c7c7003887c5"); 

	 // Получаем объект для доступа к таблице 

	 var tableContractors = connector.GetTableAccessor("Контрагенты"); 

	 try 

	 { 

	 tableContractors.BeginUpload(true); // Начинаем выгрузку 

	 var rows = new Cleverence.Warehouse.RowCollection(); // Коллекция строк таблицы, которую будем 

	 // использовать при выгрузке 

	   using (SqlConnection connection  = new SqlConnection(connectionString)) //Устанавливаем  соединение  с  //БД, из которой будем читать данные 

	 { 

	 connection.Open(); command.Connection = connection; 

	 SqlDataReader reader  = command.ExecuteReader(); while (reader.Read()) //Читаем данные 

	 { 

	 string id  = reader.GetString(0); string name = reader.GetString(1); string inn  = reader.GetString(1); 

	   if(rows.Count >= 1000) 

	 { 

	 //Если  набрали  достаточно строк, выгружаем  порцию строк и  создаем  новый объект  коллекции, 

	 //чтобы набирать строки дальше  в пустую коллекцию. tableContractors.Upload(rows); 

	 rows = new Cleverence.Warehouse.RowCollection(); 

	 } 

	 var row = new Cleverence.Warehouse.Row(); //Создаем строку таблицы row.SetField("Ид", id); //Проставляем поля row.SetField("Наименование", name); 

	 row.SetField("ИНН", inn); 

	 rows.Add(row); //Добавляем строку в коллекцию строк 

	 } 

	   //Если  есть строки  для  выгрузки, выгружаем 

	 } if(rows.Count > 0)

	 tableContractors.Upload(rows); 

	 } 

	   tableContractors.EndUpload(); //Завершаем выгрузку 

	 } 

	 catch 

	 { 

	 //Обработка ошибки 

	 tableContractors.ResetUpload(); //Если  возникла ошибка, сбрасываем  выгрузку

«1С:Предприятие 8»:

	connector  = новый  COMОбъект("Cleverence.Warehouse.StorageConnector"); //  Создаем экземпляр  объекта 

	 //соединения 

	 connector.УстановитьПодключениеСБазойСМАРТС("михаил-пк:10501/d7c15f54-fd05-4811-8f6d-c7c7003887c5"); 

	 //Выполняем подключение 

	   таблицаКонтрагенты  = connector.ПолучитьДоступКТаблице("Контрагенты"); //  Получаем  объект для доступа к  // таблице 

	   Попытка 

	 таблицаКонтрагенты.НачатьВыгрузку(Истина);  // Начинаем  выгрузку 

	 строкиДляВыгрузки  = новый COMОбъект("Cleverence.Warehouse.RowCollection"); //  Коллекция строк //таблицы, которую будем  использовать при  выгрузке 

	   Запрос = Новый Запрос(ТекстЗапроса); 

	 ТаблицаРезультата  = Запрос.Выполнить().Выгрузить(); //Выполняем запрос 

	   Для каждого СтрокаТаблицы из ТаблицаРезультата Цикл 

	 Ид = XMLСтрока(СтрокаТаблицы.КонтрагентСсылка); //Получаем  необходимые  поля Наименование = СтрокаТаблицы.Наименование; 

	 ИНН = СтрокаТаблицы.ИНН; 

	   Если строкиДляВыгрузки.Количество  >= 1000  Тогда 

	 //Если  набрали  достаточно строк, выгружаем  порцию и очищаем коллекцию строк таблицаКонтрагенты.ДобавитьВВыгрузку(строкиДляВыгрузки); таблицаКонтрагенты.Очистить(); 

	 КонецЕсли; 

	   строкаДляВыгрузки  = новый COMОбъект("Cleverence.Warehouse.Row"); //Создаем строку  таблицы строкаДляВыгрузки.УстановитьПоле(“Ид”,  Ид); //Проставляем  поля строкаДляВыгрузки.УстановитьПоле(“Наименование”,  Наименование); строкаДляВыгрузки.УстановитьПоле(“ИНН”, ИНН); 

	   строкиДляВыгрузки.Добавить(строкаДляВыгрузки);  //Добавляем  строку  в коллекцию  строк КонецЦикла; 

	   //Если  есть строки  для  выгрузки, выгружаем Если строкиДляВыгрузки.Количество  > 0  Тогда 

	 таблицаКонтрагенты.ДобавитьВВыгрузку(строкиДляВыгрузки); КонецЕсли; 

	   таблицаКонтрагенты.ЗавершитьВыгрузку();  //Завершаем  выгрузку Исключение 

	 // Обработка ошибки 

 

	 таблицаКонтрагенты.СброситьВыгрузку(); //Если возникла  ошибка,  сбрасываем выгрузку КонецПопытки;