إضافة جهات اتصال أو حذفها من Microsoft Exchange Server في Java

Microsoft Exchange Server هو خادم بريد إلكتروني وتقويم يوفر خدمات تعاون مختلفة مثل البريد الإلكتروني والتقويمات وإدارة جهات الاتصال وما إلى ذلك. في إحدى مشاركاتي ، لقد أوضحت لك كيفية الوصول إلى رسائل البريد الإلكتروني وقراءتها من Microsoft Exchange Server برمجيًا في Java. ومع ذلك ، غالبًا ما نحتاج إلى قائمة جهات الاتصال التي لدينا على خادم MS Exchange. لذلك في هذه المقالة ، ستتعلم كيفية إضافة جهات الاتصال أو حذفها أو تحديثها على Microsoft Exchange Server في Java.

Java API للوصول إلى جهات الاتصال على MS Exchange Server

Aspose.Email for Java هي واجهة برمجة تطبيقات شائعة لتنفيذ تطبيقات عميل البريد الإلكتروني في Java. علاوة على ذلك ، فإنه يسمح لك بالعمل مع MS Exchange Server والتعامل مع جهات الاتصال ورسائل البريد الإلكتروني وعناصر المحادثة. سنستخدم واجهة برمجة التطبيقات هذه لإضافة جهات الاتصال وتحديثها وحذفها على Exchange Server. يمكنك إما تنزيل JAR الخاص بواجهة برمجة التطبيقات أو تثبيته باستخدام تكوينات Maven التالية.

مخزن:

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>http://repository.aspose.com/repo/</url>
</repository>

الاعتماد:

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-email</artifactId>
    <version>22.2</version>
    <classifier>jdk16</classifier>
</dependency>

أضف جهات اتصال إلى MS Exchange Server في Java

فيما يلي خطوات إضافة جهات اتصال إلى Microsoft Exchange Server في Java.

  • أولاً ، قم بإنشاء وتهيئة كائن NetworkCredential باستخدام اسم المستخدم وكلمة المرور والمجال.
  • بعد ذلك ، قم بتهيئة IEWSClient باستخدام كائن URI الخاص بصندوق البريد وكائن NetworkCredential.
  • أنشئ كائنًا من فئة جهة اتصال وعيّن خصائصه مثل الاسم والوظيفة والجنس والهاتف والأشخاص المرتبطين ، إلخ.
  • أخيرًا ، قم باستدعاء طريقة EWSClient.createContact (جهة اتصال) لإضافة جهة اتصال.

يُظهر نموذج التعليمات البرمجية التالي كيفية إضافة جهة اتصال إلى Microsoft Exchange Server في Java.

// تعيين صندوق البريد URI واسم المستخدم وكلمة المرور ومعلومات المجال
String mailboxUri = "https://ex2010/ews/exchange.asmx";
String username = "test.exchange";
String password = "pwd";
String domain = "ex2010.local";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// إنشاء اتصال جديد
Contact contact = new Contact();

// تعيين معلومات عامة
contact.setGender(Gender.Male);
contact.setDisplayName("Frank Lin");
contact.setCompanyName("ABC Co.");
contact.setJobTitle("Executive Manager");
PhoneNumber tmp0 = new PhoneNumber();
tmp0.setNumber("123456789");
tmp0.setCategory(PhoneNumberCategory.getHome());

// أضف أرقام الهواتف
contact.getPhoneNumbers().add(tmp0);
AssociatedPerson tmp1 = new AssociatedPerson();
tmp1.setName("Catherine");
tmp1.setCategory(AssociatedPersonCategory.getSpouse());

// الأشخاص المرتبطين بالاتصال
contact.getAssociatedPersons().add(tmp1);
AssociatedPerson tmp2 = new AssociatedPerson();
tmp2.setName("Bob");
tmp2.setCategory(AssociatedPersonCategory.getChild());
contact.getAssociatedPersons().add(tmp2);
AssociatedPerson tmp3 = new AssociatedPerson();
tmp3.setName("Merry");
tmp3.setCategory(AssociatedPersonCategory.getSister());
contact.getAssociatedPersons().add(tmp3);
Url tmp4 = new Url();
tmp4.setHref("www.blog.com");
tmp4.setCategory(UrlCategory.getBlog());

// عناوين URL
contact.getUrls().add(tmp4);
Url tmp5 = new Url();
tmp5.setHref("www.homepage.com");
tmp5.setCategory(UrlCategory.getHomePage());
contact.getUrls().add(tmp5);
EmailAddress tmp6 = new EmailAddress();
tmp6.setAddress("Frank.Lin@Abc.com");
tmp6.setDisplayName("Frank Lin");
tmp6.setCategory(EmailAddressCategory.getEmail1());

// قم بتعيين عنوان البريد الإلكتروني لجهة الاتصال
contact.getEmailAddresses().add(tmp6);

try {
	// إنشاء اتصال
	client.createContact(contact);
} catch (java.lang.RuntimeException ex) {
	System.out.println(ex.getMessage());
}

حذف جهات الاتصال من MS Exchange Server في Java

يمكنك أيضًا حذف جهة اتصال من MS Exchange Server. لتصفية جهات الاتصال ، يمكنك استخدام الاسم أو البريد الإلكتروني أو أي خاصية أخرى مناسبة. فيما يلي خطوات حذف جهة اتصال من Microsoft Exchange Server في Java.

يوضح نموذج التعليمات البرمجية التالي كيفية حذف جهات الاتصال من Microsoft Exchange Server في Java.

// تهيئة عميل EWS
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// اسم جهة الاتصال
String strContactToDelete = "John Teddy";

// احصل على جهات اتصال
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());

// حلقة من خلال جهات الاتصال
for (Contact contact : contacts) {
    if (contact.getDisplayName().equals(strContactToDelete))
    	// حذف اتصال
        client.deleteItem(contact.getId().getEWSId(), DeletionOptions.getDeletePermanently());
}
client.dispose();

قم بتحديث جهة اتصال على Exchange Server في Java

Aspose.Email for Java يسمح لك أيضًا بتحديث جهة اتصال على MS Exchange Server. فيما يلي خطوات إجراء هذه العملية.

  • أولاً ، قم بإنشاء وتهيئة كائن NetworkCredential باستخدام اسم المستخدم وكلمة المرور والمجال.
  • بعد ذلك ، قم بتهيئة IEWSClient باستخدام كائن URI الخاص بصندوق البريد وكائن NetworkCredential.
  • احصل على جهات اتصال من Exchange Server باستخدام طريقة IEWSClient.getContacts (EWSClient.getMailboxInfo().getContactsUri()).
  • بعد ذلك ، مرر عبر جهات الاتصال وقم بتصفية جهة الاتصال المطلوبة.
  • أخيرًا ، قم بتحديث خصائص جهة الاتصال واتصل بـ IEWSClient.updateContact (جهة اتصال) لحفظها.

يوضح نموذج التعليمات البرمجية التالي كيفية تحديث جهة اتصال على MS Exchange Server في Java.

// تعيين صندوق البريد URI واسم المستخدم وكلمة المرور ومعلومات المجال
String mailboxUri = "https://ex2010/ews/exchange.asmx";
String username = "test.exchange";
String password = "pwd";
String domain = "ex2010.local";
NetworkCredential credentials = new NetworkCredential(username, password, domain);

// تهيئة عميل EWS
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// قائمة بجميع جهات الاتصال وحلقة من خلال جميع جهات الاتصال
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
Contact contact = contacts[0];

// تحديث تفاصيل الاتصال
System.out.println("Name: " + contact.getDisplayName());
contact.setDisplayName("David Ch");
client.updateContact(contact);

احصل على ترخيص API مجاني

يمكنك الحصول على ترخيص مؤقت مجاني لاستخدام Aspose.Email لجافا بدون قيود تقييم.

استنتاج

في هذه المقالة ، تعلمت كيفية العمل مع جهات الاتصال على Microsoft Exchange Server في Java. لقد أوضحنا كيفية إضافة جهات الاتصال وإزالتها وتحديثها من MS Exchange Server في Java. بالإضافة إلى ذلك ، يمكنك استكشاف التوثيق لقراءة المزيد عن Aspose.Email لجافا. أيضًا ، يمكنك نشر استفساراتك على المنتدى.

أنظر أيضا