Constellationアプリケーションのデバッグ用Pegaツール

ConstellationアプリケーションのデバッグではLiveUIはサポートされていません。 

Pega ClipboardはConstellationアプリケーションで部分的にサポートされています。

Clipboardツールは、ケースがプレビューモードで実行されている場合にのみ、静的データを調査するために使用できます。

Clipboardツールをエンドユーザー（Reactベース）ポータルから実行したり、Dev Studioから実行してからユーザーポータルスレッドに切り替えてライブデータを調査したりすることはできません。

ConstellationアプリケーションはConstellation DX API v2を使用してインフィニティサーバーと通信しますが、これはステートレスインターフェイスです。Constellationはステートレスなので、Clipboardツールは各DX API呼び出しの後にリリースされます。 

PegaのTracerツールはConstellationアプリケーションでサポートされていますが、一部変更があります。

Constellationアプリケーションはステートレスで、DX APIに依存しているため、Tracerツールの結果ウィンドウには、ブラウザーセッション中にアプリケーションがブラウザーとやり取りするスキームが反映されます。 

Tracerツールでは、次のオプションが引き続きサポートされています。

• App StudioとDev Studioの両方からフルトレースを実行して、リクエスターセッション全体をトレース。
• サービスRESTルールのトレース — このオプションは、DX API呼び出しをデバッグする場合に特に役立ちます。これは、サービスRESTのシミュレーションを実行するときにも機能します。

Tracerツールを使用して、Constellation DX API呼び出し中に実行されるルールの現在のステップページを開いたり、特定のページを監視するように設定したりできます。出力にはいくつかの違いがあります。

• Tracerツールの出力は、Constellation DX API呼び出しごとにグループ化されます
• 各UIアクションは、個別のConstellation DX API呼び出しを生成します。ステートレスアーキテクチャでは、各リクエストは同じ手順に従う必要があります。
  1. API呼び出しを認証する
  2. 自動化ルールを呼び出します。
  3. 初期セットアップ（ApplicationSetup、InitialProfileSetupなど）を処理する
  4. APIリクエストを処理する
  5. 応答をクライアントに返す

「View Rules」という新しいTracerツール設定が追加されました。次の図に示すように、Tracerツールの設定を開き、Tracerが関連情報をキャプチャするためのView Rules チェックボックスを選択する必要があります。

ビュールール設定により、ビューをトレースし、クライアントに渡されるビューメタデータを調べることができます。

わかりやすくするために、結果ウィンドウでは、イベントをリクエストID別にグループ化します。これは、Constellationアプリケーションでは複数のリクエストが同時にアクティブになる可能性があるためです。

API呼び出しのより詳細なデバッグを行うには、次の図に示すように、DebugPegaAPI動的システム設定の「Rule」を「true」に設定します。

このオプションは、 Pega API Rest Service Infoステートメントに追加フィールドを記録し、ページの指示とフィールドレベルのセキュリティーのデバッグに役立ちます。

DebugPegaAPI ルールが有効になると、次の情報がPegaのログファイルに保存されます。

• DX API呼び出しのリクエストボディで使用される入力値
• DX APIによって実行されるアクション
• DX APIでエラーや例外が発生するビュー内のフィールド
• エラーと例外の原因の説明
• エラーコードと例外番号

Dev Studioの各ビューのメタデータにアクセスできます。ビューに関連付けられたJSONを検査するには、次の図に示すように、まず pxEnableC11nDevWhen Ruleというルールを「true」に設定します。

Viewルールのクイック検索を実行するには、検索バーに次の構文を入力します。ViewName pxObjClass:Rule-UI-Viewまたは、アプリエクスプローラーを使用して、次の図に示すように、Rule-UI-View を検索して、アプリケーションで使用可能なビューのリストを検索します。

Dev Studioでビュールールを開くと、結果には個々のビューに関連するメタデータが表示されます。次の図に、ResolutionMethodビューに関連付けられたJSONデータが表示されます。

以下のインタラクションで理解度をチェックしてください。