A delta-explorer használata

A delta-explorer a szolgáltatói változásokat vizsgálható végrehajtási ágakba olvassa. Először végezd el a helyi beállítást és a Graph-alkalmazás jogosultságainak beállítását.

Fogalmak és panelek

Egy stream (folyam) egyetlen hatókört jelöl: postafiók-mappákat, egy mappa üzeneteit vagy Outlook-főkategóriákat (címkéket). Egy execution (végrehajtás) egy szolgáltatói olvasási kör. A mappa- és üzenetfolyamok delta-folytatást használnak. A Continue (folytatás) a visszaadott hivatkozást használja. A Replay (újrajátszás) a mentett hivatkozást újra kéri, mint másik ágat. Az Outlook-címkék ehelyett teljes lekérdezéseket használnak, ahogy lent írjuk.

A bal panel a folyamokat listázza, és kínálja a mappa- és üzenetdeltát, az Outlook-címke-lekérdezéseket és a Whole mailbox (teljes postafiók) műveletet. A középső panel a végrehajtási fákat, az állapotokat, az eredményszámokat és a ROOT, DELTA_LINK vagy REPLAY bemeneteket mutatja. A jobb panel a Response (válasz), Request (kérés), Events (események), Differ (különbség) és Lineage (leszármazás) nézeteket kínálja.

Lapozás és folytatás

A mappa- és üzenet-delta folyamoknál az @odata.nextLink oldalak egy végrehajtáshoz tartoznak. A szolgáltatás automatikusan követi őket. Az utolsó @odata.deltaLink adja a következő delta-kört. A lapozás nem hoz létre külön ágcsomópontokat.

A sorozat a hatókör kiválasztásával és a végrehajtás létrehozásával indul. Ezután a Graph-oldalakat kéri, elmenti az utolsó hivatkozást, normalizálja az állapotot, és megjeleníti a választ és a különbségeket. A Graph-URL-eknek HTTPS graph.microsoft.com/v1.0/ célt kell megcélozniuk.

A kéréskezelő segédfüggvény támogatott korlátozási vagy szolgáltatás-nem-elérhető válaszoknál legfeljebb három kísérletet enged. Tiszteletben tartja a korlátozott soron belüli várakozásokat. A 30 másodpercnél hosszabb Retry-After értéknél visszaadja a vezérlést, és nem tartja a kérést soron belül.

Outlook-címkék teljes lekérdezései

Az OUTLOOK_CATEGORY folyamok a STANDARD_PULL módot használják. Minden futás a fix outlook/masterCategories gyűjteménnyel indul, és követi az összes válaszoldalt. Nem tárol újrahasználható delta- vagy folytatási hivatkozást. A Continue/Replay delta-szemantika itt nem alkalmazható. Az összehasonlítási szülő a legutóbbi sikeres teljes lekérdezés. A sikertelen lekérdezések nem írják felül ezt az alapot.

Az olvasási jogosultságú katalógus-hozzáféréshez Graph Application-jogosultság kell, MailboxSettings.Read néven, bérlői adminisztrátori hozzájárulással. Lásd: Graph-jogosultságok.

A kategória-differ általában az elején és végén üres karakterektől megtisztított (trimmed), NFC-normalizált megjelenített név alapján azonosít egy elemet, tartalékként a szolgáltatói azonosítóval. A színváltozás Changed (módosítva). Az átnevezés a régi név eltávolítása és az új név hozzáadása. Lásd: kategória-összehasonlítás.

Teljes postafiók

A Whole mailbox (teljes postafiók) először az Outlook-címkéket olvassa, majd frissíti a mappafolyamot. Azonosítja az aktív mappákat, és párhuzamosan frissíti az üzenetfolyamaikat. Szélesebb lefedettséget ad, de több erőforrást használ, és növelheti a korlátozást. Probléma izolálásakor inkább egyetlen mappát válassz.

A következő művelet kiválasztása

Helyzet	Művelet
Egészséges folyam folytatása	Execute next (következő végrehajtása)
Mentett hivatkozásra adott válasz reprodukálása	Replay link (hivatkozás újrajátszása)
A token lejárt	New root (új gyökér) friss kiinduló állapothoz
Váratlan szerkezet vagy különbség	Hasonlítsd össze a Lineage-et, a szülőt és a nyers Response-t

Az újrajátszás új szolgáltatói olvasás, nem garantált történeti újrajátszás. Ágelemzés előtt olvasd el a differ-szemantikát.