知っておきたい!IM-LogicDesignerのデバッグ方法

公開日: 2024-04-01 / カテゴリ: IM-LogicDesigner

この記事では、IM-LogicDesignerでロジックフローやマッピングの動作を確認する方法を紹介します。

IM-LogicDesignerでは、保存したロジックフローをデバッグして、処理の動作や結果を確認できます。マッピングの値やロジックフローの処理過程を確認したり、デバッグログから実行時の詳細な情報を確認したりできます。確認したい内容に応じて、デバッグ方法を使い分けましょう。

IM-LogicDesignerのデバッグ方法

IM-LogicDesignerでは、ロジックフローを保存した後、次の方法で動作を確認できます。

ここでは、それぞれのデバッグ方法について説明します。

マッピングのデバッグ

マッピングのデバッグでは、マッピングに入力値を設定して実行し、期待した出力値が得られるかを確認します。

たとえば、次のような場合に利用できます。

  • マッピングした値が期待した値にならない
  • 複雑なマッピングで、値がどのように受け渡されているか確認したい
  • 異なるデータ型や配列を含むマッピングが、期待した結果になるか確認したい
  • マッピング関数による値の変換結果を確認したい

マッピング設定に問題がある場合は、ロジックフロー全体を実行する前にマッピング単位で確認することで、問題のある箇所を切り分けやすくなります。

マッピングをデバッグする

マッピングのデバッグ機能と実行方法について確認できます。マッピングの設定画面からデバッグを実行し、入力値に対する出力値を確認できます。

ローコード操作マニュアル - マッピング設定 > マッピングをデバッグする

ロジックフローのデバッグ

ロジックフローのデバッグでは、ロジックフロー全体を実行して処理結果を確認する方法と、処理を一時停止しながら処理の過程を確認する方法があります。

通常のデバッグ方法

通常のデバッグでは、ロジックフローに入力する値を指定して実行し、各処理が想定どおりに実行され、期待した結果が得られるかを確認します。ロジックフロー全体を実行するだけでなく、処理をエレメントごとに一時停止しながら確認する「ステップ実行」も利用できます。

たとえば、ロジックフローの途中で値が期待したものと異なっている場合は、ステップ実行で処理を順番に確認することで、どの処理で値が変わったのかを確認できます。

ロジックフローをデバッグする

ロジックフローのデバッグ画面と実行方法について確認できます。デバッグ画面で必要な入力値を設定して、ロジックフローを実行します。

ローコード操作マニュアル - ロジックフローのデバッグ > ロジックフローのデバッグを実行する

ステップごとにデバッグする

ステップ実行によるデバッグの方法について確認できます。

ローコード操作マニュアル - ロジックフローのデバッグ > ステップごとにデバッグを実行する

ブレイクポイントを設定したデバッグ方法

ロジックフローの特定の処理まで実行して、その時点での値や処理結果を確認したい場合は、ブレイクポイントを設定してデバッグします。

ブレイクポイントを設定すると、指定したエレメントで処理を一時停止できます。処理の途中で確認したい箇所が決まっている場合に利用すると便利です。

ブレイクポイントを利用したデバッグ

ブレイクポイントを利用したロジックフローのデバッグ方法について確認できます。デバッグ画面でブレイクポイントを設定した後、通常のフロー実行またはステップ実行を行います。

ローコード操作マニュアル - ロジックフローのデバッグ > ブレイクポイントを利用してデバッグを実行する

ログを用いたデバッグ

IM-LogicDesignerでは、ロジックフローの実行時に、実行フェーズや入出力値などの情報をデバッグログとして出力できます。ロジックフローを実行した結果だけでは原因を特定しにくい場合や、実行時の詳細な情報を確認したい場合は、デバッグログを利用できます。

デバッグログを確認するには、あらかじめログの出力設定を行う必要があります。

デバッグログの出力設定

ログ出力対象に設定したロジックフローのデバッグログをデータベースに出力する方法について説明しています。出力されたログは、「デバッグログ一覧」画面から確認できます。

ローコード操作マニュアル - フロールーティング設定(APIのURL)> デバッグログを設定する

ログを用いたデバッグ

デバッグログを確認する方法について説明しています。ロジックフローの実行履歴やタスクの入出力値、エラーメッセージなどを確認し、処理の流れやエラーが発生した箇所を調査できます。

ローコード操作マニュアル - デバッグログの確認

デバッグの確認ポイント

ロジックフローにおけるデバッグのポイントを確認します。

  • ロジックフローの正常な動作確認:仕様通りにロジックフローが正しい結果を返しているか
  • 例外処理やエラー発生時の挙動確認:想定外の入力やエラー発生時に、処理が適切に動作するか
  • 条件分岐の評価結果チェック:条件分岐が意図通りに評価され、正しい処理が実行されるか
  • 繰り返し処理の動作確認:配列を用いた繰り返し処理が正しく動作し、すべての要素に対して意図した結果が取得できるか

ロジックのデバッグ操作(ケース別)

ロジックのデバッグにおける確認ポイントやケース別の操作例について確認できます。

ローコード操作マニュアル - ロジックのデバッグ操作(ケース別)

チュートリアル

実際にアプリケーションを作成しながら、デバッグの実行方法を学びましょう。チュートリアルでは、登録機能と一覧取得機能を備えたシンプルな資産管理アプリケーションを作成します。

登録処理

作成した登録処理フローの動作や値の流れを検証するために、デバッグを実行します。

登録処理のデバッグ

登録画面や登録処理の作成が完了した後、デバッグを実行して動作を確認します。まずはロジックフロー単体で動作を確認し、その後、画面から処理を呼び出して一連の動作を確認します。

ローコードチュートリアル[入門編]- 3.7 画面と処理のデバッグ

一覧取得処理

作成した一覧取得処理フローの動作や値の流れを検証するために、デバッグを実行します。

一覧取得処理のデバッグ

管理画面や一覧取得処理の作成が完了した後、同じようにデバッグを実行して動作を確認します。まずはロジックフロー単体で動作を確認し、その後、画面から処理を呼び出して一連の動作を確認します。

ローコードチュートリアル[入門編]- 4.7 画面と処理のデバッグ

まとめ

IM-LogicDesignerでは、ロジックフローの作成途中でもデバッグを実行し、マッピングの結果やロジックフローの処理過程を確認できます。

マッピングの値を確認したい場合はマッピングのデバッグ、ロジックフローの処理結果や処理過程を確認したい場合はロジックフローのデバッグ、実行時の詳細な情報を確認したい場合はデバッグログというように、確認したい内容に応じて使い分けることがポイントです。まずは、それぞれのデバッグ方法と特徴を押さえて、ロジックフローの動作確認に活用してみましょう。

intra-martでは、IM-LogicDesignerをもっと知っていただくために、マニュアルやコンテンツなどを豊富にご用意しています。IM-LogicDesignerの機能を最大限に発揮させるためにもぜひご活用ください。