Beim Lesen aufgelöst
Eine Leseanfrage sagt, welche Locale und welchen Kontext sie möchte und ob sie den Entwurf möchte. Der Server trifft die Auswahl, und jeder Client erhält die fertigen Werte in den Feldern, die er angefragt hat.
Drei Argumente bei jeder Leseanfrage
Jede Leseanfrage pro Modell, ob für einen Einzelfall oder als Liste, nimmt drei Argumente entgegen: locale, contexts und preview. Die aufgelösten Werte kommen direkt in den typisierten Feldern zurück. Das typisierte SDK nimmt dieselben drei bei seinen eigenen Aufrufen entgegen.
Locale-Rückfall, Feld für Feld
Für jedes übersetzbare Feld geht der Server eine geordnete Liste durch und liefert den ersten Wert, den er findet: die angefragte Locale, ihre konfigurierte Rückfallkette, die nächsten Treffer in derselben Sprache und Schrift, den Projektstandard und dann den verfassten Wert. Weil der Durchlauf pro Feld erfolgt, kann ein teilweise übersetzter Datensatz seinen Titel aus einer Locale und seinen Text aus einer anderen in derselben Antwort zurückgeben. Eine Leseanfrage ohne Locale erhält die verfassten Werte.
Varianten und Zielgruppe
Das Argument contexts trägt Targeting-Dimensionen. Gerät, Plattform und Locale sind eingebaut, und die eigenen Dimensionen Ihres Projekts, etwa ein Markt, sind als Enums typisiert. Der Server leitet den Anmeldestatus und die Zugehörigkeit zu einem Segment aus dem Zugriffs-Token des angemeldeten Nutzers ab. Dann wählt er die passende Variante und merged deren Werte auf den Datensatz. Eine Dimension, die Sie weglassen, fehlt, sodass eine Regel, die sie verlangt, nicht zutrifft. Die Seite Personalisierung geht ein Beispiel durch.
Entwurf oder veröffentlicht
Ist preview auf true gesetzt, gibt eine Leseanfrage statt der veröffentlichten Version den neuesten Entwurf zurück, und zwar für einen Schlüssel, der den Scope drafts:read hält.
Prüfen, wie eine Leseanfrage aufgelöst wurde
Zwei Debug-Schalter berichten über eine Leseanfrage, ohne ihren Inhalt zu ändern. localeStrict listet die Felder auf, die auf einen Rückfall zurückgegriffen haben. resolutionTrace gibt den vollständigen Durchlauf zurück, an einen Schlüssel, der den Targeting-Debug-Scope hält.
Details nachlesen
Der GraphQL-Leitfaden dokumentiert die Argumente locale, contexts und preview und was jedes davon auflöst.