Skip to main content

Microsoft Graph CLI-eszközkészlet

A Microsoft Graph CLI-eszközkészlet közvetlenül a Graphon keresztül kezeli az Outlook-postafiókokat. Üzeneteket küld és keres, megjelöli őket olvasottként, áthelyezi vagy törli őket, valamint mappákat és főkategóriákat kezel. A munkafolyamatok típusos műveleteket kapcsolnak össze egyetlen folyamatban.

Kezdd a telepítéssel és az alkalmazás jogosultságainak megadásával. A CLI saját, csak alkalmazásszintű hitelesítő adatot használ. Nem örökli a bejelentkezett MailGen-felhasználó postafiók-jogosultságát.

Cél​

Az eszköz kontrollált szinkronizálási kísérleteket támogat. Egy munkafolyamat az A postafiókból küldhet, és megvárhatja a B postafiókban lévő példányt. Megtarthatja a B-beli másolat változatlan üzenetazonosítóját, kategorizálhatja a másolatot, és áthelyezheti. Ezután megvizsgálhatod a különálló szinkronizáló rendszer reakcióját.

Ezek a szolgáltatói műveletek eCAS API-hívás vagy adatbázis-hozzáférés nélkül futnak. Az eszköz külön van az éles Graph-szinkronizálástól.

TerületKépesség
ÜzenetekListázás és lekérés, küldés és válaszadás, várakozás, olvasottnak jelölés, áthelyezés, kategóriák, kukába küldés, végleges törlés
MappákRekurzív listázás, lekérés, létrehozás, átnevezés, áthelyezés, törlés
CímkékListázás, lekérés, létrehozás, színváltoztatás, törlés
MunkafolyamatokTípusos műveletek összeállítása TypeScriptben
AutomatizálásEgy JSON-eredmény és előre kiszámítható kilépési kód

Itt a címke egy Outlook főkategóriát jelent. Az üzenet kategórianeveket tartalmaz. A kategóriakezelő parancsok kategóriaazonosítókat adnak vissza.

Állapotmentes végrehajtás​

Minden hívás beolvassa az alkalmazás-hitelesítő adatokat, és hitelesített Graph-klienst hoz létre. Végrehajtja a műveletet, kiírja a JSON-t, majd kilép. Nem tart fenn parancsok közötti munkafolyamat-állapotot, sem üzenet- vagy mappaazonosítókat. Nem hívja az InstantUserDataGettert, nem csatlakozik a Prismához, és nem olvassa a DELTA_LINK_ENCRYPTION_KEY változót.

Üzenetazonosság​

Az üzenetkérések ezt a fejlécet tartalmazzák:

Prefer: IdType="ImmutableId"

Az azonosító stabil marad, ha ugyanazon postafiókon belül áthelyezed az üzenetet. A feladói és a címzetti másolat különböző azonosítót kap. A címzetti másolat megkereséséhez használd az internetMessageId értéket, majd az eredmény emailId mezőjét.

Névfeloldás​

A mappa- és kategórianevek pontosan, kis- és nagybetű-érzéketlenül egyeznek. Ha nincs egyezés, a művelet megáll. Ha több mappa egyezik, a művelet szintén megáll, és visszaadja a jelölt azonosítókat. Egy explicit azonosító pontosan a megadott objektumot célozza. Ez megakadályozza, hogy egy munkafolyamat csendben egy kétértelmű mappát válasszon.

Tovább​

  1. Állítsd be a CLI-t.
  2. Keresd meg a parancsot.
  3. Értelmezd a JSON-t és a hibákat.
  4. Állíts össze munkafolyamatot.

A futtatható projekt az Architecture/GraphSyncExperimenter/cli-graph/ mappában van. Ezek az olvasói oldalak a projekt külön dokumentációja.