Laboratóriumi adatmodell és differ
A laboratórium tárolja a Graph-válaszokat, és összehasonlítja a végrehajtást a szülő ággal. Postafiók-adatok rögzítése előtt végezd el a helyi beállítást.
Tárolt entitások
| Entitás | Jelentés |
|---|---|
DeltaStream | Mappa-delta, mappaüzenet-delta vagy Outlook-kategória teljes lekérdezésének hatóköre |
DeltaExecution | Egy kör szülő-gyermek kapcsolatokkal |
DeltaEntitySnapshot | A legutóbb ismert entitásállapot |
DeltaEntityVersion | Egy végrehajtáshoz kapcsolt entitásállapot |
WebhookCall, WebhookEvent | Callback- és értesítési bizonyíték |
A delta-végrehajtások tárolják a válaszokat, védik a folytatási URL-eket, normalizálják az eseményeket, és frissítik a pillanatkép- és verzióállapotot. Az Outlook-kategória teljes lekérdezései ehelyett teljes választ mentenek, és a legutóbbi sikeres teljes lekérdezéssel hasonlítják össze. Újrahasználható folytatási hivatkozást nem tartanak meg.
Normalizált események
A Graph visszaadhat teljes objektumot, részleges patch-et vagy törlési jelölőt. A normalizálás a entityId, eventType, before, after és differences mezőket adja, hogy az összehasonlítás egységes ábrázolást használjon.
A részleges frissítés csak néhány mezőt tartalmaz. A megjelenített differ ezeket a mezőket egyesíti az összehasonlítási állapottal, mielőtt a változásokat kiszámítja. A nyers válasz és a tárolt normalizált after objektum részleges maradhat. A normalizálás nem alkalmazza a differ egyesítését minden tárolt pillanatképre. Egy csak isRead mezőt tartalmazó nyers válasz nem bizonyítja a kihagyott tulajdonságok törlését.
Különbség-jelentések
| Különbség | Feltétel |
|---|---|
| Added (hozzáadva) | Nincs before, de van after állapot |
| Removed: tombstone | Szolgáltatói eltávolítási jelölő vagy hiányzó after, ismert korábbi állapottal. A removalReason értéke tombstone |
| Removed: moved to Deleted Items | Észlelt áthelyezés a Törölt elemek mappába. A removalReason értéke movedToDeletedItems, az egyesített after elérhető marad |
| Changed/Updated (módosítva) | Mindkét állapot létezik, és a releváns összehasonlító mezők eltérnek |
| Unchanged (változatlan) | Az összehasonlított állapotban nincs releváns különbség |
Az áthelyezés a Törölt elemek mappába nem bizonyítja a végleges törlést. A szolgáltatói tombstone az eltávolítást jelzi az adott delta-hatókörből, nem feltétlenül az elem végleges megsemmisítését. Vizsgáld meg az eltávolítási okot és a hatókört.
Ugyanazon changeKey értékű duplikált entitások előfordulhatnak egy végrehajtáson belül. A differ eltávolítja a duplikált megfigyeléseket, hogy elkerülje az ismétlődő hozzáadásokat és a zajos összegzéseket.
A Differ fül a hozzáadott, eltávolított, módosított és változatlan darabszámokat, valamint a duplikáció-eltávolítás számát mutatja. Megjeleníti az állapot szerint színezett entitásokat, a mezőváltozásokat, például isRead és flag.flagStatus, valamint az opcionális HTML-törzs-összehasonlítást.
Az eredményt a kiválasztott végrehajtás szülőjéhez képest értelmezd. Nem az egész élő postafiók független állítása. Ha egy különbség váratlannak tűnik, használd a Lineage és nyers válasz nézetet.
Outlook-címke-összehasonlítás
Az OUTLOOK_CATEGORY a STANDARD_PULL módszerrel, lapozott teljes katalógus-olvasásokat használ. A legutóbbi sikeres teljes lekérdezéssel hasonlít össze, nem mentett delta-tokennel. A sikertelen lekérdezések nem lesznek összehasonlítási alapok.
A 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ítja a kategóriát, tartalékként az azonosítóval. Az azonos nevű, de módosult színű elem Changed (módosítva). Az átnevezés eltávolításként és hozzáadásként jelenik meg. Ezek az összehasonlítási azonosítók nem helyettesítik az API-műveletekhez használt szolgáltatói kategóriaazonosítót. Az olvasási jogosultságú katalógus-lekérdezésekhez MailboxSettings.Read kell. Lásd: címkelekérdezés viselkedése.