Полезный код для программистов 1С (часть 4). Работа с файловой системой Асинх (аналог общего модуля БСП)

02.09.22

Разработка - Инструментарий разработчика

Я хотел бы поговорить с вами о файлах. А точнее о том, как сделать работу с ними приятной...

Скачать файл

ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.

Наименование SM По подписке [?] Купить один файл
Общий модуль ФайловаяСистемаКлиентАсинх
.txt 44,96Kb
18
18
1 SM
Скачать Купить за 1 850 руб.
Шаблон для конфигуратора 1С (для общего модуля)
.st 10,72Kb
8
8
1 SM
Скачать Купить за 1 850 руб.

Где-то там (у нормальных программистов) есть такое понятие callback hell. Я бы ее назвал лапшой вызовов, поскольку в нашей стране приплетать религию где-либо опасно :). Благодаря появлению в платформе 1С объекта "ОписаниеОповещения" и соответствующих обработчиков, а также (ранее) повсеместное использование "Начать(что-то делать)", лапша начинает плодится с такой скоростью... в общем секта летающего макаронного монстра по нам плачет.

Ну и как результат - общие модули "ДелаемНужноеКлиентСлужебный", отдельные области "ЗавершениеНемодальныхВызовов", ну и попытка продраться через последовательность вызовов. А еще можно последовательность оповещений, замкнуть в какой-нибудь "хитрый" общий обработчик (чур я вам этого не подсказывал).

Ну в общем, поплакал и хватит. В конце концов у нас есть Асинх и Ждать. В большинстве случаев на немодальные методы с оповещениями, появились их аналоги Асинх

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

"И отличненько", сказал я, и пошел переписывать всю работу с файлами, благо выпала мне такая задача, где надо много и хорошо с ними работать. И в итоге родился общий модуль ФайловаяСистемаКлиентАсинх. Список методов, которые поддерживает данный общий модуль:

  • ЗагрузитьФайл - помещает файл в хранилище. Может вызвать сам диалог выбора файла и обработать результат. Возвращает структуру с данными о результате помещения файла;
  • ЗагрузитьФайлы - аналогично вышеуказанному методу, для нескольких файлов. Возвращает массив структур;
  • СохранитьФайл - получает файл из хранилища и сохраняет в файловой системе. Может сам вызвать диалог сохранения файла. Возвращает ОписаниеПереданногоФайла;
  • СохранитьФайлы - аналогично вышеуказанному методу, для нескольких файлов. А еще умеет упаковывать в архив. Возвращает массив описаний;
  • УдалениеФайлов - выполняет удаление одного или нескольких файлов. Прошу не пинать за не совсем правильное наименование метода, УдалитьФайлы уже занято платформой, а я не сильно хотел думать;
  • ВыбратьКаталог - открывает диалог выбора каталога, возвращает путь к нему;
  • ВыбратьФайл - открывает диалог выбора файла, возвращает путь к нему;
  • ВыбратьФайлы - аналогично вышеуказанному методу, для нескольких файлов;
  • СоздатьВременныйКаталог - создает временный каталог, возвращает путь к нему;
  • ПодключитьРасширениеДляРаботыСФайлами - предлагает пользователю установить расширение работы с файлами, возвращает признак подключенного расширения;
  • СообщитьОшибкуПодключенияРасширения - вызывает сообщение пользователю, исключение или предупреждение (в зависимости от настройки) с текстом что необходимо подключить расширение работы с файлами.

Общий модуль работает в тонком, толстом и веб-клиенте. Все вызовы кроме методов получения параметров и сообщения выполняются с использованием конструкции Ждать. Окончания Асинх не использовано намерено, поскольку оно содержится в имени общего модуля.

В веб-клиенте выполняется проверка наличия расширения, предложение об установке и сохранение настройки о наличии расширения аналогично типовым методам общего модуля ФайловаяСистемаКлиент из БСП.

Был сделан с подглядыванием в БСП 3.1.4.232, но это не принципиально думается мне. Главное, чтобы платформа была 8.3.18 и выше.

Заключение

Данный общий модуль можно скачать из нашего репозитория, а можете поддержать автора и скачать его отсюда. $m стоят недорого, а мне приятно )))).

А еще я добавил шаблоны для удобной автозамены кода (по данному общему модулю). Эти и другие шаблоны вы можете найти в репозитории.

Ну и традиционно, другие полезные инструменты (их вы тоже можете найти в нашей библиотеке):

Пы.сы.

Данный общий модуль был отправлен специалистам 1С для включения в состав БСП, они сказали что рассмотрят и перенесут.

См. также

Инструментарий разработчика Роли и права Запросы СКД Программист Платформа 1С v8.3 Управляемые формы Запросы Система компоновки данных Конфигурации 1cv8 Платные (руб)

Набор инструментов программиста и специалиста 1С для всех конфигураций на управляемых формах. В состав входят инструменты: Консоль запросов, Консоль СКД, Консоль кода, Редактор объекта, Анализ прав доступа, Метаданные, Поиск ссылок, Сравнение объектов, Все функции, Подписки на события и др. Редактор запросов и кода с раскраской и контекстной подсказкой. Доработанный конструктор запросов тонкого клиента. Продукт хорошо оптимизирован и обладает самым широким функционалом среди всех инструментов, представленных на рынке.

10000 руб.

02.09.2020    140517    770    391    

803

Пакетная печать Печатные формы Инструментарий разработчика Программист Платформа 1С v8.3 Запросы 1С:Зарплата и кадры бюджетного учреждения 1С:Конвертация данных 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Платные (руб)

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

18000 руб.

06.10.2023    11518    31    6    

61

Инструментарий разработчика Программист Платформа 1С v8.3 Конфигурации 1cv8 Платные (руб)

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

5400 руб.

17.05.2024    13716    31    27    

75

Инструменты администратора БД Инструментарий разработчика Роли и права Программист Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

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

10000 руб.

10.11.2023    7253    27    4    

51

SALE! %

Инструментарий разработчика Инструменты администратора БД Системный администратор Программист Платформа 1С v8.3 Управляемые формы Конфигурации 1cv8 Россия Платные (руб)

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

3600 2880 руб.

14.01.2013    181833    1103    0    

876

Инструментарий разработчика Программист 8.3.14 1С:Конвертация данных Россия Платные (руб)

Расширение для конфигурации “Конвертация данных 3”. Добавляет подсветку синтаксиса, детальную контекстную подсказку, глобальный поиск по коду.

15000 руб.

07.10.2021    15980    3    12    

39

Инструментарий разработчика Программист Платформа 1С v8.3 Конфигурации 1cv8 Россия Платные (руб)

Восстановление партий или взаиморасчетов, расчет зарплаты, пакетное формирование документов или отчетов - теперь все это стало доступнее. * Есть желание повысить скорость работы медленных алгоритмов! Но... * Нет времени думать о реализации многопоточности? * о запуске и остановке потоков? * о поддержании потоков в рабочем состоянии? * о передаче данных в потоки и как получить ответ из потока? * об организации последовательности? Тогда ЭТО - то что надо!!!

5000 руб.

07.02.2018    101109    242    97    

303

Инструментарий разработчика Перенос данных 1C Программист Платформа 1С v8.3 Платные (руб)

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

2400 руб.

24.09.2019    24492    17    15    

34
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. gybson 02.09.22 18:44 Сейчас в теме
Это ведь команды платформы ...
2. vandalsvq 1573 02.09.22 23:34 Сейчас в теме
(1) какие именно команды платформы вы имеете в виду?
5. gybson 03.09.22 17:18 Сейчас в теме
(2) Для которых вы обертку сделали. Из самой заметки как-то неочевидно зачем это вообще надо было делать. Особенно ВыбратьФайл. Но красиво.
6. vandalsvq 1573 03.09.22 17:43 Сейчас в теме
(5) методы есть, никто не спорит. Но самый цимес в веб-клиенте, в некоторых случаях надо расширение для работы с файлами, в некоторых не надо. И получается, что если писать с учетом всех требований, сначала надо спросить об установке расширения, потом проверить, потом только что-то делать. Таким образом, вместо 5-10-15 строчек кода пишется только одна.
7. gybson 04.09.22 13:27 Сейчас в теме
(6) Мне кажется конкретно из-за расширения не стоит так заморачиваться. Документация : "В веб-клиенте расширение работы с файлами не требуется, но используется, если оно уже установлено. В веб-клиенте, если расширение работы с файлами не установлено, настройки из параметра <ПараметрыДиалогаПолученияФайлов> игнорируются."
8. vandalsvq 1573 04.09.22 21:31 Сейчас в теме
(7)
В веб-клиенте расширение работы с файлами не требуется


Список где требуется:
- ПоместитьФайлНаСерверАсинх - Вариант синтаксиса: По пути файла на диске
- ПоместитьФайлыНаСерверАсинх - аналогично
- ПолучитьФайлССервераАсинх - Вариант синтаксиса: Без диалога
- ПолучитьФайлыССервераАсинх - аналогично
- УдалитьФайлыАсинх
- ДиалогВыбораФайла.ВыбратьАсинх
- КаталогВременныхФайловАсинх

Как минимум не люблю лишний раз вспоминать и подсматривать где какая спецификация. Впрочем, я не убеждаю вас использовать разработку, если вам не приходится работать с веб-клиентом регулярно, писать с учетом разных типов клиентов и окружений - это отлично. Поскольку головной боли меньше.
3. malikov_pro 1313 03.09.22 10:26 Сейчас в теме
Напишите статью про свои "Шаблоны для конфигуратора" https://github.com/progtb/1c-style-guide-progtb/tree/master/st, сам подключаю от Чистова, но они не развиваются.

Схожее направление в коде у https://github.com/infostart-hub/infostart-erp-community.

За хороший код + и sm.
4. vandalsvq 1573 03.09.22 12:19 Сейчас в теме
(3) упс... я невнимательно прочитал сообщение. Зато это натолкнуло на мысль создать шаблоны для данного общего модуля, что я и сделал )))). Статью про шаблоны возможно напишу чуть позже. Счас на очереди другая статья.
9. quazare 3728 05.09.22 06:09 Сейчас в теме
Спасибо! Всегда полезно почитать материалы, в которых уже кто-то разобрался
10. RuSeek 18.09.23 14:27 Сейчас в теме
Асинх Функция ЗагрузитьФайлВПрограмму(....) всегда будет возвращать обещание, она не вернет структуру, разве не так?
11. vandalsvq 1573 18.09.23 16:43 Сейчас в теме
(10) такого метода в общем модуле нет. Но я попробую ответить "в общем". Зависит от того как вы напишите. Если будет
Результат = ЗагрузитьФайлВПрограмму();
, тогда Результат будет иметь тип Обещание. А если
Результат = Ждать ЗагрузитьФайлВПрограмму();
, тогда Результат будет равен данным, которые будут получены, по окончанию работы метода (например структуру или что там будет после Возврат)

По сути вторая конструкция получит тоже обещание, но дождется окончательного выполнения и вернет результат.

Надеюсь я вам помог ответом
Оставьте свое сообщение