עבודה עם תיקיות ב‑Exchange Server

רישום כל התיקיות מהשרת

API של Aspose.Email מספקת את היכולת להתחבר ל‑Exchange Server ולרשום את כל התיקיות ותתי‑תיקיות. ניתן גם לקבל את כל תתי‑התיקיות מכל תיקייה באופן רקורסיבי. היא גם מאפשרת רישום תיקיות עם עימוד (paging) מהלקוח של Exchange באמצעות Exchange Web Service (EWS). מאמר זה מסביר כיצד לקבל את כל תתי‑התיקיות משרת ה‑Exchange ולהשיג תיקיות עם פגינציה.

קטע הקוד הבא מציג כיצד לרשום תיקיות מ-Exchange Server.

קבלת מידע על סוג התיקייה באמצעות EWS

ה ExchangeFolderType מאתחל המסופק על‑ידי ExchangeFolderInfo מחלקה שניתן להשתמש בה לקבלת מידע על סוג התיקייה. זה מוצג בדוגמת הקוד למטה.

רשימת תיקיות עם תמיכת עמודים באמצעות EWS

קטע הקוד הבא מראה לך כיצד להשתמש בתמיכה בעימוד עם EWS.

גישה לתיקיות מותאמות אישית או תת‑תיקיות בתיבת הדואר

IEWSClient מאפשר למפתחים לגשת לכל תיקייה מותאמת אישית או תת‑תיקייה מתיבת הדואר. ה‑ FolderExists() מתודה של IEWSClient מחזירה את ה‑URI של תיקייה/תת‑תיקייה מותאמת שצוינה, שניתן להשתמש בו לאחר מכן כדי לגשת לתיקייה היעד. בדוגמה הבאה, תיקייה מותאמת בשם "TestInbox", שנוצרה תחת INBOX, נפתחת וכל ההודעות מוצגות מתיקייה מותאמת זו. לביצוע משימה זו, מתבצעים השלבים הבאים:

1. אתחל את ה‑ IEWSClient אובייקט על‑ידי מסירת אישורים תקפים.
2. גש לתיבת הדואר ברירת המחדל.
3. גש לתיקיית האב, שהיא INBOX בדוגמה זו. תיקיית אב זו יכולה להיות גם תיקייה מותאמת אישית.
4. השתמש FolderExists() מתודה לחיפוש בתת‑תיקייה המותאמת שצוין, לדוגמה, "TestInbox". היא תחזיר את ה‑URI של "TestInbox".
5. השתמש ב‑URI זה כדי לגשת לכל ההודעות בתיקייה המותאמת הזאת.

קטעת הקוד הבא מראה לך כיצד לגשת לתיקיות מותאמות אישית או תת‑תיקיות בתיבת הדואר באמצעות EWS.

רישום תיקיות ציבוריות

Microsoft Exchange Server מאפשר למשתמשים ליצור תיקיות ציבוריות ולפרסם הודעות בהן. כדי לבצע זאת דרך האפליקציה שלך, השתמש ב‑ EWSClient מחלקה להתחברות ל‑Exchange Server וקריאה והורדת הודעות ופרסומים מתיקיות ציבוריות. קטע הקוד הבא מראה איך לקרוא את כל התיקיות הציבוריות ותתי‑התיקיות, ולרשום ולהוריד כל הודעה שנמצאה בתיקיות אלו. דוגמה זו פועלת רק עם Microsoft Exchange Server 2007 ומעלה מכיוון שרק גרסאות אלו תומכות ב‑EWS.

סנכרון פריטי תיקייה

ממשקי Aspose.Email IEWSClient מספקת את האפשרות לסנכרן תיקיית Exchange לתוכן שלה. ה‑ SyncFolder מתודה שנחשפת על‑ידי ה‑ IEWSClient מחלקה שניתן להשתמש בה כדי לסנכרן מידע על תיקייה ספציפית. קטע הקוד הבא מראה לך כיצד לסנכרן מידע על תיקיית Exchange.

קבלת הרשאות לתיקיות Exchange

למשתמשים מוקצות הרשאות לתיקיות הציבוריות ב‑Exchange Server, אשר מגבילות/קובעות את רמת הגישה של המשתמש לתיקיות אלה. המחלקה ExchangeFolderPermission מספקת קבוצה של תכונות הרשאה לתיקיות Exchange כגון permission level, האם הם יכולים ליצור פריטים, למחוק פריטים ולבצע משימות אחרות בהתאם לתכונות ההרשאה. ניתן לקבל את ההרשאות באמצעות ה‑ GetFolderPermissions() מתודה של IEWSClient. מאמר זה מסביר כיצד לקבל את ההרשאות שהוחלו על תיקייה ציבורית עבור כל המשתמשים שיש להם גישה לתיקיות המשותפות.

כדי לבצע משימה זו:

1. אתחל את ה‑ IEWSClient.
2. השתמש ב- ListPublicFolders כדי לקבל רשימה של כל התיקיות הציבוריות
3. שחזר את ההרשאות הקשורות לתיקייה באמצעות GetFolderPermissions() שיטה

קטעת הקוד הבא מראה לך כיצד להשתמש ב- IEWSClient מחלקה לקבלת ההרשאות שהוחלו על תיקייה.

יצירת תיקיות ותת‑תיקיות

ממשק ה‑API של Aspose.Email מספק אפשרות ליצור תיקיות בתיבת דואר של Exchange. ה‑ CreateFolder מתודה של IEWSClient ניתן להשתמש בזה למטרה זו. כדי ליצור תיקייה בתיבת הדואר של שרת Exchange, ניתן לבצע את הצעדים הבאים.

1. צור מופע של IEWSClient.
2. הגדר את set_UseSlashAsFolderSeparator מאפיין כנדרש. אם מוגדר ל‑true, האפליקציה תתייחס ל‑"Slash" כמפריד תיקיות והתת‑תיקייה תיווצר אחרי הסלאש.
3. השתמש ב- CreateFolder שיטה ליצירת התיקייה.

קטע הקוד הבא מראה כיצד ליצור תיקיות ותיקיות משנה.

גיבוי תיקיות Exchange ל‑PST

כאשר משתמשים רוצים לבצע גיבוי של כל תיקיות תיבת הדואר או חלק מהן, Aspose.Email מספקת אפשרות לגבות את כל תיקיות תיבת הדואר של Exchange או רק נבחרות לקובץ PST. כדי לבצע גיבוי של תיקיות שרת Exchange, ניתן לעקוב אחרי הצעדים הבאים.

1. צור מופע של IEWSClient.
2. הוסף את המידע הדרוש של התיקייה ל‑ ExchangeFolderInfoCollection
3. השתמש IEWSClient->Backup שיטה לייצא את תוכן התיקייה ל‑PST

קטע הקוד הבא מראה כיצד לגבות תיקיות Exchange ל‑PST.