Risolto in lettura
Una lettura dice quale locale e quale contesto vuole e se vuole la bozza. Il server fa la scelta, e ogni client riceve i valori finiti sui campi che ha richiesto.
Tre argomenti su ogni lettura
Ogni lettura per modello, singola o di elenco, accetta tre argomenti: locale, contexts e preview. I valori risolti tornano direttamente sui campi tipizzati. L'SDK tipizzato accetta gli stessi tre nelle proprie chiamate.
Fallback del locale, campo per campo
Per ogni campo traducibile il server percorre un elenco ordinato e serve il primo valore che trova: il locale, quello richiesto, la sua catena di fallback configurata, le corrispondenze più vicine nella stessa lingua e nello stesso script, il predefinito del progetto, poi il valore originale. Poiché il percorso è per campo, un record tradotto in parte può restituire il titolo da un locale e il corpo da un altro nella stessa risposta. Una lettura che non indica un locale riceve i valori originali.
Varianti e pubblico
L'argomento contexts porta le dimensioni di targeting. Dispositivo, piattaforma e locale sono integrati, e le dimensioni del tuo progetto, un mercato per esempio, sono tipizzate come enum. Il server ricava lo stato di login e l'appartenenza a un segmento dal token di accesso dell'utente autenticato. Poi seleziona la variante corrispondente e ne unisce i valori al record. Una dimensione che ometti è assente, quindi una regola che la richiede non corrisponde. La pagina sulla personalizzazione ne illustra un esempio.
Bozza o pubblicato
Con preview impostato a true, una lettura restituisce l'ultima bozza al posto della versione pubblicata, per una chiave con drafts:read come scope.
Verificare come si è risolta una lettura
Due interruttori di debug riferiscono su una lettura senza cambiarne il contenuto. localeStrict elenca i campi che sono ricaduti sul fallback. resolutionTrace restituisce il percorso completo, a una chiave che ha lo scope di debug del targeting.
Approfondisci
La guida a GraphQL documenta gli argomenti locale, contexts e preview e che cosa risolve ciascuno.