Работа с дистрибуционни списъци

Възможно е да създадете списък за разпращане (Distribution list) с помощта на Aspose.Email API, който е колекция от множество контакти. Списъкът за разпращане може да бъде записан на диск във формат Outlook MSG и може да се преглежда/манипулира, като се отвори в MS Outlook.

Създаване и запазване на дистрибуционни списъци

Следният фрагмент от код показва как да създадете и запазите дистрибуционен списък.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

String displayName1 = "Sebastian Wright";
String email1 = "[e-mail]";

String displayName2 = "Wichert Kroos";
String email2 = "[e-mail]";

String strEntryId1;
String strEntryId2;

// Create distribution list from contacts
try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_out.pst", FileFormatVersion.Unicode)) {
    // Add the contact folder to pst
    FolderInfo contactFolder = personalStorage.createPredefinedFolder("Contacts", StandardIpmFolder.Contacts);

    // Create contacts
    strEntryId1 = contactFolder.addMapiMessageItem(new MapiContact(displayName1, email1));
    strEntryId2 = contactFolder.addMapiMessageItem(new MapiContact(displayName2, email2));

    // Create distribution list on the base of the created contacts
    MapiDistributionListMember member1 = new MapiDistributionListMember(displayName1, email1);
    member1.setEntryIdType(MapiDistributionListEntryIdType.Contact);
    member1.setEntryId(Base64.getDecoder().decode(strEntryId1));

    MapiDistributionListMember member2 = new MapiDistributionListMember(displayName2, email2);
    member2.setEntryIdType(MapiDistributionListEntryIdType.Contact);
    member2.setEntryId(Base64.getDecoder().decode(strEntryId2));

    MapiDistributionListMemberCollection members = new MapiDistributionListMemberCollection();
    members.add(member1);
    members.add(member2);

    MapiDistributionList distributionList = new MapiDistributionList("Contact list", members);
    distributionList.setBody("Distribution List Body");
    distributionList.setSubject("Sample Distribution List using Aspose.Email");

    // Add distribution list to PST
    contactFolder.addMapiMessageItem(distributionList);
}

// Create one-off distribution list members (for which no separate contacts were created)
try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_OneOffmembers_out.pst", FileFormatVersion.Unicode)) {
    // Add the contact folder to pst
    FolderInfo contactFolder = personalStorage.createPredefinedFolder("Contacts", StandardIpmFolder.Contacts);

    MapiDistributionListMemberCollection oneOffmembers = new MapiDistributionListMemberCollection();
    oneOffmembers.add(new MapiDistributionListMember("John R. Patrick", "[e-mail]"));
    oneOffmembers.add(new MapiDistributionListMember("Tilly Bates", "[e-mail]"));

    MapiDistributionList oneOffMembersList = new MapiDistributionList("Simple list", oneOffmembers);
    contactFolder.addMapiMessageItem(oneOffMembersList);
}

Запазване на Mapi Distribution List в един много контактен VCF файл

Този void save(String fileName, MapiDistributionListSaveOptions options) методът позволява да запазите Mapi Distribution List в определено име на файл, използвайки предоставените опции за запазване. Можете да предоставите името на файла и инстанция на the MapiDistributionListSaveOptions клас като параметри. The MapiDistributionListSaveOptions класът съдържа опции за запазване на Mapi Distribution List. В този случай можете да укажете формат за запазване като VCard (ContactSaveFormat.VCard), за да запазите дистрибуционния списък като много контактен VCF файл.

Следният фрагмент от код демонстрира как да запазите дистрибуционен списък в много контактен VCF файл:

MapiDistributionList dlist = (MapiDistributionList)msg.toMapiMessageItem();
MapiDistributionListSaveOptions options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
dlist.save("distribution_list.vcf", options);

Четене на дистрибуционен списък от PST

Следният фрагмент от код показва как да прочетете дистрибуционен списък от PST файл.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String fileName = "outlook/message.msg";

MapiMessage message = MapiMessage.fromFile(fileName);
MapiDistributionList dlist = (MapiDistributionList)message.toMapiMessageItem();