EcmФайлы / С: различия между версиями

Материал из Управление номенклатурой
Перейти к навигации Перейти к поиску
(Авто)
(Авто)
 
(не показано 20 промежуточных версий этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE:Файловый архив}}
{{DISPLAYTITLE:Файловый архив}}
== Метеданные ==
Каталог ссылок на файлы, с указанием места хранения файла, описанием основных и дополнительных свойств.
 
== Использование ==
Варианты использования файлового архива:
* Когда системе требуется '''привязать файл к объекту''', например картинку к товару;
* '''Генерировать новые фалы''', например для выгрузки данных;
* Выбрать файл для '''импорта данных''', например при загрузке прайс-листов.
 
Ссылки на файлы, делятся по месту хранения:
 
* '''Серверные''' - хранятся на ПК сервера и доступны для обработки на стороне сервере. Так же доступны любому клиенту, после копирования на клиентский том, либо через Связанные тома;
** '''в контейнере''' - файлы на стороне сервера, могут хранится в другом файле контейнере (в архиве). Физический файл в архиве, но в системе есть описание, в каком файле архива и какой файл внутри архива. Таким образом мы можем привязать его к любому объекту. Например файлы пакета выгрузки, все с общем архиве, но мы все равно видим список XML файлов какие привязаны к пакету выгрузки и находятся в этом архиве, видим и можем при необходимости скачать, либо открыть на клиенте, через связанные тома, либо временную загрузку на том клиента;
* '''Клиентские''' - хранятся на ПК клиента, не доступны для обработки. Используются для открытия файлов на стороне клиента, локальным ПО. Например офисные документы. При этом в системе есть описание ссылки, и значит файл возможно привязать к объекту системы. Например привязать документацию к товару, или контрагенту. Клиентские файлы доступны только клиент, владельцу тома.
 
<blockquote>В архиве (контейнере) могут быть файлы только на стороне сервера, на серверных томах. Для клиентских томов такая возможность не предусмотрена.</blockquote>Как ссылки на файлы попадают в архив:
 
# '''Добавить файл к объекту''', пользователь выбирает объект, локальный файл. Файл отправляется на сервер, записывается на серверный том, создается ссылка с описанием файла;
# '''Сканирование том''', на стороне сервера уже есть каталог с файлами, которые туда каким то образом копируются, запускается обработчик поиска файлов в томе, по каким то алгоритмам выбирает файлы и регистрирует в файловом архиве;
# '''Привязать файл к объекту''', пользователь выбирает объект, локальный файл. Файл остается в том каталоге где и был, в файловом архиве создается запись, что по такому то пути, есть файл, созданная ссылка с описанием к файлу привязывается к выбранному объекту (номенклатуры и т.п.). Только для локальных файлов, ссылки доступны только для пользователя привязавшего файл, и только когда он заходит с того же клиентского устройства, с которого привязывал файл;
# '''Временные файлы на клиенте''', при запросе клиентом файла из серверного тома, файл копируется на клиент, для него регистрируется ссылка в файловом архиве, и связывается с исходным файлом. При следующем обращении к файлу тем же пользователем и с того же клиента, файл больше не копируется, а открывается сразу локальная копия;
# '''Генерация''' файлов, какие то функции системы создают новые файлы, регистрируют в файловом архиве и связывают с объектами системы. Например при выгрузке данных, модуль экспорта формирует XML файлы с данными, регистрирует и связывает с объектов Пакет данных.
 
== Действия ==
Стандартные действия с файловым архивом.
 
* '''Открыть''' - открыть файл приложением по умолчанию установленном на клиенте. Сработает только при условии, когда у тома файла настроен связанный клиентский том, либо для текущего устройства клиента настроен локальный том;
* '''Свойства по типу''' - открыть свойства файла, специально формой для типа файла. Например в форме Картинок, будет предварительный просмотр;
* '''Скачать файл''' - скачивает копию файла с сервере на клиент. Важно! Это будет именно копия, в отличии от команды '''Открыть''' не будет создана запись, что на клиенте есть копия файла. Настройка локального тома не требуется, будет работать всегда;
* '''Заменить файл''' - заменить текущий файл, на сервере выбранным на клиенте. Выбираем на клиенте файл, он будет отправлен на сервере и записан вместо текущего файла;
* '''Действия''' - подменю действия:
** '''Обновить локальную копию''' - ранее загруженная копия на приложение клиента, будет заменена версией файла с сервера. Локальные изменения будут потеряны;
** '''Обновить копию на сервере''' - локальная копия файла будет отправлена на сервер. Серверная копия будет заменена локальной, измененной;
** '''Создать архив фалов''' - выбранные в списке файлы, будут добавлены в новый архив (на стороне сервере), в хранилище будет создан новый файл архив, которые затем возможно скачать, либо как то еще использовать в системе;
** '''Удалить локальную копию''' - локальная копия на приложении клиента будет удалена. В следующей попытке открыть файл, будет загружена версия файла с сервере. Если не удалить при повторной попытке открыть будет открываться локальная копия, без запроса к серверу;
** '''Удалить файлы''' - удаляет регистрацию файла. И сами файлы, если у тома не включен признак '''Не удалять файлы с тома''';
 
== Формы ==
'''Ссылка''': e1cib/list/Справочник.ecmФайлы
 
=== Форма элемента ===
Основная форма создание и редактирование элемента данных.
 
{| class="wikitable" width=100%
! style="width:30%;"|Реквизит
! style="width:50%;"|Описание
! style="width:20%;"|Тип значения
|-
|'''Наименование'''
|Представление записи при просмотре в списках, и выбранных значениях реквизитов.
|Строка(150)
|}
==== Хранение ====
{| class="wikitable" width=100%
! style="width:30%;"|Реквизит
! style="width:50%;"|Описание
! style="width:20%;"|Тип значения
|-
|Том
|Серверный либо клиентский том, где хранится файл
|[[EcmТома / С|Тома файлов]]
|-
|Путь
|Путь к файлу
|Строка
|-
|Имя
|Имя файла, как он записан в файловой системе
|Строка(150)
|-
|Контейнер
|Ссылка на файл контейнер (если файл в архиве), контейнер это так же файл в данном архиве, со своими свойствами
|[[EcmФайлы / С|Файловый архив]]
|-
|Устройство
|Ссылка на описания устройства, если файл хранится на ПК клиента
|[[EcmУстройства / С|Устройства пользователей]]
|}
==== Свойства ====
{| class="wikitable" width=100%
! style="width:30%;"|Реквизит
! style="width:50%;"|Описание
! style="width:20%;"|Тип значения
|-
|Тип файла
|Обобщенный тип файла (картинка, табличный документ и т.п.)
|[[EcmТипыФайлов / С|Типы файлов]]
|-
|Тип данных
|Тип данных хранящихся в файле, если файл содержит данные
|[[FilestorТипыДанных / С|Типы данных]]
|-
|Расширение
|Расширение файла, может использовать в фильтре при выборе списка файлов для обработки
|Строка(10)
|-
|Дата изменения
|Дата и время изменения файла в момент регистрации в системе. Может отличаться от реального времени изменения файла, может использоваться обработчиками как признак того, что какие то данные ранее полученные из файла необходимо обновить в системе
|Дата
|-
|Размер (байт)
|Размер файла в байтах
|Число(10, 0)
|-
|Контрольная сумма
|Контрольная сумма содержимого файла, используется для поиска одинаковых файлов. Не гарантия уникальности, но это лучше чем ничего
|Строка(64)
|}
==== Копия файла ====
{| class="wikitable" width=100%
! style="width:30%;"|Реквизит
! style="width:50%;"|Описание
! style="width:20%;"|Тип значения
|-
|Обработчик
|Ссылка на настроенную задачу, по которой был создан файл. Если файл был создан преобразованием исходного файла в новый
|[[FilestorВнешниеОбработчикиФайлов / С|Внешние обработчики файлов]]
|-
|Основной файл
|Ссылка оригинальный файл, из которого был создан обработчиком, либо копией какой файла является
|[[EcmФайлы / С|Файловый архив]]
|-
|Назначение
|Текстовый признак, для какой то дополнительной идентификации, для чего была создана копия файла, либо новый обработанный файл
|[[EcmНазначениеКопииФайла / Пер|Назначение копии файла]]
|-
|Дата регистрации
|Дата и время регистрации файла в системе
|Дата
|-
|Это временный файл
|Признак того, что файл был создан как временный, и при необходимости его можно удалить, без каких либо последствий в логике работы системы
|Включить или Отключить
|}
=== Форма списка ===
Основная форма просмотра списка данных.
 
=== Форма выбора ===
Основная Форма выбора элемента данных.
 
=== Контейнер ===
=== На клиентах ===
=== Копии файла ===
=== Владельцы файла ===
 
== Метаданные ==
=== Данные ===
=== Данные ===
==== Реквизиты ====
==== Реквизиты ====
{| class="wikitable"
{| class="wikitable mw-collapsible mw-collapsed" width=100%
|+
! style="width:20%;"|Синоним
!Синоним
! style="width:20%;"|Имя
!Имя
! style="width:30%;"|Тип значения
!Тип значения
! style="width:30%;"|Описание
!Описание
|-
|-
|'''Наименование'''
|'''Наименование'''
Строка 18: Строка 161:
|Том
|Том
|Справочники: [[EcmТома / С|Тома файлов]]
|Справочники: [[EcmТома / С|Тома файлов]]
| -
|Серверный либо клиентский том, где хранится файл
|-
|-
|Путь
|Путь
|Путь
|Путь
|Строка
|Строка
| -
|Путь к файлу
|-
|-
|Имя
|Имя
|Имя
|Имя
|Строка(150)
|Строка(150)
| -
|Имя файла, как он записан в файловой системе
|-
|-
|Расширение
|Расширение
|Расширение
|Расширение
|Строка(10)
|Строка(10)
| -
|Расширение файла, может использовать в фильтре при выборе списка файлов для обработки
|-
|-
|Дата изменения
|Дата изменения
|ВремяИзменения
|ВремяИзменения
|Дата
|Дата
| -
|Дата и время изменения файла в момент регистрации в системе. Может отличаться от реального времени изменения файла, может использоваться обработчиками как признак того, что какие то данные ранее полученные из файла необходимо обновить в системе
|-
|-
|Размер (байт)
|Размер (байт)
|Размер
|Размер
|Число(10, 0)
|Число(10, 0)
| -
|Размер файла в байтах
|-
|-
|Контрольная сумма
|Контрольная сумма
|Сумма
|Сумма
|Строка(64)
|Строка(64)
| -
|Контрольная сумма содержимого файла, используется для поиска одинаковых файлов. Не гарантия уникальности, но это лучше чем ничего
|-
|-
|Контейнер
|Контейнер
|Контейнер
|Контейнер
|Справочники: [[EcmФайлы / С|Файловый архив]]
|Справочники: [[EcmФайлы / С|Файловый архив]]
| -
|Ссылка на файл контейнер (если файл в архиве), контейнер это так же файл в данном архиве, со своими свойствами
|-
|-
|Устройство
|Устройство
|Устройство
|Устройство
|Справочники: [[EcmУстройства / С|Устройства пользователей]]
|Справочники: [[EcmУстройства / С|Устройства пользователей]]
| -
|Ссылка на описания устройства, если файл хранится на ПК клиента
|-
|-
|Основной файл
|Основной файл
|ОсновнойФайл
|ОсновнойФайл
|Справочники: [[EcmФайлы / С|Файловый архив]]
|Справочники: [[EcmФайлы / С|Файловый архив]]
| -
|Ссылка оригинальный файл, из которого был создан обработчиком, либо копией какой файла является
|-
|-
|Тип файла
|Тип файла
|Тип
|Тип
|Справочники: [[EcmТипыФайлов / С|Типы файлов]]
|Справочники: [[EcmТипыФайлов / С|Типы файлов]]
| -
|Обобщенный тип файла (картинка, табличный документ и т.п.)
|-
|-
|Это временный файл
|Это временный файл
|Временный
|Временный
|Булево
|Включить или Отключить
|Временный файл, добавленный для обработки из контейнера или внешнего хранилища
|Признак того, что файл был создан как временный, и при необходимости его можно удалить, без каких либо последствий в логике работы системы
|-
|-
|Дата регистрации
|Дата регистрации
|ДатаРегистрации
|ДатаРегистрации
|Дата
|Дата
| -
|Дата и время регистрации файла в системе
|-
|-
|Назначение
|Назначение
|НазначениеКопии
|НазначениеКопии
|Перечисления: [[EcmНазначениеКопииФайла / Пер|Назначение копии файла]]
|Перечисления: [[EcmНазначениеКопииФайла / Пер|Назначение копии файла]]
| -
|Текстовый признак, для какой то дополнительной идентификации, для чего была создана копия файла, либо новый обработанный файл
|-
|-
|Тип данных
|Тип данных
|ТипДанных
|ТипДанных
|Справочники: [[FilestorТипыДанных / С|Типы данных]]
|Справочники: [[FilestorТипыДанных / С|Типы данных]]
| -
|Тип данных хранящихся в файле, если файл содержит данные
|-
|-
|Обработчик
|Обработчик
|Обработчик
|Обработчик
|Справочники: [[FilestorВнешниеОбработчикиФайлов / С|Внешние обработчики файлов]]
|Справочники: [[FilestorВнешниеОбработчикиФайлов / С|Внешние обработчики файлов]]
| -
|Ссылка на настроенную задачу, по которой был создан файл. Если файл был создан преобразованием исходного файла в новый
|}
|}
=== Подсистемы ===
=== Подсистемы ===

Текущая версия от 09:02, 15 июля 2023

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

Использование

Варианты использования файлового архива:

  • Когда системе требуется привязать файл к объекту, например картинку к товару;
  • Генерировать новые фалы, например для выгрузки данных;
  • Выбрать файл для импорта данных, например при загрузке прайс-листов.

Ссылки на файлы, делятся по месту хранения:

  • Серверные - хранятся на ПК сервера и доступны для обработки на стороне сервере. Так же доступны любому клиенту, после копирования на клиентский том, либо через Связанные тома;
    • в контейнере - файлы на стороне сервера, могут хранится в другом файле контейнере (в архиве). Физический файл в архиве, но в системе есть описание, в каком файле архива и какой файл внутри архива. Таким образом мы можем привязать его к любому объекту. Например файлы пакета выгрузки, все с общем архиве, но мы все равно видим список XML файлов какие привязаны к пакету выгрузки и находятся в этом архиве, видим и можем при необходимости скачать, либо открыть на клиенте, через связанные тома, либо временную загрузку на том клиента;
  • Клиентские - хранятся на ПК клиента, не доступны для обработки. Используются для открытия файлов на стороне клиента, локальным ПО. Например офисные документы. При этом в системе есть описание ссылки, и значит файл возможно привязать к объекту системы. Например привязать документацию к товару, или контрагенту. Клиентские файлы доступны только клиент, владельцу тома.

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

Как ссылки на файлы попадают в архив:

  1. Добавить файл к объекту, пользователь выбирает объект, локальный файл. Файл отправляется на сервер, записывается на серверный том, создается ссылка с описанием файла;
  2. Сканирование том, на стороне сервера уже есть каталог с файлами, которые туда каким то образом копируются, запускается обработчик поиска файлов в томе, по каким то алгоритмам выбирает файлы и регистрирует в файловом архиве;
  3. Привязать файл к объекту, пользователь выбирает объект, локальный файл. Файл остается в том каталоге где и был, в файловом архиве создается запись, что по такому то пути, есть файл, созданная ссылка с описанием к файлу привязывается к выбранному объекту (номенклатуры и т.п.). Только для локальных файлов, ссылки доступны только для пользователя привязавшего файл, и только когда он заходит с того же клиентского устройства, с которого привязывал файл;
  4. Временные файлы на клиенте, при запросе клиентом файла из серверного тома, файл копируется на клиент, для него регистрируется ссылка в файловом архиве, и связывается с исходным файлом. При следующем обращении к файлу тем же пользователем и с того же клиента, файл больше не копируется, а открывается сразу локальная копия;
  5. Генерация файлов, какие то функции системы создают новые файлы, регистрируют в файловом архиве и связывают с объектами системы. Например при выгрузке данных, модуль экспорта формирует XML файлы с данными, регистрирует и связывает с объектов Пакет данных.

Действия

Стандартные действия с файловым архивом.

  • Открыть - открыть файл приложением по умолчанию установленном на клиенте. Сработает только при условии, когда у тома файла настроен связанный клиентский том, либо для текущего устройства клиента настроен локальный том;
  • Свойства по типу - открыть свойства файла, специально формой для типа файла. Например в форме Картинок, будет предварительный просмотр;
  • Скачать файл - скачивает копию файла с сервере на клиент. Важно! Это будет именно копия, в отличии от команды Открыть не будет создана запись, что на клиенте есть копия файла. Настройка локального тома не требуется, будет работать всегда;
  • Заменить файл - заменить текущий файл, на сервере выбранным на клиенте. Выбираем на клиенте файл, он будет отправлен на сервере и записан вместо текущего файла;
  • Действия - подменю действия:
    • Обновить локальную копию - ранее загруженная копия на приложение клиента, будет заменена версией файла с сервера. Локальные изменения будут потеряны;
    • Обновить копию на сервере - локальная копия файла будет отправлена на сервер. Серверная копия будет заменена локальной, измененной;
    • Создать архив фалов - выбранные в списке файлы, будут добавлены в новый архив (на стороне сервере), в хранилище будет создан новый файл архив, которые затем возможно скачать, либо как то еще использовать в системе;
    • Удалить локальную копию - локальная копия на приложении клиента будет удалена. В следующей попытке открыть файл, будет загружена версия файла с сервере. Если не удалить при повторной попытке открыть будет открываться локальная копия, без запроса к серверу;
    • Удалить файлы - удаляет регистрацию файла. И сами файлы, если у тома не включен признак Не удалять файлы с тома;

Формы

Ссылка: e1cib/list/Справочник.ecmФайлы

Форма элемента

Основная форма создание и редактирование элемента данных.

Реквизит Описание Тип значения
Наименование Представление записи при просмотре в списках, и выбранных значениях реквизитов. Строка(150)

Хранение

Реквизит Описание Тип значения
Том Серверный либо клиентский том, где хранится файл Тома файлов
Путь Путь к файлу Строка
Имя Имя файла, как он записан в файловой системе Строка(150)
Контейнер Ссылка на файл контейнер (если файл в архиве), контейнер это так же файл в данном архиве, со своими свойствами Файловый архив
Устройство Ссылка на описания устройства, если файл хранится на ПК клиента Устройства пользователей

Свойства

Реквизит Описание Тип значения
Тип файла Обобщенный тип файла (картинка, табличный документ и т.п.) Типы файлов
Тип данных Тип данных хранящихся в файле, если файл содержит данные Типы данных
Расширение Расширение файла, может использовать в фильтре при выборе списка файлов для обработки Строка(10)
Дата изменения Дата и время изменения файла в момент регистрации в системе. Может отличаться от реального времени изменения файла, может использоваться обработчиками как признак того, что какие то данные ранее полученные из файла необходимо обновить в системе Дата
Размер (байт) Размер файла в байтах Число(10, 0)
Контрольная сумма Контрольная сумма содержимого файла, используется для поиска одинаковых файлов. Не гарантия уникальности, но это лучше чем ничего Строка(64)

Копия файла

Реквизит Описание Тип значения
Обработчик Ссылка на настроенную задачу, по которой был создан файл. Если файл был создан преобразованием исходного файла в новый Внешние обработчики файлов
Основной файл Ссылка оригинальный файл, из которого был создан обработчиком, либо копией какой файла является Файловый архив
Назначение Текстовый признак, для какой то дополнительной идентификации, для чего была создана копия файла, либо новый обработанный файл Назначение копии файла
Дата регистрации Дата и время регистрации файла в системе Дата
Это временный файл Признак того, что файл был создан как временный, и при необходимости его можно удалить, без каких либо последствий в логике работы системы Включить или Отключить

Форма списка

Основная форма просмотра списка данных.

Форма выбора

Основная Форма выбора элемента данных.

Контейнер

На клиентах

Копии файла

Владельцы файла

Метаданные

Данные

Реквизиты

Синоним Имя Тип значения Описание
Наименование Наименование Строка(150) -
Том Том Справочники: Тома файлов Серверный либо клиентский том, где хранится файл
Путь Путь Строка Путь к файлу
Имя Имя Строка(150) Имя файла, как он записан в файловой системе
Расширение Расширение Строка(10) Расширение файла, может использовать в фильтре при выборе списка файлов для обработки
Дата изменения ВремяИзменения Дата Дата и время изменения файла в момент регистрации в системе. Может отличаться от реального времени изменения файла, может использоваться обработчиками как признак того, что какие то данные ранее полученные из файла необходимо обновить в системе
Размер (байт) Размер Число(10, 0) Размер файла в байтах
Контрольная сумма Сумма Строка(64) Контрольная сумма содержимого файла, используется для поиска одинаковых файлов. Не гарантия уникальности, но это лучше чем ничего
Контейнер Контейнер Справочники: Файловый архив Ссылка на файл контейнер (если файл в архиве), контейнер это так же файл в данном архиве, со своими свойствами
Устройство Устройство Справочники: Устройства пользователей Ссылка на описания устройства, если файл хранится на ПК клиента
Основной файл ОсновнойФайл Справочники: Файловый архив Ссылка оригинальный файл, из которого был создан обработчиком, либо копией какой файла является
Тип файла Тип Справочники: Типы файлов Обобщенный тип файла (картинка, табличный документ и т.п.)
Это временный файл Временный Включить или Отключить Признак того, что файл был создан как временный, и при необходимости его можно удалить, без каких либо последствий в логике работы системы
Дата регистрации ДатаРегистрации Дата Дата и время регистрации файла в системе
Назначение НазначениеКопии Перечисления: Назначение копии файла Текстовый признак, для какой то дополнительной идентификации, для чего была создана копия файла, либо новый обработанный файл
Тип данных ТипДанных Справочники: Типы данных Тип данных хранящихся в файле, если файл содержит данные
Обработчик Обработчик Справочники: Внешние обработчики файлов Ссылка на настроенную задачу, по которой был создан файл. Если файл был создан преобразованием исходного файла в новый

Подсистемы

Источник — http://un.web-kat.ru/index.php?title=EcmФайлы_/_С&oldid=4051