注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
このページでは、Pilot の使用時によく発生する問題や質問について説明します。
Pilot は、ビューに応じて2つのデータソースを使用します。
Main に影響しません。Main では、アプリケーション内で実行するアクションはすべて、即座に反映されるライブのオントロジー編集です。デプロイには、プロジェクト、組織、エンロールメントの各レベルで権限が必要です。権限エラーが発生した場合は、次の点を確認してください。
Developer Console の権限の詳細については、Developer Console の権限を参照してください。権限が正しいように見えてもエラーが続く場合は、ブラウザーコンソールで詳細なエラーメッセージを確認し、管理者に共有してください。
Pilot のシステムログにアクセスするには、次の手順を実行します。
Pilot ログタブには、コンテナのログがリアルタイムで表示されます。これらのログを使用して、ビルドエラー、依存関係のインストールの問題、実行時の問題を診断します。
プレビュータブにアプリケーションではなくビルドエラーが表示される場合は、次の手順を実行します。
Pilot ログタブで、開発サーバーの詳細なビルド出力を確認することもできます。
新しいアプリケーションを作成すると、Pilot がコンテナをプロビジョニングします。この処理には通常30〜60秒かかります。コンテナが起動しない場合は、次の点を確認してください。
Main のデプロイビューでアプリケーションをプレビューしているときに実行するアクション（オブジェクトの作成、編集、削除など）はすべて、本番データに即座に反映されるライブのオントロジー編集です。これは期待される動作であり、バグではありません。
本番環境に影響を与えずにアクションをテストする場合は、代わりにデプロイブランチのデプロイビューでアプリケーションをプレビューします。ブランチで行ったオントロジー編集はそのブランチに限定され、マージするまで Main に伝播しません。
Pilot ブランチから Main にオントロジーリソースをデプロイすると、アクションタイプの識別子（RID）がブランチと Main で異なる場合があります。アプリケーションコードがブランチ固有の RID を参照している場合、これにより参照エラーが発生することがあります。
この問題を解決するには、次の手順を実行します。
Main に戻ります。Main ブランチの識別子を使用するようにアクションの参照を更新することを Pilot に依頼します。高さのない「divider」要素に関するエラーメッセージがブラウザーコンソールに表示されることがあります。これらのエラーは表示上のもので、アプリケーションの機能には影響しません。無視しても問題ありません。
ステータス監視ポップオーバーに npm 依存関係のインストールに失敗したことが表示される場合は、次の手順を試してください。
Reinstall npm dependencies と入力して、依存関係の再インストールを Pilot に依頼します。デプロイパネルにアプリケーションをデプロイできないことが表示される場合は、次の手順に沿って進めてください。
カスタムウィジェットの作成時に、プレビュータブにブロックされたフレームまたは空のフレームが表示される場合は、Content Security Policy に Pilot コンテナのオリジンが含まれていない可能性があります。ウィジェットのプレビューは Workshop ウィジェットサンドボックス内で表示されるため、frame-ancestors ディレクティブでコンテナのオリジンを許可する必要があります。管理者は Control Panel でオリジンを追加できます。関連するウィジェットサンドボックスの設定については、追加の iframe 属性を有効にするを参照してください。
ウィジェットのパラメーターやイベントの変更は、ウィジェット開発サーバーが再読み込みされるまで、実行中のプレビューに適用されません。設定の変更を適用するには、ウィジェットのプレビューでウィジェット開発モードを再読み込みを選択します。