Войти
 
 
   
 
  
Новости Notes.ру Библиотека Биржа труда Вопрос - ответ Форум Регистрация Поиск О проекте
Разделы
О Notes
Советы
Шаблоны и примеры
Литература
Презентации
 
Дополнительные инструменты в панели инструментов   
Шаблоны и примеры Читать статью
 
Классы для работы со стабами удалённых документов для Windows64   
Шаблоны и примеры Читать статью
 
Базовые компоненты XPages Extension Library: Widget Container   Серия статьей дающая представление о базовых компонентах Extension Library, их основных свойствах и мест применения
О Notes Читать статью
 


О Notes

Главная   Библиотека   О Notes

XPages. Extension Library: описание, установка, использование

Артем Арешко
artemaa@gmail.com
live-scripts.blogspot.com

XPages. Extension Library: описание, установка, использование

Одно из важнейших понятий в работе с xPages - это библиотека компонентов Extension Library.

Что же это такое?
Если говорить своими словами - это open source проект, поддерживаемый IBM, по предоставлению различных компонент для работы с xPages, облегчающих жизнь. Проект в основном живет и развивается на OpenNTF.org. Пройдя по ссылке вы найдете: ссылку для закачки последнего релиза, ссылку на Wiki-документацию, презентацию и видео.
Ниже будет описана установка Extension Library на сервер, затем на клиент (Designer), но в рамках статьи не будут рассмотрены: все возможные способы установки, обновление версии Extension Library или удаление библиотеки.

Установка библиотеки компонентов
Справедливости ради отмечу, что подобным образом можно устанавливать любые кастомные библиотеки компонентов для XPages (да-да, Extension Library, конечно же не единственная библиотека в своем роде).

Во-первых, зачем куда чего устанавливать:
1. На сервер: для возможности пользователям работать с приложениями: все обращения идут к серверу, а значит и ресурсы должны лежать там.
2. На клиент: для возможности разработки (компоненты должны быть доступны в палитре) и тестирования/работы на локале. При открытии приложения в клиенте Notes на локале идет обращение к локальным ресурсам.

Приступим, установка на сервер:
1. Исходные данные:
- Domino Server 8.5.3 +
- Соответствующая версия Extension Library. Все релизы можно посмотреть по ссылке.

2. Развернуть базу Update Site
- Развернуть на сервере базу на основе шаблона Eclipse Update Site. Шаблон лежит на сервере в дополнительных шаблонах (advanced templates)


- В ACL нужно дать права тем, кто будет размещать там плагины. Минимальный необходимый доступ: Author

3. Загрузить плагины в базу Update Site
- Среди скаченных файлов библиотеки, должен быть updateSiteOpenNTF.zip - его надо распаковать
- В архиве 2 папки: featuresplugins - и один файл: site.xml. Он-то и нужен
- Открываем только что развернутую базу Update Site, жмем "Import Local Update Site", указываем путь к файлу site.xml и ОК.


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


4. Изменить серверный Notes.ini
- В Notes.ini на сервере нужно добавить переменную OSGI_HTTP_DYNAMIC_BUNDLES, с указанием пути к базе Update Site, например: OSGI_HTTP_DYNAMIC_BUNDLES=updateSite1.nsf
- Может быть указано более одной базы UpdateSite через ",", например: OSGI_HTTP_DYNAMIC_BUNDLES=updateSite1.nsf,folder\updateSite2.nsf
- На каждом сервере, где будет указана данная переменная будет работать реплика базы Update Site. Т.е. для тиражирования на другие сервера нужно добавить указанную выше переменную в Notes.ini серверов и сделать на них реплики Update Site.

5. Перезагрузить сервер
- После выполнения данных шагов необходимо перегрузить Domino сервер (например, командой res ser)
- При загрузке сервера (а точнее задачи http), вы должны будете увидите строку со следующим содержанием:
HTTP JVM: CLFAD0330I: NSF Based plugins are being installed in the OSGi runtime. For more information please consult the log
- Проверить, подгружены ли конкретные плагины можно командой: tell http osgi ss com.ibm.xsp.extlib. Пример ответа:
> tell http osgi ss com.ibm.xsp.extlibx
16/04/2013 09:22:17 Framework is launched.
16/04/2013 09:22:17 id State Bundle
16/04/2013 09:22:17 12 <<LAZY>> com.ibm.xsp.extlibx.relational_9.0.0.v00_01_20130415-0518
16/04/2013 09:22:17 13 <<LAZY>> com.ibm.xsp.extlibx.sbt_9.0.0.v00_01_20130415-0518
16/04/2013 09:22:17 14 RESOLVED
com.ibm.xsp.extlibx.relational.derby_9.0.0.v00_01_20130415-0518
16/04/2013 09:22:17 15 RESOLVED com.ibm.xsp.extlibx.oauth_9.0.0.v00_01_20130415-0518
16/04/2013 09:22:17 Master=106
16/04/2013 09:22:17 19 <<LAZY>> com.ibm.xsp.extlibx.core_9.0.0.v00_01_20130415-0518
16/04/2013 09:22:17 20 RESOLVED com.ibm.xsp.extlibx.controls_9.0.0.v00_01_20130415-0518
16/04/2013 09:22:17 24 <<LAZY>> com.ibm.xsp.extlibx_9.0.0.v00_01_20130415-0518

Несколько важных моментов и личных грабель:
1. Плагины установленные данным способом на самом деле не находятся на сервере, а подгружаются автоматически через OSGI. Т.е. как только задача http будет завершена, плагины не будут доступны
2. Пытался поставить Extension Library на 8.5.2...не пошло. Мне трудно сказать почему. В плагинах не обнаружил нужных. Пришлось апгрейдить клиент до 8.5.3
3. Для установки нужно брать соотетствующий, вашей версии релиз (например на сервер 8.5.2). Наопминаю, что все релизы можно посмотреть по ссылке.
4. Если вы ставите 8.5.3 + Upgrade Pack 1, ставить Extension Library не нужно - она уже есть в составе UP1, НО в ней могут быть не все компоненты, которые есть в последнем релизе Extension Library. У меня установка UP1 не удалась из-за ошибки, потому Extension Library ставился вручную.
5. Часть данной статьи про установку на сервер, по сути вольный и не абсолютно полный пересказ вот этой статьи. Тем не менее это не теория, данный путь проходился ни один раз самостоятельно.

Установка на клиент
1
. Исходные данные:
- Клиент 
Notes 8.5.3 +
Extension Library, установленная на сервере через Update Site

2
. Включить опцию установки плагинов
- В 
Domino Designer идем в File -> Preferences


- Ищем опции Domino Designer и в них выставляем галку "
Enable Eclipse plug-in install"


3
. Устанавливаем плагины
- Находясь в Domino Designer: 
File -> Application -> Install


- В появившемся окне выбираем опцию 
Search for new features to install, Next >


- В следующем пункте 
Add remote location.
- В диалоге забиваем произвольное название и указываем 
Web URL к базе Update Site -> ОК -> Finish.
- Во время установки для каждого *.jar файла будет выскакивать предупреждение тип "А точно установить?". По-умолчанию там выбрано "Нет, пропустить установку этого компонента", нужно переключить на "Установить" и нажать ОК
- После установки всех плагинов Designer нужно 
перезапустить, что он сам любезно предложит сделать.
Примечание:

1. Можно установить плагины так же через имеющийся в скаченных файлах библиотеки
updateSiteOpenNTF-designer.zip. Тогда на шаге выбора источника установки нужно указать не "Add remote location", а "Add Zip/Jar location" и выбрать путь к *.zip файлу
2. Или вообще вручную скопировать папки 
features и plugins из updateSiteOpenNTF-designer.zip в Notes\Data\workspace\applications\eclipse

Краткое об использовании
Открыв Designer и зайдя в xPages или Custom Cоntrol вы сразу увидите изменения на панели компонент - она сильно увеличиться в размерах. Использование компонентов очень сильно облегчает работу со многими вещами. Проверено и подтверждено. Особенно, это заметно, когда пыхтя ты пытаешься добиться результата стандартными методами, а используя компонентExtension Library вы его получаете сразу.

Пожалуй, лучшее ознакомительное видео, которое позволяет узреть силу компонентов и понять, как собирать форму на основе Extention Libarary лежит на xPages.tv. Сам ресурс xPages.tv,  созданный, кстати на xPages и доступный для скачивания на OpenNTF.org, весьма полезен.

Полезные ссылки:
1. xPages wiki, используя поиск можно найти очень много интересного касательно непосредственного применения компонент extLib
2. Подраздел xPages wiki по Extension Library компонентам
3. xPages.tv - видео уроки по использованию xPages
 
  Опубликовано — 09/25/2015 |    



Добавить комментарий
Имя * :
e-mail
Комментарий * :
Код подтверждения * :

Мероприятия
18.12.2012   Опыт реализованных проектов на базе технологий IBM
24.10.2012   Решения IBM для построения надежной ИТ-инфраструктуры и сервисов
09.10.2012   Форум «Ударим СЭДом по бездорожью, разгильдяйству и непрозрачным бизнес-процессам! Система электронного документооборота CompanyMedia 4.0: вперед в будущее!»
Пресс-релизы
02.06.2011   ООО "АДБ.РУ" выпустило очередную версию системы управления контентом для Lotus Domino - Logosphere 2.7.
21.01.2010   Компания «Поликом Про» выполнила для компании «Синергия» пилотный проект по внедрению системы защиты электронной почты IBM Lotus Protector for Mail Security
22.12.2009   Новые технологии разработки приложений на базе Lotus Domino
Биржа труда
18.04.2012 - разработчик Lotus Notes (ОАО "УРАЛСИБ")
26.07.2011 - Программист Lotus (удаленная работа) ()
06.06.2011 - Эксперт (Lotus Notes/Domino) (Крупный банк (ТОП-5))
Последнее на форуме
 
А так же:
Как удалить профиль?
16.04.2016 00:08:51
Скопировать в буфер поле документа
24.05.2015 08:55:52
Импорт DXL-описания документов в Lotus Domino. Одноимённые поля
16.04.2015 16:49:58
 
© LOGOSPHERE.RU