OutSystems　逆引き（トラブルシュート）

OutSystemsで実現したいことから、実装方法を調べられるようにすることを企図したカテゴリ。各種ファイル操作について。

このカテゴリは、記述すべきことを思いつく度に更新します。

OutSystemsアプリケーション内で発生した問題に対処する方法。

モジュールをファイルに出力する

Forumなどで質問する際に、実装を確認するためにモジュールをファイル形式で提供するよう求められることがあります。

IPPが効いている環境から出力したファイルは、他の（ライセンスが違う）環境にはそのままインストールできません（Forgeを経由すれば別）。

Service Studio

Moduleメニュー > Export > Save or Save As

omlという形式で保存される。

Integration Studio

Extensionをファイルにエクスポートする方法。

Integration StudioでExtensionを開く。

Fileメニュー > Save or Save As

出力ファイル形式はxif。

実行時の動作を調査する

作成したアプリケーションを実際に動作させ、動作の様子を観察することによって問題を発見する方法。

デバッグでローコード部分のロジックを調査する

最も基本となる調査方法。Service Studioを調査対象のモジュールに接続し、Action Flow上でロジックが流れていくのを確認し、同時にその時点での変数の値を確認できる。

実行方法は公式ドキュメント（アプリケーションをデバッグする）を参照。

注意点として、一般のプログラミング言語・環境では、デバッグ中に変数の値を書き換える方法があるが、OutSystemsにはない。

Producerモジュールのデバッグをする

ユーザーのリクエストを直接受け付けるモジュール以外（Producerモジュール）をデバッグするには、1手間追加する必要があります。

例えばA, Bというモジュールがあり、A->Bの順でActionを呼び出して使っているとします。このとき、Bモジュールをデバッグするには、

Service StudioでBモジュールを開く
画面下部の「Debuggerタブ」を開く
Debuggerタブ内の「Entry Module」からAを選択する
「START DEBUGGING」ボタンをクリックしてデバッグを開始する

ブラウザからサーバに送られる通信内容を確認する

ブラウザとサーバーの境界で問題が発生しているときは、通信内容を確認することで調査を進められることがあります。

Traditional Web: SubmitやAjax Submitするときに通信内容を確認する

Reactive Web App: Client ActionからServer Action等を呼び出すときの通信内容を確認する

また、JavaScriptをラップした部品を使っている場合、JavaScriptやCSSのファイルを想定通りに読み込めているかを確認することが役立つこともある。

手軽な方法としては、ブラウザの開発者ツールを起動（F12キー）し、そのネットワークタブを開いたままアプリケーションを操作すると、その間の通信を確認できます。

以下の例は、Reactive Web AppをChromeの開発者ツールでキャプチャしたもの。CheckRoleWithServer というServer ActionをInput Parameter無しでリクエストしたときの通信。このようにパラメータ・結果のHTTPステータス・戻り値等を確認できる。

あるいは、Fiddlerのような通信をキャプチャしてくれるソフトウェアを利用する方法もあります。

モバイルアプリケーションの実機デバッグ

端末にインストールしたアプリケーションをService Studioに接続してデバッグできます。

参考：

モバイルアプリケーションでトラブルシューティングする方法のまとめ　のChrome/Service Studio/Android Studioと実機を接続してのデバッグ

ログを確認する

内容が多いので、別の記事に記述予定

Forgeコンポーネント

Forgeコンポーネントもまた、OutSystemsのアプリケーション・モジュールであるため、一般的な調査方法は通常のOutSystemsモジュールと変わりません。

ただし、インストールしたForgeコンポーネントのバージョンが最新でないことによってドキュメントや掲示板の前提バージョンと異なることがあります。

インストールされているForgeコンポーネントのバージョンを調べる方法として、

Forge Components Installed Versions (別のForgeコンポーネント) で確認
Merge/Compareの機能を使って手動で特定する

があります。

参考：

Forgeコンポーネントのバージョン問題