Если вы работаете с платформой 1С:Предприятие — особенно в части программирования или администрирования — то рано или поздно сталкиваетесь с аббревиатурой НСТР. Она появляется в документации, коде конфигураций, а иногда и в ошибках. Но что именно скрывается за этими четырьмя буквами? Почему этот механизм важен для корректной работы системы, и где его можно встретить на практике?

На первый взгляд, НСТР кажется очередным техническим термином, который знают только разработчики. Однако его понимание полезно и для опытных пользователей — например, когда требуется настроить обмен данными между базами или интегрировать 1С с внешними системами. В этой статье мы разберём, что такое НСТР в 1С, как он устроен, где применяется, и почему без него не обойтись в сложных конфигурациях.

Сразу уточним: речь пойдёт не о каком-то отдельном модуле или продукте, а о встроенном механизме платформы. Его название расшифровывается как «Набор Строк» (или Named String Table в англоязычной документации), и он тесно связан с работой HTTP-Сервисов, Web-расширений и других компонентов, где требуется передача структурированных данных. Если вы когда-нибудь видели в коде конструкцию Новый Структура или Новый Соответствие, то НСТР — их близкий «родственник», но с уникальными особенностями.

Что такое НСТР в 1С: расшифровка и техническая суть

НСТР — это аббревиатура от «Набор Строк», одного из встроенных типов данных в платформе 1С:Предприятие 8. В английской версии документации он обозначается как Named String Table (NST), что подчёркивает его ключевую особенность: это не просто набор строк, а структура с именованными колонками и строками, оптимизированная для передачи табличных данных между компонентами системы.

С технической точки зрения, НСТР представляет собой объект, который:

  • 📋 Содержит колонки с именами (как в таблице базы данных).
  • 📄 Хранит строки данных, где каждая строка — это набор значений для колонок.
  • 🔄 Поддерживает динамическое добавление/удаление строк и колонок.
  • 🔗 Часто используется для сериализации/десериализации данных (например, при обмене по HTTP).

Проще говоря, это «лёгкая» таблица в памяти, которую удобно передавать между разными частями 1С или внешними системами. В отличие от ТаблицаЗначений, НСТР не привязан к конкретной конфигурации и может использоваться в внешних обработках, HTTP-сервисах или Web-клиентах без привязки к метаданным.

📊 Где вы чаще всего встречали упоминание НСТР?
В коде 1С
В документации по HTTP-сервисам
При настройке обмена данными
Никогда не слышал

Где применяется НСТР: основные сценарии использования

Набор Строк не является универсальным инструментом для всех задач, но есть области, где он незаменим. Рассмотрим ключевые случаи, когда разработчики и администраторы 1С прибегают к НСТР:

1. Обмен данными по HTTP/REST

При интеграции 1С с внешними сервисами (например, API банков, маркетплейсов или CRM-систем) часто требуется передавать данные в структурированном виде. НСТР позволяет:

  • 🌐 Формировать JSON- или XML-ответы для внешних систем.
  • 📥 Парсить входящие данные и преобразовывать их в удобный для 1С формат.
  • 🔄 Обрабатывать пакетные запросы (например, выгрузка нескольких документов за один вызов).

2. Работа с Web-расширениями и JavaScript

В современных конфигурациях 1С активно используются Web-клиенты и расширения для браузеров. НСТР служит «мостом» между 1С и JavaScript-кодом, так как его легко конвертировать в JSON и обратно. Например, при:

  • 📊 Отображении динамических таблиц на веб-странице.
  • 🖱️ Обработке действий пользователя (например, фильтрация данных без перезагрузки).

3. Логирование и отладка

При разработке сложных механизмов обмена или обработки данных НСТР помогает:

  • 📝 Вести журналы операций с детализацией по полям.
  • 🐛 Быстро анализировать ошибки интеграции (например, какие именно данные не прошли валидацию).
💡

Если вам нужно передать данные из 1С в JavaScript без потерь структуры, НСТР + метод ЗаписатьJSON — один из самых надёжных способов.

НСТР vs ТаблицаЗначений vs Структура: сравнение и различия

Новички в 1С часто путают НСТР с другими коллекциями данных — ТаблицаЗначений, Структура или Соответствие. Разберём ключевые отличия:

Характеристика НСТР (Набор Строк) ТаблицаЗначений Структура
Тип данных Коллекция строк с именованными колонками Таблица с колонками и строками (привязана к метаданным) Набор пар «ключ-значение»
Где используется HTTP-сервисы, Web-расширения, обмен данными Отчёты, обработки, формы Хранение настроек, параметров
Сериализация Легко конвертируется в JSON/XML Требует дополнительных действий Конвертируется в JSON, но без структуры
Производительность Оптимизирован для передачи данных Может быть медленнее при больших объёмах Быстрый доступ по ключу

Когда выбирать НСТР?

  • ✅ Нужно передать табличные данные во внешнюю систему.
  • ✅ Требуется гибкая структура без привязки к метаданным 1С.
  • ✅ Работаете с HTTP-Сервисами или Web-клиентом.

Когда НСТР не подходит?

  • ❌ Нужна привязка к справочникам/документам 1С (лучше ТаблицаЗначений).
  • ❌ Требуется сложная обработка данных (фильтрация, сортировка — удобнее в Запросах 1С).
💡

НСТР — это «переходной» формат между внутренними данными 1С и внешними системами. Он не заменяет ТаблицуЗначений или Структуру, а дополняет их в сценариях интеграции.

Как работать с НСТР в коде 1С: основные методы и примеры

Разберём базовые операции с Набором Строк на практике. Для создания объекта используется конструктор Новый НаборСтрок. Далее можно добавлять колонки, строки и манипулировать данными.

Пример 1: Создание и заполнение НСТР

// Создаём новый набор строк

НСТР = Новый НаборСтрок;



// Добавляем колонки с именами


НСТР.Колонки.Добавить("Имя");


НСТР.Колонки.Добавить("Возраст");


НСТР.Колонки.Добавить("Город");



// Добавляем строку


Строка = НСТР.Добавить;


Строка.Имя ="Иванов Иван";


Строка.Возраст = 30;


Строка.Город ="Москва";

Пример 2: Чтение данных из НСТР

// Перебор строк

Для Каждого Строка Из НСТР Цикл


Сообщить(Строка.Имя +"," + Строка.Возраст);


КонецЦикла;

Пример 3: Конвертация НСТР в JSON

// Преобразуем в JSON для передачи по HTTP

JSONТекст = Новый ЗаписьJSON;


JSONТекст.УстановитьСтроку;


ЗаписатьJSON(НСТР, JSONТекст);



// Получаем результат


РезультатJSON = JSONТекст.Закрыть;

Пример 4: Загрузка данных из JSON в НСТР

// Чтение JSON в НСТР

ЧтениеJSON = Новый ЧтениеJSON;


ЧтениеJSON.УстановитьСтроку(РезультатJSON);


НСТР = ПрочитатьJSON(ЧтениеJSON);

Убедиться, что колонки добавлены до заполнения строк|Проверить типы данных (например, число vs строка)|Обработать возможные ошибки при чтении JSON|Тестировать на небольших объёмах данных-->

Типичные ошибки при работе с НСТР и как их избежать

Даже опытные разработчики 1С иногда сталкиваются с проблемами при использовании Набора Строк. Вот наиболее распространённые ошибки и способы их решения:

1. Пропущенные колонки

Если попытаться записать данные в колонку, которая не была объявлена заранее, 1С выдаст ошибку. Всегда проверяйте наличие колонок перед заполнением:

Если НЕ НСТР.Колонки.Содержит("НоваяКолонка") Тогда

НСТР.Колонки.Добавить("НоваяКолонка");


КонецЕсли;

2. Несовпадение типов данных

НСТР не выполняет автоматическое приведение типов. Если колонка объявлена как число, а вы пытаетесь записать строку, возникнет ошибка. Используйте явное преобразование:

Строка.Возраст = Число("30"); // вместо Строка.Возраст ="30";

3. Пустые строки при чтении JSON

При десериализации JSON в НСТР иногда строки оказываются пустыми. Это может происходить из-за:

  • 🔴 Неправильного формата JSON (например, отсутствуют кавычки для строк).
  • 🔴 Несоответствия имён колонок в JSON и в НСТР.
Что делать, если JSON не парсится в НСТР?

1. Проверьте JSON на валидность с помощью онлайн-инструментов (например, jsonlint.com).

2. Убедитесь, что имена полей в JSON совпадают с именами колонок в НСТР (с учётом регистра!).

3. Если данные сложные, разбейте JSON на части и парсьте поочерёдно.

4. Падение производительности при больших объёмах

НСТР не предназначен для обработки миллионов строк. Если вам нужно работать с большими данными, используйте:

  • 📊 ТаблицаЗначений с оптимизированными алгоритмами.
  • 🗃️ Запросы 1С с пагинацией.
💡

Для отладки НСТР используйте метод ЗаписатьJSON — он поможет увидеть реальную структуру данных, которую «видит» система.

НСТР в HTTP-сервисах: пример интеграции с внешним API

Одно из самых востребованных применений Набора Строк — обмен данными через HTTP-Сервисы. Рассмотрим практический пример: выгрузка списка клиентов из 1С в внешнюю CRM-систему.

Шаг 1: Создание HTTP-сервиса в 1С

Добавляем новый HTTP-Сервис в конфигураторе и пишем обработчик:

Функция ПолучитьСписокКлиентов(Запрос) Экспорт

НСТР = Новый НаборСтрок;


НСТР.Колонки.Добавить("Ид");


НСТР.Колонки.Добавить("Наименование");


НСТР.Колонки.Добавить("ЭлектроннаяПочта");



// Заполняем данными из справочника"Контрагенты"


Запрос = Новый Запрос;


Запрос.Текст ="ВЫБРАТЬ


| Справочник.Контрагенты.Ссылка КАК Ид,


| Справочник.Контрагенты.Наименование,


| Справочник.Контрагенты.ЭлектроннаяПочта


|ИЗ


| Справочник.Контрагенты";


РезультатЗапроса = Запрос.Выполнить;



Для Каждого Строка Из РезультатЗапроса Цикл


НоваяСтрока = НСТР.Добавить;


НоваяСтрока.Ид = Строка.Ид.УникальныйИдентификатор;


НоваяСтрока.Наименование = Строка.Наименование;


НоваяСтрока.ЭлектроннаяПочта = Строка.ЭлектроннаяПочта;


КонецЦикла;



// Возвращаем JSON


ЗаписьJSON = Новый ЗаписьJSON;


ЗаписьJSON.УстановитьСтроку;


ЗаписатьJSON(НСТР, ЗаписьJSON);


Возврат ЗаписьJSON.Закрыть;


КонецФункции

Шаг 2: Вызов сервиса из внешней системы

Внешний сервис (например, на Python или JavaScript) может получить данные по адресу вида:

GET http://ваш-сервер/hs/ваш_сервис/ПолучитьСписокКлиентов

И получить ответ в формате:

{

"meta": {...},


"data": [


{"Ид":"a1b2c3...","Наименование":"ООО Ромашка","ЭлектроннаяПочта":"info@romashka.ru"},


{...}


]


}

Шаг 3: Обработка ответа

Внешняя система парсит JSON и использует данные для своих нужд (например, обновляет базу клиентов).

💡

HTTP-сервисы с НСТР позволяют гибко настраивать обмен данными без жёсткой привязки к структуре базы 1С. Это особенно ценно при интеграции с системами, где формат данных часто меняется.

НСТР в Web-расширениях: взаимодействие с JavaScript

Ещё одна область, где Набор Строк незаменим — это работа с Web-расширениями 1С. Например, если вам нужно отобразить на веб-странице таблицу данных из 1С и дать пользователю возможность её редактировать.

Пример: Передача данных из 1С в JavaScript

Допустим, у нас есть обработка, которая формирует список товаров. Мы хотим показать его на странице с возможностью фильтрации.

Код 1С (серверная часть):

Функция ПолучитьТоварыДляWeb

НСТР = Новый НаборСтрок;


НСТР.Колонки.Добавить("Код");


НСТР.Колонки.Добавить("Наименование");


НСТР.Колонки.Добавить("Цена");



// Заполняем данными (например, из справочника"Номенклатура")


Запрос = Новый Запрос;


Запрос.Текст ="ВЫБРАТЬ ПЕРВЫЕ 100


| Номенклатура.Код,


| Номенклатура.Наименование,


| Номенклатура.Цена


|ИЗ


| Справочник.Номенклатура КАК Номенклатура";


Результат = Запрос.Выполнить;



Для Каждого Строка Из Результат Цикл


НоваяСтрока = НСТР.Добавить;


НоваяСтрока.Код = Строка.Код;


НоваяСтрока.Наименование = Строка.Наименование;


НоваяСтрока.Цена = Строка.Цена;


КонецЦикла;



// Возвращаем JSON для JavaScript


ЗаписьJSON = Новый ЗаписьJSON;


ЗаписьJSON.УстановитьСтроку;


ЗаписатьJSON(НСТР, ЗаписьJSON);


Возврат ЗаписьJSON.Закрыть;


КонецФункции

Код JavaScript (клиентская часть):

// Получаем данные из 1С

fetch('/hs/ваш_сервис/ПолучитьТоварыДляWeb')


.then(response => response.json)


.then(data => {


// Отрисовываем таблицу на странице


const table = document.getElementById('goodsTable');


data.data.forEach(item => {


const row = table.insertRow;


row.insertCell(0).textContent = item.Код;


row.insertCell(1).textContent = item.Наименование;


row.insertCell(2).textContent = item.Цена;


});


});

Преимущества такого подхода:

  • 🔄 Динамическое обновление данных без перезагрузки страницы.
  • 🎨 Возможность использовать любые JS-библиотеки для визуализации (например, DataTables или Ag-Grid).
  • 🔒 Безопасность: данные передаются в структурированном виде, минимизируя риск инъекций.
Как ускорить загрузку больших таблиц?

1. Реализуйте пагинацию на стороне 1С (возвращайте данные порциями по 50-100 строк).

2. Используйте сжатие JSON (например, gzip на веб-сервере).

3. Кэшируйте часто запрашиваемые данные на клиенте (например, в localStorage).

Будущее НСТР: актуальность и альтернативы в современных версиях 1С

Механизм Набора Строк появился в 1С давно, но остаётся востребованным и в актуальных версиях платформы (8.3.20+). Однако у него есть и альтернативы, которые стоит учитывать при проектировании решений:

1. JSON-сериализация напрямую

В новых версиях 1С появилась возможность работать с JSON более гибко — например, через объекты ЧтениеJSON/ЗаписьJSON без промежуточного преобразования в НСТР. Это удобно для простых структур данных.

2. Использование ДвоичныеДанные для больших объёмов

Если нужно передавать большие массивы данных (например, файлы или изображения), НСТР не подходит. В таких случаях используют ДвоичныеДанные или потоковое чтение.

3. GraphQL и OData

Для сложных интеграций (например, с 1С:EDT или облачными сервисами) всё чаще применяют стандарты GraphQL или OData, которые предлагают более гибкие механизмы запросов, чем НСТР.

4. Расширения для REST API

В 1С:Предприятие 8.3.20+ появилась встроенная поддержка REST-сервисов, которые могут автоматически конвертировать ТаблицуЗначений или Структуру в JSON без ручного формирования НСТР.

Тем не менее, НСТР остаётся актуальным там, где нужна:

  • 🔧 Тонкая настройка структуры ответа (например, переименование колонок «на лету»).
  • 🔄 Обратная совместимость с устаревшими системами.
  • 📦 Компактность (по сравнению с ТаблицейЗначений).
📊 Какую альтернативу НСТР вы используете чаще?
JSON напрямую
REST-сервисы 1С
GraphQL/OData
ДвоичныеДанные
Пока только НСТР

FAQ: Частые вопросы о НСТР в 1С

Можно ли использовать НСТР в обычных обработках (не HTTP-сервисах)?

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

Как преобразовать ТаблицуЗначений в НСТР?

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

Функция ТаблицаЗначенийВНСТР(Таблица)

НСТР = Новый НаборСтрок;


// Копируем колонки


Для Каждого Колонка Из Таблица.Колонки Цикл


НСТР.Колонки.Добавить(Колонка.Имя);


КонецЦикла;


// Копируем строки


Для Каждого Строка Из Таблица Цикл


НоваяСтрока = НСТР.Добавить;


Для Каждого Колонка Из Таблица.Колонки Цикл


НоваяСтрока[Колонка.Имя] = Строка[Колонка.Имя];


КонецЦикла;


КонецЦикла;


Возврат НСТР;


КонецФункции

Почему при записи в НСТР возникает ошибка «Колонка не найдена»?

Эта ошибка означает, что вы пытаетесь записать данные в колонку, которая не была заявлена заранее. Всегда проверяйте наличие колонок перед заполнением, особенно если данные приходят из внешней системы (например, JSON с неожиданной структурой).

Можно ли в НСТР хранить вложенные объекты (например, еще один НСТР)?

Нет, Набор Строк предназначен для плоских структур (строки и колонки с примитивными типами: строка, число, дата и т. д.). Для вложенных данных используйте Структуру или Массив.

Как ускорить работу с НСТР при больших объёмах данных?

Если вам нужно обработать тысячи строк:

  1. Используйте Запросы 1С для предварительной фильтрации данных.
  2. Разбивайте данные на пакеты (например, по 500 строк).
  3. Отключайте ненужные колонки в НСТР (чем меньше колонок, тем быстрее обработка).