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

02.09.22

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

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

Скачать файл

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

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

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

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

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

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

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

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

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

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

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

Заключение

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

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

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

Пы.сы.

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

См. также

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

Инструменты для разработчиков 1С 8.3: Infostart Toolkit. Автоматизация и ускорение разработки на управляемых формах. Легкость работы с 1С.

12000 руб.

02.09.2020    169296    937    403    

905

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

Инструмент представляет собой обработку для проведения свёртки или обрезки баз данных. Работает на ЛЮБЫХ конфигурациях (УТ, БП, ERP и т.д.). Поддерживаются серверные и файловые базы, управляемые и обычные формы. Может выполнять свертку сразу нескольких баз данных и выполнять их автоматически без непосредственного участия пользователя. Решение в Реестре отечественного ПО

8400 руб.

20.08.2024    12612    99    42    

101

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

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

9360 руб.

17.05.2024    26537    90    48    

134

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

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

22200 руб.

06.10.2023    16829    41    15    

75

SALE! %

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

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

4800 3840 руб.

14.01.2013    190552    1150    0    

918

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

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

15000 руб.

10.11.2023    11396    40    27    

66

БСП (Библиотека стандартных подсистем) Программист Платные (руб)

Синтакс-помощник БСП - cправочник по библиотекам стандартных подсистем и электронных документов. В состав справочника входит описание экспортных процедур и функций, размещенных в областях кода ПрограммныйИнтерфейс БСП и БЭД.

1800 руб.

21.11.2024    3644    16    15    

18

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

Разработка Конструктор автоматизированных рабочих мест "Конструктор АРМ" реализована в виде расширения и является универсальным инструментом для создания АРМ любой сложности в пользовательском режиме.

3600 руб.

27.12.2024    778    2    0    

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


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

Как минимум не люблю лишний раз вспоминать и подсматривать где какая спецификация. Впрочем, я не убеждаю вас использовать разработку, если вам не приходится работать с веб-клиентом регулярно, писать с учетом разных типов клиентов и окружений - это отлично. Поскольку головной боли меньше.
3. malikov_pro 1326 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 1592 03.09.22 12:19 Сейчас в теме
(3) упс... я невнимательно прочитал сообщение. Зато это натолкнуло на мысль создать шаблоны для данного общего модуля, что я и сделал )))). Статью про шаблоны возможно напишу чуть позже. Счас на очереди другая статья.
9. quazare 3866 05.09.22 06:09 Сейчас в теме
Спасибо! Всегда полезно почитать материалы, в которых уже кто-то разобрался
10. RuSeek 18.09.23 14:27 Сейчас в теме
Асинх Функция ЗагрузитьФайлВПрограмму(....) всегда будет возвращать обещание, она не вернет структуру, разве не так?
11. vandalsvq 1592 18.09.23 16:43 Сейчас в теме
(10) такого метода в общем модуле нет. Но я попробую ответить "в общем". Зависит от того как вы напишите. Если будет
Результат = ЗагрузитьФайлВПрограмму();
, тогда Результат будет иметь тип Обещание. А если
Результат = Ждать ЗагрузитьФайлВПрограмму();
, тогда Результат будет равен данным, которые будут получены, по окончанию работы метода (например структуру или что там будет после Возврат)

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

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