Panel Studio
Panel Studioは、PlaidCloud内でPanelアプリを編集するためのエディターです。アプリのファイルをエディターの横に表示し、開ける非公開のプレビューをビルドして、準備ができたらアプリを公開します。始めるのにgitリポジトリは必要ありません。
Panel Studioを開く
Section titled “Panel Studioを開く”- プロジェクトのホームボードで、PanelアプリのOpen in Studioを選択します。
- マイPanelアプリで、アプリの行にあるOpen in Studioを選択します。
新しいアプリを始めるには、どちらの場所でもCreate appを選択します。
アプリを作成する
Section titled “アプリを作成する”Create appダイアログでは、次の5つの出発点から選べます。
| 開始元 | 作成されるもの |
|---|---|
| Blank | app.pyとrequirements.txtを持つ最小限のアプリ。 |
| テーブル | 選択したテーブルをもとに構築されたアプリ。 |
| ビュー | プロジェクトのビューをもとに構築された、同様のアプリ。 |
| テンプレート | Panelアプリキットのすぐに使えるアプリ。 |
| From the gallery | ワークスペースがアプリギャラリーに掲載したアプリのコピー。 |
アプリに名前を付け、プロジェクトを選んで、作成を選択します。Studioが新しいアプリを開き、左側にそのファイルが一覧表示されます。
リストからファイルを選ぶと、エディターで編集できます。Pythonの依存関係は、1行に1パッケージずつrequirements.txtに記載します。依存関係は、アプリのビルド時にインストールされます。
Ask Weaveを選択すると、Weaveにアプリの作成や変更を任せられます。WeaveでPanelアプリを構築するを参照してください。
保存、プレビュー、公開
Section titled “保存、プレビュー、公開”保存すると、変更内容がドラフトとして保存されます。ライブのアプリは変更されず、他のユーザーにドラフトが見えることもありません。
プレビューは、保存したドラフトを非公開のコピーとしてビルドし、開きます。プレビューを開けるのは、アプリの編集者だけです。
- プレビューは、保存しないまま24時間が経過すると削除されます。
- ワークスペースで同時に持てるプレビューは、最大10個です。
- 最新の編集内容を確認するには、もう一度保存してプレビューを選択します。
公開すると、ライブのアプリが保存したドラフトに置き換えられます。アプリのプロジェクトに対する編集権限が必要で、Studioはまず確認を求めます。
アプリを開いた後に他のユーザーが変更を公開した場合、Studioはその作業を上書きせずに、競合を報告します。アプリを再読み込みし、自分の編集内容を取り込んで、もう一度公開してください。
ビルドステータスとエラー
Section titled “ビルドステータスとエラー”ビルドタブには、最新のビルドのステータスが表示され、実行中は更新されます。ビルドが失敗すると、タブに各エラーがファイル名と行番号とともに一覧表示されるため、その行に直接移動できます。requirements.txtの依存関係の問題には、修正方法のヒントが付きます。
エラーと警告は、エディター内の該当する行にもマークされるため、問題をその場所で確認できます。
アプリの公開後の各ステータスの意味については、Panelアプリの使用を参照してください。
履歴タブには、アプリの公開済みのバージョンがすべて、新しいものから順に、ビルドステータスとともに一覧表示されます。古いものを表示するには、さらに読み込むを選択します。
以前のバージョンに戻すには、そのバージョンで復元を選択して確認します。復元したバージョンがライブのアプリになり、再ビルドされます。未保存のドラフトは失われません。ドラフトとして残り、次に公開するときに、復元したバージョンの上に重ねて反映されます。アプリがすでにそのバージョンと一致している場合、Studioはその旨を表示し、何も変更しません。復元中に他のユーザーが公開した場合、Studioは何も復元せず、もう一度試すよう求めます。
インサイトタブには、ユーザーがアプリをどのように使っているか、アプリの応答がどのくらい速いかが表示されます。過去7日、14日、30日から選択します。
| セクション | 表示内容 |
|---|---|
| Views per day | 毎日アプリが開かれた回数。 |
| Page load | 対象期間のページ読み込みから算出した、読み込み時間の中央値と、読み込みの95パーセントがそれより速く完了する時間。 |
| Slowest queries | 最も時間がかかったクエリ。実行された頻度と、その中央値、遅い側の値、最も遅い値が付きます。 |
| エラー | 対象期間に発生した問題。エラーの種類と、アプリ内での発生場所別。 |
対象期間の活動量がインサイトで読み取れる量を超えている場合は、数値が部分的であることが示されます。ページ読み込みがアプリのパフォーマンスの上限を超えると、インサイトは、その件数と、遅かったクエリを警告します。インサイトに、クエリが返したデータや、アプリを開いたユーザーの名前が表示されることはありません。
2つのタブはどちらも、アプリがプロジェクトに割り当てられている必要があります。未割り当てのアプリには、割り当てを促すメッセージが表示されます。
アラートとダイジェスト
Section titled “アラートとダイジェスト”Alerts & Digestsを選択すると、アプリのデータの数値を監視して上限を超えたときに通知する設定や、スケジュールに沿って要約を送信する設定ができます。アラートとダイジェストを参照してください。
アプリをギャラリーに掲載する
Section titled “アプリをギャラリーに掲載する”Gallery… を選択すると、プロジェクトを閲覧できるユーザーなら誰でもそこから自分のアプリを作成できるテンプレートとしてアプリを掲載したり、ギャラリーから削除したりできます。アプリギャラリーを参照してください。
ホームにピン留めする
Section titled “ホームにピン留めする”Pin to Homeを選択すると、アプリがプロジェクトのホームボードに追加されます。Unpin from Homeを選択すると削除されます。
アプリを削除する
Section titled “アプリを削除する”Panelアプリを削除する前には、確認が求められます。マイPanelアプリで、アプリの行にあるマイナスアイコンを使用します。公開の取り消しでも確認が求められます。
次のステップ
Section titled “次のステップ”- WeaveでPanelアプリを構築する — アプリを説明し、変更の内容を正確に承認します。
- Panelアプリキット — Studioのテーブル、ビュー、テンプレートからの開始で使われるコンポーネントです。
- アラートとダイジェスト — 数値が上限を超えたとき、またはスケジュールに沿って、ユーザーに通知します。
- アプリギャラリー — アプリを他のユーザーの出発点として共有します。
- Panelアプリの使用 — 公開後のログ、利用状況、再ビルドを説明します。