コンテンツにスキップ
Delivery API
機能を前提に計画する前に、機能の提供状況をご確認ください。

ガイドコンテンツ

プレビュー、公開、ロールバック

下書き、実際のデザインでのプレビュー、不変のリビジョン、スケジュール公開、ロールバックについて説明します。

このページは英語から翻訳されたものです。内容に相違がある場合は、英語版が優先されます。 英語版を読む

Studio でのすべての変更は、まず下書きになります。下書きが公開用の Delivery API から返されることはないため、誤ってウェブサイトに漏れることはありません。

編集者は、次の 3 つの方法で下書きを確認できます。

  • ページエディターの Website view は、フィールドの隣のフレームに実際のウェブサイトを表示します。
  • Full-screen preview と pop-out は、さまざまな画面サイズで下書きを表示します。
  • Preview on website は、15 分間有効なワンタイムリンクでウェブサイトのプレビュー用ルートを開きます。

プレビューにはウェブサイト側のプレビュー用ルートが必要で(Next.js ウェブサイトを接続するをご覧ください)、開発環境でのみ動作します。下書きは常に noindex 付きで配信され、キャッシュされることはありません。

必要に応じて、編集者はプレビューされたページ上のセクションをクリックして、Studio でそのセクションを選択できます。下書きプレビューの場合のみ、ウェブサイトは次のことを行います。

  1. 各セクションの要素に data-atlas-section-id="<section id>" を付ける。
  2. フレーム内で動作しているときは、親ウィンドウに { type: 'atlas:ready' } を送信する。
  3. クリックされたら、ページ遷移を防止して { type: 'atlas:select', sectionId } を送信する。
  4. { type: 'atlas:highlight', sectionId } で指定されたセクションを枠線で強調する。

メッセージは Studio のオリジンからのみ受け付け、Studio のオリジンにのみ送信してください。これらはいずれも、プレビュー以外では動作しません。

公開すると、不変のリビジョンが作成されます。ウェブサイトは、次のリクエストで、または Webhook を使っている場合は即座にそれを認識します。公開の前に、Studio は公開時の問題(たとえば必須フィールドが空のまま、など)を一覧表示し、それらが解消されるまでページを公開できません。

編集コレクション(ニュース、記事)は、スケジュール公開、スラッグ、RSS フィードにも対応しています。

  • 開発環境では、ページの以前のリビジョンを復元して、もう一度公開します。
  • 本番環境では、以前のリリースにロールバックします。これにはロールバック権限が必要です。

ロールバック自体も、記録される新しいイベントです。何も削除されません。