Skip to main content

A jelenlegi postafiók-onboarding folyamata

A mailGen/ECS_MovePST_To_TempSQL/GraphOneTimeUserOnboarder importálja a csatlakoztatott Outlook-postafiókokat. Az onboarding indítása előtt készítsd elő a Microsoft Graph alkalmazás-hozzáférést, a PostgreSQL-t, a Kafkát, az objektumtárolót és a keresést.

Indítás és folytatás​

A támogatott /onboarding műveletekhez használd ezt: Egy postafiók csatlakoztatása és előkészítése. A Microsoft-összekötő a Folytatás Microsofttal gombot csak akkor kínálja, ha az előkészített, tartósan mentett bérlőkapcsolat már létezik.

Ha szükséges, kösd össze a kívánt Microsoft-identitást, válaszd ki a saját csatlakoztatott fiókodat, majd válaszd a Kezdeti beállítás indítása vagy a Postafiók beállítása lehetőséget. Az actornak szüksége van a mail.onboarding jogosultságra. Egy már meglévő postafiók-sor vagy mailboxId nem előfeltétele az indításnak.

A BFF az onboardingot az app.onboarding.commands.v1 témán keresztül kéri. A parancs az alkalmazásfelhasználó és a csatlakoztatott fiók azonosítóját hordozza. A worker a tartós futás létrehozása vagy betöltése előtt ellenőrzi a jogosultságot. A provider postafiók-azonosítóját külön oldja fel. Ezek az azonosítók különböző célt szolgálnak.

Az ellenőrzőpontok lehetővé teszik, hogy az újrapróbálható lépések folytatódjanak anélkül, hogy a teljes futás elveszne. Az indítás a befejezetlen futásokat is megvizsgálja. Az újrajátszáshoz kifejezett futási jogosultság kell.

Importálási sorrend​

  1. Azonosság feloldása. Oldd fel a providerMailboxUserId értékét, és ellenőrizd az engedélyezett Entra-alannyal szemben. Hozd létre vagy frissítsd a postafiók-tulajdonos rekordot, a bérlőkapcsolatot és a helyi postafiókot.
  2. Szinkronizálás előkészítése. Hozd létre a webhook-előfizetéseket és a kezdeti puller-állapotot, majd olvasd be a mappafát és a referenciaadatokat, köztük a kategóriákat.
  3. Üzenetek tárolása. Olvasd mappánként az üzenetmetaadatokat, és töltsd fel a törzseket S3-ba. A metaadatokat és az objektumkulcsokat PostgreSQL-ben tárold.
  4. Nyers adatok exportálása. A MailboxItem.Export.All Application-jogosultsággal és adminisztrátori hozzájárulással használd a Graph exportItems műveletét. Dekódold a FastTransfer-adatokat, és nyerd ki a fájlmellékleteket. Tárold az objektumokat és a metaadatokat.
  5. Keresés előkészítése. Futtasd az indexelést, miután a tartós metaadat-, törzs-, export- és mellékletmentés átmegy a saját akadályán.
  6. Sorrend kiosztása. Mentsd el a stabil postafiók-sorpartíciót, és engedd el az inicializálásra váró munkát.
  7. Inicializálás lezárása. Rögzítsd az életciklus befejezését, és sorba állítsd a mailbox.onboarding.initializingDone műveletet.

A nyers exportálás és a FastTransfer-mellékletek kinyerése kötelező. A szigorú befejezési akadály mindkét szakaszt ellenőrzi a referenciaadatok, az üzenetek és az indexelés mellett. Az exportjogosultság hiányát nem pótolja a sima postaolvasási hozzáférés. Lásd: Graph-alkalmazásjogosultságok.

A BFF az onboarding és a végső inicializálási művelet befejezése után nyitja meg a munkaterületet. A mappa- és üzenetimportok Graph-delta olvasásokat használnak. Az üzenetkérések a Prefer: IdType="ImmutableId" fejlécet használják, így a stabil azonosítók egy postafiókon belül a mozgatások után is megmaradnak.

Éles működési határ​

Az éles worker indításkor nem töröl és nem állít vissza teszt-leveleket. A fejlesztési törlés külön, kifejezett folyamat. Lásd: tárolás és helyreállítás.