GraphQL IDE
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
GraphQL IDE を使用すると、GraphQL サーバーへの要求の送信やデータの取得を簡単に行うことができます。これらの IDE は GraphQL 言語のクエリ機能をサポートしています。
GraphQL IDE は、構文とエラーをリアルタイムで強調表示します。入力していくと、GraphQL からスキーマ ドキュメントのスニペットが提供されるため、クエリに何を追加しているかがわかります。
これらの IDE を使用すると、組織のすべてのデータ ソースを、常に最新の 1 つの連携したデータ グラフとして表示できます。
Preview API と Delivery API の上に、スキーマの自動リロードなどの機能が追加されて構築された GraphQL IDE があります。
IDE を使用するには、有効な認証が必要です。
Content Hub との Sitecore GraphQL Integrated Development Environment (IDE) は、以下を提供します。
- Preview API IDE
- Delivery API IDE
- 構文とエラーの強調表示
- スキーマの自動リロード
- クエリの実行履歴
- オートコンプリート機能
- パラメーターに関するすべての情報を確認できる [DOCS] タブ。
- Prettify を使用したコードの書式設定
GraphQL の Sitecore Content Hub
Preview API IDE
Preview API IDE は、Preview API を使用します。Content Hub のインスタンスに対してライブで実行されます。ドラフトやまだ承認されていないその他のコンテンツを含む、すべてのコンテンツへのアクセスを許可します。
Delivery API IDE
Delivery API IDE は、Delivery API を使用します。Preview API IDE と同じスキーマを持ちます。配信プラットフォームでホストされ、承認および公開されたコンテンツへのアクセスのみを提供します。
履歴
GraphQL IDE は、クエリの実行履歴を保持します。繰り返し使用するクエリには、星印を付けて履歴の上部に表示することもできます。
クエリに星印を付けるには:
- IDE で、[履歴] を選択します。
- 目的のクエリを選択するには、星印をクリックします。
- [使用] をクリックします。
Prettify
Prettifyは、正しいインデントを追加してクエリの書式設定を行います。
オートコンプリート
IDE にはオートコンプリート機能があるため、必要なフィールドを直感的に見つけることができます。構文の強調表示、リンティング、オートコンプリート、およびフラグメントへのナビゲートを提供します。
スキーマ
[スキーマ] タブには、定義されたスキーマの詳細が表示されます。次のスクリーンショットには、IDE の右側に SCHEMA が表示されています。
スキーマをダウンロードするには:
-
右上にある [ダウンロード] をクリックします。
-
スキーマのダウンロード形式を選択します。
- JSON
- SDL
DOCS
GraphQL IDE には、GraphQL で利用可能なドキュメントが表示されます。インタラクティブで、複数列に表示でき、ネイティブ キーボードに対応しています。
[DOCS] タブでは、クエリに必要なパラメーターや応答に指定できるフィールドに関するすべての情報を確認できます。
フィールドやそのサブフィールドに移動すると、エクスプローラーがスキーマ内の現在のパスを追跡します。
クエリの詳細を表示するには、ドキュメント列で [DOCS] タブをクリックします。
次のスクリーンショットは、allM_Asset クエリを、型と引数を含めて表示しています。
[ドキュメント] で使用できる機能は主に 2 つあります。
機能 | 説明 |
---|---|
探しているスキーマ フィールドを見つける | フィールドを名前で検索します (例: アセット)。インターフェイスにより、同じ名前を持つフィールドを区別できます。あいまい検索を使用できるため、フィールドの正確なスペルを知らなくても問題ありません。 |
スキーマのエントリ ポイントからそのフィールドへの理想的なパスを見つける | 型とフィールドのペアを特定すると、エクスプローラーは、スキーマのエントリ ポイントから始まるそのフィールドへのすべてのパスを一覧表示します。これらのパスは深さ順に並べられます。 |
クエリ変数
クライアント コードでは、新しいクエリを再構築する代わりに、引数としてさまざまな値を渡すことができます。クエリ変数は、IDE の [クエリ変数] タブの下に追加できます。
次のスクリーンショットでは、hasComplexRights
クエリ変数を Boolean (true に設定) として作成しています。次に、この変数を assetComplexDRM クエリで使用します。