Модуль в этой статье: iFlow Docs
После Deploy в SAP CPI: отслеживание развёртывания, документ пакета, ландшафт и Value Mapping в Excel
Узнайте, когда iFlow перешёл в Started или почему он упал, выберите среду Cloud или Edge, запустите новые проверки дизайна, задокументируйте весь пакет с ландшафтом, выгрузите Value Mapping в Excel и выключите любой инструмент.
Нажатие Deploy в SAP Cloud Integration (SAP CPI) запускает ожидание: переключиться в Monitor, найти iFlow, обновлять, пока не появится Started или Error, а потом разбираться, что означает ошибка. А когда интерфейс готов, кто-нибудь обязательно попросит документ, схему ландшафта и Value Mapping в электронной таблице.
Теперь Kitegra берёт на себя и эту часть работы рядом с дизайнером SAP Integration Suite: отслеживание развёртывания с тестовым вызовом, выбор среды выполнения для tenant с Edge Integration Cell, новые проверки дизайна, документ пакета со схемой ландшафта и готовностью документации, лист Value Mapping в Excel и объяснение скриптов Groovy простыми словами. Каждый инструмент можно выключить отдельно. В этой статье разберём их по порядку.
Отслеживание развёртывания: Started или ошибка, не покидая iFlow
Нажмите Deploy в дизайнере как обычно и подтвердите диалог SAP. Появится уведомление Развертывание с надписью «Развертывание…» и прошедшим временем, а вы продолжаете работать. Kitegra запрашивает у SAP состояние через три секунды, затем всё реже, но не реже чем раз в 20 секунд. Когда SAP отвечает, уведомление превращается в:
- Started с развёрнутой версией. Если у iFlow есть конечная точка HTTP, Отправить тестовый вызов открывает HTTP Runner с готовым запросом, а Показать последнее сообщение заново открывает панель сообщений.
- Ошибка с текстом ошибки SAP и, если случай известен, тем, что он обычно означает: другой развёрнутый iFlow уже использует адрес отправителя, скрипт не компилируется, у внешнего параметра нет значения или SAP не смог собрать iFlow. Открыть развернутое содержимое в SAP ведёт к подробностям.
- Всё ещё развертывается — через десять минут, со ссылкой на развёрнутое содержимое в SAP.
Если вы отменили диалог Deploy в SAP, ничего не отслеживается. Отслеживание только читает состояние развёртывания; само развёртывание выполняет SAP, а запускает его ваш собственный щелчок. Как затем проследить сообщение через iFlow, описано в статье трассировка сообщения шаг за шагом, а сам вызов — в статье тестирование HTTPS iFlow с ключом сервиса.
Выбор среды выполнения: Cloud или Edge
Tenant с Edge Integration Cell выполняет iFlow более чем в одной среде. Только на таком tenant в блоке Kitegra отображается Среда выполнения: Cloud (или имя среды Edge). Выберите там среду, и Message Monitor будет читать сообщения этого iFlow и задавать его уровень журналирования именно в ней. Выбор также показывает, развёрнут ли iFlow в каждой среде и какой версии. На tenant с одной средой выполнения его не видно.
Новые проверки дизайна в iFlow Inspector
В чек-листе ревью iFlow появились пять проверок и новая категория «Документация»:
| Проверка | Почему это важно |
|---|---|
| Получатель без адреса (ошибка) | iFlow развёртывается, но каждый вызов этого получателя завершается ошибкой во время выполнения. |
| Отправитель HTTPS с адресом по умолчанию (предупреждение) | Пустой адрес, / или заглушка вроде /test ничего не говорят вызывающим, и два iFlow могут на нём столкнуться. |
| Отправитель HTTPS ожидает CSRF-токен (информация) | Каждый вызывающий должен сначала получить X-CSRF-Token, иначе его POST получит 403. |
| Адрес получателя записан в iFlow (информация) | Перенос между DEV, QA и PROD означает правку iFlow; Externalize Parameters исправляет это за один шаг. |
| Участник с именем по умолчанию (информация, Документация) | «Sender» и «Receiver» видны и в мониторинге, так что никто не поймёт, о какой системе речь. |
Как и остальные проверки, они учитываются в оценке и отключаются по одной. Просмотр бесплатен; экспорт отчёта входит в Pro. Externalize Parameters и другие новые инструменты Helper описаны в статье Externalize Parameters, копирование шагов и импорт из Hub.
Документ для всего пакета
Рядом с пунктом Документировать этот iFlow в меню Kitegra теперь есть Документ пакета. Он по очереди читает каждый iFlow пакета, в котором находится открытый iFlow («Чтение iFlow 2 из 5…»), и его можно остановить и открыть то, что уже прочитано. iFlow, которые прочитать не удалось, перечисляются. Документ открывается в новой вкладке — в Word, PDF или HTML либо в вашем собственном шаблоне Word, как и технический проектный документ одного iFlow. В нём версия пакета, поставщик, теги и число iFlow, затем каждый iFlow и две новые части:
- Ландшафт систем: диаграмма с отправителями слева, iFlow пакета посередине и получателями справа. Участники с одинаковым именем объединяются в один блок, и на каждой линии указаны типы адаптеров.
- Готовность документации: по пунктам проверяется то, что нужно читателю: описание и теги пакета, описание каждого iFlow, участники, переименованные из Sender и Receiver, и вынесенные в параметры адреса получателей. Видно, сколько проверок пройдено и чего не хватает, — можно закрыть пробелы до передачи.
Value Mapping в Excel
На странице iFlow Docs в разделе Value Mapping загрузите ZIP Value Mapping (скачайте его из пакета в SAP) или его value_mapping.xml. Kitegra покажет значения и создаст книгу Excel с отдельным листом для каждой пары агентство и идентификатор: исходное агентство, идентификатор и значение, затем целевое агентство, идентификатор и значение. Файл читается в вашем браузере; из SAP ничего не считывается, и ничего никуда не отправляется. Для маппингов так же работает лист Message Mapping.
Скрипты простыми словами
Объяснение скриптов в меню Kitegra перечисляет все шаги скриптов Groovy в iFlow. Для каждого показаны итоговый комментарий автора, определённые функции, что скрипт читает (тело, заголовки, свойства обмена, вложения), что задаёт и меняет, основная логика (разбор или построение XML или JSON, циклы, условия, HTTP-вызовы, даты), используемые API SAP, например Security Material, Value Mapping или Partner Directory, а также заметки и риски. Щёлкните имя шага, чтобы выделить его на диаграмме. Объяснение строится по тексту скрипта в вашем браузере; скрипт никуда не отправляется.
Выключите инструменты, которыми не пользуетесь
На странице параметров теперь есть раздел Инструменты с переключателем для каждого инструмента, сгруппированным по модулям: от проверки XPath, упорядочивания, Security Material, Externalize, копирования шагов и импорта из Hub в Helper, через сообщения, выбор среды выполнения, просмотрщик журналов и отслеживание развёртывания, сведения об iFlow, Inspector и поиск, документы и объяснение скриптов — до заметок, сниппетов, сравнения, конвертации, генерации и HTTP Runner в Toolbox. Выключенный инструмент сразу исчезает из дизайнера и всплывающего окна; ваши данные сохраняются, а Включить все возвращает всё обратно. Чтобы выключить модуль целиком, используйте «Модули» на той же странице; см. страницу параметров.
Отслеживание развёртывания, выбор среды выполнения, объяснение скриптов и просмотр проверок дизайна бесплатны. Документ пакета, ландшафт и лист Value Mapping относятся к iFlow Docs, на Free и Starter доступно несколько использований. Пока Kitegra запускается, все инструменты открыты для всех, кто вошёл в аккаунт. Сравните тарифы.
Попробуйте в следующем iFlow
Узнайте, что Kitegra добавляет к дизайнеру SAP Integration Suite, или посмотрите новые инструменты для написания iFlow.
Частые вопросы
Kitegra развёртывает мой iFlow?
Нет. Deploy в SAP нажимаете вы; отслеживание развёртывания только читает его состояние и сообщает, когда iFlow перешёл в Started или завершился ошибкой.
Как задокументировать весь пакет SAP CPI?
Откройте любой iFlow пакета и выберите «Документ пакета» в меню Kitegra. Он прочитает каждый iFlow и откроет один документ со схемой ландшафта и готовностью документации — в Word, PDF или HTML.
Можно ли выгрузить Value Mapping в Excel?
Да. Скачайте ZIP Value Mapping из его пакета в SAP и загрузите его на странице iFlow Docs. Вы получите по листу на каждую пару агентство и идентификатор; файл не покидает ваш браузер.
Почему я не вижу выбора среды выполнения?
Он появляется только на tenant с несколькими средами выполнения, например Cloud плюс Edge Integration Cell.
Если выключить инструмент, удалятся ли мои данные?
Нет. Инструмент исчезает из дизайнера и всплывающего окна, а его данные остаются. Включите его снова в разделе «Инструменты» на странице параметров.