Для разработчиков: расширения

>> Скачать руководство в формате docx
>> Скачать FI_IUploader.dll

 

Общие сведения

Расширения (Extensions) представляют собой библиотеки динамической компоновки на платформе .Net, позволяющие увеличить функционал FileImaging, добавляя поддержку новых сервисов обмена изображениями для размещения слепков.

 

Технические характеристики

 

Расширение должно быть разработано на платформе .Net на любом языке, поддерживающим данную технологию и содержать в ссылках проекта (References) библиотеку FI_IUploader.dll.

 

Структура проекта

 

Расширение должно содержать пространство имен FI_Extension.

 

Классы

Название и расположение класса	Доступ	Наследование
FI_Extension.Uploader	Public	IUploader
FI_Extension.Uploader.FailedEventArgs	Public	IUploader.IFailedEventArgs
FI_Extension.Uploader.CompletedEventArgs	Public	IUploader.ICompletedEventArgs
FI_Extension.Uploader.ProcessEventArgs	Public	IUploader.IProcessEventArgs

 

Структура классов:

 

Uploader

События:

Доступ	Аргументы	Наследование
Public	sender (тип IUploader) e (тип IUploader.ICompletedEventArgs)	IUploader.Completed
Public	sender (тип IUploader) e (тип IUploader.IProcessEventArgs)	IUploader.Process
Public	sender (тип IUploader) e (тип IUploader.IFailedEventArgs)	IUploader.Failed

Свойства:

Доступ	Тип данных	Наследование
Public	System.String	IUploader.ImageFile
Public, ReadOnly	System.Boolean	IUploader.Working

Процедуры (методы):

Доступ	Аргументы	Наследование
Public	Нет	IUploader.StartUpload
Public	Нет	IUploader.CancelUpload

 

 

FailedEventArgs

 

Свойства:

Доступ	Тип данных	Наследование
Public	System.String	IFailedEventArgs.Cause

 

 

CompletedEventArgs

 

Свойства:

Доступ	Тип данных	Наследование
Public	System.String	ICompletedEventArgs.URL

 

 

ProcessEventArgs

Свойства:

Доступ	Тип данных	Наследование
Public	System.Double	IProcessEventArgs.Percent

 

 

Пояснения к структуре

 

Класс Uploader является основным, содержащим в себе подклассы FailedEventArgs, CompletedEventArgs и ProcessEventArgs для событий  Failed, Completed и Process соответственно и должен находится в пространстве имен FI_Extension.
Событие Failed должно быть вызвано в случае возникновения ошибки при работе расширения (свойство Cause должно содержать описание ошибки).
Событие Completed должно быть вызвано в момент завершения загрузки изображения на сервис (свойство URL должно содержать полученную ссылку).
Событие Process должно вызываться в процессе загрузки изображения (свойство Percent должно содержать текущий процент выполнения в долях целого).

Метод StartUpload должен начинать загрузку изображения на сервер.
Метод CancelUpload должен прекращать загрузку изображения на сервер.

Свойство ImageFile должно содержать путь к файлу слепка на локальной машине пользователя.
Свойство Working должно описывать текущее состояние (True, если идет загрузка изображения)

 

Правила формирования имени файла

Для корректной работы расширения в FileImaging имя файла библиотеки должно формироваться следующим образом:
FI_Extension_<Название сервиса>.dll
Например,
FI_Extension_Radikal.dll
В программе такое расширение будет отображено как “Radikal”