вернуться к основную страницу ValTable

изменения до оформления версии

27-07-2005
- Новый тип хранения данных - Дата (см. НоваяКолонка)
- Новый метод ТипКолонки

09-08-2005
- расширен метод Выгрузить. Теперь выгружать можно в файл и в стандартную ТаблицаЗначений

14-08-2005 - 16-08-2005
- метод Загрузить теперь может также загружать СписокЗначений, метод Выгрузить добавлено для СписокЗначений и для AddIn.ValTable. Применение метода ПолучитьИД() теперь не обязательно. Для ознакомления со всеми новыми возможности см.описание методов.
- новый метод НовыеКолонки. Позволяет создать одним вызовом множество колонок.

25-08-2005
- Новый метод УстановитьПоЗначению (аналогично Установить для СписокЗначений)
- метод УдалитьКолонку теперь может удалить сразу несколько колонок.
- исправлены ошибки: не работал тип СтрокаБР, глюки с сохранением в файл, глюки с некоторыми сообщениями об ошибках

16-09-2005
- в методе ВыбратьПоЗначению в качестве фильтра можно устанавливать список значений, количество фильтров можно передать одновременно до трех
- метод УстановитьПоЗначению может отрабатывать фильтр по СписокЗначений и устанавливать сразу несколько колонок
- метод Итог теперь может выдать итоговую сумму по указанному фильтру
- после метода ВыбратьСтроки, при количестве строк в таблице = 0, метод ПолучитьСтроку генерировал ошибку. Исправлено.
- метод Выгрузить в СписокЗначений теперь не обязательно указывать ''... как Значение'' или ''... как Представление''
- метод Выгрузить, название конечного объекта можно указать сокращенно - ''СЗ'' или ''ТЗ''
- метод УстановитьЗначение - теперь может устанавливать значение сразу для нескольких ячек (типа Заполнить в стандартной ТЗ)
- УДАЛЕНЫ МЕТОДЫ:
-- ПолучитьИтогиПомножеству - см.ПолучитьИтоги
-- ПолучитьИД - теперь не нужен
-- НовыеКолонки - см.НоваяКолонка
- в комплект поставки включена обработка для просмотра и печати таблицы ''ПросмотрОбъекта.ert'', см.раздел ''Как посмотреть и распчатать таблицу'

версия 2.0 (06-10-2005)

Упразднен тип СтрокаБР. Тип Строка теперь хранит строки без учета регистра. Тип объект теперь может хранить ЛЮБОЙ тип данных. Если требуется хранить строку с учетом регистра, тогда используется тип Объект. Если при создании колонки название типа опущено, тогда создается колонка типа Объект. Данные, выгруженные в файл прошлой версией, не будут правильно загружаться в объект текущей версии.

Значения, тип которых = 100, при выгрузке в файл не сохраняются (соотвественно и не загружаются).

Порядок сортировки колонки типа Объект, при разных в нем типах:

1. пустое значение
2. Числа,Даты (для дат сравнивается численное представление) строки, Тип(Значение) < 100 и <> 12
3. Тип(Значение) = 12 (между собой сортировка всегда по позиции)
4. Контексты

Загрузка из ТЗ, СЗ и запросов
Если типы не указываются, тогда они определяются по перовой строке!!! компонента загружает в типы: число, дата, объект (строки тоже в объект) при этом, если колонка содержит разные данные, а первая строка содержит значение типа число, тогда необходимо принудительно указать тип объект.

Подсчет итогов.
Для типа Объект могут считаться итоги (Итог(), ПолучитьИтоги()), при этом, если тип сохраненного значения не число, тогда это значение приводится к строке (берется представление) и конвертируется в число.

Хранение в объекте значений типа число менее выгодно по скорости и по объему памяти, чем хранение в колонке типа число. При сохранении прочих типов в объекте их повторяемость более вероятна, чем числовых (элементов справочников редко бывает более 10000, и со строками таже картина, ну а числовые в отчетах в основном на каждую строку свое значение).

Для метода ВыбратьПоЗначению разрешено в виде значения фильтра передавать пустое значение (до этого считалось, что значение фильтра забыли указать). Количество фильтров определяется только первым параметром (количество колонок).

Удаление строк.
Если таблица, из которой удаляется строка не является владельцем данных, тогда из нее эта строка просто исключается и никаких проблем (ведь эта таблица содержит всего лишь ссылки на главную таблицу). Если таблица является владельцем данных, тогда память из-под удаляемой строки не высвобождается, но строка помечается как удаленная (если высвобождать, тогда это большие затраты по времени, плюс эта строка может содержать данные, на которые ссылаются таблицы-подмножества). Впоследствии, при добавлении новой строки, новая строка может просто сослаться на эту удаленную строку и разотметить ее удаление. Если таблица имела подмножества, которые ссылались на удаленную строку, тогда при записи в эту новую строку, в подмножествах данные тоже будут меняться.

добавлен в ALS раздел "Известные глюки"

версия 2.0.5 (30.10.2005)

Исправления:
исправлен недочет, связаный с использованием значений из реквизитов неопределенного типа
исправлен баг, возникавший при использовании метода ВыбратьПоЗначению
Исправлена ошибка: не сохраняла значения типа перечисление.
Исправлен недочет метода УстановитьПоЗначению
Новое:
- Добавлен метод Версия.
- Добавлен метод Зарегистрированна
- Расширен метод НайтиЗначение - теперь может производить поиск сразу по трем значениям и по СписокЗначений.
- !!!Изменен синтаксис метода ПолучитьПоЗначению (и добавлена возможность получения по нескольким знач)
- Добавлен метод УдалитьПоЗначению(колонка, зн1, зн2, зн3)
- Добавлен метод КоличествоСтрокВПодмножестве
- сделана возможность фильтровать по значениям в ТаблицаЗначений
(если использовать СписокЗначений, то в него нельзя поместить пустое значение) отсюда следствие, можно использовать так:
т.ВыбратьПоЗначению("значение", т2.Выгрузить("ТЗ"));
фильтрует по первой колонке таблицы

Версия 2.0.6

- Метод Выгрузить в файл может теперь сохранять вложенные AddIn.ValTable. Все прочие значения типа ТаблицаЗначений или СписокЗначений (тип == 100) попрежнему при сохранении очищаются.

- Метод УстановитьЗначение при использовании для целей заполнения. Начальную и конечную строку указывать не обязательно, если они опущены обе!!! тогда заполняются все строки таблицы, а если таблица пустая, то ошибка не генерится. Во всех прочих случаях остается, что если конечная строка не указана, то действует только для одной строки.

- Метод Загрузить теперь не требует наличие строки в ТЗ, и при их отсутствии создает колонки типа Объект.

Версия 2.0.7 (26.06.2006)

Новое в версии:
- ПереименоватьКолонку(СтароеНазв, НовоеНазв)
- Макс(Колонка) Для типов Дата возвращаемое значение имеет тип Число.
- Мин(Колонка)
- УдалитьСтроку() без параметра удаляет текущую строку
- Установить() может установить значение в несколько колонок, указанных через запятую
- Итог, если кому вздумается, теперь может посчитать итог и по типу Дата
- НайтиЗначение при найденом значении позиционирует текущую строку

Введено округление на все устанавливаемые дробные числа до 10E-13 по причине...

    т = СоздатьОбъект("AddIn.ValTable");
    т.НоваяКолонка("Ч", "Число");
    т.НоваяСтрока();
    т.ч = 2.3;
    т.НоваяСтрока();
    т.ч = т.ПолучитьЗначение(1, "Ч");
    сообщить(т.ПолучитьИтоги("Ч", "").КоличествоСтрок());

выдавало две строки (число 2.3 в типе double = 2.2(9))

Методы, которые возвращают сформированную новую таблицу (ПолучитьИтоги, ВыбратьПоЗначени, ...)
теперь, если при в новой таблице количество строк больше нуля, тогда текущая строка автоматически устанавливается на первую.

Метод ПолучитьИтоги может получать итоги без указания реквизитов групп
т.ПолучитьИтоги('''', ''Количество,Сумма'');
в результате, получается таблица из одной строки, с колонками, указанными в итогах, и эта таблица спозиционированна на первую строку. Удобно при построении отчетов, формировать итоговую строку, т.к. обычно секция итога повторяет секцию строки, и в данном случае будут идентичны и обращения к реквизитам таблицы.

Версия 2.0.8 (05.09.2006)

- метод Загрузить из объекта Запрос с пустым результатом запроса не генерирует ошибку.
- метод Показать(<Модально>)
- метод КопиКолонку(<УстанавливаемаяКолонка>, <КолонкаИсходная>)

Версия 2.0.9 (28.04.2007)

- всех изменений не помню, кучка мелкий исправлений
- исправлен глюк при работе с УРБД - некорректно воспринимала значения типа документ