Данная статья является последней в цикле материалов, инструктирующих как спроектировать и построить ваше собственное клиентское приложение при помощи IBMDB2Content Manager C++ Object Oriented (Объектно-ориентированных) API (C++ OOAPI), основанная на подробном анализе вымышленной рекламной фирмы, ADCompany. Приложение ADClient, показанное в данном примере, и соответствующей ему исходный код приведены в конце руководства.
Введение
pClient и eClient, объединенные с IBM DB2 Content Manager (CM), удовлетворяют клиентским требованиям многих пользователей Content Manager. Тем не менее, многие пользователи нуждаются в разработке своих собственных клиентских приложений для соответствия своим особым коммерческим нуждам и более тесной интеграции своего бизнеса с CM. Пример программы CM C++ OOAPI предоставляет разработчикам возможность детально изучить OOAPI, но не дает полного представления о том, как эти интерфейсы API организовать.
Приложение ADClient, образец которого описан в данном разделе, является подробным примером, объясняющим как организовать и реализовать API. Используйте данные статьи в качестве справочника по разработке вашего собственного клиентского приложения при помощи DB2 Enterprise Content Manager C++ OOAPI. Для наглядной демонстрации данного решения используется вымышленная ситуация в компании ADCompany.
На Рисунке 1 сверху вниз кратко изложен аналитический процесс, иллюстрирующий то, как организовано решение в данном цикле. Сначала проанализируйте предполагаемые бизнес-требования и разработайте модель бизнес процесса (BPM). Затем постройте реальный процесс в системе CM в качестве архитектуры решений предприятия, на основе которой в конечном итоге проектируется и разрабатывается приложение. В данном разделе, состоящем из трех частей, рассматриваются следующие темы:
- Часть 1: Руководство по моделированию бизнес-процесса и его реализации в DB2 Content Manager, на примере ADCompany
- Введение в архитектуру IBM DB2 CM
- Ознакомление с примером ADCompany
- Бизнес требования ADCompany
- Анализ бизнес-требований ADCompany
- BPM для ADCompany
- Архитектура решения для модели бизнес процесса ADCompany
- Часть 2: Руководство по проектированию и разработке приложения ADClient
- Ознакомление с требованиями для клиентского приложения (ADClient)
- Обзор функциональной спецификации ADClient
- Общий дизайн библиотеки ADClientFunc.dll - Обзор
- Рабочий проект ADClientFunc.dll - Диаграмма дизайна классов
- Рабочий проект ADClientFunc.dll - Класс порталов для поддержки всех экспортированных интерфейсов API
- Рабочий проект ADClientFunc.dll - Дизайн классов управления
- Рабочий проект ADClientFunc.dll - Дизайн структур данных для элементов в CM
- Исходный код приложения ADClient
- Часть 3: Руководство по эксплуатации приложения ADClient
- Ознакомление с приложением ADClient
- Обзор описания процесса на примере ADCompany
- Подробное рассмотрение процесса использования ADClient компанией ADCompany
Ознакомление с приложением ADClient
ADClient является однодокументным интерфейсом (SDI), построенным на Библиотеке Фундаментальных Классов Microsoft (MFC). Графический интерфейс пользователя (GUI) для данного приложения включает два окна, изображенных на Рисунке 2. Левое окно представляет древовидный список, отображающий текущую рабочую область. Правое окно представляет сетку, где перечислены все рабочие элементы в специальной рабочей папке. Практически все операции могут выполняться в главном меню и в меню, выводимом нажатием правой кнопки мыши. Имя зарегистрированного пользователя также перечислено в строке заголовка главного окна ADClient.
Рисунок 2. Графический интерфейс пользователя (GUI) для ADClient
Регистрационный файл приложения ADClient
Если ADClient дает сбой, вы можете обратиться к adclient.log, чтобы увидеть, где произошла ошибка. Файл adclient.log расположен в том же каталоге, что и adclient.exe. ADClient не обрабатывает ошибки, переданные ADClientFunc.dll, следовательно, в случае сбоя ADClient не поступает сообщения об ошибке.
Повторный обзор описания процесса на примере ADCompany
В данном разделе кратко рассматривается определение процесса, которое было подробно описано в Части 1 цикла статей. На Рисунке 3 изображено описание процесса со всеми пользователями ADCompany, использующими собственные сетевые узлы (node). Для получения подробной информации о том, как последовательно описать процесс, и о содержании примера ADCompany, см.Часть 1 данного цикла статей.
Менеджер учетных записей ADAM, работающий на сетевом узле ADCollectRequirementWB, создает рабочую папку, именуемую XYZFolder, для клиента ADCompany - компании XYZ. Затем он импортирует документ с требованиями, принадлежащий типу элемента ADRequirement в XYZFolder. Наконец, он направляет XYZFolder на следующие два рабочих узла, ADArtDraftWB и ADCopyDraftWB.
Арт-Директор, ADAD, работающий на рабочем узле ADArtDraftWB и Текстовый Директор, ADCD, работающий на ADCopyDraftWB, одновременно получают XYZFolder. Они скачивают требования, сохраненные Менеджером учетных записей из типа элемента ADRequirement и выполняют художественный и текстовый дизайн. После его завершения они импортируют свои документы, один из которых принадлежит к типу элемента ADArtDraft, а другой принадлежит к ADCopyDraft. В итоге они направляют XYZFolder в пункт сбора ADWaitForDraftCP.
Пункт сбора ADWaitForDraftCP ожидает оба объекта типа элемента ADArtDraft и ADCopyDraft. Когда оба приходят, он направляет XYZFolder на сетевой узел ADApproveDesignWB.
Дизайн-Директор, ADDD, работающий на рабочем узле ADApproveDesignWB, отвечает за просмотр черновиков Арт-Директора и Текстового Директора. Она может одобрить или отклонить черновой проект. Если она одобряет оба черновых варианта, XYZFolder одновременно направляется на рабочий узел ADArtFinishWB и ADCopyFinishWB. Если же нет, XYZFolder отправляется назад на предыдущий сетевой узел.
Художественный эксперт, ADAS, работающий на рабочем узле ADArtFinishWB и Текстовый Эксперт, ADCS, работающий на ADCopyFinishWB одновременно получают XYZFolder. Они скачивают черновики художественного и текстового дизайн-проекта, соответственно одобренные Дизайн-Директором, и завершают художественный и текстовый дизайн-проект. После завершения дизайн-проекта они импортируют собственные документы (один из которых принадлежит к типу элемента ADArtFinish, а другой к ADCopyFinish) в XYZFolder. В итоге они направляют XYZFolder в пункт сбора ADWaitForFinalDesignCP.
Пункт сбора ADWaitForFinalDesignCP ожидает оба объекта типа элемента ADArtFinish и ADCopyFinish. Когда оба поступают, он направляет XYZFolder на рабочий узел ADProductionWB.
Производитель ADPD, находящийся на рабочем узле ADProductionWB, скачивает окончательный вариант художественного и текстового дизайн-проекта из XYZFolder и выпускает непосредственно рекламу. Сделав это, он импортирует документ с рекламой, принадлежащий к типу элемента ADProduction в XYZFolder, и отправляет папку.
Рисунок 3. Описание процесса в компании ADCompany
Подробное рассмотрение процесса использования ADClient компанией ADCompany
Данные, указанные для каждого пользователя, являются индивидуальными. Экраны, не относящиеся к зарегистрированному пользователю, пропущены.
Примечание:В связи с тем, что существуют некоторые ограничения в ADClient, указанные выше, убедитесь, что соблюдены все ниже перечисленные предварительные требования, прежде чем запускать приложение ADClient:
- запущен DB2-сервис
- запущен Websphere-сервис
- запущен Сервер приложений icmrm
- введены верные символы, такие как имя зарегистрированного пользователя и пароль, чтобы не произошло обработки ошибки в коде.
Подробное рассмотрение использования ADClient всеми пользователями ADCompany
- Менеджер Бюджета (ADAM) на рабочем узле ADCollectRequirementWB.
- Зарегистрируйтесь в ADClient, используя adam/пароль.
- Создайте папку с названиемXYZFolder, принадлежащую типу элемента ADWorkFolder.
- Импортируйте документ с требованиями, принадлежащий типу элемента ADRequirement в XYZFolder.
- ЩелкнитеContinue (Продолжить), чтобы направить XYZFolder на следующий рабочий узел.
- ЩелкнитеExit (Выйти)для выхода из ADClient.
- Арт-Директор (ADAD) на рабочем узле ADArtDraftWB.
- Зарегистрируйтесь в ADClient, используя adad/пароль.
- Перечислите рабочие элементы в XYZFolder.
- Импортируйте черновой документ дизайна, принадлежащий типу элемента ADArtDraft в XYZFolder.
- ЩелкнитеContinue (Продолжить), чтобы направить XYZFolder на следующий рабочий узел.
- ЩелкнитеExit (Выйти)для выхода из ADClient.
- Текстовый Директор (ADCD) на рабочем узле ADCopyDraftWB.
- Зарегистрируйтесь в ADClient, используя adcd/пароль.
- Перечислите рабочие элементы в XYZFolder.
- Импортируйте черновой документ текста, принадлежащий типу элемента ADCopyDraft в XYZFolder.
- ЩелкнитеContinue (Продолжить), чтобы направить XYZFolder на следующий рабочий узел.
- ЩелкнитеExit (Выйти)для выхода из ADClient.
- Дизайн Директор (ADDD) на рабочем узле ADApproveDesignWB.
- Зарегистрируйтесь в ADClient, используя addd/пароль.
- Перечислите рабочие элементы в XYZFolder.
- ЩелкнитеContinue (Продолжить), чтобы направить XYZFolder на следующий рабочий узел.
- Диалоговое окно оценки рекомендует Дизайн-Директору одобрять или не одобрять дизайн, выполненный Арт-Директором, Текстовым Директором или же обоими.
- ЩелкнитеExit (Выйти)для выхода из ADClient
- Художественный эксперт (ADAS) на рабочем узле ADArtFinishWB.
- Зарегистрируйтесь в ADClient, используя adas/пароль.
- Перечислите рабочие элементы в XYZFolder.
- Импортируйте окончательный документ дизайн-проекта, принадлежащий типу элемента ADArtFinish в XYZFolder.
- ЩелкнитеContinue (Продолжить), чтобы направить XYZFolder на следующий рабочий узел.
- ЩелкнитеExit (Выйти)для выхода из ADClient
- Текстовый эксперт (ADCS) на рабочем узле ADCopyFinishWB.
- Зарегистрируйтесь в ADClient, используя adcs/пароль
- Перечислите рабочие элементы в XYZFolder.
- Импортируйте окончательный документ текста дизайн-проекта, принадлежащий типу элемента ADCopyFinish в XYZFolder.
- ЩелкнитеContinue (Продолжить), чтобы направить XYZFolder на следующий рабочий узел.
- ЩелкнитеExit (Выйти)для выхода из ADClient
- Производитель (ADPD) на рабочем узле ADProduction.
- Зарегистрируйтесь в ADClient, используя adpd/пароль.
- Перечислите рабочие элементы в XYZFolder.
- Импортируйте окончательный документ с рекламой, принадлежащий типу элемента ADProduction в XYZFolder.
- ЩелкнитеContinue (Продолжить), чтобы направить XYZFolder в конечный пункт.
- ЩелкнитеExit (Выйти)для выхода из ADClient.
Заключение
Данный раздел статьи о том, как разработать клиентское приложение с CM C++ OOAPI, предназначен для тех, кто интересуется использованием приложения ADClient. Вам предлагается последовательно запустить данное приложение для различных зарегистрированных пользователей на разных рабочих узлах, как было описано выше. После того, как вы завершите запуск ADClient от начального до конечного узла рабочего процесса, определенного в первой части, вы должны ознакомиться с механизмом клиентского приложения. В Части 2 подробно рассматривается проект и код.
Теперь, по прочтении трех частей данного цикла статей, вы ознакомились с моделированием бизнес процесса, архитектурой в CM, объектно-ориентированным проектированием, а также с применением CM C++ OOAPI.