皆さん、こんにちは! @Henrique.GonçalvesDias と私は、[MessageViewer](https://openexchange.intersystems.com/package/IRIS-Interoperability-Message-Viewer?tab=details) の最近のアップデートにおいて、IRIS Interoperability でメッセージを可視化する新しい方法を提案しました。 そのアップデートでは、UML シーケンス図に基づく可視化を提供しようとしました。 詳細は、[前](https://community.intersystems.com/post/visual-trace-and-freedom-choice)の記事をご覧ください。 このようなダイアグラムを描画するために必要な困難な幾何学計算を行えるように、素晴らしい [mermaid](https://github.com/mermaid-js/mermaid) JS オープンソースライブラリを使用しました。 この記事で紹介したいのは、このライブラリの使用方法です。 ここでは、シーケンス図のみに焦点を当てますが、このライブラリでは[非常にたくさん](https://mermaid-js.github.io/mermaid/#/)のことを行えることを忘れないでください。 mermaid では Markdown に着想を得た構文を使用して、ダイアグラムを定義します。 非常に直感的であるため、退屈な文章を長々と書くのではなく、例を紹介したいと思います。
sequenceDiagram Alice->>John: Hello John, how are you? loop Healthcheck John->>John: Fight against hypochondria end Note right of John: Rational thoughts! John-->>Alice: Great! John->>Bob: How about you?mermaid エンジンはこの定義に基づいて、SVG を使って直接 Web ページに以下のダイアグラムをレンダリングします。
この例は mermaid のドキュメントから得たもので、この[オンラインエディター](https://mermaidjs.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoic2VxdWVuY2VEaWFncmFtXG5BbGljZS0-PkpvaG46IEhlbGxvIEpvaG4sIGhvdyBhcmUgeW91P1xubG9vcCBIZWFsdGhjaGVja1xuICAgIEpvaG4tPj5Kb2huOiBGaWdodCBhZ2FpbnN0IGh5cG9jaG9uZHJpYVxuZW5kXG5Ob3RlIHJpZ2h0IG9mIEpvaG46IFJhdGlvbmFsIHRob3VnaHRzIVxuSm9obi0tPj5BbGljZTogR3JlYXQhXG5Kb2huLT4-Qm9iOiBIb3cgYWJvdXQgeW91P1xuQm9iLS0-PkpvaG46IEpvbGx5IGdvb2QhIiwibWVybWFpZCI6eyJ0aGVtZSI6ImRlZmF1bHQifX0)で試すことができます。 色々試すことのできる[構成がたくさん](https://mermaid-js.github.io/mermaid/#/sequenceDiagram)あります。 ご覧の通り、ダイアグラムの定義では、アクターと参加者、相互に送信しているイベントとメッセージを指定するだけです。
また、Web ページにダイアグラムを表示するには、div コンテナにダイアグラムを指定し、mermaid エンジンを初期化してダイアグラムをレンダリングする JS コードのみが必要です。
<div class="mermaid"> sequenceDiagram Alice->>John: Hello John, how are you? loop Healthcheck John->>John: Fight against hypochondria end Note right of John: Rational thoughts! John-->>Alice: Great! John->>Bob: How about you? </div>
mermaid.initialize({ startOnLoad: true, theme: 'forest' });この例は、こちらの[フィドル](https://jsfiddle.net/jrpereirajr/71Lm2nsx/)にあります。 これは、提案された作業のフロントエンドベースです。 バックエンドでは、IRIS 相互運用性セッションからメッセージを取得し、適切な JSON オブジェクトにフォーマットしてフロントエンドに送り返す REST エンドポイントを設定する必要があります。 この記事の焦点はフロントエンドのコードであるため、バックエンドの実装には触れませんが、[dispatch](https://github.com/diashenrique/iris-message-viewer/blob/2bfab2c687f2fe53cd3ddda160ad76c139715486/src/cls/diashenrique/messageviewer/REST/Dispatch.cls#L11) と [service](https://github.com/diashenrique/iris-message-viewer/blob/master/src/cls/diashenrique/messageviewer/REST/Diagram.cls) クラスでこれを確認できます。 バックエンドは、以下のような JSON を送り返します。
{ "participants":[ "diashenrique.messageviewer.Service.SendMessage", "diashenrique.messageviewer.Operation.ConsumeMessageClass" ], "messages":[ { "id":"1182", "from":"diashenrique.messageviewer.Service.SendMessage", "to":"diashenrique.messageviewer.Operation.ConsumeMessageClass", "message":"2021-10-05 03:16:56.059 SimpleMessage" }, { "id":"1183", "from":"diashenrique.messageviewer.Operation.ConsumeMessageClass", "to":"diashenrique.messageviewer.Service.SendMessage", "message":"2021-10-05 03:16:56.06 NULL" } ] }最後に、簡単な JS 関数を使用して、この JSON を mermaid シーケンス図の仕様に合わせて以下のように変換します。
sequenceDiagram autonumber participant P0 as diashenrique.messageviewer.Service.SendMessage participant P1 as diashenrique.messageviewer.Operation.ConsumeMessageClass P0->>P1: 2021-10-05 03:16:56.059 SimpleMessage P1->>P0: 2021-10-05 03:16:56.06 NULL
そして、これがレンダリングされたシーケンス図です。
完全な JS コードは[こちら](https://github.com/diashenrique/iris-message-viewer/blob/master/src/csp/resources/js/diagram.js)で確認できます。 以上です。 この記事があなたの素晴らしいプロジェクトにいくらかでも役立てられれば幸いです。 それではまた!