Kitegra 2.0: автодополнение, трассировка сообщений, iFlow Inspector и документация для SAP CPI

Когда вы строите iFlow в дизайнере SAP Integration Suite, из него приходится постоянно уходить: в монитор — посмотреть, что произошло с сообщением, в таблицу — за спецификацией маппинга, в другой инструмент — вызвать эндпоинт, к коллеге — спросить, какое правило именования действует. Kitegra — расширение для Chrome и Edge, которое переносит эту работу прямо к схеме, которую вы редактируете.

В версии 2.0 один модуль вырос до пяти областей. В этой статье — что делает каждая из них, что и когда расширение меняет в вашем tenant, что оно хранит и синхронизирует и сколько iFlow входит в каждый тариф. Это одно из расширений Kitegra для Chrome.

Пять областей вокруг дизайнера iFlow

Откройте iFlow — и на панели инструментов схемы появится блок Kitegra, и в режиме просмотра, и в режиме редактирования. У «Сообщений», «Журналов» и «Сведений об iFlow» в нём есть собственные кнопки; все остальные инструменты находятся в меню за последней кнопкой, а с клавиатуры это меню открывает Alt+Shift+P. Каждый инструмент открывает панель, которую можно перемещать по странице. Инструменты относятся к пяти областям:

• Helper (Integration Flow Helper): быстрее писать iFlow с подсказками и проверками прямо в полях дизайнера.
• Message Monitor: сообщения, трассировка и журналы открытого iFlow прямо в дизайнере.
• iFlow Inspector: сведения о развёрнутом iFlow, проверки имён и дизайна, поиск.
• iFlow Docs: документы, созданные из iFlow или Message Mapping.
• Toolbox (в интерфейсе — «Инструменты»): бесплатные инструменты для сравнения, преобразования и генерации payload, сниппеты, заметки и HTTP-запросы.

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

Helper: быстрее писать iFlow

Введите ${ или $ в поле дизайнера — откроется список имён, подходящих для этого места iFlow. Остальные функции Helper опираются на ту же модель вашего iFlow:

• Подсказки: headers и exchange properties, которые задаёт ваш iFlow, стандартные headers SAP и Camel, параметры {{…}}, переменные, Data Store, а также имена Security Material и Keystore в полях учётных данных.
• Проверка выражений: незакрытые выражения, лишние пробелы, headers, которые ничто не задаёт до текущего шага, и имена OData, которых нет в EDMX.
• Источники: пути XPath из примера payload, URL и тела из файла OpenAPI, Swagger или Postman, а также headers, передаваемые через ProcessDirect и JMS.
• Упорядочить диаграмму: в режиме редактирования одним щелчком приводит схему в порядок; Save сохраняет результат, а кнопка отмены рядом возвращает как было.

Шесть предыдущих статей разбирают это подробнее, начиная с выражений Camel Simple в SAP CPI.

Message Monitor: что произошло

• Сообщения: последние сообщения открытого iFlow на панели рядом со схемой — со статусом, временем и длительностью, а ошибка SAP поясняется под заголовком «Что это обычно значит:».
• Trace: один переключатель ставит уровень журнала iFlow на TRACE и держит его, пока вы работаете.
• На схеме: шаги, которые прошло трассированное сообщение, окрашиваются на схеме, а щелчок по шагу показывает тело, headers и exchange properties перед ним.
• Журналы сообщений: просмотр журналов с поиском по Message ID или Correlation ID, хронология связанных сообщений и время шагов на схеме.

Весь процесс показан в статье о пошаговой трассировке сообщения.

iFlow Inspector и iFlow Docs: ревью и документация

• Именование: правила, о которых договорилась команда, проверяются на каждом шаге, с предложенным именем и кнопкой «Переименовать».
• Проверки дизайна: обработка ошибок, секреты в открытом виде, небезопасные протоколы, риски в скриптах и многое другое, с баллом от 0 до 100, базовой линией и отчётом в HTML, PDF или Excel. Их перечисляет чек-лист ревью iFlow.
• Сведения об iFlow: развёртывание, конечные точки, записи Data Store, переменные и блокировка редактирования, а также Undeploy, Unlock и «Удалить», когда они нужны.
• Поиск по iFlow или по всему его пакету.
• Проектный документ, созданный из iFlow, в Word, PDF или HTML — со схемой и описанием каждого процесса — или заполненный в ваш собственный шаблон Word. См. создание технического проектного документа.
• Таблица маппинга в Excel для Message Mapping и объяснение скриптов.

Toolbox и рабочее пространство

• Сравнение payload, конвертер форматов, генератор тестовых payload с ошибками (faults), сниппеты Groovy и шпаргалка, а также заметки для iFlow, для tenant или общие.
• HTTP Runner для эндпоинтов ваших iFlow с OAuth из сервисного ключа Process Integration Runtime.
• Панель окружения (PROD, TEST, DEV) и оформление вкладок для каждого tenant, ссылки на мониторинг, сочетания клавиш и размер панели свойств.

Интерфейс доступен на 15 языках, в светлой и тёмной теме.

С чего начать: по шагам

1. Добавьте Kitegra в Chrome или Microsoft Edge.
2. Откройте iFlow в дизайнере SAP Integration Suite на своём tenant (адрес вида *.hana.ondemand.com).
3. Щёлкните в поле, например в значении Content Modifier, и введите ${ или $; выберите имя из списка.
4. В блоке Kitegra на панели инструментов схемы нажмите «Сообщения», «Журналы» или «Сведения об iFlow» либо откройте его меню, чтобы перейти к «Инспектору» и другим инструментам.
5. Откройте всплывающее окно расширения — там ваши tenants, пакеты и iFlow, а также вид «Инструменты» со страницами Toolbox.

Без аккаунта каждым модулем можно пользоваться на 5 iFlow. Чтобы использовать модули на большем числе iFlow, выберите в расширении Войти через Kitegra.

Попробуйте в следующем iFlow

Посмотрите Kitegra рядом с другими расширениями Kitegra для Chrome и сравните, что входит в каждый тариф.

Что расширение меняет в вашем tenant и когда

Расширение читает открытый iFlow, его сообщения и журналы через вашу собственную сессию SAP. Оно никогда не сохраняет, не развёртывает и не редактирует содержимое iFlow: «Переименовать» и сниппеты только вводят текст в поля дизайнера, а сохраняете вы сами. Tenant меняется только тогда, когда вы нажимаете одно из четырёх названных действий:

Один переключатель на странице параметров, «Разрешить действия, изменяющие тенант», выключает все четыре: их кнопки исчезают, а расширение отказывается их выполнять. HTTP Runner отправляет только те запросы, которые вы сами пишете и отправляете.

Что хранится и что синхронизируется

• Содержимое сообщений (тела, headers, свойства, вложения и журналы) показывается на странице и никогда не сохраняется и никуда не отправляется.
• Без аккаунта Kitegra ничто не покидает ваш браузер.
• После входа Kitegra хранит для каждого открытого вами iFlow его имя и id, пакет, ссылку на дизайнер, использованные модули, даты и односторонний хеш вашего аккаунта SAP, чтобы считать iFlow вашего тарифа.
• После входа то, что вы написали, доступно на любом компьютере: настройки и сочетания клавиш, заметки, правила именования, настройки и базовые линии проверок дизайна, оформление tenant, сниппеты и коллекции HTTP Runner, из которых удалены все значения авторизации и секретные переменные. Если на странице параметров включён переключатель «Панель управления Kitegra» (по умолчанию он включён), отправляются также названия и id ваших пакетов и iFlow, а на командном тарифе их и ваши заметки видит владелец команды.
• Никогда не отправляется: содержимое сообщений, скрипты, маппинги, примеры payload, спецификации API, учётные данные и секреты. В разделе «Параметры › Синхронизация» кнопка «Удалить синхронизированные данные» удаляет из Kitegra всё синхронизированное.

Сколько iFlow входит в каждый тариф

Лимит считает разные iFlow, отдельно для каждого модуля, бессрочно: повторное открытие уже использованного iFlow не засчитывается ещё раз, а iFlow, использованный в одном модуле, засчитывается в другом, только когда вы используете на нём и этот модуль.

Helper, Message Monitor, iFlow Inspector и iFlow Docs считают iFlow; Toolbox и дополнения для рабочего пространства их не учитывают. iFlow сверх лимита тарифа отмечается замком в дизайнере и во всплывающем окне. Пока Kitegra запускается, все инструменты открыты для всех, кто вошёл в аккаунт, в том числе на тарифе Free. При входе через Kitegra iFlow, которые вы использовали без аккаунта, переносятся в ваш аккаунт. Сравните тарифы.

Частые вопросы