Fragments
How to create and query fragments using the FragmentBuilder
class.
Beta
The Optimizely Graph .NET Client is in beta. Contact your Customer Success Manager for information.
You can query fragments using theFragmentBuilder
class. You can create and store the fragments in classes and then use them in your query.
Add multiple fragments to a typed query:
var fragment1= new FragmentBuilder<ProxyModels.Content>("FirstFragment")
.Fields(x => x.ContentLink.Id, x => x.SiteId);
var fragment2= new FragmentBuilder<ProxyModels.Content>("SecondFragment")
.Fields(x => x.Name);
Add fragment to your typed query:
var query = _client
.ForType<Content>()
.Fields(x=>x.MetaTitle)
.AddFragments(fragment1, fragment2)
.Total()
.ToQuery()
.BuildQueries();
Then the query should look like:
query Sample_Query {
Content{
items {
MetaTitle
...FirstFragment
...SecondFragment
}
total
}
}
fragment SecondFragment on Content {
Name
}
fragment FirstFragment on Content {
ContentLink{
Id
}
SiteId
}
Create nested fragments
You can also build and then add nested fragments similar to typed query fragments:
var subFragment= new FragmentBuilder<ProxyModels.Language>("SubFragment")
.Fields(x => x.Name, x => x.DisplayName);
var mainFragment= new FragmentBuilder<ProxyModels.Content>("MainFragment")
.Fields(x => x.Name)
.AddFragments(subFragment);
var query = _client
.ForType<Content>()
.Fields(x=>x.MetaTitle)
.AddFragments(mainFragment)
.Total()
.ToQuery()
.BuildQueries();
This generates a query that looks like this:
query Sample_Query {
Content{
items {
MetaTitle
...MainFragment
}
total
}
}
fragment MainFragment on Content {
Name
...SubFragment
}
fragment SubFragment on Language {
Name
DisplayName
}
Note
Fragment names must be unique.
Create fragment for a specific field
If you want to build a query where the SubFragment
is inside a Language
field and the MainFragment
is inside a ContentExtend
field like the following example:
query Sample_Query {
Content{
items {
MetaTitle
ContentExtend{
...MainFragment
}
}
total
}
}
fragment MainFragment on Content {
Name
Language{
...SubFragment
}
}
fragment SubFragment on Language {
Name
DisplayName
}
Select the field before adding a fragment in the AddFragment
method.
Note
Methods do not have an 's'.
var subFragment= new FragmentBuilder<ProxyModels.Language>("SubFragment")
.Fields(x => x.Name, x => x.DisplayName);
var mainFragment= new FragmentBuilder<ProxyModels.Content>("MainFragment")
.Fields(x => x.Name)
.AddFragment(_=> _.Language, subFragment);
var query = _client
.ForType<Content>()
.Fields(x=>x.MetaTitle)
.AddFragment(_=> _.ContentExtend, mainFragment)
.Total()
.ToQuery()
.BuildQueries();
The field selection must have the same type as the fragment's type.
Updated 8 days ago