Плагин Personal Wizards из IBM Lotus Expeditor может регистрировать действия пользователей Lotus Expeditor, выполняющих определённые задачи, а затем создавать исполняемую модель этой задачи. Personal Wizards представляет собой инструмент для записи и воспроизведения задач в приложениях Lotus Expeditor. Вот некоторые примеры использования Personal Wizards:
- Создание интерактивной документации, помогающей пользователям пошагово выполнить определённую задачу
- Автоматизация рутинных задач, повышающая эффективность работы пользователей
- Создание руководств, демонстрирующих функции новых приложений Lotus Expeditor или новых версий существующих приложений
- Отладка приложений Lotus Expeditor путём записи действий пользователя и их соотнесения с событиями сервера
В нашей статье мы продемонстрируем работу плагина Personal Wizards в некоторых сценариях.
Запуск плагина Personal Wizards
После установки плагина Personal Wizards (см. инструкцию по установке на Lotus Sandbox, developerWorks) в главном меню Lotus Expeditor появится пункт меню Personal Wizards, как показано на рисунке 1. Имейте в виду, что этот пункт меню будет отображаться только после запуска приложения с помощью панели запуска (launchpad).
Рисунок 1. Запуск Personal Wizards
При выборе пункта меню Start PersonalWizards вызывается интерфейс Personal Wizards, как показано на рисунке 2.
Рисунок 2. Пользовательский интерфейс Personal Wizards
Создание интерактивного документа, помогающего пользователю пошагово выполнить определённую задачу
Выполнив следующие шаги, вы сможете с помощью плагина создать документ Personal Wizards:
-
Запись задачи. Начните запись с помощью Personal Wizards, нажав на вкладку Record. Фон окна Personal Wizards становится красным, что означает, что идёт процесс записи. Теперь выполните задачу в приложении Lotus Expeditor. Personal Wizards записывает выполняемые вами действия, создавая документ, в котором описываются шаги выполнения задачи, как показано на рисунке 3.
Рисунок 3. Запись с помощью Personal Wizards
Если при выполнении процедуры вы сделаете ошибку, нажмите на кнопку Undo, которая удалит последнее действие из процедуры (но не из приложения Lotus Expeditor). Кнопку Undo можно последовательно нажимать столько раз, сколько необходимо. Если вы обнаружите, что выполнили лишние шаги, их можно удалить, не прибегая к кнопке Undo; просто выделите строки в документе, щёлкнув по ним мышью (чтобы выделить несколько отдельных строк, удерживайте клавишу Ctrl, а чтобы выбрать несколько расположенных рядом строк – клавишу Shift), а затем нажмите кнопку Delete.
После завершения демонстрации задачи нажмите на вкладку Stop. Появится диалоговое окно Save procedure (см. рисунок 4), в которое можно ввести (или выбрать) имя документа и каталог для его сохранения. Если вы не собираетесь сохранять документ, нажмите на кнопку Discard, расположенную в этом диалоговом окне; помните, что после этого восстановить документ будет невозможно. В этом же диалоговом окне можно указать каталог, в который будут сохранены документы (или процедуры); изменить его можно, нажав на кнопку Change.
Рисунок 4. Сохранение документов
-
Группировка шагов в документе. Чтобы повысить удобство работы с документом, можно объединить некоторые шаги в группы. Выберите несколько смежных шагов, а затем выберите Authoring – Group steps. Появится диалоговое окно, в котором можно ввести текст для всей группы; введите имя группы в поле Group Text. После этого выбранный текст будет отображён со сдвигом под заголовком группы (см. рисунок 5).
Рисунок 5. Группировка шагов
-
Аннотация шагов в документе. Аннотация шагов в документе может ещё больше повысить удобство работы с ним. Для добавления аннотации к шагу выберите этот шаг, а затем выберите Authoring – Add/edit comment. Появится диалоговое окно Annotate Step (см. рисунок 6), в которое можно ввести комментарий, предваряющий шаг. Этот комментарий отображается в документе в виде зелёной текстовой строки (см. рисунок 7), нового текста собственно для шага, а также текста во всплывающем контекстном окне, которое появляется во время воспроизведения (см. раздел "Автоматизация документа Personal Wizards", в котором приведён пример такого окна).
Рисунок 6. Добавление аннотации
Рисунок 7. Шаг с добавленной аннотацией в документе
Создание интерактивного руководства с помощью Personal Wizards
После создания с помощью Personal Wizards документа, его можно распространить среди пользователей, чтобы с его помощью они могли бы получать интерактивные указания при выполнении задачи. Для этого нужно выполнить следующие шаги:
- Распространение документа Personal Wizards. Документы Personal Wizards хранятся в ZIP-файлах. Эти файлы хранятся в каталогах, указанных в диалоговом окне Save: это может быть каталог по умолчанию или каталог, выбранный автором документа.
- Загрузка документа Personal Wizards. Документы загружаются с помощью опции Load procedure в меню File.
-
Пошаговое прохождение документа Personal Wizards. После загрузки документа Personal Wizards в интерфейсе появляется вкладка Playback (см. рисунок 8). При нажатии на эту вкладку отображаются кнопки управления воспроизведением на зелёном фоне. Шаг, с которого начнётся воспроизведение, выделен. В нормальном состоянии он помечается жёлтым цветом. Если Personal Wizards не может обнаружить виджет, связанный с этим шагом, шаг выделяется цветом морской волны, а в области статуса в нижней части окна Personal Wizards выводится информация (фиолетовым текстом) об отсутствующем виджете (см. рисунок 9). Если шаг в документе выделен жёлтым, связанный с ним виджет обводится в интерфейсе приложения красным овалом (см. рисунок 10). Такие овалы называются экранными выделениями (on-UI highlights).
Рисунок 8. Вкладка Playback
Рисунок 9. Область статуса
Рисунок 10. Шаг с ассоциацией
Нажмите кнопку Do Single Step, чтобы выполнить выделенный шаг. После завершения шага Personal Wizards автоматически переместит выделение на следующий шаг. При наличии в документе условных операторов (If-операторов) Personal Wizards автоматически оценит их, переместив выделение в соответствующее место в документе.
После завершения последнего шага в процедуре Personal Wizards выведет диалоговое окно с сообщением: "The procedure has completed" (процедура завершена). Нажмите OK.
Автоматизация повторяющихся задач
Помимо пошагового воспроизведения задачи, Personal Wizards также полностью поддерживает автоматизацию. Можно добавить автоматизацию в документ Personal Wizards или создать параметр в документе Personal Wizards.
Автоматизация документа Personal Wizards
Загрузите документ и начните воспроизведение. Для начала автоматизации нажмите кнопку Do all. Начнётся автоматическое выполнение шагов в документе, которой будет происходить до тех пор, пока задача не завершится, либо пока выполнение не остановится на шаге, для которого требуется пользовательский ввод. Такой шаг называют параметрическим, поскольку определённое записанное значение (в нижеприведённом примере это сумма в долларах, которая вводится в поле Total Cash) было сконвертировано в определяемый пользователем параметр. При переходе на шаг, содержащий параметр, интерфейс приложения выводит сообщение, Personal Wizards приостанавливается, ожидая ввода данных пользователем. После выполнения требуемого действия (например, ввода текста или выбора из списка), автоматизированный процесс продолжается.
Создание параметра в документе Personal Wizards
Виджет, указанный на определённом шаге документа, можно сконвертировать в параметр либо во время записи документа, либо позднее с помощью инструмента Edit (который вызывается при нажатии на вкладку Edit, после чего отображаются средства редактирования). Выберите шаг, который нужно сделать параметрическим, нажав на шаг, а затем выбрав Authoring – Parameterize selected step. Появится диалоговое окно Parameterize Step (см. рисунок 11). В поле Step Text определяется то, как шаг описывается внутри документа, и в этом поле изначально показывается автоматически сгенерированное описание. Поле Popup-bubble Text определяет текст, который выводится в определённом контексте в интерфейсе приложения, когда пользователь воспроизводит документ. Переключатель Selection type определяет, разрешается ли пользователю выбирать несколько элементов из списка или только один. Эти две опции доступны только для действий, для которых возможны оба варианта; в противном случае опция Allow Multi-select становится недоступной, как в примере, показанном на рисунке 11.
Рисунок 11. Определение параметра для шага
При завершении редактирования и переходе в другой режим (Stop, Record или Playback) вы увидите то же диалоговое окно, что использовалось для сохранения записей, и вам будет предоставлена возможность сохранить отредактированный документа или отменить все изменения.
В этом разделе мы опишем две других сферы применения Personal Wizards: разработку руководств и отладку приложений Lotus Expeditor.
С помощью Personal Wizards можно создавать руководства, которые помогают пользователю выполнить определённую задачу. При помощи руководства Personal Wizards пользователь действительно выполняет задачу (а не просто имитирует её выполнение), и при необходимости ему даются конкретные указания (а не просто последовательность шагов для выполнения).
Руководства создаются так же, как и все другие документы Personal Wizards. Различие проявляется при воспроизведении. При работе с руководством пользователь просто выполняет шаги, не нажимая кнопку Do single step или Do all. Шаг, который будет выполнен, обозначается в документе выделением, а то, где он будет выполнен, – соответствующим выделением в интерфейсе.
Если пользователь выполнит операцию, не указанную в документе, цвет выделения изменится с жёлтого на малиновый. Это означает, что пользователь сбился с правильного пути. Такое выделение сохранится до тех пор, пока пользователь не выполнит следующий ожидающийся в документе шаг, и после этого цвет выделения снова станет жёлтым.
Данная функция также позволяет пользователю переходить в другую часть документа. Например, документ может содержать некоторые дополнительные шаги, которые пользователь захочет пропустить. При выполнении пользователем шагов из другой части руководства выделение автоматически переходит в этот фрагмент документа.
Отладка приложений Lotus Expeditor
Плагин Personal Wizards можно использовать для отладки клиент-серверных приложений, регистрируя взаимодействия между сервером и клиентом. Personal Wizards создаёт log-файл взаимодействий с отметками времени, который затем можно сравнить с журналами сервера. Более подробную информацию см. в статье: Выявление отказов в корпоративных J2EE-системах: как добиться точности при анализе коренных причин (EN).
В этом разделе мы опишем некоторые продвинутые функции Personal Wizards.
Объединение нескольких записей в один документ
Вы можете столкнуться с ситуацией, когда шаги в документе Personal Wizards не соответствуют среде, в которой в данный момент используется документ. Например, ранее записанная процедура начинается с шага "Double-click on 'Open Customer Session'" (двойной щелчок при открытии пользовательского сеанса). Если пользовательский сеанс уже открыт, опция Open Customer Session недоступна. Вместо неё в интерфейсе приложения отображается опция Close Customer Session (закрыть пользовательский сеанс). В этой ситуации необходимо закрыть существующий пользовательский сеанс, прежде чем открывать сеанс для другого пользователя.
Добавить эту информацию в документ можно, начав новую запись в существующем документе. На рисунке 12 вы видите, что присутствует опция Close Customer Session (а опции Open Customer Session нет).
Рисунок 12. Фрагмент графического интерфейса приложения с изменениями в среде
Для обновления записи необходимо выполнить следующие шаги:
- Загрузите исходный документ.
- Выберите вкладку Record. В результате будет выделен первый шаг (опция "Double-click the 'Open Customer Session'"), как и при воспроизведении документа. Поскольку элемент управления Open недоступен, выделение имеет цвет морской волны.
- Выполните первый шаг задачи, т. е. дважды щёлкните по опции Close Customer Session. Personal Wizards обнаружит, что этот шаг отличается от ожидаемого, и сделает вывод о причине этого различия. Обратите внимание, что в обновлённом документе (показанном на рисунке 13), Personal Wizards определил, что если доступна опция Close Customer Session, нужно выполнять двойной щелчок; в противном случае, необходимо выполнять все шаги первой демонстрации (поскольку в среде для первой демонстрации отсутствовал элемент управления Close Customer Session).
Рисунок 13. Точка принятия решения, созданная Personal Wizards
- Выполните второй шаг задачи – дважды щёлкните по Open Customer Session. Обратите внимание, что документ изменится (см. рисунок 14). Сохраняется только один If-оператор, содержащий Double-click on “Close Customer Session”, а все другие шаги процедуры теперь находятся за пределами If-оператора, так как в обеих демонстрациях содержался шаг "Double-click on 'Open Customer Session'". Personal Wizards делает вывод, что этот шаг, как и все следующие за ним шаги, являются общими для обеих демонстраций. Обратите внимание, что следующий шаг выделяется жёлтым цветом, что означает, что сейчас будет выполняться шаг, который Personal Wizards считает необходимым выполнить.
Рисунок 14. Решение принято, и Personal Wizards снова перешёл в режим интерактивного руководства
- Теперь можно продолжить демонстрацию, выполнив дальнейшие шаги вручную или с помощью элемента управления Do single step, или же завершить её, нажав на вкладку Stop. При нажатии на Stop выводится диалоговое окно Save, как и при записи изначального документа; оно позволяет сохранить изменённый документ (с тем же именем, заменив существующий документ, или с новым), а также отказаться от сохранения новой записи.
Графическое выделение элементов интерфейса (экранные аннотации)
Полезной функцией при создании руководств является возможность привлекать внимание пользователей к некоторым элементам интерфейса приложения. В нижеприведённом примере последними шагами процедуры является перевод курсора на вкладку Account Details и проверка перевода вклада. Этой цели служит всплывающая подсказка, показывающая пользователю, на что смотреть. Мы называем такие подсказки экранными аннотациями. Экранная аннотация состоит из овала вокруг определённого виджета интерфейса приложения, с помощью которого выполняется процедура, и текстового окна с сообщением и кнопкой OK. Текстовое окно и выделяемая область соединяются стрелкой (см. рисунок 15). При выводе экранной аннотации в ходе воспроизведения выполнение останавливается до тех пор, пока пользователь не нажмёт на кнопку OK.
Рисунок 15. Экранная аннотация
Для создания экранной аннотации выполните следующие шаги:
- Выберите шаг, после которого будет отображаться всплывающая подсказка (при воспроизведении сначала выполняется выбранный шаг, а затем выводится аннотация), а затем выберите Authoring – Annotate UI item.
- При перемещении курсора по экрану вокруг различных виджетов будут образовываться красные овалы. Перемещая курсор по экрану, можно выделять различные виджеты. Выделив необходимый виджет (к которому следует добавить аннотацию), нажмите клавишу F1. В любой момент операцию можно отменить, нажав клавишу Esc.
- Появится диалоговое окно Annotate UI item (см. рисунок 16), в котором можно добавить комментарий, который будет отображаться в текстовом окне экранной аннотации. Нажмите OK для создания аннотации или Cancel для отмены операции.
Рисунок 16. Создание экранной аннотации
Плагин Personal Wizards для Lotus Expeditor можно использовать во множестве сценариев, в том числе для записи последовательности операций для создания практических инструкций, повышающих эффективность работы; для создания интерактивных пособий и руководств; а также для отладки приложений Lotus Expeditor. Плагин предоставляет простой интерфейс записи и воспроизведения, а также множество продвинутых функций для создания богатой и мощной интерактивной документации по выполнению конкретных задач.
Научиться
- Оригинал статьи: Using the Personal Wizards plug-in in IBM Lotus Expeditor (EN).
- Прочтите статью developerWorks Lotus: Миграция приложений Eclipse RCP на IBM Lotus Expeditor.
- Прочтите статью developerWorks Lotus: Сквозная интеграция с помощью повсеместной передачи сообщений и микроброкера IBM Lotus Expeditor (EN).
- Прочтите статью developerWorks Lotus: Создание автономного приложения в IBM Lotus Expeditor (EN).
- Прочтите статью developerWorks Lotus: Разработка и развёртывание функционально насыщенных клиентских приложений на настольных компьютерах и мобильных устройствах с помощью IBM Lotus Expeditor V6.1 (EN).
- Прочтите статью developerWorks Lotus: Миграция приложений Eclipse RCP на IBM Lotus Expeditor.
- Прочтите статью developerWorks Lotus: Создание взаимодействующих компонентов для IBM Lotus Expeditor Property Broker.
- Прочтите статью developerWorks Lotus: Разработка OSGi-службы как Web-службы в IBM Lotus Expeditor.
- Прочтите статью developerWorks Lotus: Создание и развертывание простого Web Services Resource в IBM Lotus Expeditor.
- Прочтите публикацию из серии IBM Redbooks: Создание составных приложений в Lotus Expeditor V6.1 (EN).
- Посетите страницу developerWorks, посвящённую Lotus Expeditor (EN).
- Обратитесь к Обучающему помощнику по IBM Lotus Expeditor (EN).
- Посетите страницу документации по IBM Lotus Expeditor (EN).
Получить продукты и технологии
- Загрузите ознакомительную версию IBM Lotus Expeditor V6.1 Toolkit (EN).
Обсудить
Лоренс Бергман (Lawrence Bergman) получил степень кандидата наук по информатике в 1993 г. в Университете Северной Каролины, Чапел Хилл. В следующем году он стал сотрудником Исследовательского центра IBM им. Т. Дж. Уотсона. Им опубликованы работы по визуализации научных данных, взаимодействию человек – компьютер, интеллектуальным пользовательским интерфейсам, мультимедийным базам данных, повсеместному компьютингу и наглядному программированию. В настоящее время он работает над рекомендующими системами.
Витторио Кастелли (Vittorio Castelli) получил степень кандидата наук по электротехнике в 1995 г. в Стэнфордском университете. В этом же году он стал сотрудником Исследовательского центра IBM им. Т. Дж. Уотсона. Им опубликованы работы по компьютерному обучению, статистическому распознаванию образов, сжатию данных, обработке изображений, мультимедийным базам данных, извлечению информации из данных, многомерным индексным структурам, интеллектуальным пользовательским интерфейсам, надёжности компьютерных систем и реконструкции ПО, а также по фундаментальным проблемам теории информации. В настоящее время он работает над обработкой текстов на естественных языках и извлечением информации.