標準の実装 GraphiQL IDE は、Adobe Experience Manager(AEM) の GraphQL API でas a Cloud Serviceして使用できます。
GraphiQL はAEMのすべての環境に含まれています(ただし、エンドポイントを設定した場合にのみアクセス/表示できます)。
以前のリリースでは、GraphiQL IDE をインストールするためにパッケージが必要でした。 これをインストール済みの場合は、削除できます。
必ず エンドポイントを設定済み 内 設定ブラウザー GraphiQL IDE を使用する前に。
この GraphiQL ツールを使用すると、次のことを可能にして、GraphQL クエリをテストおよびデバッグできます。
dev-publish
)クエリエディターには、次のいずれかからアクセスできます。
http://localhost:4502/aem/graphiql.html
システムで GraphiQL を使用して、GETリクエストを使用してクライアントアプリケーションからクエリをリクエストできるようにし、クエリの公開に使用できます。 実稼動環境では、次の操作を実行できます。 クエリを実稼動環境に移動する. 最初は、実稼動作成者に対して、クエリを使用して新しく作成したコンテンツを検証し、最後に実稼動公開でライブ消費を検証します。
最初の手順として、 エンドポイント クエリに使用する エンドポイントは、クエリに使用する Sites 設定に適しています。
これは、右上のドロップダウンリストから使用できます。
エディターに新しいクエリを入力できます。エディターは左中央のパネルにあり、GraphiQL ロゴのすぐ下にあります。
永続化されたクエリが既に選択されていて、エディターパネルにが表示されている場合は、「 」を選択します。 +
( 次の 永続クエリ) をクリックして、新しいクエリの準備ができたエディターを空にします。
入力を始めるだけで、エディターも次のようにします。
GraphQL クエリは通常、 {
文字。
行の先頭に #
は無視されます。
用途 名前を付けて保存 をクリックして新しいクエリを保持します。
更新するクエリを、 永続クエリ パネル(左端)
クエリがエディターパネルに表示されます。 必要な変更を加え、を使用します。 保存 を使用して、更新を永続化されたクエリにコミットします。
新しいクエリを直ちに実行することも、永続化されたクエリを読み込んで実行することもできます。 永続化されたクエリを読み込むには、リストからクエリを選択します。クエリがエディターパネルに表示されます。
どちらの場合も、エディターパネルに表示されるクエリは、次のいずれかの場合に実行されるクエリです。
Control-Enter
また、GraphiQL IDE では、 クエリ変数.
次に例を示します。
永続クエリ は、要求元のクライアントアプリケーションのパフォーマンスを向上させるために、Dispatcher および CDN レイヤーでキャッシュできるので、お勧めします。 デフォルトでは、AEMはデフォルトの有効期間 (TTL) に基づいてコンテンツ配信ネットワーク (CDN) キャッシュを無効にします。
GraphQL を使用して、HTTP キャッシュヘッダーを設定し、個々の永続化されたクエリ用にこれらのパラメーターを制御できます。
この ヘッダー オプションには、持続的なクエリ名(左端のパネル)の右側の 3 つの縦並びのドットからアクセスできます。
これを選択すると、 キャッシュ設定 ダイアログ:
適切なパラメーターを選択し、必要に応じて値を調整します。
選択 保存 をクリックして変更を保持します。
リスト(左パネル)から永続化されたクエリを選択したら、 公開 および 非公開 アクション。 これにより、パブリッシュ環境に対してアクティベートされます ( 例: dev-publish
) を使用すると、テスト時にアプリケーションから簡単にアクセスできます。
永続化されたクエリのキャッシュの定義 Time To Live
{"cache-control":"parameter":value} のデフォルト値は 2 時間(7200 秒)です。
この URL をコピー 「 」オプションを使用すると、永続化されたクエリに直接アクセスして結果を確認するために使用する URL をコピーして、クエリをシミュレートできます。 その後、これをテストに使用できます。例えば、ブラウザーでにアクセスすると、次のようになります。
次に例を示します。
http://localhost:4502/graphql/execute.json/global/article-list-01
この URL をブラウザーで使用すると、結果を確認できます。
この URL をコピー オプションには、持続的なクエリ名(左端のパネル)の右側の 3 つの縦並びのドットからアクセスできます。
この 削除 オプションには、持続的なクエリ名(左端のパネル)の右側の 3 つの縦ドットからもアクセスできます。
GraphiQL を使用して永続的なクエリを開発およびテストした後、最終目標は次のとおりです。 実稼動環境に転送する アプリケーションで使用する場合。
IDE のアクションアイコンに直接アクセスできるキーボードショートカットがいくつか用意されています。
Shift-Control-P
Shift-Control-M
Control-Enter
Control-Space
一部のキーボードでは Control
キーには次のラベルが付けられます。 Ctrl
.