עבודה עם תצורת משתמש בשרת

ניהול תצורת משתמש

ניתן להשתמש ב‑Aspose.Email ל‑Java כדי לנהל תצורת משתמש על Exchange Server עם ה‑ EWSClient מחלקה. מחלקה זו משתמשת ב‑Exchange Web Services, הזמינות רק ב‑Exchange Server 2007 וגרסאות מאוחרות יותר. במאמר זה נראה כיצד לקרוא, ליצור, לעדכן ולמחוק תצורות משתמש ב‑Exchange Server 2010. נדרש Microsoft Exchange Server 2010 Service Pack 1 לכל הפיצ’רים המתוארים במאמר זה. קטע הקוד הבא מראה לך כיצד להתחבר ל‑Exchange Server 2010 בכל הדוגמאות במאמר זה.

private static IEWSClient getExchangeEWSClient() {
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String domain = "";
    final String username = "username@ASE305.onmicrosoft.com";
    final String password = "password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
    return client;
}

קריאת תצורת משתמש

כדי לקבל את מידע תצורת המשתמש של תיקייה ספציפית מה‑Exchange Server:

  1. התחבר ל‑Exchange Server באמצעות מחלקת IEWSClient.
  2. קרא למתודה IEWSClient.getUserConfiguration() כדי לקבל את תצורת המשתמש עבור תיקייה.
  3. הצג את תכונות תצורת המשתמש כגון מזהה (ID), שם ופריטי מילון כזוגות מפתח‑ערך.

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

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Get the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);

System.out.println("Configuration Id: " + userConfig.getId());
System.out.println("Configuration Name: " + userConfig.getUserConfigurationName().getName());
System.out.println("Key value pairs:");
// foreach to while statements conversion
for (Object key : userConfig.getDictionary().keySet()) {
    System.out.println(key + ": " + userConfig.getDictionary().get(key).toString());
}

יצירת תצורות משתמש

כדי ליצור את תצורת המשתמש עבור תיקייה ספציפית ב‑Exchange Server:

  1. התחבר ל‑Exchange Server באמצעות מחלקת IEWSClient.
  2. קרא למתודה IEWSClient.createUserConfiguration() כדי ליצור את תצורת המשתמש עבור תיקייה.

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

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = new UserConfiguration(userConfigName);
userConfig.getDictionary().put("key1", "value1");
userConfig.getDictionary().put("key2", "value2");
userConfig.getDictionary().put("key3", "value3");
client.createUserConfiguration(userConfig);

עדכון תצורת משתמש

כדי לעדכן את תצורת המשתמש עבור תיקייה ספציפית ב‑Exchange Server:

  1. התחבר ל‑Exchange Server באמצעות מחלקת IEWSClient.
  2. קרא למתודה IEWSClient.updateUserConfiguration() כדי לעדכן את תצורת המשתמש עבור תיקייה.

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

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);
userConfig.setId(null);

// Update User Configuration
userConfig.getDictionary().put("key1", "new-value1");
client.updateUserConfiguration(userConfig);

מחיקת תצורת משתמש

כדי למחוק את תצורת המשתמש עבור תיקייה ספציפית ב‑Exchange Server:

  1. התחבר ל‑Exchange Server באמצעות מחלקת IEWSClient.
  2. קרא למתודה IEWSClient.deleteUserConfiguration() כדי למחוק את תצורת המשתמש עבור תיקייה.

קוד הדוגמה הבא מראה לך כיצד למחוק תצורת משתמש.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Delete User Configuration
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
client.deleteUserConfiguration(userConfigName);