Модуль в этой статье: iFlow Docs
Документация Message Mapping в SAP CPI: таблица маппинга в Excel одним щелчком
Как документировать Message Mapping в SAP CPI в виде таблицы маппинга: какие столбцы важны, как описывать функции и контексты и как экспортировать таблицу в Excel.
Спецификация маппинга обычно первый документ интерфейса и первый, который устаревает. Message Mapping в SAP Cloud Integration (SAP CPI) меняется во время разработки и тестов, а таблица, которая его описывала, остаётся прежней.
В этой статье описаны столбцы, которые нужны таблице маппинга, как описывать функции, контексты и value mapping так, чтобы читатель мог их проследить, и как экспортировать таблицу из самого маппинга.
Почему спецификации маппинга расходятся с реальностью
Спецификацию маппинга пишет до появления самого маппинга человек, который знает бизнес-поля. Затем разработчик обнаруживает, что полю нужна смена контекста, дате — другой формат, а коду — value mapping. Каждое из этих решений живёт в графическом представлении редактора маппинга, и мало какие из них возвращаются в таблицу.
Какие столбцы нужны таблице маппинга
| Столбец | Что в нём |
|---|---|
| Целевое поле | Полный путь поля в целевом сообщении |
| Кратность | Сколько раз оно может встречаться, например 0..1 или 1..unbounded |
| Исходные поля | Исходные пути, из которых берётся значение |
| Правило | Логика простыми словами |
| Функции | Использованные стандартные функции, например concat, if или formatByExample |
| Константы | Фиксированные значения, записанные в маппинге |
| UDF | Пользовательские функции и что они делают |
| Value Mapping | Коды, преобразуемые через value mapping |
| Примечания | Смены контекста и всё, что должен знать тестировщик |
Как описывать функции, контексты и value mapping
- Записывайте правило предложением: «объединяет FirstName и LastName через пробел» проверить проще, чем список имён функций.
- Называйте контекст, когда он меняется. Поле, заполняемое один раз на позицию, ведёт себя иначе, чем поле, заполняемое один раз на документ, и большинство ошибок маппинга прячется именно здесь.
- Для value mapping указывайте агентства и идентификаторы, чтобы тестировщик знал, в какой таблице искать.
- Для пользовательской функции пишите, что и когда она возвращает, а не как она написана.
Экспортируйте таблицу из маппинга
- Откройте iFlow в дизайнере, нажмите кнопку «Инструменты Kitegra» и выберите «Документировать этот iFlow».
- На странице «Документ iFlow» откройте «Таблица маппинга». Она перечисляет Message Mapping этого iFlow, по одной строке на целевое поле, со столбцами, описанными выше.
- Скачайте её как книгу Excel с одним листом на каждый маппинг.
- Без дизайнера выберите вместо этого «Загрузить маппинги (.mmap или ZIP)». Загруженный файл не учитывается в iFlow вашего тарифа.
Таблица строится по файлу маппинга, поэтому показывает, что маппинг делает сегодня. Читайте её вместе с техническим проектным документом, созданным из того же iFlow.
Проверьте таблицу перед передачей
- Сравните несколько строк с тестовым сообщением: исходное значение, правило, целевое значение.
- Запустите iFlow с TRACE и прочитайте тело до и после шага маппинга, как описано в статье о пошаговой трассировке сообщения.
- Заполните столбец «Примечания» там, где читателю нужно больше, чем правило: почему поле константное, какая система владеет справочником кодов.
Чем помогает Kitegra
Таблица маппинга — часть области iFlow Docs в Kitegra. Она строится в вашем браузере; маппинги никогда не отправляются в Kitegra.
Helper, Message Monitor, iFlow Inspector и iFlow Docs по отдельности считают iFlow, на которых вы их используете: 5 на модуль без аккаунта Kitegra, 50 на тарифе Free, 100 на Starter и 300 на Pro; в Business ограничений нет. Toolbox и дополнения для рабочего пространства бесплатны. Сравните тарифы.
Попробуйте в следующем iFlow
Узнайте, что Kitegra добавляет к дизайнеру SAP Integration Suite, или посмотрите его рядом с другими расширениями Kitegra для Chrome.
Частые вопросы
Как документировать Message Mapping в SAP CPI?
В виде таблицы маппинга с одной строкой на целевое поле: целевой путь, кратность, исходные поля, правило словами, функции, константы, UDF, value mapping и примечания.
Можно ли экспортировать Message Mapping в Excel?
Да. На странице «Документ iFlow» «Таблица маппинга» скачивается как книга Excel с одним листом на каждый маппинг.
Можно ли документировать маппинг без дизайнера?
Да. Загрузите файл .mmap или ZIP с маппингами; загрузка не учитывается в iFlow вашего тарифа.
Объясняет ли таблица пользовательские функции?
Она перечисляет UDF, которые использует каждое поле. Что UDF делает в бизнес-терминах, стоит описать строкой в столбце «Примечания».
Отправляются ли мои маппинги в Kitegra?
Нет. Таблица строится в вашем браузере, и маппинги никогда не отправляются.