標準の GraphQL IDE の実装は、Adobe Experience Manager(AEM)as a Cloud Service の GraphQL API で使用できます。
GraphiQL は AEM のすべての環境に含まれています(ただし、エンドポイントを設定した場合にのみアクセス可能/表示可能になります)。
以前のリリースでは、GraphiQL IDE をインストールするためにパッケージが必要でした。これをインストール済みの場合は、削除できます。
GraphiQL IDE を使用する前に、設定ブラウザーでエンドポイントを設定しておく必要があります。
The GraphiQL ツールを使用すると、次のことが可能になり、GraphQLクエリをテストおよびデバッグできます。
dev-publish
クエリエディターには、次のいずれかの方法でアクセスできます。
http://localhost:4502/aem/graphiql.html
)システムで GraphiQL を使用すると、GET リクエストを使用してクライアントアプリケーションからクエリをリクエストしたり、クエリを公開したりできます。実稼動環境で使用する場合は、その後クエリを実稼動環境に移動できます。最初は実稼動オーサーに移行して、新しくオーサリングしたコンテンツをクエリで検証し、最終的には実稼動パブリッシュに移行してライブで利用できるようにします。
まず、クエリに使用するエンドポイントを選択する必要があります。クエリに使用する Sites 設定に適したエンドポイントです。
これは、右上のドロップダウンリストから選択できます。
エディターに新しいクエリを入力できます(エディターは左中央パネルの GraphiQL ロゴのすぐ下にあります)。
永続クエリが既に選択されていて、エディターパネルに表示されている場合は、(永続クエリの横にある)「+
」を選択してエディターを空にし、新しいクエリを作成できるようにします。
入力を開始します。エディターには次の機能があります。
GraphQL クエリは通常、{
文字で始まります。
#
で始まる行は無視されます。
「名前を付けて保存」を使用して、新しいクエリを永続化します。
更新するクエリを(左端の)永続クエリパネルのリストから選択します。
エディターパネルにクエリが表示されます。 必要な変更を加えたあと、「保存」を使用して、更新内容を永続クエリにコミットします。
新しいクエリをすぐに実行することもできますし、永続クエリを読み込んで実行することもできます。永続化されたクエリを読み込むには、リストからクエリを選択します。クエリがエディターパネルに表示されます。
どちらの場合も、エディターパネルに表示されるクエリは、次のいずれかの操作を行ったときに実行されるクエリです。
Control-Enter
を使用するまた、GraphiQL IDE を使用して、 クエリ変数.
例:
永続クエリは、Dispatcher と CDN レイヤーでキャッシュできるので推奨されます。これにより、最終的に要求元のクライアントアプリケーションのパフォーマンスが向上します。デフォルトでは、AEM はデフォルトの有効期間(TTL)に基づいてコンテンツ配信ネットワーク(CDN)のキャッシュを無効にします。
詳しくは、永続クエリのキャッシュをご覧ください。
Dispatcher 上のカスタム書き換えルールが、AEM パブリッシュのデフォルトを上書きする場合があります。
TTL ベースのキャッシュコントロールヘッダーを Dispatcher から送信する場合、場所の一致パターンにもとづいて、必要に応じて一致パターンから /graphql/execute.json/*
を除外できます。
GraphQL を使用すると、HTTP キャッシュヘッダーを設定することにより、個々の永続クエリ用にこれらのパラメーターを制御できます。
「ヘッダー」オプションには、永続クエリ名(左端のパネル)の右側にある 3 つの縦並びのドットからアクセスできます。
これを選択すると、キャッシュ設定ダイアログが開きます。
適切なパラメーターを選択し、必要に応じて次の値を調整します。
「保存」を選択して、変更内容を保持します。
リスト(左パネル)から永続化されたクエリを選択したら、 公開 アクション。
これにより、選択した環境に対するクエリがアクティブ化されます。 次のいずれかを選択できます: 公開 環境 ( 例: dev-publish
)、または プレビュー 環境を使用して、テスト時にアプリケーションから簡単にアクセスできます。
永続クエリのキャッシュ Time To Live
{"cache-control":"parameter":value} の定義では、デフォルト値は 2 時間(7200 秒)になっています。
公開時と同様に、リスト(左パネル)から持続的なクエリを選択すると、 非公開 アクション。
これにより、選択した環境からクエリが非アクティブ化されます。 公開 環境、または プレビュー 環境。
また、潜在的な問題を回避するために、クライアントアプリケーションに必要な変更を加えたことを確認する必要があります。
The 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
のラベルが付いています。