В этой статье описывается конвертация приложения Lotus Notes в приложение Java на примере программы Personal Journal. Этот подход можно применить для конвертации остальных шаблонов Lotus Notes, в результате чего они будут выглядеть аналогично приложениям органайзера Lotus Notes 8 (Mail, Calendar, Contacts).

Ранее в разделе developerWorks® Lotus была опубликована дополнительная статья на эту тему - "Расширенные функции отображений Java в IBM Lotus Notes 8.5".

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

1. Многоуровневые категории в отображении могут работать некорректно.
2. Итоговые колонки в многоуровневых отображениях с категориями могут работать некорректно.
3. Пользовательские пиктограммы могут не работать для категорий.
4. Навигатор может не отображать нестандартные действия на навигационной панели.
5. Навигатор не отображает нестандартные действия в выпадающем меню заголовка навигационной панели.

Процесс конвертации

Чтобы представить приложение Lotus Notes с помощью отображений Java в клиенте Lotus Notes 8 (или более поздней версии), это приложение должно быть композитным. Таким образом, первым шагом будет создание композитного приложения с помощью редактора композитных приложений (CAE). Затем нужно изменить шаблон с помощью Lotus Domino Designer и делать другие изменения при помощи CAE.

Приложение Personal Journal является хорошим стартовым примером, потому что это простое приложение с навигатором, отображением списков и панелью предпросмотра, удовлетворяющее перечисленным критериям.

Прежде чем мы начнем, убедитесь, что у вас установлены клиент Lotus Notes 8.5 с редактором композитных приложений и Lotus Domino Designer 8.5. Вам также понадобится PNG-файл размером 16x16 пикселов для пиктограммы страницы, которая будет отображаться на соответствующей вкладке приложения.

На рисунке 1 показано исходное приложение Personal Journal до конвертации, а на рисунке 2 - приложение после выполнения указанных в статье шагов.

В начало

Создание нового приложения Personal Journal

Выполните в клиенте Lotus Notes следующие действия:

1. Создайте новое приложение Lotus Notes на основе journal6.ntf.
2. Убедитесь, что опция "Inherit future design changes" отключена.
3. Откройте новое приложение.
4. Щелкните правой клавишей мыши на вкладке и откройте новое приложение в Lotus Domino Designer.

В начало

Создание нового композитного приложения в Lotus Domino Designer

Выполните в Lotus Domino Designer следующие действия:

1. Выберите в навигаторе пункт Composite Applications, затем Applications.
2. Нажмите кнопку NewCompApp на панели Design.
3. Назовите файл нового приложения "Notes Journal Application.xml" и нажмите OK, как показано на рисунке 3.
   
   
   
   Рисунок 3. Создание композитного приложения в Lotus Domino Designer
   
   
   
4. Выберите элемент Framesets в Lotus Domino Designer, затем дважды щелкните на BorderFrame. См. рисунок 4.
5. Нажмите File - Properties и выберите Frameset из появившегося списка.
6. Укажите в качестве названия приложения "Notes Journal Application.xml" (Composite Application – App Name).
7. Укажите в качестве названия страницы "Blank Page" (Composite Application – Page Name).
   
   
   
   Рисунок 4. Lotus Domino Designer: Изменение настроек набора фреймов
   
   
   
8. Выберите File - Save.
9. Нажмите File - Exit.

В начало

Построение нового приложения на основе компонентов Mail

Инфраструктура композитных приложений использует для генерации страницы композитного приложения компоненты Lotus Notes Mail (навигатор и отображение списка). Компоненты Lotus Notes Mail уже настроены для управления отображением списка и его предпросмотром. Вам остается перенести эти компоненты в набор фреймов вашего исходного приложения Journal.

Выполните в клиенте Lotus Notes следующие шаги:

1. Откройте клиент Lotus Notes.
2. Откройте пример приложения Journal (NSF-файл, который вы создали ранее).
3. Выберите Action - Edit Application для открытия приложения в композитном приложении.
4. Нажмите на правую стрелку для открытия палитры компонентов. См. рисунок 5.

Добавление нужных компонентов

Теперь вам необходимо добавить два компонента.

Выполните в редакторе композитных приложений следующие шаги:

1. Выберите элемент Lotus Notes Mail View из раздела PIM отображаемого списка и перетащите его на среднюю панель. См. рисунок 6.
   
   
   
   Рисунок 6. CAE: выбор компонента Mail View
   
   
   

   Полученный вид окна показан на рисунке 7.

   
   
   Рисунок 7. CAE после выбора компонента отображения почты Lotus Notes
   
   
   
2. Действия, выполненные вами на предыдущем шаге, должны были переместить фокус обратно к рабочему пространству клиента Lotus Notes. Если это случилось, выберите Lotus Notes в разделе Taskbar и переоткройте Editing: Blank Application. Вам также может понадобиться нажать на правую стрелку, чтобы заново открыть палитру компонентов.
3. Теперь перетащите компонент Lotus Notes Mail Navigator на среднюю панель. Этот шаг непростой; вам нужно перетащить представление на левую границу панели. Когда вы увидите черную стрелку, появившуюся слева от границы панели, и узкий окаймляющий прямоугольник, как показано на рисунке 8, отпустите компонент.
   
   
   
   Рисунок 8. CAE: выбор компонента Mail Navigator
   
   
   

После выбора навигатора вы должны увидеть экран, аналогичный показанному на рисунке 9.

Использование настроек фреймов з приложения Personal Journal

Теперь вам необходимо заменить почтовые компоненты элементами из Personal Journal. Ваше новое приложение должно унаследовать настройки фреймов из шаблона журнала.

Выполните следующие действия:

1. Щелкните правой кнопкой на компоненте Lotus Notes Mail Navigator (на левой панели) и выберите Edit Component Properties.
2. На вкладке Display Settings выберите Title Bar для отображения строки заголовка.
3. Выберите вкладку Component Settings.
4. Найдите поле Lotus Notes URL.
5. Замените E на 0; затем замените MailFS на BorderFrame (notes:///0000000000000000/BorderFrame?OpenFrameset). Теперь ваше окно должно выглядеть аналогично рисунку 10.
   
   
   
   Рисунок 10. CAE: обновление поля Lotus Notes URL
   
   
   
6. Нажмите OK и закройте окно.
7. Щелкните правой кнопкой на компоненте Lotus Notes Mail View (левая панель) и выберите Edit Component Properties.
8. Выберите вкладку Component Settings.
9. Найдите поле Notes URL.
10. Замените E на 0; затем замените MailFS на BorderFrame: notes:///0000000000000000/BorderFrame?OpenFrameset.
11. Выберите вкладку Advanced.
12. Выберите com.ibm.rcp.csiviews.viewpart.threadurl и нажмите Delete.
13. Выберите com.ibm.rcp.csiviews.viewpart.folderalias и нажмите Delete.
14. Нажмите OK.
15. Выберите Save and Close из меню File, чтобы сохранить сделанные изменения.

Задание пиктограммы страницы и переименование приложения

Выполните в Lotus Domino Designer следующие действия:

1. Вам нужно изображение формата PNG (16 X 16). Для примера посмотрите изображение tab_notebook_16.png в шаблоне notebook8.ntf.
2. Откройте Lotus Domino Designer.
3. Выберите Resources – Images.
4. Нажмите "Import Image Resource", чтобы импортировать ваше изображение в качестве нового графического ресурса. Введите *.png в поле имени файла. См. рисунок 11.
   
   
   
   Рисунок 11. Lotus Domino Designer: добавление пиктограммы страницы в директорию shared resources/image.
   
   
   
   
   Рисунок 12. Lotus Domino Designer: настройка фильтра для отображения PNG файлов
   
   
   
5. Откройте редактор композитных приложений через клиент Lotus Notes.
6. Щелкните правой кнопкой на Blank Page в навигаторе и выберите опцию Edit Page Properties.
7. Нажмите Select, чтобы выбрать сохраненную ранее пиктограмму. См. рисунок 13.
   
   
   
   Рисунок 13. CAE: редактирование пиктограммы страницы
   
   
   
8. Теперь вы можете настроить имя вашего приложения, отредактировав поле Page Title. См. рисунок 14.
   
   
   
   Рисунок 14. CAE: редактирование поля Page Title
   
   
   
9. Нажмите OK.
10. Выберите Save and Close из меню File.
    

    Вы можете вернуться в клиент Lotus Notes и открыть ваше приложение. Оно должно выглядеть аналогично рисунку 15. Вам может понадобиться перезапустить Lotus Notes, чтобы пиктограмма закладки обновилась.

    
    
    Рисунок 15. Lotus Notes: обновленное приложение в клиенте Lotus Notes
    
    
    

Установка ссылки для пиктограммы страницы

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

Выполните в Lotus Domino Designer следующие действия:

1. Откройте созданное ранее приложение Notes Journal Application, созданное вами ранее.
2. Выберитесозданный ранее файл Notes Journal Application.xml и выберите Open (щелкните правой кнопкой мыши).
3. Найдите в тексте <preference name=”com.ibm.portal.PageIcon”>.
4. Установите в качестве значения base:value PNG-файл вашей пиктограммы страницы, указав его, как показано ниже:
   <preference name=”com.ibm.portal.PageIcon”>
<base:value value=”Notebook_view16.png” xsi:type=”base:String”/>
</preference>
5. Сохраните файл и нажмите Exit.

Создание многозадачных кнопок для панели управления

Lotus Notes 8 позволяет создавать многозадачные кнопки на панелях управления. Многозадачные кнопки позволяют пользователю совершить действие по умолчанию одним нажатием или вызвать всплывающий список возможных действий.

Пример многозадачной кнопки есть в ящике входящей почты почтового приложения. При нажатии кнопки "New" открывается новое письмо. Если вместо New вы нажмете стрелочку вниз, вы увидите список вариантов, как на рисунке 16.

Чтобы создать многозадачную кнопку, выполните в Lotus Domino Designer следующие шаги:

1. Откройте окно свойств Shared Action.
2. Выберите опцию "Display as split button" в окне свойств действия. См. рисунок 17.
   
   
   
   Рисунок 17. Создание многозадачной кнопки
   
   
   

Настройка типа вкладки

По умолчанию XML-настройки Lotus Notes приводят к созданию адресов Notes Remote Procedure Call (NRPC) при установке вкладки приложения на панель приложений. Эти адреса работают медленно и могут генерировать ошибки, если соответствующее приложение более не существует. Поэтому имеет смысл использовать для закладок URL-адреса Notes. Этот шаг также позволяет гарантировать, что в качестве пиктограммы вкладки используется пиктограмма из базы данных.

Чтобы переключиться на URL Notes, необходимо добавить соответствующую настройку в XML композитного приложения. Это можно сделать, открыв редактор композитных приложений (выберите Actions - Edit Application) и выбрав Edit Page Properties. См. рисунок 18.

Затем переключитесь в раздел Advanced в окне Edit Page Properties и нажмите Add, чтобы добавить настройку com.ibm.rcp.bookmark_level и выбрать ее значение. См. рисунок 19.

Запрет переключения навигатора

По умолчанию строка заголовка навигатора содержит переключатель Switch to Calendar. Эту опцию можно отключить с помощью еще одной настройки XML композитного приложения.

Выполните следующие действия:

1. Запустите редактор композитных приложений (выбрав Actions - Edit Application) и отредактируйте свойства компонента навигатора через меню правой кнопки мыши.
2. Когда отобразится окно свойств компонента, выберите закладку Advanced. Нажмите Add и добавьте настройку com.ibm.rcp.showSwitch со значением false. Сохраните и закройте окно. См. рисунок 21.
   
   
   
   Рисунок 21. Добавление настройки отображения переключателя
   
   
   

В начало

Заключение

В этой статье были описаны шаги, позволяющие настраивать и модернизировать ваши приложения. Теперь вы имеете многие из инструментов для придания вашим приложениям вида, подобного стандартным приложениям органайзера Lotus Notes 8 (Mail, Calendar, Contacts, To Do и Notebook). Более подробную информацию можно найти в руководстве редактора приложений Lotus Notes и Domino Designer 8.5.

Ресурсы

• Примите участие в обсуждении материала на форуме.
  
  
• Оригинал статьи "Basics steps: Converting an IBM Lotus Notes application to use Lotus Notes 8 Java components" (EN).
  
  
• Дополнительная статья developerWorks по этой теме: "Расширенные функции отображений Java в IBM Lotus Notes 8.5".
  
  
• Статья developerWorks "What's new in IBM Lotus Notes 8.5" (EN).
  
  
• Страница информации о продуктах IBM Lotus Notes и Domino 8.5.
  
  
• Информация об IBM Lotus Domino Designer 8.5.
  
  

Об авторах

Оценить эту статью

Комментарии

В начало

Содержание

• Процесс конвертации
• Создание нового приложения Personal Journal
• Создание нового композитного приложения в Lotus Domino Designer
• Построение нового приложения на основе компонентов Mail
• Заключение
• Ресурсы
• Об авторах
• Комментарии