ЭкспортироватьВыборку |
Экспортирует записи выборки из программы во внешний файл, аналогично команде экспорта данных, вызываемой при нажатии комбинации клавиш <Ctrl+U>.
Синтаксис
ЭкспортироватьВыборку(Выборка, ИмяКаталога[, ИмяКонфигурации[, ДействиеСФайлами]])
Параметры
Выборка (объект) – выборка, записи которой нужно экспортировать во внешний файл.
ИмяКаталога (текст) – название каталога, в котором находится импортируемый внешний файл (файл с расширением, указанном в формате экспорта/импорта).
ИмяКонфигурации (текст) – название конфигурации экспорта – импорта. Если не указана, используется конфигурация по умолчанию. Необходимо указывать точное название конфигурации со всеми пробелами и чёрточками, а также соблюдая регистры.
ДействиеСФайлами (текст) – указывается действие, которое должно выполниться, если при экспорте будут обнаружены существующие файлы. Параметр может принимать следующие значения: "добавить" - добавить записи в существующий файл; "очистить" – удалить записи из существующего файла; "удалить" - удалить файл. Если параметр не указан, то при существовании файлов будет возникать запрос:
Обратите внимание на то, что при указании данного параметра, обязательно должно быть указано либо конкретное ИмяКонфигурации, либо пустая строка "".
Возвращает
Да (логическое значение) – данные импортированы.
Нет (логическое значение) – данные не импортированы.
Примеры
Экспортируем все записи справочника во внешний файл:
оВыборка = Выборка("Сотрудники");
ЭкспортироватьВыборку(оВыборка, "d:\\_Work\\2\\");
Добавим во внешний файл новые записи справочника:
оВыборка = Выборка("Сотрудники");
ЭкспортироватьВыборку(оВыборка, "d:\\_Work\\2\\", "- По умолчанию
-", "добавить");
См. также:
• Выборка