SAP CPI の Deploy のあとに：デプロイ監視、パッケージのドキュメント、システム全体図、Excel の Value Mapping

SAP Cloud Integration（SAP CPI）で Deploy を押すと、待ち時間が始まります：Monitor に切り替え、iFlow を探し、Started か Error になるまで更新を続け、そのエラーが何を意味するのかを読み解く。そしてインターフェースが完成すると、今度は誰かがドキュメントとシステム全体図、そしてスプレッドシートにした Value Mapping を求めてきます。

Kitegra は、SAP Integration Suite のデザイナーのすぐ横で、この部分の作業も引き受けるようになりました：テスト呼び出し付きのデプロイ監視、Edge Integration Cell のある tenant 向けのランタイムの選択、新しい設計チェック、システム全体図とドキュメントの準備状況を含むパッケージのドキュメント、Excel の Value Mapping シート、そして Groovy スクリプトのわかりやすい説明です。どのツールも個別にオフにできます。この記事で順に紹介します。

デプロイ監視：iFlow を離れずに Started か Error かを知る

いつもどおりデザイナーで Deploy を押し、SAP のダイアログで確定します。「デプロイ中…」と経過時間を示すデプロイの通知が表示され、そのまま作業を続けられます。Kitegra は 3 秒後に SAP に状態を問い合わせ、その後は間隔を広げながら、最長でも 20 秒ごとに確認します。SAP が応答すると、通知は次のように変わります。

• Started：デプロイされたバージョンと一緒に表示されます。iFlow に HTTP エンドポイントがあれば、テスト呼び出しを送信でリクエストの準備が整った HTTP Runner が開き、最新のメッセージを表示で最新の状態のメッセージパネルが開きます。
• エラー：SAP のエラーテキストに加え、既知のケースなら、それが通常何を意味するかを表示します：別のデプロイ済み iFlow がすでにその送信者アドレスを使っている、スクリプトがコンパイルできない、外部化パラメーターに値がない、または SAP が iFlow をビルドできなかった、などです。SAP でデプロイ済みコンテンツを開くで詳細に移動します。
• まだデプロイ中：10 分経っても終わらないときに、SAP のデプロイ済みコンテンツへの案内とともに表示されます。

SAP の Deploy ダイアログをキャンセルした場合は、何も監視しません。監視はデプロイの状態を読むだけです。デプロイそのものは、あなた自身のクリックで始まる SAP の処理です。その後、メッセージが iFlow をどう通ったかを追う方法はメッセージをステップごとにトレースするで、呼び出し自体についてはサービスキーで HTTPS の iFlow をテストするで説明しています。

ランタイムの選択：Cloud か Edge か

Edge Integration Cell のある tenant では、iFlow が複数のランタイムで動きます。そうした tenant でだけ、Kitegra のボックスにランタイム: Cloud（または Edge ランタイムの名前）が表示されます。そこでランタイムを選ぶと、Message Monitor はそのランタイムでこの iFlow のメッセージを読み、ログレベルを設定します。選択欄には、各ランタイムにデプロイされているかどうかと、そのバージョンも表示されます。ランタイムが 1 つだけの tenant には表示されません。

iFlow Inspector の新しい設計チェック

iFlow レビューのチェックリストに 5 つのチェックが加わり、新しく「ドキュメント」カテゴリーができました。

ほかのチェックと同じく、スコアに反映され、1 つずつオフにできます。表示は無料で、レポートのエクスポートは Pro に含まれます。Externalize Parameters やほかの新しい Helper のツールについては、Externalize Parameters、ステップのコピー、Hub からのインポートで説明しています。

パッケージ全体のドキュメント

Kitegra メニューのこの iFlow をドキュメント化の隣に、パッケージのドキュメントが加わりました。開いている iFlow のパッケージに含まれるすべての iFlow を 1 つずつ読み込み（「iFlow を読み込み中（2 / 5）…」）、途中で止めて、そこまで読んだ分を開くこともできます。読み込めなかった iFlow は一覧で示されます。ドキュメントは新しいタブで開き、Word、PDF、HTML のほか、自分の Word テンプレートに流し込むこともできます。1 つの iFlow の技術設計書と同じです。内容は、パッケージのバージョン、ベンダー、タグ、iFlow の数、続いて各 iFlow、そして 2 つの新しいパートです。

• システム全体図：左に送信者、中央にパッケージの iFlow、右にレシーバーを置いたダイアグラムです。同じ名前の参加者は 1 つのボックスにまとめられ、各線にはアダプターの種類が付きます。
• ドキュメントの準備状況：読み手に必要なものを 1 つずつ確認します：パッケージの説明とタグ、各 iFlow の説明、Sender や Receiver から名前を変えた参加者、外部化されたレシーバーのアドレス。合格したチェックの数と足りないものを示すので、引き渡す前に抜けを埋められます。

Excel にする Value Mapping

iFlow Docs のページの Value Mapping で、Value Mapping の ZIP（SAP のパッケージからダウンロード）またはその value_mapping.xml をアップロードします。Kitegra は値を一覧表示し、エージェンシーと識別子のペアごとに 1 シートの Excel ブックを書き出します：ソースのエージェンシー、識別子、値、続いてターゲットのエージェンシー、識別子、値です。ファイルはブラウザーの中で読み込まれ、SAP から何かを読むことも、どこかへ送ることもありません。マッピングについては、Message Mapping のシートが同じように使えます。

スクリプトをわかりやすく説明

Kitegra メニューのスクリプトの説明は、iFlow のすべての Groovy スクリプトのステップを一覧表示します。それぞれについて、作者の要約コメント、定義している関数、読むもの（ボディ、ヘッダー、交換プロパティ、添付ファイル）、設定・変更するもの、主なロジック（XML や JSON の解析・生成、ループ、条件分岐、HTTP 呼び出し、日付）、Security Material、Value Mapping、Partner Directory などの使っている SAP の API、そして注意点とリスクを表示します。ステップ名をクリックすると、ダイアグラム上でそのステップが選択されます。説明はブラウザーの中でスクリプトのテキストから組み立てられ、スクリプトがどこかへ送られることはありません。

使わないツールはオフに

オプションページにツールセクションが加わり、すべてのツールにスイッチがあります。ツールはモジュールごとにまとめられています：Helper の XPath の確認、整列、Security Material、Externalize、ステップのコピー、Hub からのインポートから、メッセージ、ランタイムの選択、ログビューアー、デプロイ監視、iFlow の情報、Inspector と検索、ドキュメントとスクリプトの説明、そして Toolbox のメモ、スニペット、比較、変換、生成、HTTP Runner までです。オフにしたツールはデザイナーとポップアップからすぐに消えます。データは残り、すべてオンですべてが戻ります。モジュール全体をオフにするには、同じページの「モジュール」を使います。オプションページをご覧ください。

デプロイ監視、ランタイムの選択、スクリプトの説明、設計チェックの表示は無料です。パッケージのドキュメント、システム全体図、Value Mapping のシートは iFlow Docs に含まれ、Free と Starter でも数回使えます。Kitegra のローンチ期間中は、サインインしているすべての人がすべてのツールを使えます。プランを比較する。

次の iFlow で試してみましょう

Kitegra が SAP Integration Suite のデザイナーに何を加えるのか、または iFlow を書くための新しいツールを読んでみてください。

よくある質問