Тип: Строка. Содержит имя файла, в который сохраняется документ, если пользователь выполнил команду "Сохранить". Данное свойство будет заполняться: 1. при программной установке значения; 2. при интерактивном открытии документа из файла; 3. при вызове метода Показать, если в нем указано имя файла; 4. при вызове пользователем команды "Сохранить как…". Внимание! Значение данного свойства не сохраняется в следующих случаях: - при сохранении документа в двоичные данные, - при сохранении документа в файл.
Полное описание, параметры и ограничения
ТабличныйДокумент.ИспользуемоеИмяФайла (SpreadsheetDocument.UsedFileName)
ТабличныйДокумент (SpreadsheetDocument)
ИспользуемоеИмяФайла (UsedFileName)
Доступен, начиная с версии 8.1.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит имя файла, в который сохраняется документ, если пользователь выполнил команду "Сохранить".
Данное свойство будет заполняться:
1. при программной установке значения;
2. при интерактивном открытии документа из файла;
3. при вызове метода Показать, если в нем указано имя файла;
4. при вызове пользователем команды "Сохранить как…".
Внимание! Значение данного свойства не сохраняется в следующих случаях:
- при сохранении документа в двоичные данные,
- при сохранении документа в файл.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Описание изменено в версии 8.3.23.
Методическая информация
Практические примеры
Сохранить вид документа в MXL без записи на диск
Скрываем сетку и заголовки и переносим документ через собственный поток в памяти. Имя для будущего Сохранить не является частью файла.
Где и как запускать
Полный модуль собственной управляемой формы; толстый клиент Windows. Не запускать в рабочей конфигурации.
Подготовка
Создайте собственную отдельную учебную базу с именем конфигурации УчебнаяКонфигурацияСинтаксиса, внешнюю обработку и пустую управляемую форму. Откройте её в толстом клиенте Windows 8.5.1.1343.
Для командного урока создайте команду Выполнить, кнопку и действие Выполнить. Вставьте весь приведённый модуль, включая функции ниже процедуры.
Книга / 3 и Ручка / 1 создаются в новом табличном документе. Рабочие печатные формы, документы базы и файлы организации не используются.
Основной язык собственной конфигурации — ru. Урок языков дополнительно требует язык en. Языки создаются вручную в Конфигураторе; код не устанавливает их и не переводит текст автоматически.
Урок проверки печати требует установленного собственного тестового/виртуального принтера. На форме создайте строковый реквизит УчебныйПринтер и введите точное имя устройства.
Для реальной печати дополнительно нужен строковый реквизит Подтверждение. Для окна нужна отдельная команда СкрытьУчебноеОкно. Для сохранения первый запуск использует новый временный MXL, не существующий рабочий файл.
При создании руководства 1С, принтер и запись файла не запускались. Окна, драйвер и обратный вызов проверяются вручную в собственной учебной базе.
&НаКлиенте
Процедура Выполнить(Команда)
Документ = СоздатьУчебныйДокумент();
Документ.ОтображатьЗаголовки = Ложь;
Документ.ОтображатьСетку = Ложь;
Документ.СохранятьСвойстваОтображения = Истина;
Документ.ИспользуемоеИмяФайла = "guide-owned-unsaved-" + Строка(Новый УникальныйИдентификатор) + ".mxl";
Документ.КодЯзыка = "ru";
Поток = Новый ПотокВПамяти;
Попытка
Документ.Записать(Поток, ТипФайлаТабличногоДокумента.MXL);
Сообщить(Поток.Размер() > 0);
Поток.Перейти(0, ПозицияВПотоке.Начало);
Копия = Новый ТабличныйДокумент;
Копия.Прочитать(Поток, , ТипФайлаТабличногоДокумента.MXL);
Копия.КодЯзыка = "ru";
Сообщить(Копия.Область(2, 1).Текст = "Книга");
Сообщить(Копия.Область(3, 2).Текст = "1");
Сообщить(НЕ Копия.ОтображатьЗаголовки);
Сообщить(НЕ Копия.ОтображатьСетку);
Сообщить(ПустаяСтрока(Копия.ИспользуемоеИмяФайла));
Сообщить(НЕ ПустаяСтрока(Документ.ИспользуемоеИмяФайла));
Исключение
ОшибкаОперации = ОписаниеОшибки();
Поток.Закрыть();
ВызватьИсключение ОшибкаОперации;
КонецПопытки;
Поток.Закрыть();
КонецПроцедуры
&НаКлиенте
Функция СоздатьУчебныйДокумент()
Документ = Новый ТабличныйДокумент;
Документ.КодЯзыка = "ru";
Документ.Область(1, 1).Текст = "Товар";
Документ.Область(1, 2).Текст = "Количество";
Документ.Область(2, 1).Текст = "Книга";
Документ.Область(3, 1).Текст = "Ручка";
Документ.Область(2, 2).Текст = "3";
Документ.Область(3, 2).Текст = "1";
Документ.Область(, 1, , 1).ШиринаКолонки = 25;
Документ.Область(, 2, , 2).ШиринаКолонки = 12;
Возврат Документ;
КонецФункцииРазбор по шагам
Отключить два свойства отображения и включить СохранятьСвойстваОтображения.
Назначить вымышленное новое имя документа, но передать Записать именно ПотокВПамяти: файл с этим именем не создаётся.
Перед чтением перейти в начало потока. Прочитать получает MXL третьим аргументом, не вторым.
Сравнить две ячейки и отображение копии. Проверить, что ИспользуемоеИмяФайла не переносится через сохранение, и закрыть собственный поток в обеих ветках.
Как проверить результат
Семь проверок дают Истина.
У копии скрыты сетка и заголовки. ИмяФайла копии пустое, исходный документ хранит собственную подсказку для Сохранить.
Ожидаемый результат
Полный обмен MXL в памяти с сохранением нужного вида документа.
На что обратить внимание
Имя файла в свойстве не означает, что файл уже записан.
Веб-клиент не поддерживает вариант Записать в поток: урок предназначен для толстого клиента Windows.
Не ищите КодЯзыка в сохранённом MXL как переносимое свойство: оно по контракту не сохраняется.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.