کار با پیکربندی کاربر بر روی سرور

مدیریت پیکربندی کاربر

Aspose.Email برای Java می‌تواند برای مدیریت پیکربندی کاربر بر روی Exchange Server با استفاده از EWSClient کلاس. این کلاس از Exchange Web Services استفاده می‌کند که فقط در Exchange Server 2007 و نسخه‌های بعدی موجود است. در این مقاله، نحوهٔ خواندن، ایجاد، به‌روزرسانی و حذف پیکربندی‌های کاربر در Exchange Server 2010 را می‌بینیم. سرویس پک 1 Exchange Server 2010 برای تمام ویژگی‌های توضیح‌داده‌شده در این مقاله لازم است. قطعه کد زیر نشان می‌دهد چگونه در تمام مثال‌های این مقاله به 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. خواص پیکربندی کاربر مانند شناسه، نام و آیتم‌های دیکشنری را به صورت جفت کلید‑مقدار نمایش دهید.

قطعه کد زیر نشان می‌دهد چگونه پیکربندی کاربر را بخوانید.

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);