o
Types of GQL mode in Sitecore: > Connected GraphQL (GQL):-
* With connected GraphQL, a JSS app makes direct HTTP requests to a
Sitecore GraphQL endpoint. This mode is identical to using a GraphQL API in any JavaScript application, and is not JSS-specific.
Reference: Connected GraphQL > Integrated GraphQL (GQL):- * With integrated GraphQL, the format of the route data returned for a specific component by the Sitecore Layout Service can be modified into the result of a GraphQL query.
When the
Sitecore Layout Service renders a page, it returns a JSON representation of the layout of the page and the data for each component. Normally the component data is a set of fields from the Sitecore datasource item. Integrated GraphQL lets you re-shape this into a GraphQL query result.
Reference: Integrated GraphQL
• GraphQL (GQL) Queries Usage: For this article, I am using following Templates and
Sitecore JSS app Content Tree:
The examples of Sitecore GraphQL queries are:
o Get an item by path and show field id and name : With this you can restrict the results items and get required details only
o Return the name and value from all fields : With this you can get all fields values
o Get the values of Treelist or Multilist field type : To get the values of specific field types like tree-list or multi-list you have to write the query by referencing the specific template on which your item is based. In our case we are using Doctor template which is having services field. The field name in GraphQL queries is CASE SENSITIVE.
o Get the template field details with values of current item : With this you can get all field details of current item template
o Get the field values using Aliases : With the help of Aliases you can provide friendly name to the fields name
o Return a specific field with Alias : With the help of below you can access specific field, assign Alias to field name and assign alias to attribute which providing field value i.e. value. The GraphQL will NOT throw any error if field not exist
o Get Child Items using GraphQL : With the help of GraphQL you can get the child items for current item
o Get specific Child Items using GraphQL and alias : By passing the template id of child items you can filter the listing of child items in GraphQL:
o Get multi-level children details : In GraphQL, you will be having full control on the depth of records which you required, and it’s upto you how many level you wanted to traverse to all child items details related to any item
o Get repeated fields using Fragments : In GraphQL, we can use reusable units called Fragments to group repeated fields so that it can be utilized many places without writing same line of code many times and nested Fragments can also be used in GraphQL queries
o Get list of all languages : In Sitecore GraphQL, we can get list of all languages for particular item:
o Sitecore GraphQL Search - using Search query keyword : In GraphQL, before using the Search query, you have to validate that your
[WebRoot]\App_Config\Include\zzz\[App Name].config having Search query schema enabled or not:
<queries hint="raw:AddQuery">
<!-- enable querying on items via this API -->
<query name="item" type="Sitecore.Services.GraphQL.Content.Queries.ItemQuery, Sitecore.Services.GraphQL.Content" />
<query name="search" type="Sitecore.Services.GraphQL.Content.Queries.SearchQuery, Sitecore.Services.GraphQL.Content" />
</queries> |
Please make sure that search schema present, and if above search schema not present then you will get error
Cannot query field \"search\" on type \"Query\". error showing up after executing the query. In Sitecore Experience Graph Browser:
Details of Sitecore GraphQL Search Parameters: * first: the data type of this parameter is INTEGER and you can decide how many records required
* after: the data type of this parameter is STRING and used as a Page Offset
* rootItem: the data type of this parameter is STRING and we can pass path of item or item guid to restrict the search scope
* keyword: the data type of this parameter is STRING and we can use this parameter to search on all fields
* language: the data type of this parameter is STRING and we can use this parameter to get specific language content irrespective current context language
* latestVersion: the data type of this parameter is BOOLEAN and we can use this parameter to get latest version of result and default value is true
* index: the data type of this parameter is STRING and we can use this parameter to get search results from specific Search index e.g. sitecore_master_index
* fieldsEqual: this field will accept item in array form and can be used to filter out the results on set of fields .e.g.
fieldsEqual:[ {name:"firstName", value:"*A*" } , {name:"lastName", value:"*K*" } ] * facetOn: the data type of this parameter is STRING and we can use this parameter to get facets on particular field in Sitecore GraphQL Search results e.g.
facetOn:["services", "firstName"]We can separate more than one field via comma. The Siteocre GQL facetOn field can also be utilized to add facets on _name or _template field.
o Sitecore GrapQL Search with filters on template fields : In GraphQL Search you can apply filter on the fields
o Sitecore GrapQL Search with filters on multiple template fields : In GraphQL Search:
* You can apply filter on multiple fields
* Restrict the number of fields which needs to be return as a part of Sitecore GraphQL Search Query Results
* Explicitly access the fields on Sitecore GraphQL Search Query Result set
* With the help of Alias you can provide friendly name to fields returns from Sitecore GraphQL Search Query Result set
o Sitecore GrapQL Search with filters and Mult-list Facet field : In GraphQL Search:
* You can apply facets on multiple fields
* You can get values of Facet items from the Sitecore GraphQL Search Query Results
* You can get values of Tree-list or Multi-list facet field with Sitecore GraphQL Search
• Important Notes: * In Sitecore GraphQL (GQL) while writing queries use always field names defined in the Sitecore CMS not Solr field name
* In fieldsEqual parameter you can pass more than one fields with space or comma like this:
fieldsEqual:[ {name:"firstName", value:"*A*" } , {name:"lastName", value:"*K*" } ]
fieldsEqual:[ {name:"firstName", value:"*A*" } {name:"lastName", value:"*K*" } ]
* In facetOn parameter we can separate more than one field via comma e.g.
facetOn:["services", "firstName"]
* By default when you will setup the Sitecore JSS Application then Sitecore JSS restrict the access of Templates to just this app's templates e.g. if you have created the app called SUGDEMO then it will include all templates which are present under the /sitecore/templates/Project/sugdemo. If you waned to include other locations template then you have to include template path at app specific config file [WebRoot]\App_Config\Include\zzz\[App Name].config under the node
templates > paths:
<templates>[Template Path]</templates> * In you will update the template in Sitecore then
Sitecore.Services.GraphQL.Content.EventHandlers.TemplateUpdateHandler will update the Sitecore GraphQL schema and events are Item Copied, Item Deleted, Item Renamed, Item Saved, Publish End and Publish End Remote
• Sitecore GraphQL Query Query Cheat Sheet: Please find below list of Sitecore GraphQL queries:
Comments