Как получить таблицу значений в 1С: от отладчика до автоматизации

Работа с таблицами значений в 1С:Предприятие 8.3 — одна из самых востребованных задач как для разработчиков, так и для опытных пользователей. Эти динамические структуры данных позволяют хранить и обрабатывать информацийные массивы прямо в сеансе работы, не прибегая к базе данных. Но как их получить, если они не отображаются на форме? Или как выгрузить их для анализа в Excel?

В этой статье мы разберём 5 проверенных способов извлечения таблиц значений — от ручных методов через отладчик до программной выгрузки в файлы. Особое внимание уделим типичным ошибкам, которые приводят к потере данных или искажению структуры. Материал актуален для всех популярных конфигураций: Управление торговлей (УТ 11), Бухгалтерия предприятия (БП 3.0), Зарплата и управление персоналом (ЗУП 3.1) и других решений на платформе 8.3.

Если вы никогда не работали с отладчиком 1С, не беспокойтесь — мы дадим пошаговые инструкции с картинками (в текстовом формате) и объясним, какие альтернативные методы можно использовать без программирования. А для разработчиков приведём примеры кода на встроенном языке с комментариями.

1. Получение таблицы значений через отладчик (для любых конфигураций)

Самый универсальный способ — использовать встроенный отладчик 1С. Он работает даже в типовых конфигурациях без доступа к конфигуратору. Алгоритм простой:

1. Запустите 1С:Предприятие в режиме отладки (для этого при старте удерживайте клавишу Shift или добавьте ключ /Debug в ярлык запуска).
2. Выполните действия, после которых должна появиться таблица значений (например, сформируйте отчёт или откройте документ).
3. В момент, когда таблица должна быть создана, нажмите Ctrl+Alt+Break (или выберите Отладка → Прервать в меню).
4. В окне отладчика перейдите на вкладку Переменные и найдите переменную типа ТаблицаЗначений.

Если таблица не отображается в списке переменных, попробуйте:

• 🔍 Поиск по имени: Введите в фильтр название таблицы (например, Товары или ДанныеОтчета).
• 📝 Просмотр стека вызовов: На вкладке Стек вызовов найдите процедуру, где таблица создаётся, и изучите её локальные переменные.
• 🔄 Повторный запуск: Иногда таблица создаётся только при определённых условиях (например, после нажатия кнопки"Рассчитать").

Важно: В отладчике вы можете не только просмотреть данные, но и изменить их"на лету" — это полезно для тестирования логики безфикации кода. Однако такие изменения не сохранятся после закрытия сеанса.

⚠️ Внимание: Если вы работаете с управляемыми формами, некоторые таблицы значений могут быть привязаны к элементам формы (например, ЭлементыФормы.ТаблицаДокумента.Значение). Их проще найти через вкладку Форма в отладчике.

2. Выгрузка таблицы в файл (Excel, CSV, JSON)

Когда таблица значений нужна для внешнего анализа, её удобно выгрузить в файл. В 1С есть несколько встроенных методов для этого:

Способ 1: Через меню"Все действия"

Многие типовые конфигурации (например, УТ 11 или БП 3.0) позволяют выгрузить таблицу прямо из интерфейса:

1. Откройте форму с таблицей (например, отчёт или документ).
2. Нажмите Ещё → Все действия → Выгрузить (или Сохранить как...).
3. Выберите формат: Excel, CSV или XML.

Способ 2: Программная выгрузка (для разработчиков)

Если стандартных команд нет, используйте следующий код на встроенном языке:

Процедура ВыгрузитьТаблицуВExcel(Таблица, ПутьКФайлу)
ЗаписьXML = Новый ЗаписьXML;
ЗаписьXML.ОткрытьФайл(ПутьКФайлу);
ЗаписьXML.ЗаписатьОбъект(Таблица);
ЗаписьXML.Закрыть;
КонецПроцедуры

// Пример вызова:
ТаблицаДанных = Новый ТаблицаЗначений;
ТаблицаДанных.Колонки.Добавить("Наименование");
ТаблицаДанных.Колонки.Добавить("Количество");
ВыгрузитьТаблицуВExcel(ТаблицаДанных,"C:\Temp\Данные.xml");

Для выгрузки в Excel лучше использовать библиотеку OneScript.Excel или компоненту COMObect("Excel.Application") (требует установленного Microsoft Office).

⚠️ Внимание: При выгрузке в CSV даты и числа могут конвертироваться в строки с разделителями, зависящими от региональных настроек Windows. Например, 01.12.2023 станет 1/12/2023 на английской системе. Всегда проверяйте результат!

Убедиться, что путь для сохранения существует|Проверить права на запись в папку|Очистить таблицу от ненужных колонок|Сохранить резервную копию данных-->

3. Использование запросов для создания таблиц значений

Если таблица значений не существует, но нужные данные хранятся в базе, её можно создать динамически с помощью запроса. Это особенно полезно для отчётов, где требуется сводная информация из нескольких таблиц.

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Номенклатура.Наименование КАК Товар,
| СУММА(Документ.Количество) КАК ИтогоКоличество
|ИЗ
| Документ.РеализацияТоваровУслуг КАК Документ
| ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура КАК Номенклатура
| ПО Документ.Номенклатура = Номенклатура.Ссылка
|ГДЕ
| Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода
|СГРУППИРОВАТЬ ПО
| Номенклатура.Наименование";

Запрос.УстановитьПараметр("НачалоПериода", НачалоМесяца(ТекущаяДата));
Запрос.УстановитьПараметр("КонецПериода", КонецМесяца(ТекущаяДата));

Результат = Запрос.Выполнить;
ТаблицаРезультатов = Результат.Выгрузить; // Это и есть таблица значений!

Ключевые моменты:

• 📌 Метод Выгрузить автоматически преобразует результат запроса в таблицу значений.
• 🔧 Для сложных отчётов используйте ОбъединениеРезультатов или ПоместитьВременныеТаблицы.
• ⚡ Оптимизация: Если запрос выполняется долго, добавьте индексы в виртуальные таблицы или используйте ПЛАН ЗАПРОСА для анализа.

Таблицы значений, созданные через запрос, не обновляются автоматически при изменении данных в базе. Их нужно пересчитывать вручную или по событию (например, при открытии формы).

4. Работа с таблицами значений в обработках и отчётах

Многие типовые отчёты (например, Оборотно-сальдовая ведомость в БП 3.0) формируют таблицы значений на этапе выполнения. Чтобы их"поймать":

1. Откройте нужный отчёт через Отчёты → Стандартные отчёты.
2. Установите необходимые отборы и нажмите Сформировать.
3. После формирования перейдите в Все действия → Показать настройки.
4. На вкладке Дополнительно найдите опцию Вывести результат в таблицу значений (в некоторых конфигурациях она скрыта — включите отображение всех команд через Ещё → Настройка панели действий).

Если такой опции нет, можно модифицировать отчёт:

1. Скопируйте типовой отчёт в пользовательский (Все функции → Копировать).
2. В модуле отчёта найдите процедуру СформироватьРезультат.
3. Добавьте строку Результат = Новый ТаблицаЗначений; перед выводом данных.
4. Замените вывод на форму на Возврат Результат;.

Для управляемых форм (например, в УТ 11) таблицы значений часто хранятся в реквизитах формы. Чтобы их извлечь:

// Получение таблицы из формы документа
ТаблицаТоваров = Объект.Товары.Выгрузить;

⚠️ Внимание: В конфигурациях с БСП (Библиотека стандартных подсистем) некоторые таблицы значений могут быть обёрнуты в объекты типа ДанныеФормыКоллекция. Чтобы получить исходную таблицу, используйте метод ВыгрузитьЗначенияВТаблицу.

5. Автоматизация: получение таблиц через внешние обработки

Для регулярного извлечения таблиц значений удобно использовать внешние обработки. Они позволяют:

• 🔄 Автоматизировать выгрузку по расписанию (через регламентные задания).
• 📊 Сохранять историю изменений (например, еженедельные остатки товаров).
• 🔗 Интегрироваться с другими системами (например, отправлять данные в Google Sheets или Power BI).

Пример обработки для выгрузки таблицы в JSON:

Перем ТаблицаДанных;

Процедура ПриОткрытии(Отказ)
ТаблицаДанных = Новый ТаблицаЗначений;
ТаблицаДанных.Колонки.Добавить("Код");
ТаблицаДанных.Колонки.Добавить("Наименование");
// Заполнение таблицы данными (например, из справочника)
Выборка = Справочники.Номенклатура.Выбрать;
Пока Выборка.Следующий Цикл
НоваяСтрока = ТаблицаДанных.Добавить;
НоваяСтрока.Код = Выборка.Код;
НоваяСтрока.Наименование = Выборка.Наименование;
КонецЦикла;
КонецПроцедуры

Процедура ВыгрузитьВJSON(Команда)
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку;
ЗаписьJSON.ЗаписатьОбъект(ТаблицаДанных);
ТекстJSON = ЗаписьJSON.Закрыть;

// Сохранение в файл
ТекстJSON.Записать("C:\Temp\Номенклатура.json");
Сообщить("Файл сохранён!", СтатусСообщения.Информация);
КонецПроцедуры

Готовые обработки для выгрузки таблиц можно найти:

• 📁 На Инфостарт (раздел"Обработки для 1С").
• 🛠 В каталоге 1С:ИТС (требуется подписка).
• 💾 В репозиториях GitHub (поиск по запросу 1C table export).

Важно: Перед использованием сторонних обработок проверьте их на тестовой базе — некоторые могут содержать вредоносный код или конфликтовать с вашей конфигурацией.

6. Типичные ошибки и как их избежать

При работе с таблицами значений даже опытные пользователи сталкиваются с проблемами. Вот самые распространённые:

Ещё несколько нюансов:

• 🔢 Типы данных: При загрузке таблицы из Excel числа могут становиться строками. Используйте Число или Дата для приведения типов.
• 🔒 Блокировки: Если таблица используется в транзакции, её нельзя изменить из другого сеанса. Используйте Попытка...Исключение для обработки ошибок.
• ⏱ Производительность: Для таблиц с >10 000 строк используйте ИндексированнаяТаблицаЗначений (доступна с версии платформы 8.3.14).

Если вы получаете ошибку Данные не являются значением объекта типа ТаблицаЗначений, скорее всего, вы пытаетесь привести к таблице данные другого типа (например, результат запроса без выгрузки). Всегда проверяйте тип с помощью ТипЗнч:

Если ТипЗнч(Результат) = Тип("ТаблицаЗначений") Тогда
// Работаем с таблицей
Иначе
Сообщить("Ошибка: получен неверный тип данных!");
КонецЕсли;

7. Альтернативные способы: OData, REST и DirectConnect

Для интеграции с внешними системами таблицы значений можно получать через:

1. OData-сервис (для 1С:Предприятие 8.3.10+)

Если в вашей конфигурации настроен OData, вы можете получить таблицу через HTTP-запрос:

// Пример URL для получения данных:
http://ваш_сервер/одата/standard.odata/Catalog_Номенклатура?
$select=Description,Code&$top=100

Для авторизации используйте Basic Auth или токены (в зависимости от настроек сервера).

2. REST API (через HTTP-сервисы)

Многие современные конфигурации (например, 1С:ERP) предоставляют REST API. Пример вызова из Postman:

POST /hs/exchange/rest/GetTableData
Headers:
Authorization: Bearer ваш_токен
Content-Type: application/json

Body:
{
"tableName":"GoodsList",
"filter": {"dateFrom":"2023-01-01"}
}

3. DirectConnect (для SQL-баз)

Если 1С работает на MS SQL Server или PostgreSQL, можно подключиться напрямую к базе и выполнить запрос:

-- Пример SQL-запроса для получения данных из таблицы значений
-- (требует знания структуры базы 1С!)
SELECT
T1._Description AS Наименование,
T1._Code AS Код
FROM
_Reference16 T1 -- Справочник.Номенклатура
WHERE
T1._Marked = 1;

⚠️ Внимание: Прямой доступ к базе 1С нарушает лицензионное соглашение и может привести к повреждению данных. Используйте этот метод только для чтения и после согласования с администратором системы.

Для автоматизации обмена данными между 1С и другими системами рекомендуем использовать 1С:Коннектор или 1С:Интеграцию — они предоставляют безопасные и документированные способы работы с таблицами значений.

FAQ: Ответы на частые вопросы

РезультатСравнения = Новый ТаблицаЗначений;
Для Каждого Строка1 Из Таблица1 Цикл
Строка2 = Таблица2.Найти(Строка1.Ключ);
Если Строка2 = Неопределено Тогда
РезультатСравнения.Добавить.Описание ="Отсутствует в Таблице2:" + Строка1.Ключ;
ИначеЕсли Строка1.Значение <> Строка2.Значение Тогда
РезультатСравнения.Добавить.Описание ="Различаются значения:" + Строка1.Ключ;
КонецЕсли;
КонецЦикла;

Результат = КомпоновщикМакета.Выполнить(СхемаКомпоновкиДанных, Настройки);
ТаблицаДанных = Результат.Результат.Выгрузить; // Это таблица значений!

Для Каждого ЭлементРезультата Из Результат.Результат Цикл
Если ТипЗнч(ЭлементРезультата) = Тип("ТаблицаЗначений") Тогда
// Обработка таблицы
КонецЕсли;
КонецЦикла;