Uso del IDE de GraphiQL graphiql-ide
Hay una implementación del IDE estándar de GraphiQL disponible para usar con la API de GraphQL de Adobe Experience Manager AEM ().
La herramienta GraphiQL le permite probar y depurar sus consultas de GraphQL permitiéndole lo siguiente:
- seleccionar el punto de conexión adecuado para la configuración de sitios que desee utilizar en sus consultas
- introducir directamente nuevas consultas
- crear y acceder a consultas persistentes
- ejecutar las consultas para ver inmediatamente los resultados
- administrar variables de consulta
- guardar y administrar consultas persistentes
- publicar o cancelar la publicación de consultas persistentes (por ejemplo, a/de
dev-publish) - consultar el historial de las consultas anteriores
- usar el Explorador de documentación para acceder a la documentación; le ayuda a conocer y comprender qué métodos están disponibles.
Puede acceder al editor de consultas desde:
- Herramientas > General > Editor de consultas de GraphQL
- directamente; por ejemplo,
http://localhost:4502/aem/graphiql.html
Puede utilizar GraphiQL en el sistema para que la aplicación cliente pueda solicitar consultas mediante peticiones GET y consultas de publicación. Para el uso en producción, debe mover las consultas al entorno de producción. Inicialmente, al creador de producción para validar contenido recién creado con las consultas y, después, para publicar la producción para consumo activo.
Selección del punto de conexión selecting-endpoint
Como primer paso, debe seleccionar el Punto de conexión que desea utilizar para las consultas. El punto de conexión es apropiado para la configuración de sitios que desea usar para sus consultas.
Esta opción está disponible en la lista desplegable de la parte superior derecha.
Creación y persistencia de una nueva consulta creating-new-query
Puede introducir la nueva consulta en el editor, que se encuentra en el panel central izquierdo, directamente debajo del logotipo de GraphiQL.
+ (junto a Consultas persistentes) para vaciar el editor listo para la nueva consulta.Empiece a escribir, el editor también hace lo siguiente:
- cuando pasa el ratón, muestra información adicional acerca de los elementos
- proporciona funciones como resaltado de sintaxis, autocompletado o autosugerencia
{.# se ignoran.Use Guardar como para que persista la nueva consulta.
Actualización de consultas persistentes updating-persisted-query
Seleccione la consulta que desee actualizar en la lista del panel Consultas persistentes (extremo izquierdo).
La consulta se muestra en el panel del editor. Realice los cambios que necesite y, a continuación, utilice Guardar para confirmar las actualizaciones en la consulta persistente.
Ejecución de consultas running-queries
Puede ejecutar una nueva consulta inmediatamente, o bien puede cargar y ejecutar una consulta persistente. Para cargar una consulta persistente, selecciónela en la lista; se muestra en el panel Editor.
En cualquier caso, la consulta que se muestra en el panel Editor es la que se ejecutará cuando:
- haga clic en el icono Ejecutar consulta
- use la combinación de teclas
Control-Enter
Variables de consulta query-variables
El IDE de GraphiQL también le permite administrar sus variables de consulta.
Por ejemplo:
Publicación de consultas persistentes publishing-persisted-queries
Una vez seleccionada la consulta persistente de la lista (panel izquierdo), puede usar las acciones Publish y Cancelar la publicación. Esto las activará en el entorno de publicación (por ejemplo, dev-publish) para facilitar el acceso a las aplicaciones a la hora de realizar pruebas.
Time To Live {"cache-control":"parameter":value} tiene un valor predeterminado de dos horas (7200 segundos).Copia de una URL para acceder directamente a la consulta copy-url
La opción Copiar URL le permite simular una consulta copiando la URL utilizada para acceder directamente a la consulta persistente y ver los resultados. Esto se puede utilizar para hacer pruebas; por ejemplo, accediendo en un explorador:
Por ejemplo:
http://localhost:4502/graphql/execute.json/global/article-list-01
Con esta dirección URL en un explorador, puede confirmar los resultados:
La opción Copiar URL es accesible a través de los tres puntos verticales a la derecha del nombre de la consulta persistente (panel de la izquierda):
Eliminación de consultas persistentes deleting-persisted-queries
La opción Eliminar también es accesible a través de los tres puntos verticales a la derecha del nombre de la consulta persistente (panel de la izquierda).
Instalación de la consulta persistente en producción installing-persisted-query-production
Después de desarrollar y probar la consulta persistente con GraphiQL, el objetivo final es transferirlo a su entorno de producción para que lo usen sus aplicaciones.
Métodos abreviados de teclado keyboard-shortcuts
Hay una selección de métodos abreviados de teclado que proporcionan acceso directo a los iconos de acción en el IDE:
- Adornar consulta:
Shift-Control-P - Combinar consulta:
Shift-Control-M - Ejecutar consulta:
Control-Enter - Autocompletar:
Control-Space
Control está etiquetada como Ctrl.