Пособие для партнёров DocsVision




НазваниеПособие для партнёров DocsVision
страница6/35
Дата конвертации12.12.2012
Размер3.06 Mb.
ТипРеферат
1   2   3   4   5   6   7   8   9   ...   35

3.3Разработка компонента карточки


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

icon_prim

Примечание

Карточка может и не иметь пользовательского интерфейса – например, если она используется только в качестве хранилища данных для других карточек. В этом случае данный этап может быть пропущен.

Программный компонент карточки представляет собой элемент управления ActiveX, предоставляющий пользовательский интерфейс для работы с данными карточки. Элемент управления вызывается Навигатором при активации карточки («открытии») или выполнении команд карточки.

Можно выделить несколько типов программных компонент карточек:

карточки документов — программные компоненты, реализующие только интерфейс для ввода и редактирования данных. Типичными примерами карточек документов являются карточки стандартного решения DocsVision «Делопроизводство»: Входящий документ, Исходящий документ и другие;

карточки справочников — программные компоненты, предназначенные для редактирования данных справочников. Помимо средств для ввода и редактирования данных, предоставляют специальный интерфейс для выбора элементов справочника;

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

специализированные карточки — системные карточки, служебные компоненты или утилиты, предназначенные для использования в составе других карточек или реализации специфической функциональности. К числу таких карточек можно отнести системную карточку файла, карточку Список файлов из стандартного решения DocsVision «Делопроизводство» и другие.

Разработка программного компонента состоит из нескольких этапов:

реализация стандартных интерфейсов — программирование кода карточки в соответствии со стандартами платформы DocsVision для обеспечения её корректной работы в системе;

реализация пользовательского интерфейса — включает в себя проектирование и реализацию вариантов взаимодействия кода карточки с пользователем, дизайн и расположение элементов управления на форме карточки;

реализация дополнительной функциональности — дополнительные функции карточки, связанные с её назначением;

отладка и тестирование — проверка корректной работы разработанного компонента в составе системы.

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

icon_prim

Примечание

Примерный перечень сред и языков, в которых может быть разработана карточка DocsVision:

Microsoft Visual Studio 6.0 (Visual Basic, Visual C++);

Microsoft Visual Studio 2003 (VB.NET, C#);

Microsoft Visual Studio 2005 (VB.NET, C#);

Borland Delphi и другие.

В данном Руководстве примеры кода приведены для Microsoft .NET (C#).

3.3.1Реализация стандартных интерфейсов


Сначала необходимо создать новый проект — компонент, который будет реализовывать визуальную часть карточки. Проект должен иметь тип «Windows Forms Control Library»:



Рис. 3.. Создание проекта







Перед началом работы с проектом следует подключить все необходимые библиотеки:



Рис. 3.. Подключение библиотек

В число необходимых входят следующие объектные библиотеки:

DocsVision.Platform.WinForms.dll — содержит интерфейс для взаимодействия с контейнером карточек (средой, в которой запускаются и работают компоненты карточек), а также элементы управления DocsVision для карточек в среде WinForms;

icon_prim

Примечание

Вместо DocsVision.Platform.WinForms.dll, можно использовать библиотеку DocsVision.Platform.WPF.dll – она позволяет разрабатывать карточки по технологии Windows Presentation Foundation (WPF). При этом основные принципы разработки и интерфейсы остаются точно такими же, как и в случае WinForms - поэтому далее в данном Руководстве они не рассматриваются отдельно.

DocsVision.Platform.ObjectManager.dll — библиотека менеджера объектов. В этой библиотеке определены основные интерфейсы для взаимодействия с сервером и другими объектами системы (API).

icon_prim

Примечание

Эти сборки входят в состав как серверной, так и клиентской программ инсталляции; однако устанавливаются они в GAC (Global Assembly Cache) – специальную системную папку, предназначенную для размещения общедоступных сборок. К сожалению, Visual Studio не позволяет напрямую добавить ссылки на библиотеки, расположенные в GAC. Поэтому может понадобиться вручную скопировать из GAC (\Windows\assembly\GAC_MSIL\) в папку проекта, для последующей установки ссылок на них.

Очевидно, следует также подключить пространства имен этих сборок в область видимости текущего проекта при помощи директивы using:

using DocsVision.Platform.WinForms;

using DocsVision.Platform.ObjectManager;

Поскольку Навигатор активирует компонент карточки через COM-интерфейс, следует сразу добавить в основной класс специальный атрибут , позволяющий другим приложениям взаимодействовать с .NET-сборкой по технологии COM. Вместе с этим атрибутом необходимо сразу указать уникальный идентификатор класса (CLSID), который будет однозначно идентифицировать этот класс среди прочих. Этот идентификатор необходимо сгенерировать самостоятельно (например, при помощи утилиты GuidGen из состава Visual Studio). Этот же идентификатор нужно будет указать в XML-описании карточки в качестве строки активизации компонента карточки.

Эти атрибуты объявлены в пространстве имен System.Runtime.InteropServices, поэтому нужно подключить его к своему проекту:

using System.Runtime.InteropServices;

Пример описания класса с установленным атрибутом:

[ComVisible(true)]

[Guid("221D8441-BEE9-4CAE-A59B-2007B6EEF5CF")]

[ClassInterface(ClassInterfaceType.None)]

public sealed partial class TestCard : UserControl

Для того чтобы карточка могла быть использована совместно с другими компонентами платформы, ее программный компонент должен реализовывать набор предопределенных интерфейсов. Все эти интерфейсы уже реализованы в специальном классе DocsVision.Platform.WinForms.CardControl, поэтому разработчик избавлен от их непосредственной имплементации. Все что остается сделать – это унаследовать основной класс своей карточки от базового класса CardControl (вместо стандартного UserControl):

public sealed partial class TestCard : CardControl

{

}



После этого в коде карточки автоматически появится доступ к членам базового класса, среди которых самые важные:

  • CardData – объект данных текущей карточки

  • CardHost – объект контейнера карточек

  • Session – текущая сессия (точка входа к остальным объектам API)

Дополнительные свойства, доступные из базового класса:

  • FolderID – идентификатор папки, из которой открыта карточка

  • ShortcutID – идентификатор ярлыка, из которого открыта карточка

  • ModeID – идентификатор текущего режима карточки

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

using System;

using System.Runtime.InteropServices;

using System.Windows.Forms;
using DocsVision.Platform.ObjectManager;

using DocsVision.Platform.WinForms;

using DocsVision.Platform.WinForms.DataSource;
namespace DocsVision.Test

{

[ComVisible(true)]

[Guid("221D8441-BEE9-4CAE-A59B-2007B6EEF5CF")]

[ClassInterface(ClassInterfaceType.None)]

public sealed partial class TestCard : CardControl

{
///

/// Default constructor

///


public TestCard()

{

InitializeComponent();

}

}

}

icon_prim

Примечание

Готовый компонент карточки необходимо зарегистрировать как COM-библиотеку при помощи утилиты regasm.exe (утилита входит в состав .NET Framework). При этом, если компнент имеет strong name, то его можно установить в GAC (утилитой gacutil.exe), и зарегистрировать вызовом regasm.exe. Если же сборка не имеет strong name, то регистрацию необходимо выполнить утилитой regasm.exe с ключом /codebase.


1   2   3   4   5   6   7   8   9   ...   35

Похожие:

Пособие для партнёров DocsVision iconУстановка патчей *. msp DocsVision Установить патч можно только на клиентах DocsVision (но не на сервере) Установка патчей библиотек DocsVision
Скопируйте пакет в папку «Директория с установленным DocsVision\Platform 3\Server\Site\Setup». В данной директории можно создать...
Пособие для партнёров DocsVision iconDocsVision 6 sr1: Руководство по установке и настройке
Особенности конфигурации серверного программного обеспечения для установки DocsVision 5
Пособие для партнёров DocsVision iconВы  держите  в  руках  брошюру  для  партнеров  1с,  которая поможет вам повысить продажи. Речь идет не о  продажах вообще, а о возможности более эффективно  предлагать  клиентам  серверные  продукты  Microsoft, 
Приложение Полезные ресурсы для партнеров  26 вы  держите  в  руках  брошюру  для  партнеров  1с, 
Пособие для партнёров DocsVision iconРекомендации по созданию условий для эффективного функционирования стратегических партнерств с участием учреждений профобразования Роль вуза в подготовке кадров для стратегических партнеров и участников кластера
В части подготовки кадров для стратегических партнеров и участников кластера можно выделить две глобальные цели
Пособие для партнёров DocsVision iconНастоящий документ описывает конфигурирование системы DocsVision 5 и дальнейшее ее администрирование, а именно

Пособие для партнёров DocsVision iconУчебное пособие по курсу «Организация эвм, комплексов и сетей» часть I
Пособие предназначено для самостоятельной работы студента над курсом “Организация эвм, комплексов и сетей” по первой части курса...
Пособие для партнёров DocsVision iconПеречень предприятий Южного Федерального округа, которые выпускают продукцию, возможно интересную для иностранных партнеров
Южного Федерального округа, которые выпускают продукцию, возможно интересную для иностранных партнеров
Пособие для партнёров DocsVision iconИнструкция по внедрению  «1С: Университет»  версия 0 12  (для партнеров фирмы «1С»)
Общие сведения    4 
Пособие для партнёров DocsVision iconПособие для воспитателей Кишинев, 2010 czu 373. 2
...
Пособие для партнёров DocsVision iconСпециалист по технологическому развитию партнеров 
Интеллектуальные объединенные коммуникации для бизнеса (Microsoft Exchange и Lync) 
Разместите кнопку на своём сайте:
kak.znate.ru


База данных защищена авторским правом ©kak.znate.ru 2012
обратиться к администрации
KakZnate
Главная страница