Как открыть TXT файл в 1С: инструкция с примерами кода

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

Выбор способа зависит от размера файла и задачи. Если файл небольшой и его нужно просто показать пользователю или разобрать целиком, удобнее «ТекстовыйДокумент». Если файл большой (сотни мегабайт) или его нужно читать построчно с контролем кодировки, правильнее использовать «ЧтениеТекста» — оно не загружает весь файл в память.

Ниже разобраны оба подхода с готовыми примерами кода, вопросы кодировки, работа с файлами на клиенте и на сервере, типичные ошибки и способы проверки результата.

Способы открытия TXT файла: что выбрать

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

Объект «ЧтениеТекста» открывает файл как поток и позволяет читать его построчно, блоками или целиком методом «Прочитать()». Файл при этом не загружается в память полностью, что критично для больших выгрузок. Кодировку можно указать явно при открытии.

Объект «ТекстовыйДокумент» загружает файл целиком методом «Прочитать()» и предоставляет доступ к строкам по индексам. Он удобен, когда нужно показать содержимое пользователю, выполнить поиск и замену или когда файл гарантированно небольшой.

Открытие файла через ЧтениеТекста

Это основной и рекомендуемый способ для обработки файлов обмена. Объект создаётся конструктором «Новый ЧтениеТекста», куда передаётся путь к файлу и, при необходимости, кодировка. Затем в цикле вызывается метод «ПрочитатьСтроку()», который возвращает «Неопределено», когда файл закончился.

ЧтениеТекста = Новый ЧтениеТекста("D:\Обмен\price.txt", КодировкаТекста.UTF8);
Строка = ЧтениеТекста.ПрочитатьСтроку();
Пока Строка <> Неопределено Цикл
    // Разбор строки, например по разделителю
    Части = СтрРазделить(Строка, ";");
    // ... обработка данных ...
    Строка = ЧтениеТекста.ПрочитатьСтроку();
КонецЦикла;
ЧтениеТекста.Закрыть();

Обратите внимание на обязательный вызов «Закрыть()» после завершения чтения. Пока файл открыт объектом, он может быть заблокирован для других программ, особенно на Windows. Если обработка прерывается по ошибке, стоит закрывать файл в блоке «Попытка...Исключение...КонецПопытки», чтобы не оставлять «висеть» открытый дескриптор.

Если нужно прочитать файл целиком одной строкой, используйте метод «Прочитать()» без параметров — он вернёт всё содержимое. Это удобно для небольших файлов, но лишает главного преимущества потокового чтения.

Чтение с указанием разделителя строк

В конструкторе «ЧтениеТекста» третьим и четвёртым параметрами можно задать разделитель строк и разделитель групп символов. Это полезно, когда файл приходит из системы с нестандартными переносами строк — например, только с символом возврата каретки. Если строки «слипаются» в одну, проверьте именно этот параметр.

Открытие файла через ТекстовыйДокумент

Объект «ТекстовыйДокумент» создаётся конструктором «Новый ТекстовыйДокумент», после чего метод «Прочитать()» загружает файл. Доступ к строкам осуществляется через «КоличествоСтрок()» и «ПолучитьСтроку(Номер)», нумерация строк начинается с единицы.

Документ = Новый ТекстовыйДокумент;
Документ.Прочитать("D:\Обмен\price.txt", КодировкаТекста.UTF8);
Для Номер = 1 По Документ.КоличествоСтрок() Цикл
    Строка = Документ.ПолучитьСтроку(Номер);
    // обработка строки
КонецЦикла;

Такой подход удобен, когда нужно несколько раз проходить по строкам, обращаться к ним по номеру или показать текст пользователю через метод «Показать()». Однако весь файл помещается в память, поэтому для файлов в десятки и сотни мегабайт этот способ применять не следует — возможны замедление работы и ошибки нехватки памяти на сервере.

Кодировка: почему текст открывается «кракозябрами»

Самая частая проблема при открытии TXT — неверная кодировка. Файл, созданный в кодировке Windows-1251, при чтении как UTF-8 превращается в нечитаемые символы, и наоборот. 1С не определяет кодировку автоматически надёжно: значение по умолчанию зависит от настроек, поэтому кодировку лучше указывать явно.

Основные варианты перечисления «КодировкаТекста»: UTF8 (типично для современных систем и Linux), ANSI (Windows-1251 для русскоязычных файлов из Windows), OEM (DOS-кодировка, встречается в выгрузках старого оборудования и касс), UTF16. Если источник файла известен, уточните кодировку в его документации.

Признак неверной кодировки — кириллица отображается как «РљРѕРґ», «?????» или подобные последовательности. Исправляется это не заменой символов, а повторным открытием файла с правильным значением «КодировкаТекста».

Открытие файла на клиенте и на сервере

В файловой базе и в толстом клиенте путь к файлу работает напрямую. Но в клиент-серверном режиме код, выполняемый на сервере, видит только диски сервера — путь «C:\Users\...» пользователя для сервера не существует. Это вторая по частоте причина ошибок «файл не найден».

Стандартная схема для тонкого и веб-клиента такая: на клиенте файл помещается во временное хранилище методом «НачатьПомещениеФайла», затем на сервере данные из хранилища записываются во временный файл методом «ПолучитьИмяВременногоФайла()», и уже этот файл открывается «ЧтениеТекста».

1. 1
   На клиенте вызовите НачатьПомещениеФайла с диалогом выбора файла и получите адрес во временном хранилище
2. 2
   Передайте адрес хранилища в серверную процедуру
3. 3
   На сервере получите данные из хранилища и запишите их во временный файл (ПолучитьИмяВременногоФайла с расширением txt)
4. 4
   Откройте временный файл через ЧтениеТекста и обработайте построчно
5. 5
   Удалите временный файл после обработки и очистите хранилище

Для интерактивного выбора файла у пользователя используйте «ДиалогВыбораФайла» с режимом «Открытие» и фильтром «Текстовые файлы (.txt)|.txt». Диалог работает асинхронно через «Показать()» с описанием оповещения.

Проверка результата и обработка ошибок

Перед открытием файла полезно проверить его существование объектом «Файл» и методом «Существует()» — это позволит выдать понятное сообщение вместо системной ошибки. Также стоит проверить, что файл не пустой: чтение первой строки вернёт «Неопределено» сразу.

Файл = Новый Файл(ПутьКФайлу);
Если Не Файл.Существует() Тогда
    ВызватьИсключение "Файл не найден: " + ПутьКФайлу;
КонецЕсли;

Разбор данных из строк тоже требует защиты: количество колонок после «СтрРазделить» может не совпадать с ожидаемым, числа могут содержать запятую вместо точки, а даты — нестандартный формат. Преобразование значений оборачивайте в «Попытка...Исключение» и собирайте список проблемных строк, чтобы показать пользователю после загрузки, а не прерывать весь процесс на первой ошибке.

Типичные ошибки и ограничения

Большинство проблем при открытии TXT в 1С сводится к нескольким повторяющимся сценариям. Знание их заранее экономит значительное время отладки.

Дополнительное ограничение: в веб-клиенте работа с файловой системой возможна только через расширение работы с файлами или асинхронные методы помещения — синхронные вызовы типа «ПоместитьФайл» без расширения могут быть недоступны. Проектируйте код сразу на асинхронных методах («НачатьПомещениеФайла»), чтобы он работал во всех клиентах.

Частые вопросы