Инструменты пользователя

Инструменты сайта


Боковая панель

Если вам не пришло письмо с регистрационными данными, проверьте папку «Спам»

Новости:

1 сентября
* Новая версия DataExpress



Обратная связь

Wiki-синтаксис
Как написать хорошую статью
Полигон

moduli:jurist23rus:dx_xranilische_fajlov:dx_xranilische_fajlov

DX Хранилище файлов

Автор: jurist23rus
Версия: 3.6
Последнее обновление: от 07.07.2019 г.
Фотогалерея
Скачать
Обсудить на форуме

Это комплекс, состоящий из взаимодействующих и программно связанных друг с другом форм и модуля расширений, в совокупности предназначенный для организации системы загрузки/выгрузки, хранения и манипуляций с одним или группой файлов. Все элементы комплекса устанавливаются в Вашу базу данных, легко настраиваются и работают как её неотъемлемая часть, взаимодействуя с уже имеющимися в вашей базе формами.

Состоит из

  1. Родительской формы с именем «FileStore» - это и есть само хранилище файлов, именно в данной форме происходят операции с файлами.
  2. Одноимённого модуля расширений, предназначенного для работы с формой «FileStore».

Для работы модуля нужна версия DX от 31.03.2019 г. или выше.

Комплекс полностью совместим со всеми модулями расширений моего авторства (jurist23rus) последних версий. О наличии проблем с совместимостью с модулями расширений других авторов оставляйте сообщения в данной теме.

Установка

Предполагается, что те кто читают эту инструкцию имеют минимальные навыки работы в приложении DataExpress 3.

  1. Сделать резервную копию вашей базы данных (без этого категорически не советую что-либо делать, иначе есть риск потерять все данные).
  2. Скачать файлы проекта формата .dxp и файлом модуля расширений формата .epas.
  3. Установить модуль расширений для чего:
    1. Открыть вашу базу данных и войти под учётной записью Разработчика (нужно иметь доступ к дизайнеру). Выбрать меню: Файл - Расширения - кнопка Импорт модуля - выбрать скачанный файл формата FileStore v.X.X.epas
    2. Если появилось окно ошибок компилятора, значит есть какие-то ошибки совместимости модулей. В этом случае установку лучше не продолжать, а сделать скриншот окна ошибок и сообщить о проблеме.
  4. Установить форму хранилища файлов для чего:
    1. Проверить, что в Вашей базе нет форм (а также запросов и отчётов) с именем «FileStore». Если такая форма у вас уже есть, переименовать её или удалить.
    2. Войти в дизайнер и выбрать пункт меню Сервис - Объединение проектов - выбрать файл FileStore v.X.X.dxp - в появившемся окне на вкладке Формы установить флажок в поле FileStore и нажать ОК.
  5. Если вы всё сделали правильно, то в вашей базе появятся новые формы «FileStore» и её дочерняя форма «File» в дереве форм, а в редакторе скриптов модуль формы «FileStore» и одноимённый модуль расширений. Теперь комплексом можно пользоваться.

Удаление

  1. Войти в дизайнер и удалить форму «FileStore»
  2. Войти меню Файл - Расширения - Выбрать модуль «FileStore» v.X.X и нажать Удалить.

Обновление

Перед началом действий сделайте резервную копию базы данных, в противном случае вы рискуете потерять все данные.

  1. Необходимо сохранить данные, которые уже имеются в модуле для этого:
    1. Пользователям модуля версии 2.0 и ниже должны установить модуль действия для кнопки filestore_savedata_v.1.0 и следовать инструкции в справке модуля. После сохранения данных, модуль FileStore_SaveData v.1.0 вам уже не нужен и его можно удалить, он никак не участвует в работе хранилища.
    2. Пользователям модуля версии 3.0 и выше устанавливать дополнительный модуль нет необходимость, так как кнопка сохранения данных расположена на вкладке «Инструменты» формы FileStore.
  2. После того как вы успешно сохранили данные, вы можете удалить старую версию модуля и установить новую по инструкциям (см. выше).
  3. После установки новой версии модуля вы можете восстановить ваши данные, нажав соответствующую кнопку на вкладке «Инструменты» формы FileStore. Само собой разумеется, что данные можно восстановить только если вы их предварительно сохранили, как описано выше, в ином случае данные восстановить нельзя.

Сохранять и восстанавливать данные модуля имеет смысл только если вы обновляете форму (файл dxp). Если вы обновляете только модуль расширения (.epas) - это никак не затрагивает данные формы.

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

Работа

Действия группы "FileStore"Работа с комплексом осуществляется посредством выбора для кнопки, размещённой на вашей форме, одного из действий группы «FileStore». В данной группе возможно выбрать следующие виды действий: «Добавить файл в хранилище», «Открыть запись хранилища файлов» или «Печать данных».

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

Действие для кнопки "Открыть запись хранилища файлов"При выборе действия для кнопки «Открыть запись хранилища файлов» вы сможете открывать запись хранилища файлов, связанную с текущей записью текущей формы и производить манипуляции с файлами в том числе: добавление в базу, просмотр, открытие папки с файлом, удаление из базы, сохранение в указанной папке на жёстком диске и т.д.. При отсутствии связанных записей, будет создана новая запись в хранилище. Удаление текущей записи формы не удаляет файлов или записей в хранилище, а только обрывает связь с ними. Записи хранилища без связи с базой можно найти, используя соответствующий инструмент на форме FileStore. Записи хранилища можно связывать с другими записями базы если связанная запись была удалена или вы хотите изменить имеющуюся связь. В удалении записей хранилище нет повседневной необходимости, но при желании это можно сделать вручную, открыв форму «FileStore».

Действия, аналогичные описанным выше действиям с кнопкой, могут при необходимости выполнятся с помощью функции File_Add и FileStore. Подробнее о них можно прочесть в справке по функциям.

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

Не рекомендуется

Самостоятельно вносить какие бы то ни было изменения в форму «FileStore», в том числе: добавлять, удалять или изменять свойства и параметры компонентов; вносить корректировки в скрипты, руководящие работой формы, или модулем расширений «FileStore».

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

Галерея

История версий

Версия 3.6

  • Исправил ошибку

Версия 3.5

  • Совместимость с DX версии от 31.03.19
  • Добавил действие для кнопки «Открыть последний файл» - открывает последний сохранённый в Хранилище файл, программой, связанной с данным типом файлов по-умолчанию.

Версия 3.4

  • Исправил ошибку (копировало сразу два файла в папку назначения).
  • Добавил свойство Target для совместимости с новыми версиями DX.

Версия 3.3

  • Исправлена ошибка при добавлении файлов в модуль через кнопку «Печать данных».
  • Добавлено автоматическое создание структуры каталогов для сохранения файла при использовании кнопки «Печать данных».
  • Изменён алгоритм работы кнопки открыть файл и папку.
  • Поддержка DX от 31.08.2018 г.

Версия 3.2

  • Исправлена ошибка «создания папки» при добавлении нескольких файлов.
  • Теперь файл можно добавить в хранилище, даже если опция «Путь к папке назначения» пустая.
  • Добавлена возможность удалять файлы из папки хранения вместе с удалением записей о файлах из модуля. (При нажатии кнопки «Удалить всё» появляется диалоговое окно с вопросом о необходимости удаления файлов с жёсткого диска.)
  • Доработано действие для кнопки «Печать данных».
    • Добавлена опция «Сохранить новый документ в 'DX Хранилище файлов'».
    • Добавлены действия для файла «Тихая печать» и «Открыть в приложении».

Версия 3.1

  • Для совместимости с версией DX от 24.06.2018 года. Для более ранних версий программы нужно ставить модуль версии 3.0.

Версия 3.0

  1. Реализована система сохранения данных модуля на диск и последующего восстановления для чего на панели инструментов появились две новых кнопки: «Сохранить данные хранилища» и «Восстановить данные хранилища». Это нужно для сохранения данных, при обновлении на новую версию.
  2. Для сохранения данных модуля версии 2.0 сделал дополнительную кнопку-функцию (FileStore_SaveData v.1.0), которая сохранит данные модуля на диск. После установки версии 3.0 можно будет восстановить все что нажито непосильным трудом :-)
  3. Сделал отдельное действие для кнопки «Печать данных». Действует аналогично штатному действию кнопки «Печать», но имеет более широкий функционал, а именно: возможность задавать в виде выражения путь к файлу шаблона и путь для сохранения готового документа, возможность автоматически добавлять созданный файл в «DX Хранилище файлов».
  4. У действий кнопки «Добавить файл в хранилище» и «Открыть запись хранилища» появились дополнительные параметры для работы с файлами: «Путь к папке назначения», «Имя нового файла», «Исходное расширение в новом имени файла», «Удалять исходные файлы», «Список расширений».
  5. Теперь разработчик базы сам решает где как и с каким именем будет сохраняться добавляемый в базу файл. Исходные фалы, после загрузки их в базу, могут быть автоматически удалены с жёсткого диска во избежание создания дубликатов. Список расширений позволяет ограничивать загрузку в базу файлов только файлами определённого типа.
  6. Добавлен инструмент проверки наличия файлов на жёстком диске.

Скачать

Обсуждение

moduli/jurist23rus/dx_xranilische_fajlov/dx_xranilische_fajlov.txt · Последние изменения: 2019/10/06 13:32 — jurist23rus