注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
このページでは、Pilot の使用時によく発生する問題や疑問について説明します。
Pilot は、ローカルのシードデータと実際のオントロジーデータをサポートしています。
Main に影響しません。Main では、アプリケーション内で実行したアクションはすべて、即座に反映されるライブのオントロジー編集になります。デプロイには、プロジェクト、組織、エンロールメントの各レベルで権限が必要です。権限エラーが発生した場合は、次の点を確認してください。
Developer Console の権限の詳細については、Developer Console の権限を参照してください。権限が正しく設定されているように見えてもエラーが続く場合は、ブラウザーコンソールで詳細なエラーメッセージを確認し、管理者と共有してください。
Pilot のシステムログにアクセスするには、次の手順を実行します。
診断ビューには、最新の500行のログが表示されます。ログをコピーを選択してコピーするか、コードへのリンクからログ全体を確認します。これらのログを使用して、ビルドエラー、依存関係のインストールの問題、実行時の問題を診断します。
プレビュータブにアプリケーションではなくビルドエラーが表示される場合は、次の手順を実行します。
診断の Pilot ログで、開発サーバーからの詳細なビルド出力を確認することもできます。
新しいアプリケーションを作成すると、Pilot はコンテナをプロビジョニングします。起動時間は、プロビジョニングと依存関係のインストールにかかる時間によって異なります。コンテナが起動しない場合は、次の点を確認してください。
Main のデプロイビューでアプリケーションをプレビューしているときは、オブジェクトの作成、編集、削除など、実行したアクションはすべてライブのオントロジー編集となり、本番データに即座に反映されます。これは想定どおりの動作であり、不具合ではありません。
これは、エディタービューで本番データを選択した場合にも当てはまります。
本番環境に影響を与えずにアクションをテストするには、代わりにデプロイブランチのデプロイビューでアプリケーションをプレビューします。ブランチ上のアクションによるオブジェクトの編集は、Main にマージされません。オントロジーの定義は別途マージされます。外部への副次的効果には、別のルールが適用されます。アクションタイプのブランチを参照してください。
Pilot ブランチから Main にオントロジーリソースをデプロイすると、アクションタイプの識別子（RID）がブランチと Main の間で異なる場合があります。アプリケーションのコードがブランチ固有の RID を参照していると、参照エラーが発生することがあります。
この問題を解決するには、次の手順を実行します。
Main に戻ります。Main ブランチの識別子を使用するようにアクションの参照を更新することを Pilot に依頼します。ブラウザーコンソールに、高さのない「divider」要素に関するエラーメッセージが表示されることがあります。該当するコンポーネントが表示され、使用できるかどうかを確認してください。Workshop でウィジェットが表示されない場合は、後述の手順に従って行の高さの設定を確認してください。
ステータス監視ポップオーバーに npm の依存関係のインストールに失敗したと表示される場合は、次の手順を試してください。
Reinstall npm dependencies と入力して、Pilot に依存関係の再インストールを依頼します。デプロイパネルにアプリケーションがデプロイ不可と表示される場合は、次の手順に従ってください。
保護されたコードブランチの場合は、編集可能なブランチで修正を行い、提案を通じてマージします。ブランチ、変更、提案を参照してください。
プレビュータブにブロックされたフレームや空のフレームが表示される場合は、設定を変更する前にブラウザーのエラーを確認してください。ウィジェットのプレビューを読み込めませんという表示は、タイムアウトを示す場合もあります。ブラウザーが Content Security Policy 違反を報告している場合は、必要なコンテナオリジンを確認するよう、担当の管理者に依頼してください。ビルドエラー、依存関係、選択したウィジェットも確認してください。ウィジェットセットを開発してプレビューするを参照してください。
ウィジェットの表示 > 行の高さの設定を確認してください。コンテナの高さ全体を使用するように生成されたウィジェットは、自動 (最大) では表示される高さがゼロになることがあります。コンテナ全体に広がるように設計されたウィジェットには、Flex または適切な絶対値の高さを使用するか、コンテンツに合わせてウィジェット自体のサイズが決まるようにすることを Pilot に依頼してください。自動サイズ調整を参照してください。
Workshop のレイアウトを保存し、表示でコントロールが表示され、使用できることを確認します。
ウィジェットのパラメーターやイベントへの変更は、ウィジェット開発サーバーが再読み込みされるまで、実行中のプレビューに適用されません。設定の変更を適用するには、ウィジェットのプレビューでウィジェット開発モードを再読み込みを選択します。
リセットでプレビューの設定項目がクリアされても、表示されたウィジェットに以前の値が残っている場合は、ウィジェット開発モードを再読み込みを選択し、結果を再度確認してください。
無効になっているコントロールに表示される説明、または報告されたエラーを確認します。よくある原因は次のとおりです。
ブランチの制限については、ブランチ、変更、提案を参照してください。モデルの利用可否については、モデルとエージェントモードを参照してください。
本番データ分析には、対応する環境と機能の設定が必要です。本番プレビューが利用できても、分析機能が利用できるとは限りません。
レビューダイアログで分析が見つからない場合は、Pilot に新しい分析の作成を依頼してください。オブジェクトタイプの読み取りに失敗した場合は、再試行する前に、報告された権限エラーまたはデータエラーを確認します。本番データ分析を参照してください。