Documentation – Outlook 저장 파일(OST 또는 PST) 작업

Python-Net: Python에서 PST 파일 생성 및 정리

Mon, 01 Jan 0001 00:00:00 +0000

새 PST 파일 생성 및 하위 폴더 추가

Aspose.Email는 처음부터 Personal Storage Table (PST) 파일을 생성하고 하위 폴더를 추가하는 기능을 제공합니다. With the PersonalStorage 클래스를 사용하면 이메일 메시지, 캘린더 이벤트, 연락처 및 기타 데이터를 저장하는 PST 파일과 관련된 작업을 관리할 수 있습니다.

다음 코드 샘플은 새 저장 파일을 생성하고 그 안에 "Inbox" 폴더를 추가하는 방법을 보여줍니다:

다음 사용 PersonalStorage.create 지정된 디렉터리로 새 PST 파일을 생성하는 메서드. 파일은 the 를 사용하여 생성됩니다 UNICODE 현대 애플리케이션과의 호환성을 위한 포맷.
PST 파일의 루트 폴더에 접근하고 "Inbox"라는 새 하위 폴더를 추가하여 이메일 메시지를 정리합니다.

컨테이너 클래스 매칭 검사

Aspose.Email for Python은 PST 파일에서 폴더 생성 시 검증 프로세스를 강화하는 솔루션을 제공합니다. enforce_container_class_matching 속성을 사용하여 the FolderCreationOptions 클래스를 사용하면 PST 저장소에 새 폴더를 추가할 때 컨테이너 클래스가 엄격히 일치하도록 할 수 있습니다. 이 기능은 컨테이너 클래스 불일치를 방지하여 PST 파일 내 조직 계층을 유지하는 데 도움을 줍니다. ‘EnforceContainerClassMatching’을 ’true’로 설정하면 부모와 자식 폴더의 컨테이너 클래스가 일치하지 않을 경우 예외가 발생해 잘못된 폴더 구조를 방지합니다. 이 속성의 기본값은 ‘false’이며, 폴더 생성 시 유연성을 허용하면서 필요할 때 엄격한 컨테이너 클래스 일치를 강제할 수 있습니다.

다음 코드 샘플은 enforce_container_class_matching 속성을 사용하여 컨테이너 클래스가 일치하지 않는 폴더를 추가할 때 예외를 발생시킬지 여부를 제어하는 방법을 보여줍니다:

with PersonalStorage.create("storage.pst", FileFormatVersion.Unicode) as pst:
    contacts = pst.createpredefinedfolder("Contacts", StandardIpmFolder.Contacts)
    
    # An exception will not arise. EnforceContainerClassMatching is False by default.
    contacts.addsubfolder("Subfolder1", "IPF.Note")
    
    # An exception will occur as the container class of the subfolder being added (IPF.Note)
    # does not match the container class of the parent folder (IPF.Contact).
    contacts.addsubfolder("Subfolder3", FolderCreationOptions(enforcecontainerclassmatching=True, containerclass="IPF.Note"))

폴더 컨테이너 클래스 변경

때때로 폴더 클래스를 변경해야 할 필요가 있습니다. 일반적인 예는 서로 다른 유형(약속, 메시지 등)의 메시지가 동일한 폴더에 추가될 때입니다. 이 경우 폴더 내 모든 요소가 올바르게 표시되도록 폴더 클래스를 변경해야 합니다. 아래 코드 스니펫은 이를 위해 PST에서 폴더의 컨테이너 클래스를 변경하는 방법을 보여줍니다:

성능 향상을 위한 일괄 메시지 추가

PST 파일에 개별적으로 추가하는 대신 대량으로 메시지를 추가하면 효율성과 성능 측면에서 여러 이점이 있습니다: I/O 작업 감소, 작업 완료 시간 단축, 시스템 자원 효율적 사용 등. add_messages 메서드는 the FolderInfo 클래스는 소스 폴더에서 가져온 MAPI 메시지 컬렉션을 대상 폴더로 전달하는 데 사용됩니다.

다른 PST에서 메시지 추가

PST 파일의 소스 폴더에서 모든 MAPI 메시지를 열거하고 가져오려면, 의 enumerate_mapi_messages() 메서드를 사용합니다 FolderInfo 클래스. 그런 다음, 이 메시지들을 다른 PST 파일의 대상 폴더에 추가합니다.

import aspose.email as ae

src_pst = ae.storage.pst.PersonalStorage.from_file("source.pst", False)
dest_pst = ae.storage.pst.PersonalStorage.from_file("destination.pst")

# Get the folder by name
src_folder = src_pst.root_folder.get_sub_folder("SomeFolder")
dest_folder = dest_pst.root_folder.get_sub_folder("SomeFolder")

dest_folder.add_messages(src_folder.enumerate_mapi_messages())

디렉터리에서 메시지 추가

디렉터리에서 메시지를 추가하려면 파일을 열고 PST 파일 내 특정 폴더에 대한 참조를 얻은 후, "path" 변수로 지정된 디렉터리에서 파일 이름 목록을 가져와 각 파일을 MapiMessage로 로드하기 위한 빈 MSG 리스트를 생성합니다. 각 로드된 메시지를 msg_list에 추가합니다. 아래 코드 샘플은 디렉터리에서 메시지를 추가하는 과정을 보여줍니다:

import aspose.email as ae
import os

pst = ae.storage.pst.PersonalStorage.from_file("my.pst", False)

# Get the folder by name
folder = pst.root_folder.get_sub_folder("SomeFolder")

dirs = os.listdir("path")
msg_list = []

for file in dirs:
    msg = ae.mapi.MapiMessage.load(file)
    msg_list.append(msg)

folder.add_messages(iter(msg_list))

Python-Net: Outlook OST 파일 읽기 및 변환

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for .NET은 Microsoft Outlook OST 파일을 읽기 위한 API를 제공합니다. 디스크나 스트림에서 OST 파일을 로드하여 해당 클래스의 인스턴스로 만들 수 있습니다. Aspose.Email.Outlook.Pst.PersonalStorage 클래스이며 폴더, 하위 폴더 및 메시지와 같은 내용 정보를 가져옵니다. Microsoft Outlook은 POP3 또는 IMAP 메일 서버를 사용해 메시지를 다운로드할 때 이메일을 저장하기 위해 PST 파일을 생성하고, Microsoft Exchange를 메일 서버로 사용할 경우 OST 파일을 생성합니다. OST 파일은 PST 파일보다 더 큰 파일 크기를 지원하도록 설계되었습니다.

OST 파일 읽기

Aspose.Email를 사용해 OST 파일을 읽는 과정은 PST 파일을 읽는 것과 정확히 동일합니다. 동일한 코드로 PST와 OST 파일 모두를 읽을 수 있습니다: 올바른 파일 이름을 제공하기만 하면 됩니다. PersonalStorage.from_file() 메서드. 다음 코드 스니펫은 OST 파일을 읽는 방법을 보여줍니다:

OST를 PST로 변환

사용해 보세요!

무료로 이메일 및 메시지 아카이브를 온라인에서 변환하세요 Aspose.Email 변환 앱.

Aspose.Email를 사용하면 한 줄의 코드로 OST 파일을 PST로 변환할 수 있습니다. 마찬가지로, 동일한 코드 한 줄로 PST 파일에서 OST 파일을 생성할 수도 있습니다: FileFormat 열거자. 현재 API는 OST 2013/2016을 제외한 OST 형식을 PST로 변환하는 것을 지원합니다. 다음 코드 스니펫은 OST를 PST로 변환하는 방법을 보여줍니다:

PST를 OST로 변환

Aspose.Email에서는 PST를 OST로 변환하는 것을 지원하지 않습니다. OST는 계정을 추가하고 메일 서버와 동기화할 때 Outlook에 의해 항상 생성되기 때문입니다. PST와 OST 파일의 차이는 PST는 로컬에만 존재하고, OST 내용은 이메일 서버에도 존재한다는 점입니다. 따라서 로컬 용도로 PST를 OST로 변환할 필요가 없습니다. 대신 Outlook의 가져오기/내보내기 마법사를 사용해 PST를 기존 계정으로 가져올 수 있습니다.

OST 파일에 대한 다른 작업을 수행하려면 다음 페이지를 참고하십시오:

Outlook PST 파일을 읽고 폴더 및 하위 폴더 정보 얻기
Outlook PST 파일에서 메시지 정보 가져오기
Outlook PST 파일에서 메시지를 추출하고 MSG 형식으로 디스크 또는 스트림에 저장
Outlook PST 파일에서 연락처 정보를 가져와 MSG 형식으로 디스크에 저장

Python-Net: Aspose.Email for Python .NET을 사용하여 Outlook PST 파일 읽기

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for .NET은 Microsoft Outlook PST 파일을 읽기 위한 API를 제공합니다. 디스크 또는 스트림에서 PST 파일을 로드하여 다음 인스턴스에 넣을 수 있습니다: PersonalStorage 클래스는 폴더, 하위 폴더, 메시지와 같은 내용에 대한 상세 정보를 접근하도록 합니다. 또한, API는 PST 폴더에서 메시지를 검색할 때 검색 폴더를 포함하는 기능을 제공합니다.

PST 파일 로드

Outlook PST 파일은 다음 인스턴스에 로드할 수 있습니다: PersonalStorage 클래스. 다음 코드 스니펫은 PST 파일을 로드하는 방법을 보여줍니다.

PST 정보 표시

이후 PST 파일 로드, 파일 표시 이름, 루트 폴더, 하위 폴더 및 메시지 수에 대한 정보를 얻을 수 있습니다. 다음 코드 스니펫은 PST 파일 이름, 폴더 및 폴더별 메시지 수를 표시하는 방법을 보여줍니다:

사용자 생성 폴더만 가져오기

PST/OST 파일에는 사용자가 만든 폴더가 포함될 수 있으며, 이는 모든 표준 IPM 폴더를 제외합니다. Aspose.Email은 해당 클래스의 only_folders_created_by_user 속성을 사용하여 사용자 생성 폴더만 접근하는 기능을 제공합니다. PersonalStorageQueryBuilder 클래스. 이 속성을 True로 설정하면 사용자 생성 폴더만 가져옵니다. 다음 코드 스니펫은 프로젝트에서 only_folders_created_by_user 속성을 사용하는 방법을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

query_builder = ae.storage.pst.PersonalStorageQueryBuilder()
query_builder.only_folders_created_by_user.equals(True)

folders = pst.root_folder.get_sub_folders(query_builder.get_query())

for folder in folders:
    print(f"Folder: {folder.display_name}")

사전 정의 폴더 식별

PST 파일 내 폴더가 표준 폴더인지 확인하려면 해당 클래스의 get_predefined_type 메서드를 사용하십시오: FolderInfo 클래스. 사용자 생성 폴더와 달리 표준(또는 사전 정의) 폴더는 Outlook이 이메일 계정을 추가할 때 생성되는 폴더이며, 예를 들어 받은 편지함, 보낸 편지함, 초안, 삭제된 항목, 일정, 작업, 메모 등이 있습니다.

아래 코드 샘플은 프로젝트에서 이 메서드를 사용하는 방법을 보여줍니다. True로 설정하면 최상위 상위 폴더에 대한 사전 정의 유형을 반환합니다. 이는 현재 폴더가 사전 정의된 폴더의 하위 폴더인지 여부를 결정합니다. False로 설정하면 현재 폴더에 대한 사전 정의 유형을 반환합니다.

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folders = pst.root_folder.get_sub_folders()

for folder in folders:
    print(f"Folder: {folder.display_name}")
    print(f"Is predefined: {folder.get_predefined_type(False) != ae.storage.pst.StandardIpmFolder.UNSPECIFIED}")
    print("-----------------------------------")

PersonalStorage에서 RSS 피드 관리

Aspose.Email은 RSS 피드 사전 정의 폴더에 대한 참조를 가져오는 기능을 제공하여 개발자가 Outlook PST 파일에 저장된 RSS 피드에 프로그램matically 액세스하고 조작할 수 있도록 합니다. "RSS 피드 폴더"에 대한 참조를 얻음으로써 개발자는 새 피드 구독, 기존 피드 업데이트 또는 피드에서 정보 추출과 같은 작업을 수행할 수 있습니다.

RssFeeds의 값은 StandardIpmFolder enum은 일반적으로 Outlook PST 파일 내에서 RSS 피드를 저장하도록 설계된 사전 정의된 폴더 유형을 나타냅니다. 이 enum 값을 사용하면 개발자는 프로그램matically "RSS 피드 폴더"를 목표로 하고 상호 작용할 수 있습니다. 다음 코드 샘플은 이 기능을 프로젝트에 구현하는 방법을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

rss_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.RSS_FEEDS)

RSS 피드 폴더를 추가하려면, 다음 코드 스니펫을 사용하십시오:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

rss_folder = pst.create_predefined_folder("RSS Feeds", ae.storage.pst.StandardIpmFolder.RSS_FEEDS)

검색 가능한 폴더 구문 분석

Aspose.Email은 FolderKind 다양한 종류의 PST 폴더와 작업하기 위한 열거형입니다. NORMAL 폴더 외에도 SEARCH 폴더와 작동합니다. SEARCH 폴더는 특정 검색 기준에 일치하는 모든 이메일 항목을 표시하는 가상 폴더입니다. SEARCH 폴더를 구문 분석하려면 다음 코드 스니펫을 사용하십시오:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folders = pst.root_folder.get_sub_folders(ae.storage.pst.FolderKind.SEARCH | ae.storage.pst.FolderKind.NORMAL)

# Browse through each folder to display folder name and number of messages
for folder in folders:
    print(f"Folder: {folder.display_name}")
    sub_folders = folder.get_sub_folders(ae.storage.pst.FolderKind.SEARCH | ae.storage.pst.FolderKind.NORMAL)
    for sub_folder in sub_folders:
        print(f"Sub-folder: {folder.display_name}")

상위 폴더 정보 가져오기

다음 코드 스니펫은 부모 폴더 정보를 다음으로부터 가져오는 방법을 보여줍니다: MessageInfo.

경로를 사용한 PST 하위 폴더 검색

경로를 사용하여 PST 하위 폴더를 검색하려면 해당 클래스의 get_sub_folder 메서드를 사용하십시오: FolderInfo 클래스. 디렉터리 또는 파일 시스템 내에서 특정 하위 폴더를 검색합니다.

이 메서드는 다음 매개변수를 사용합니다:

name - 가져와야 할 하위 폴더의 이름을 나타냅니다. 메서드가 검색할 하위 폴더의 이름 또는 식별자를 지정하는 데 사용됩니다.
ignore_case - 하위 폴더 이름을 비교할 때 대소문자를 무시할지 여부를 결정하는 부울 값입니다. True로 설정하면 메서드는 대소문자를 구분하지 않고 이름을 일치시킵니다(예: "folder"와 "Folder"를 동일하게 취급). False로 설정하면 대소문자를 구분하여 비교합니다.
handle_path_separator - 경로 구분자를 하위 폴더 검색 시 처리할지 여부를 지정하는 부울 값입니다. 경로 구분자는 디렉터리 경로에서 폴더를 구분하는 문자이며(예: Windows의 "\" 또는 Unix의 "/"), True로 설정하면 메서드가 경로 구분자를 자동으로 처리하여 올바른 폴더 매칭을 보장합니다. False로 설정하면 경로 구분자를 하위 폴더 이름의 일부로 취급하여 검색 동작이 달라집니다.

다음 코드 샘플은 경로를 사용하여 PST 하위 폴더를 가져오는 방법을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

# In this sample, the method will return a ‘Jan’ named folder
# that is located at the Inbox\Reports\ path 
# relative to the root folder.
folder = pst.root_folder.get_sub_folder("Inbox\Reports\Jan", True, True)

Python-Net: PST 파일 분할 및 병합

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email API는 단일 PST 파일을 원하는 파일 크기의 여러 PST 파일로 분할할 수 있는 기능을 제공합니다. 또한 여러 PST 파일을 하나의 PST 파일로 병합할 수 있습니다. 분할 및 병합 작업은 해당 작업에 이벤트를 추가하여 추적할 수 있습니다.

사용해 보세요!

무료로 여러 이메일 파일을 온라인에서 하나로 병합 및 결합합니다 Aspose.Email Merger App.

PST 파일 분할

다수의 PST로 분할

다음 코드 스니펫은 저장 파일을 여러 파일로 분할하는 방법을 보여줍니다:

import os
from aspose.email.storage.pst import PersonalStorage

data_dir = "DataDir_Outlook"
dst_split = os.path.join(data_dir, "Chunks")

# Delete the files if already present
for file in os.listdir(dst_split):
    file_path = os.path.join(dst_split, file)
    if os.path.isfile(file_path):
        os.remove(file_path)

pst_file = os.path.join(data_dir, "pst.pst")

try:
    with PersonalStorage.from_file(pst_file) as personal_storage:
        # Splits into PST chunks with a size of 5MB
        personal_storage.split_into(5000000, dst_split)

except Exception as ex:
    print(str(ex))
    print("This example will only work if you apply a valid Aspose.Email License. "
          "You can purchase a full license or get a 30-day"
          " temporary license from http://www.aspose.com/purchase/default.aspx.")

특정 기준에 따라 분할

다음 코드 스니펫은 지정된 기준으로 저장 파일을 분할하는 방법을 보여줍니다:

import os
from datetime import datetime
from aspose.email.tools.search import MailQueryBuilder
from aspose.email.storage.pst import PersonalStorage

data_dir = "DataDir_Outlook"
path_to_pst = os.path.join(data_dir, "pathToPst")
pst_file = os.path.join(data_dir, "PersonalStorage_New.pst")

# Define search criteria
builder = MailQueryBuilder()
builder.sent_date.since(datetime(2005, 4, 1))
builder.sent_date.before(datetime(2005, 4, 7))
query = builder.get_query()

# Delete existing PST files if any
if os.path.exists(path_to_pst):
    for file in os.listdir(path_to_pst):
        file_path = os.path.join(path_to_pst, file)
        if os.path.isfile(file_path) and file.endswith(".pst"):
            os.remove(file_path)

# Split Personal Storage into multiple PST files based on criteria
with PersonalStorage.from_file(pst_file) as personal_storage:
    personal_storage.split_into(query, path_to_pst)

PST 파일 병합

단일 PST로 병합

다음 코드 스니펫은 여러 저장 파일을 하나로 병합하는 방법을 보여줍니다:

import os
from aspose.email.storage.pst import PersonalStorage

data_dir = "DataDir_Outlook"
sub_pst = os.path.join(data_dir, "Sub.pst")
merge_folder = os.path.join(data_dir, "MergePST")
total_added = 0

try:
    with PersonalStorage.from_file(sub_pst) as personal_storage:
        # Merge with the PST files located in the separate folder.
        personal_storage.merge_with(os.path.join(merge_folder, "*"))
        print("Total messages added:", total_added)

    print("\nPST merged successfully at", sub_pst)
except Exception as ex:
    print(ex)
    print("This example will only work if you apply a valid Aspose Email License. "
          "You can purchase a full license or get a 30-day temporary license "
          "from http://www.aspose.com/purchase/default.aspx.")

다른 PST에서 폴더 병합

다음 코드 스니펫은 다른 PST의 폴더를 병합하는 방법을 보여줍니다:

from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder

data_dir = "DataDir_Outlook\\"
destination_pst = PersonalStorage.from_file(data_dir + "destination.pst")
source_pst = PersonalStorage.from_file(data_dir + "source.pst")
total_added = 0

try:
    with destination_pst, source_pst:
        destination_folder = destination_pst.root_folder.add_sub_folder("FolderFromAnotherPst")
        source_folder = source_pst.get_predefined_folder(StandardIpmFolder.DELETED_ITEMS)

        # Merge with the folder from another PST.
        destination_folder.merge_with(source_folder)
        print("Total messages added:", total_added)

except Exception as ex:
    print(ex)
    print("This example will only work if you apply a valid Aspose Email License. "
          "You can purchase a full license or get a 30-day temporary license "
          "from http://www.aspose.com/purchase/default.aspx.")

Python-Net: PST 파일에서 캘린더 항목 관리

Mon, 01 Jan 0001 00:00:00 +0000

PST 파일에 캘린더 이벤트 추가

새 PST 파일 만들기 및 서브 폴더 추가 PST 파일을 생성하고 서브 폴더를 포함하는 방법을 보여줍니다. Aspose.Email을 사용하면 기존 또는 새로 만든 PST 파일의 Calendar 서브 폴더에 MapiCalendar를 추가할 수도 있습니다. 아래는 PST 파일에 MapiCalendar를 추가하는 단계입니다:

다음을 생성합니다 MapiCalendar 객체.
생성자와 메서드를 사용하여 MapiCalendar 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
루트 폴더에 접근한 후 add_mapi_message_item() 메서드를 호출하여 PST 파일 루트에 사전 정의된 폴더(캘린더)를 생성합니다.

다음 코드 스니펫은 MapiCalendar를 생성하고 이를 새롭게 만든 PST 파일의 캘린더 폴더에 추가하는 방법을 보여줍니다:

Outlook 캘린더 항목을 ICS 파일로 저장

이 문서는 Outlook PST 파일에서 캘린더 항목에 접근하고 이를 디스크에 ICS 형식으로 저장하는 방법을 설명합니다. 다음을 사용해야 합니다 the PersonalStorage 및 MapiCalendar 클래스를 사용하여 캘린더 데이터를 가져옵니다. 캘린더 항목을 저장하기 위한 단계는 다음과 같습니다:

다음 방법을 사용해 PST 파일을 로드합니다 the PersonalStorage 클래스.
캘린더 폴더로 이동합니다.
캘린더 폴더에서 메시지 컬렉션을 가져옵니다.
메시지 컬렉션을 반복합니다.
다음 사용 PersonalStorage.extract_message() 연락처 정보를 얻는 메서드 in the MapiCalendar 클래스.
다음 사용 MapiCalendar.save() 각 캘린더 항목을 디스크에 ICS 형식으로 저장하는 메서드.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 캘린더 항목을 ICS 형식으로 저장합니다. 이러한 ICS 파일은 표준 ICS 캘린더 파일을 지원하는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 열면 아래 스크린샷과 같이 표시됩니다.

다음 코드 스니펫은 Outlook PST에서 캘린더 항목을 ICS 형식으로 내보내는 방법을 보여줍니다:

원본 타임스탬프와 함께 ICS 파일 저장

클래스의 keep_original_date_time_stamp 메서드 MapiCalendarIcsSaveOptions 클래스는 캘린더 항목을 ICS(iCalendar) 파일로 저장할 때 원본 날짜 및 시간 스탬프를 보존할 수 있게 합니다. 다음 코드 샘플은 이 메서드의 구현을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

calendar_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.APPOINTMENTS)

for msg_info in calendar_folder.enumerate_messages():
    cal = pst.extract_message(msg_info).to_mapi_message_item()

    save_options = ae.mapi.MapiCalendarIcsSaveOptions()
    save_options.keep_original_date_time_stamp = True

    if not (cal is None):
      cal.save("cal.ics", save_options)

PST 파일에서 반복 발생 수정 또는 삭제

Aspose.Email for .NET API를 사용하여 PST 파일에서 기존 반복 패턴에 예외를 추가하거나 특정 발생을 삭제할 수 있습니다. 다음 코드 예제는 이러한 수정 방법을 보여줍니다:

from datetime import datetime, timedelta
from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder, FileFormatVersion
from aspose.email.mapi import MapiCalendar, MapiCalendarEventRecurrence, \
    MapiCalendarDailyRecurrencePattern, MapiCalendarRecurrenceEndType, \
    MapiCalendarExceptionInfo, MapiCalendarRecurrencePatternType, \
    MapiRecipientCollection, MapiRecipientType

start_date = datetime.now().date()

recurrence = MapiCalendarEventRecurrence()
pattern = MapiCalendarDailyRecurrencePattern()
pattern.pattern_type = MapiCalendarRecurrencePatternType.DAY
pattern.period = 1
pattern.end_type = MapiCalendarRecurrenceEndType.NEVER_END
recurrence.recurrence_pattern = pattern

exception_date = start_date + timedelta(days=1)

# adding one exception
exception_info = MapiCalendarExceptionInfo()
exception_info.location = "London"
exception_info.subject = "Subj"
exception_info.original_start_date = exception_date
exception_info.start_date_time = exception_date
exception_info.end_date_time = exception_date + timedelta(hours=5)
pattern.exceptions.append(exception_info)
pattern.modified_instance_dates.append(exception_date)
# every modified instance also has to have an entry in the DeletedInstanceDates field with the original instance date.
pattern.deleted_instance_dates.append(exception_date)

# adding one deleted instance
pattern.deleted_instance_dates.append(exception_date + timedelta(days=2))

rec_coll = MapiRecipientCollection()
rec_coll.add("receiver@domain.com", "receiver", MapiRecipientType.TO)
new_cal = MapiCalendar(
    "This is Location",
    "This is Summary",
    "This is recurrence test",
    start_date,
    start_date + timedelta(hours=3),
    "organizer@domain.com",
    rec_coll
)
new_cal.recurrence = recurrence

with PersonalStorage.create("output.pst", FileFormatVersion.UNICODE) as pst:
    calendar_folder = pst.create_predefined_folder("Calendar", StandardIpmFolder.APPOINTMENTS)
    calendar_folder.add_message(new_cal)

Python-Net: PST 파일에서 캘린더 항목 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiCalendar 추가

새 PST 파일을 만들고 하위 폴더를 추가하기는 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 캘린더 하위 폴더에 MapiCalendar를 추가할 수 있습니다. 아래는 PST에 MapiCalendar를 추가하는 단계입니다:

MapiCalendar 객체를 생성합니다.
생성자와 메서드를 사용하여 MapiCalendar 속성을 설정합니다.
PersonalStorage.create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 후 add_mapi_message_item() 메서드를 호출하여 PST 파일 루트에 사전 정의된 폴더(캘린더)를 생성합니다.

다음 코드 스니펫은 MapiCalendar를 생성하고 새로 만든 PST 파일의 캘린더 폴더에 추가하는 방법을 보여줍니다.

PST에서 캘린더 항목을 ICS 형식으로 디스크에 저장

이 문서는 Outlook PST 파일에서 캘린더 항목에 접근하고 캘린더를 ICS 형식으로 디스크에 저장하는 방법을 보여줍니다. 캘린더 정보를 가져오기 위해 PersonalStorage 및 MapiCalendar 클래스를 사용합니다. 캘린더 항목을 저장하는 단계는 다음과 같습니다:

PersonalStorage 클래스에서 PST 파일을 로드합니다.
캘린더 폴더 탐색.
캘린더 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
PersonalStorage.extract_message() 메서드를 호출하여 MapiCalendar 클래스의 연락처 정보를 가져옵니다.
MapiCalendar.save() 메서드를 호출하여 캘린더 항목을 ICS 형식으로 디스크에 저장합니다.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 캘린더 항목을 ICS 형식으로 저장합니다. ICS 파일은 표준 ICS 캘린더 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 열면 아래 스크린샷과 같은 형태로 표시됩니다.

|| | :- | 다음 코드 스니펫은 Outlook PST에서 캘린더 항목을 ICS 형식으로 내보내는 방법을 보여줍니다.

원본 타임스탬프와 함께 ICS로 저장

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

calendar_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.APPOINTMENTS)

for msg_info in calendar_folder.enumerate_messages():
    cal = pst.extract_message(msg_info).to_mapi_message_item()

    save_options = ae.mapi.MapiCalendarIcsSaveOptions()
    save_options.keep_original_date_time_stamp = True

    if not (cal is None):
      cal.save("cal.ics", save_options)

반복 항목에서 발생 인스턴스 수정/삭제

Aspose.Email for .NET API를 사용하여 기존 반복에 예외를 추가할 수 있습니다. 다음 코드 샘플은 이 기능의 사용법을 보여줍니다.

from datetime import datetime, timedelta
from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder, FileFormatVersion
from aspose.email.mapi import MapiCalendar, MapiCalendarEventRecurrence, \
    MapiCalendarDailyRecurrencePattern, MapiCalendarRecurrenceEndType, \
    MapiCalendarExceptionInfo, MapiCalendarRecurrencePatternType, \
    MapiRecipientCollection, MapiRecipientType

start_date = datetime.now().date()

recurrence = MapiCalendarEventRecurrence()
pattern = MapiCalendarDailyRecurrencePattern()
pattern.pattern_type = MapiCalendarRecurrencePatternType.DAY
pattern.period = 1
pattern.end_type = MapiCalendarRecurrenceEndType.NEVER_END
recurrence.recurrence_pattern = pattern

exception_date = start_date + timedelta(days=1)

# adding one exception
exception_info = MapiCalendarExceptionInfo()
exception_info.location = "London"
exception_info.subject = "Subj"
exception_info.original_start_date = exception_date
exception_info.start_date_time = exception_date
exception_info.end_date_time = exception_date + timedelta(hours=5)
pattern.exceptions.append(exception_info)
pattern.modified_instance_dates.append(exception_date)
# every modified instance also has to have an entry in the DeletedInstanceDates field with the original instance date.
pattern.deleted_instance_dates.append(exception_date)

# adding one deleted instance
pattern.deleted_instance_dates.append(exception_date + timedelta(days=2))

rec_coll = MapiRecipientCollection()
rec_coll.add("receiver@domain.com", "receiver", MapiRecipientType.TO)
new_cal = MapiCalendar(
    "This is Location",
    "This is Summary",
    "This is recurrence test",
    start_date,
    start_date + timedelta(hours=3),
    "organizer@domain.com",
    rec_coll
)
new_cal.recurrence = recurrence

with PersonalStorage.create("output.pst", FileFormatVersion.UNICODE) as pst:
    calendar_folder = pst.create_predefined_folder("Calendar", StandardIpmFolder.APPOINTMENTS)
    calendar_folder.add_message(new_cal)

Python-Net: PST 파일에서 Outlook 연락처 관리

Mon, 01 Jan 0001 00:00:00 +0000

Outlook 연락처를 PST 파일에 추가

새 PST 파일 만들기 및 서브 폴더 추가 PST 파일을 생성하고 그 안에 서브 폴더를 포함하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Contacts 서브 폴더에 MapiContact를 추가할 수 있습니다. 아래는 PST 파일에 MapiContact를 추가하는 단계입니다:

다음을 생성합니다 MapiContact 객체.
다양한 생성자와 메서드를 사용하여 이름, 성별, 이메일 주소, 전화 번호, 물리적 주소 및 직업 정보를 포함한 MapiContact 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Contacts)를 생성합니다. add_mapi_message_item() 메서드.

다음 코드 스니펫은 MAPI 연락처를 생성하고 이를 새로 만든 PST 파일의 연락처 폴더에 추가하는 방법을 보여줍니다:

Outlook 연락처를 MSG 파일로 저장

Outlook PST 파일에서 연락처 정보를 액세스하고 해당 연락처를 MSG 형식으로 디스크에 저장하기 위해 Aspose.Email은 다음을 제공합니다 PersonalStorage 그리고 MapiContact 클래스들. 아래 코드 스니펫은 PST 파일에서 모든 연락처 정보를 가져와 MSG 형식으로 디스크에 저장하는 방법을 보여줍니다:

PST 파일을 로드합니다 PersonalStorage 클래스.
Contacts 폴더를 탐색합니다.
Contacts 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
다음을 호출합니다. PersonalStorage.extract_message() 연락처 정보를 얻는 메서드 MapiMessage 클래스.
다음을 호출합니다. MapiMessage.save() 연락처를 MSG 형식으로 디스크에 저장하는 메서드.

Outlook 연락처를 VCF 파일로 내보내기

Microsoft Outlook PST 파일에서 연락처 정보를 액세스하고 vCard(VCF) 형식으로 디스크에 저장하려면 다음을 사용하십시오 PersonalStorage 및 MapiContact 클래스들. 아래 코드는 디스크에서 PST 파일을 로드하고 모든 연락처를 vCard(VCF) 형식으로 저장합니다. VCF 파일은 표준 vCard 연락처 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 VCF 파일을 열면 아래 스크린샷과 같은 모습이 나타납니다.

다음 코드 스니펫은 Outlook PST에서 연락처를 vCard(VCF) 형식으로 내보내는 방법을 보여줍니다:

사용 PersonalStorage.from_file PST 파일을 열기 위해.
연락처 폴더에 접근합니다 using the get_sub_folder.
연락처 루프:
- 사용 get_contents() 폴더의 모든 메시지 정보를 가져옵니다.
- 반복 message_info_collection 루프를 사용하여.
각 연락처를 추출합니다 using pst.extract_message(message_info) 그리고 이를 MAPI 메시지 항목으로 저장합니다.
각 연락처의 이름과 entry ID를 출력합니다.
연락처를 VCF 파일로 저장합니다 using contact.save.

from aspose.email.storage.pst import PersonalStorage
from aspose.email.mapi import ContactSaveFormat

# Load the Outlook PST file
pst = PersonalStorage.from_file("my.pst")

# Get the Contacts folder
folder_info = pst.root_folder.get_sub_folder("Contacts")

# Loop through all the contacts in this folder
message_info_collection = folder_info.get_contents()
for message_info in message_info_collection:
    # Get the contact information
    contact = pst.extract_message(message_info).to_mapi_message_item()

    # Display some contents on screen
    print("Name: " + contact.name_info.display_name + " - " + message_info.entry_id_string)

    # Save to disk in vCard VCF format
    contact.save("D:\\" + contact.name_info.display_name + ".vcf", ContactSaveFormat.V_CARD)

PST 파일에서 Outlook 배포 리스트 관리

Aspose.Email for Python API를 사용하면 다수의 연락처를 포함하는 배포 리스트를 생성할 수 있습니다. 배포 리스트는 Outlook MSG 형식으로 저장될 수 있으며, MS Outlook에서 열어 조회 및 조작할 수 있습니다.

배포 목록 생성 및 저장

아래 코드 스니펫은 PST 파일을 생성하고 배포 리스트를 추가하는 방법을 보여줍니다. 또한 PST 파일 내에서 배포 리스트에 연락처를 생성하고 추가하는 과정도 포함됩니다.

연락처 세부 정보를 정의합니다 - 각 연락처에 대해 displayName 및 email을 설정합니다.
다음으로 새 PST 파일을 생성합니다: PersonalStorage.create() UNICODE 형식으로.
Contacts 폴더를 사용하여 생성합니다 create_predefined_folder().
인스턴스화 MapiContact 표시 이름과 이메일을 가진 객체들을 만들고, 폴더에 연락처를 추가합니다 using add_mapi_message_item().
인스턴스화하여 배포 리스트 멤버를 생성합니다 MapiDistributionListMember 각 연락처에 대해 entry_id를 base64 디코딩으로 설정합니다.
멤버를 추가합니다 MapiDistributionListMemberCollection.
인스턴스화하여 배포 리스트를 생성합니다 MapiDistributionList, 본문과 제목을 설정합니다.
사용 add_mapi_message_item() 배포 리스트를 연락처 폴더에 추가합니다.

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_out.pst", FileFormatVersion.UNICODE)

contactFolder = personalStorage.create_predefined_folder("Contacts", StandardIpmFolder.CONTACTS)

   # Create contacts
   strEntryId1 = contactFolder.add_mapi_message_item(MapiContact(displayName1, email1))
   strEntryId2 = contactFolder.add_mapi_message_item( MapiContact(displayName2, email2))

   member1 = MapiDistributionListMember(displayName1, email1)
   member1.entry_id_type = MapiDistributionListEntryIdType.CONTACT
   member1.entry_id = base64.b64decode( bytes(strEntryId1, "utf-8") )

   member2 = MapiDistributionListMember(displayName2, email2)
   member2.entry_id_type = MapiDistributionListEntryIdType.CONTACT
   member2.entry_id = base64.b64decode( bytes(strEntryId1, "utf-8") )

   members = MapiDistributionListMemberCollection()
   members.append(member1)
   members.append(member2)

   distribution_list = MapiDistributionList("Contact list", members)
   distribution_list.body = "Distribution List Body"
   distribution_list.subject = "Sample Distribution List using Aspose.Email"     
                    
   # Add distribution list to PST 
   contactFolder.add_mapi_message_item(distribution_list);

PST 파일에서 배포 목록 읽기

다음 코드 스니펫은 PST 파일에서 배포 리스트를 읽는 방법을 보여줍니다:

from aspose.email.mapi import MapiMessage

# Load the MAPI message from file
message = MapiMessage.load("dl.msg")

# Convert the message to MAPI distribution list
dlist = message.to_mapi_message_item()

Outlook PST 파일에서 배포 리스트 업데이트

예를 들어 새 멤버를 추가하기 위해 PST 파일의 배포 목록을 업데이트하려면 다음 코드 샘플을 사용하십시오:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

# Add a new member to each distribution list in pst
for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Create a new member to add
        member = ae.mapi.MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com")
        dist_list.members.append(member)
        # Update DL in PST
        folder.update_message(msg.entry_id_string, dist_list)

Python-Net: PST 파일에서 연락처 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 연락처 추가

새 PST 파일을 만들고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email를 사용하면 생성하거나 로드한 PST 파일의 Contacts 하위 폴더에 MapiContact를 추가할 수 있습니다. 아래는 PST에 MapiContact를 추가하는 단계입니다:

MapiContact 객체를 생성합니다.
다양한 생성자와 메서드를 사용하여 MapiContact 속성을 설정합니다.
PersonalStorage.create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 뒤 add_mapi_message_item() 메서드를 호출하여 PST 파일의 루트에 미리 정의된 폴더(Contacts)를 생성합니다.

다음 코드 스니펫은 MapiContact를 생성한 다음 새로 만든 PST 파일의 연락처 폴더에 추가하는 방법을 보여줍니다.

PST 파일의 연락처 정보를 MSG 형식으로 저장

이 문서는 Outlook PST 파일에서 연락처 정보를 액세스하고 연락처를 MSG 형식으로 디스크에 저장하는 방법을 설명합니다. 연락처 정보를 가져오고 표시하기 위해 PersonalStorage 및 MapiContact 클래스를 사용합니다. 연락처 정보를 가져오는 단계는 다음과 같습니다:

PersonalStorage 클래스에서 PST 파일을 로드합니다.
Contacts 폴더를 탐색합니다.
Contacts 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
PersonalStorage.extract_message() 메서드를 호출하여 MapiMessage 클래스의 연락처 정보를 가져옵니다.
MapiMessage.save() 메서드를 호출하여 연락처를 MSG 형식으로 디스크에 저장합니다.

다음 코드 스니펫은 PST 파일에서 모든 연락처 정보를 가져와 MSG 형식으로 디스크에 저장하는 방법을 보여줍니다.

PST 파일의 연락처 정보를 VCF 형식으로 저장

이 문서는 Microsoft Outlook PST 파일에서 연락처 정보를 액세스하고 연락처를 vCard (VCF) 형식으로 디스크에 저장하는 방법을 보여줍니다. PST 파일에서 연락처 정보를 가져오기 위해 PersonalStorage 및 MapiContact 클래스를 사용합니다. 연락처 정보를 가져오는 방법은 다음과 같습니다:

PersonalStorage 클래스에서 PST 파일을 로드합니다.
Contacts 폴더를 탐색합니다.
Contacts 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
PersonalStorage.extract_message() 메서드를 호출하여 MapiContact 클래스에서 연락처 정보를 가져옵니다.
MapiContact 클래스의 다양한 속성을 사용하여 연락처 정보에 접근합니다.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 연락처를 vCard (VCF) 형식으로 저장합니다. VCF 파일은 표준 vCard 연락처 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 VCF 파일을 열면 아래 스크린샷과 같은 형태로 표시됩니다.

|| | :- | 다음 코드 스니펫은 Outlook PST에서 vCard (VCF) 형식으로 연락처를 내보내는 방법을 보여줍니다.

from aspose.email.storage.pst import PersonalStorage
from aspose.email.mapi import ContactSaveFormat

# Load the Outlook PST file
pst = PersonalStorage.from_file("my.pst")

# Get the Contacts folder
folder_info = pst.root_folder.get_sub_folder("Contacts")

# Loop through all the contacts in this folder
message_info_collection = folder_info.get_contents()
for message_info in message_info_collection:
    # Get the contact information
    contact = pst.extract_message(message_info).to_mapi_message_item()

    # Display some contents on screen
    print("Name: " + contact.name_info.display_name + " - " + message_info.entry_id_string)

    # Save to disk in vCard VCF format
    contact.save("D:\\" + contact.name_info.display_name + ".vcf", ContactSaveFormat.V_CARD)

배포 목록 작업

Aspose.Email API를 사용하여 여러 연락처를 모은 배포 목록을 생성할 수 있습니다. 배포 목록은 Outlook MSG 형식으로 디스크에 저장될 수 있으며, MS Outlook에서 열어 확인/조작할 수 있습니다.

배포 목록 만들기 및 저장

다음 코드 스니펏은 배포 목록을 생성하고 저장하는 방법을 보여줍니다.

PST에서 배포 목록 읽기

다음 코드 스니펫은 PST에서 배포 목록을 읽는 방법을 보여줍니다.

from aspose.email.mapi import MapiMessage

# Load the MAPI message from file
message = MapiMessage.load("dl.msg")

# Convert the message to MAPI distribution list
dlist = message.to_mapi_message_item()

Python-Net: PST 파일에서 Outlook MAPI 저널 항목 관리

Mon, 01 Jan 0001 00:00:00 +0000

PST 파일에 MAPI 저널 항목 추가

새 PST 파일을 만들고 하위 폴더 추가 새 PST 파일을 만들고 서브 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 새로운 MAPI 저널 항목을 생성하고 이를 PST 파일에 추가할 수도 있습니다. 아래 코드 예제는 저널 항목을 생성하고, 속성을 설정하며, 새로 만든 PST 파일에 저장하는 방법을 설명합니다:

Create MAPI Journal Entry: 새 인스턴스를 생성합니다 MapiJournal 제목, 본문 및 유형을 포함한 객체.
Set Journal Timing: 현재 날짜 및 시간을 사용하여 저널 항목의 시작 시간을 정의합니다 using dt.datetime.now() 그리고 종료 시간을 한 시간 뒤로 설정합니다 using dt.datetime.today() + timedelta(hours=1).
Create PST File: 사용 PersonalStorage.create UNICODE 형식으로 새 PST 파일을 생성하려면.
Create Journal Folder: 새 PST 파일 내에 "Journal"이라는 사전 정의된 폴더를 사용하여 생성합니다 using create_predefined_folder 와 함께 StandardIpmFolder.JOURNAL 매개변수.
Add Journal Entry to Folder: 이전에 만든 MAPI 저널 항목을 "Journal" 폴더에 추가합니다. add_mapi_message_item.

PST 파일의 MAPI 저널 항목에 첨부 파일 추가

아래 코드 예제는 Aspose.Email 라이브러리를 사용해 MAPI 저널 항목을 생성하고 저장하는 방법을 보여줍니다. 저널 항목은 전화 통화와 관련이 있으며 첨부 파일을 포함합니다.

디렉터리 및 첨부 파일 정의:
- data_dir: 파일과 출력이 저장될 데이터 디렉터리 경로를 보유하는 변수.
- attach_file_names: 저널에 추가될 첨부 파일들의 전체 경로 파일명을 포함하는 목록.
MapiJournal 객체 생성:
- A MapiJournal 제목이 "testJournal"인 객체가 생성됩니다. 이 저널 항목은 제목 및 유형 필드 모두에서 "Phone call"으로 설명됩니다.
- journal.start_time 현재 시간으로 설정됩니다 using datetime.now().
- journal.end_time 시작 시간에 한 시간을 추가하여 계산됩니다 using timedelta(hours=1).
관련 회사 설정:
- 다음은 journal.companies 속성이 이 저널 항목에 관련된 회사 목록으로 업데이트됩니다.
저널에 파일 첨부:
- 루프가 …에 있는 각 파일을 반복합니다 attach_file_names. 각 파일에 대해, 파일을 …에 추가합니다 journal.attachments 파일 내용을 바이너리 모드로 읽어.
MapiJournal 저장:
- 마지막으로, 저널 항목은 지정된 데이터 디렉터리에 ".msg" 파일로 저장됩니다.

import os
from datetime import datetime, timedelta
from aspose.email.mapi import MapiJournal

data_dir = "path_to_data_directory"
attach_file_names = [os.path.join(data_dir, "Desert.jpg"), os.path.join(data_dir, "download.png")]

journal = MapiJournal("testJournal", "This is a test journal", "Phone call", "Phone call")
journal.start_time = datetime.now()
journal.end_time = journal.start_time + timedelta(hours=1)
journal.companies = ["company 1", "company 2", "company 3"]

for attach in attach_file_names:
    journal.attachments.append(attach, open(attach, 'rb').read())

journal.save(os.path.join(data_dir, "AddAttachmentsToMapiJournal_out.msg"))

Python-Net: PST에서 MapiJournal 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiJournal 추가

새 PST 파일을 만들고 하위 폴더를 추가하기는 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 저널 하위 폴더에 MapiJournal을 추가할 수 있습니다. 아래는 PST에 MapiJournal을 추가하는 단계입니다:

MapiJournal 객체를 생성합니다.
생성자와 메서드를 사용하여 MapiJournal 속성을 설정합니다.
PersonalStorage.create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 후 add_mapi_message_item() 메서드를 호출하여 PST 파일 루트에 사전 정의된 폴더(저널)를 생성합니다.

다음 코드 스니펫은 MapiJournal을 생성하고 새로 만든 PST 파일의 저널 폴더에 추가하는 방법을 보여줍니다.

MapiJournal에 첨부 파일 추가

다음 코드 스니펫은 MapiJournal에 첨부 파일을 추가하는 방법을 보여줍니다.

import os
from datetime import datetime, timedelta
from aspose.email.mapi import MapiJournal

data_dir = "path_to_data_directory"
attach_file_names = [os.path.join(data_dir, "Desert.jpg"), os.path.join(data_dir, "download.png")]

journal = MapiJournal("testJournal", "This is a test journal", "Phone call", "Phone call")
journal.start_time = datetime.now()
journal.end_time = journal.start_time + timedelta(hours=1)
journal.companies = ["company 1", "company 2", "company 3"]

for attach in attach_file_names:
    journal.attachments.append(attach, open(attach, 'rb').read())

journal.save(os.path.join(data_dir, "AddAttachmentsToMapiJournal_out.msg"))

Python-Net: Outlook MAPI 노트를 PST 파일에서 관리하기

Mon, 01 Jan 0001 00:00:00 +0000

Outlook MAPI 노트를 PST 파일에 추가

새 PST 파일을 만들고 하위 폴더 추가 새 PST 파일을 만들고 서브 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 MAPI 노트를 생성하고 PST 파일에 저장할 수도 있습니다. 아래 코드 샘플은 서로 다른 특성을 가진 세 개의 MAPI 노트를 생성하고, 지정된 폴더 내의 PST 파일에 추가한 뒤 안전하게 파일을 닫습니다.

MapiNote 필요에 따라 제목, 본문, 색상, 높이 및 너비를 설정하는 객체가 생성됩니다.
새 PST 파일이 다음을 사용하여 생성됩니다 PersonalStorage.create UNICODE 형식을 지정합니다.
PST 파일 내에 "Tasks"라는 사전 정의된 폴더가 생성되어 노트를 저장합니다.
각 MAPI 노트(note1, note2, note3)는 notesFolder에 추가됩니다 using the add_mapi_message_item 메서드. 이 프로세스는 노트를 PST 구조에 통합하여 저장합니다.

Python-Net: PST에서 MapiNote 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiNote 추가

새 PST 파일을 만들고 하위 폴더를 추가하기는 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 노트 하위 폴더에 MapiNote를 추가할 수 있습니다. PST에 MapiNote를 추가하려면:

Microsoft Outlook을 사용해 템플릿 MapiNote를 만들고 MSG 파일로 저장합니다.
저장된 MSG 노트를 MapiMessage 객체에 로드합니다.
MapiNote 객체를 생성하고 템플릿 MSG 노트를 로드합니다.
MapiNote 속성을 설정합니다.
PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 후 AddMapiMessageItem() 메서드를 호출하여 PST 파일 루트에 사전 정의된 폴더(노트)를 생성합니다.

다음 코드 스니펫은 MapiNote를 생성하고 새로 만든 PST 파일의 노트 폴더에 추가하는 방법을 보여줍니다.

Python-Net: OLM을 PST로 변환

Mon, 01 Jan 0001 00:00:00 +0000

OLM을 PST로 변환

OLM(Outlook for Mac)은 Microsoft Outlook for Mac에서 이메일 메시지, 연락처, 캘린더, 작업 및 기타 데이터를 저장하는 파일 형식입니다. 이는 Outlook for Mac의 기본 파일 형식이므로 Windows용 Outlook에서 OLM 파일을 열 수 없습니다. Windows에서 OLM 파일을 다루려면 Aspose Email이 OLM 파일 전용 도구를 제공합니다. 이 도구는 OLM 파일을 Windows 환경에서 널리 지원되는 PST(Outlook 데이터 파일) 형식으로 변환합니다. PST 형식으로 변환한 후에는 데이터를 Windows용 Outlook이나 기타 호환 이메일 클라이언트에 가져올 수 있습니다.

주요 접근법

다음 코드 샘플은 Aspose.Email 라이브러리를 사용하여 Outlook OLM 파일을 PST 파일로 변환하는 방법을 보여줍니다. OLM 파일에서 각 폴더와 해당 메시지를 읽고 동일한 순서대로 새 PST 파일에 추가합니다.

다음의 인스턴스를 생성합니다. OlmStorage 소스 OLM 파일을 여는 클래스.
다음 사용 PersonalStorage.create 지정된 파일명과 형식 버전으로 새 PST 파일을 생성하는 메서드.
OLM 파일에서 각 폴더와 해당 메시지를 재귀적으로 읽습니다.
원본 구조를 유지하면서 각 폴더와 해당 메시지를 PST 파일에 추가하려면 add_to_pst 함수를 사용하십시오.


import aspose.email as ae

olm = ae.storage.olm.OlmStorage("my.olm")

pst = ae.storage.pst.PersonalStorage.create("my.pst", ae.storage.pst.FileFormatVersion.UNICODE)

for folder in olm.folder_hierarchy:
    add_to_pst(pst.root_folder, folder)

이 코드는 aspose.email 라이브러리를 사용하여 OLM 파일을 PST 파일로 변환하는 프로세스를 시작하는 메인 스크립트입니다. OLM 파일을 열고, 새 PST 파일을 만들고, add_to_pst 함수를 호출하여 데이터 전송 작업을 수행하는 방법을 보여줍니다. 이 스크립트는 마이그레이션의 진입점 역할을 하며, 폴더와 메시지의 세부 전송을 효율적으로 처리합니다.

재귀적 폴더 및 메시지 전송

이 접근 방식은 OLM 파일에서 PST 파일로 이메일 데이터를 마이그레이션하는 동안 폴더 및 메시지 처리 프로세스에 대한 보다 깊은 제어를 제공합니다. 아래 코드 샘플은 전송 로직을 정의하는 add_to_pst 함수를 활용합니다. 주요 역할은 폴더와 메시지를 재귀적으로 순회하여 PST 형식으로 올바르게 전송 및 복제되도록 하는 것입니다. 이 함수는 재사용성이 높으며 이러한 파일의 열기 및 생성 관리를 담당하는 더 큰 애플리케이션이나 스크립트의 일부로 사용될 것으로 기대됩니다.


def add_to_pst(pst_folder, olm_folder):
    pst_sub_folder = pst_folder.get_sub_folder(olm_folder.name)

    for msg in olm_folder.enumerate_mapi_messages():
        if pst_sub_folder is None:
            pst_sub_folder = pst_folder.add_sub_folder(olm_folder.name, get_container_class(msg.message_class))

        pst_sub_folder.add_message(msg)

    if pst_sub_folder is None:
        pst_sub_folder = pst_folder.add_sub_folder(olm_folder.name)

    for olm_sub_folder in olm_folder.sub_folders:
        add_to_pst(pst_sub_folder, olm_sub_folder)

PST에서 폴더 유형 결정

OLM 파일을 PST로 변환할 때 폴더 구조가 보존되고 PST 파일의 각 폴더가 올바른 유형을 갖도록 해야 합니다. PST와 달리 OLM의 폴더는 미리 정의된 유형이 없습니다. 데이터를 정확히 분류하고 전송하려면 아래 단계를 따르세요:

OLM 폴더에서 첫 번째 메시지를 읽고 유형을 결정합니다.
이 메시지 유형을 사용하여 분류 방법으로 PST에서 적절한 폴더 유형을 계산합니다.
PST 파일에 지정된 유형의 폴더를 생성합니다.
메시지를 새로 만든 PST 폴더에 추가합니다.

OLM 폴더의 나머지 메시지는 이미 폴더 유형이 설정되었으므로 동일한 카테고리에 속한다고 가정합니다.

get_container_class 함수는 다양한 메시지 클래스를 올바른 PST 폴더 유형에 매핑하여 Outlook 항목을 분류하는 데 도움을 줍니다:

def get_container_class(message_class):
    if message_class.startswith("IPM.Contact") or message_class.startswith("IPM.DistList"):
        return "IPF.Contact"

    if message_class.startswith("IPM.StickyNote"):
        return "IPF.StickyNote"

    if message_class.startswith("IPM.Activity"):
        return "IPF.Journal"

    if message_class.startswith("IPM.Task"):
        return "IPF.Task"

    if message_class.startswith("IPM.Appointment") or message_class.startswith("IPM.Schedule.meeting"):
        return "IPF.Appointment"

    return "IPF.Note"

Python-Net: PST 파일에서 Outlook MAPI 작업 관리

Mon, 01 Jan 0001 00:00:00 +0000

Outlook MAPI 작업을 PST 파일에 추가

새 PST 파일 만들기 및 서브 폴더 추가 PST 파일을 생성하고 그 안에 하위 폴더를 포함하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Tasks 하위 폴더에 MAPI 작업을 추가할 수도 있습니다. 아래 코드 예제는 작업을 생성하고 관리하는 방법을 보여줍니다. MapiTask 개인 저장소 테이블(PST) 파일을 조작할 수 있는 환경에서 사용되는 클래스입니다. 특정 매개변수를 가진 작업을 정의하고, 미리 정의된 "Tasks" 폴더에 해당 작업을 PST 파일에 저장합니다.

다음을 생성합니다 MapiTask 시작 날짜를 현재 날짜로, 마감 날짜를 현재로부터 3일 후로 설정하는 객체.
작업 속성을 설정합니다.
다음을 사용하여 PST를 생성합니다 PersonalStorage.Create() 메서드.
루트 폴더에 접근한 뒤 호출하여 PST 파일 루트에 미리 정의된 폴더(Tasks)를 생성합니다. add_mapi_message_item() 메서드.

Python-Net: PST 파일에서 Outlook 배포 목록 관리

Mon, 01 Jan 0001 00:00:00 +0000

배포 목록은 자동화된 소프트웨어에 의해 조작될 수 있는 연락처 그룹으로, 사용자가 동시에 여러 수신자에게 이메일을 보낼 수 있도록 합니다.

Aspose.Email for Python API를 사용하면 사용자가 배포 목록을 생성, 관리 및 조작할 수 있습니다. 여기에는 목록의 멤버 생성 및 저장, 배포 목록 읽기, 목록 속성 업데이트 및 기타 관련 작업이 포함됩니다.

PST 파일에서 배포 목록 생성 및 저장

기존 PST 연락처가 포함된 배포 목록 추가

다음 코드 스니펫은 이미 PST 파일에 저장된 연락처를 포함하는 배포 목록을 만드는 방법을 보여줍니다.

다음으로 새 PST 파일을 생성합니다: PersonalStorage.create() UNICODE 형식으로.
미리 정의된 "Contacts" 폴더를 생성하고, 두 개의 연락처 항목(Sebastian Wright 및 Wichert Kroos)을 해당 폴더에 추가합니다.
연락처를 배포 목록에 추가합니다:
- 각 연락처는 배포 목록에 다음 형태로 추가됩니다: MapiDistributionListMember.
- 각 멤버의 entry_id는 인코딩된 strEntryId를 사용하여 해당 PST 연락처와 연결됩니다.
"Contact list"라는 이름의 배포 목록을 생성하고, 추가된 연락처를 멤버로 포함시킨 뒤 PST 파일에 추가합니다.

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contactFolder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

strEntryId1 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName1, email1))
strEntryId2 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName2, email2))

member1 = ae.mapi.MapiDistributionListMember(displayName1, email1)
member1.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member1.entry_id = strEntryId1.encode()

member2 = ae.mapi.MapiDistributionListMember(displayName2, email2)
member2.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member2.entry_id = strEntryId2.encode()

members = ae.mapi.MapiDistributionListMemberCollection()
members.append(member1)
members.append(member2)

distributionList = ae.mapi.MapiDistributionList("Contact list", members)
distributionList.body = "Distribution List Body"
distributionList.subject = "Sample Distribution List using Aspose.Email"
# Add distribution list to PST
contactFolder.add_mapi_message_item(distributionList)

일회성 멤버가 포함된 배포 목록 추가

연락처가 Outlook 주소록에 포함되지 않지만 배포 목록에 포함되어야 할 경우 일회성 멤버가 적합합니다. 다음 코드 예제는 PST 파일에 저장되지 않은 연락처인 일회성 멤버와 함께 배포 목록을 만드는 방법을 보여줍니다.

다음으로 새 PST 파일을 생성합니다: PersonalStorage.create() UNICODE 형식으로.
PST에서 연락처를 연결하는 대신, 새 연락처 항목(John R. Patrick 및 Tilly Bates)을 직접 일회성 멤버로 정의합니다.
일회성 멤버를 배포 목록에 추가합니다.
배포 목록을 생성하고, 이름을 "Simple list"로 지정한 뒤 PST 파일의 "Contacts" 폴더에 추가합니다.

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contact_folder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

one_off_members = ae.mapi.MapiDistributionListMemberCollection()
one_off_members.append(ae.mapi.MapiDistributionListMember("John R. Patrick", "JohnRPatrick@armyspy.com"))
one_off_members.append(ae.mapi.MapiDistributionListMember("Tilly Bates", "TillyBates@armyspy.com"))

one_off_members_list = ae.mapi.MapiDistributionList("Simple list", one_off_members)
contact_folder.add_mapi_message_item(one_off_members_list)

PST 파일에서 배포 목록 읽기

PST에서 배포 목록을 읽으려면 아래 코드 샘플을 사용하십시오:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Now, you can work with the distribution list
        # (e.g., access its members, display its properties, or make modifications)
        for member in dist_list.members:
            print(f"{member.display_name}")

Outlook PST 파일에서 배포 리스트 업데이트

예를 들어 새 멤버를 추가하기 위해 PST 파일의 배포 목록을 업데이트하려면 다음 코드 샘플을 사용하십시오:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

# add a new member to each distribution list in pst
for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Create new member to add
        member = ae.mapi.MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com")
        dist_list.members.append(member)
        # update DL in PST
        folder.update_message(msg.entry_id_string, dist_list)

Python-Net: PST 파일에서 배포 목록 작업

Mon, 01 Jan 0001 00:00:00 +0000

배포 목록은 자동화된 소프트웨어에 의해 조작될 수 있는 연락처 그룹으로, 사용자가 동시에 여러 수신자에게 이메일을 보낼 수 있도록 합니다.

Aspose.Email 소프트웨어를 사용하면 사용자가 배포 목록을 만들고, 관리하고, 조작할 수 있습니다. 여기에는 목록에서 구성원을 만들고 저장하기, 배포 목록 읽기, 목록 속성 업데이트 및 기타 관련 작업이 포함됩니다.

배포 목록 생성 및 저장

아래 코드 샘플에 표시된 대로 배포 목록을 만들고 저장하십시오:

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contactFolder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

strEntryId1 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName1, email1))
strEntryId2 = contactFolder.add_mapi_message_item(ae.mapi.MapiContact(displayName2, email2))

member1 = ae.mapi.MapiDistributionListMember(displayName1, email1)
member1.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member1.entry_id = strEntryId1.encode()

member2 = ae.mapi.MapiDistributionListMember(displayName2, email2)
member2.entry_id_type = ae.mapi.MapiDistributionListEntryIdType.CONTACT
member2.entry_id = strEntryId2.encode()

members = ae.mapi.MapiDistributionListMemberCollection()
members.append(member1)
members.append(member2)

distributionList = ae.mapi.MapiDistributionList("Contact list", members)
distributionList.body = "Distribution List Body"
distributionList.subject = "Sample Distribution List using Aspose.Email"
# Add distribution list to PST
contactFolder.add_mapi_message_item(distributionList)

import aspose.email as ae

displayName1 = "Sebastian Wright"
email1 = "SebastianWright@dayrep.com"

displayName2 = "Wichert Kroos"
email2 = "WichertKroos@teleworm.us"

pst = ae.storage.pst.PersonalStorage.create("target.pst", ae.storage.pst.FileFormatVersion.UNICODE)

contact_folder = pst.create_predefined_folder("Contacts", ae.storage.pst.StandardIpmFolder.CONTACTS)

one_off_members = ae.mapi.MapiDistributionListMemberCollection()
one_off_members.append(ae.mapi.MapiDistributionListMember("John R. Patrick", "JohnRPatrick@armyspy.com"))
one_off_members.append(ae.mapi.MapiDistributionListMember("Tilly Bates", "TillyBates@armyspy.com"))

one_off_members_list = ae.mapi.MapiDistributionList("Simple list", one_off_members)
contact_folder.add_mapi_message_item(one_off_members_list)

PST에서 배포 목록 읽기

PST에서 배포 목록을 읽으려면 아래 코드 샘플을 사용하십시오:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Now, you can work with the distribution list
        # (e.g., access its members, display its properties, or make modifications)
        for member in dist_list.members:
            print(f"{member.display_name}")

PST에서 배포 목록 업데이트

예를 들어 새 멤버를 추가하기 위해 PST 파일의 배포 목록을 업데이트하려면 다음 코드 샘플을 사용하십시오:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.CONTACTS)

# add a new member to each distribution list in pst
for msg in folder.enumerate_messages():
    # Check if the message has the "IPM.DistList" message class
    if msg.message_class == "IPM.DistList":
        dist_list = pst.extract_message(msg).to_mapi_message_item()
        # Create new member to add
        member = ae.mapi.MapiDistributionListMember("Edward R. Manuel", "EdwardRManuel@example.com")
        dist_list.members.append(member)
        # update DL in PST
        folder.update_message(msg.entry_id_string, dist_list)

Python-Net: PST에서 MapiTask 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiTask 추가

새 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 Tasks 하위 폴더에 MapiTask를 추가할 수 있습니다. 아래는 PST에 MapiTask를 추가하는 단계입니다:

MapiTask 객체를 생성합니다.
생성자와 다양한 메서드를 사용하여 MapiTask 속성을 설정합니다.
PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
Root 폴더에 액세스한 다음 AddMapiMessageItem() 메서드를 호출하여 PST 파일 루트에 사전 정의된 폴더(Tasks)를 생성합니다.

다음 코드 스니펫은 MapiTask를 생성하고 새로 만든 PST 파일의 작업 폴더에 추가하는 방법을 보여줍니다.

Python-Net: 손상된 PST/OST 파일 읽기

Mon, 01 Jan 0001 00:00:00 +0000

손상된 PST/OST 파일 읽기

일부 경우에는 PST 또는 OST 파일이 손상이나 손상으로 인해 접근할 수 없게 될 수 있습니다. 이때 Outlook이 파일을 열지 못해 중요한 이메일 및 기타 메일함 데이터를 가져오기 어려워집니다.

Aspose.Email은 메시지 및 폴더 ID를 사용하여 손상된 PST 파일에서 손상되지 않은 메시지를 스캔하고 추출할 수 있는 API를 제공합니다.

다음 메서드는 PersonalStorage 클래스는 손상된 PST 파일에서 데이터를 복구하는 데 필수적입니다:

메시지 및 폴더 ID 가져오기:

find_messages(parent_entry_id) - 지정된 폴더 내의 메시지 ID 목록을 가져옵니다.

find_subfolders(parent_entry_id) - 지정된 폴더 내의 하위 폴더 ID 목록을 가져옵니다.
ID를 사용하여 메시지 및 폴더에 접근하기:

extract_message(entry_id) - 엔트리 ID를 사용하여 PST 파일에서 메시지를 추출합니다.

get_folder_by_id(entry_id) - 엔트리 ID를 사용하여 PST 파일에서 폴더를 가져옵니다.

다음 코드 예제는 잠재적으로 손상된 PST 파일을 탐색하고, 손상되지 않은 메시지를 추출하며, 하위 폴더를 탐색하는 방법을 보여줍니다:

import aspose.email as ae

def explore_corrupted_pst(pst, root_folder_id):
    message_id_list = pst.find_messages(root_folder_id)

    for message_id in message_id_list:
        try:
            msg = pst.extract_message(message_id)
            print("- " + msg.subject)
        except Exception as e:
            print("Message reading error. Entry id: " + message_id)

    folder_id_list = pst.find_subfolders(root_folder_id)

    for sub_folder_id in folder_id_list:
        if sub_folder_id != root_folder_id:
            try:
                subfolder = pst.get_folder_by_id(sub_folder_id)
                print(subfolder.display_name)
            except Exception as e:
                print("Message reading error. Entry id: " + sub_folder_id)

            explore_corrupted_pst(pst, sub_folder_id)


pst = ae.storage.pst.PersonalStorage.from_file("target.pst")

explore_corrupted_pst(pst, pst.root_folder.entry_id_string)

Python-Net: PST 파일에서 메시지 작업

Mon, 01 Jan 0001 00:00:00 +0000

Outlook PST 파일에 메시지 추가

PST 파일에 단일 메시지 추가

새 PST 파일을 만들고 하위 폴더 추가 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 하위 폴더에도 메시지를 추가할 수 있습니다. 아래 코드 샘플은 새 PST 파일을 만들고, "Inbox" 폴더를 추가한 뒤 해당 폴더에 메시지를 추가하는 방법을 보여줍니다. PersonalStorage 그리고 FolderInfo 클래스를 사용하여 작업을 수행합니다.

다음 사용 PersonalStorage.create 파일 경로와 파일 형식 버전을 Unicode로 지정하여 새 PST 파일을 시작하는 메서드입니다.
PST 파일의 루트 디렉터리에 "Inbox"라는 새 폴더를 생성합니다.
새로 만든 "Inbox" 폴더에 메시지를 추가하려면 다음을 사용합니다: add_message 메서드.
다음으로 메시지를 로드합니다: MapiMessage.load.

pst = PersonalStorage.create(dataDir + "AddMessagesToPst_out.pst", FileFormatVersion.UNICODE)

# Add new folder "Inbox"
inboxFolder = pst.root_folder.add_sub_folder("Inbox");

# Add message to Inbox Folder
inboxFolder.add_message(MapiMessage.load(dataDir + "MapiMsgWithPoll.msg"))

pst.dispose()

성능 향상을 위한 PST 파일에 다중 메시지 추가

개별 메시지를 PST에 추가하면 디스크에 대한 I/O 작업이 증가하여 성능이 저하될 수 있습니다. 성능을 개선하려면 메시지를 대량 모드로 PST에 추가하여 I/O 작업을 최소화합니다.

디스크에서 메시지 로드 및 추가

다음은 add_messages 이 메서드는 PST 파일에 추가할 메시지 범위를 정의할 수 있게 합니다. 아래 코드 샘플은 성능 향상을 위해 디스크에서 여러 메시지를 PST 파일에 추가하는 방법을 보여줍니다:

다음과 같이 함수를 정의합니다: add_messages_in_bulk_mode PST 파일명과 메시지 폴더를 매개변수로 전달합니다.
다음으로 지정된 PST 파일을 엽니다: PersonalStorage.from_file().
PST 루트 폴더에서 하위 폴더 "myInbox"를 가져옵니다.
지정된 폴더에서 메시지를 대량으로 추가하려면 다음을 사용합니다: folder.add_messages().
호출하십시오 add_messages_in_bulk_mode() PST 파일과 폴더 이름을 인수로 전달합니다.

from aspose.email.storage.pst import PersonalStorage, StandardIpmFolder, FileFormatVersion

def add_messages_in_bulk_mode(file_name, msg_folder_name):
    with PersonalStorage.from_file(file_name) as personal_storage:
        folder = personal_storage.root_folder.get_sub_folder("myInbox")
        folder.add_messages(message_collection(msg_folder_name))

# Add multiple messages from the specified folder to the PST file for improved performance
add_messages_in_bulk_mode("file.pst", "folder_with_messages")

사용 `MapiMessageEnumerator` 대량 작업용**

대량 메시지 처리를 간소화하려면 다음을 구현할 수 있습니다: MapiMessageEnumerator 특정 폴더에 저장된 메시지를 효율적으로 반복하는 클래스입니다. 다음 Python 스크립트는 Aspose.Email 라이브러리를 사용하여 MAPI 메시지를 열거하고 반복하는 구조화된 접근 방식을 제공합니다. 두 개의 헬퍼 클래스를 정의합니다:

MapiMessageEnumerator 디렉터리에서 메시지를 읽기 위해,
및 MapiMessageCollection 배치 작업 중에 이를 관리하기 위해.

이 접근 방식은 MAPI 메시지 파일의 탐색 및 처리를 용이하게 합니다.

import os
from aspose.email.mapi import MapiMessage

# Define a class to enumerate through MAPI message files in a directory
class MapiMessageEnumerator:
    def __init__(self, path):
        self.files = os.listdir(path)
        self.position = -1

    def __next__(self):
        self.position += 1
        if self.position < len(self.files):
            return MapiMessage.from_file(os.path.join(self.path, self.files[self.position]))
        else:
            raise StopIteration

    def __iter__(self):
        return self

# Define a collection class for managing MAPI messages
class MapiMessageCollection:
    def __init__(self, path):
        self.path = path

    def __iter__(self):
        return MapiMessageEnumerator(self.path)


# Iterate through MAPI messages in a specific directory
msg_folder_name = "\\Files\\msg"

# Initialize a collection with the directory containing message files
message_collection = MapiMessageCollection(msg_folder_name)
for message in message_collection:
    # Process each MAPI message object as needed
    pass

다른 PST에서 메시지 추가

한 PST 파일에서 다른 PST 파일로 메시지를 가져오기 위해 Aspose.Email은 다음을 제공합니다: FolderInfo.enumerate_mapi_messages() 메서드. 다음 코드 샘플은 한 PST 파일의 "Inbox" 폴더에서 다른 PST 파일로 메시지를 복사하는 방법을 보여줍니다:

Outlook PST 파일에서 메시지 검색

에서 Outlook PST 파일을 읽고 폴더 및 하위 폴더 정보를 검색합니다.우리는 Outlook PST 파일을 로드하고 폴더를 탐색하여 폴더 이름과 메시지 수를 확인하는 방법을 논의했습니다. 이 문서는 Outlook PST 파일에서 메시지에 접근하고 추출하는 방법을 설명합니다: 기본 메시지 세부 정보를 검색하고, 폴더 내 항목 수를 센 다음, 처리 또는 분석을 위해 특정 수의 메시지를 추출합니다.

기본 메시지 정보 검색

아래 코드 샘플은 Aspose.Email 라이브러리를 사용하여 PST 파일에 저장된 MAPI 메시지에서 주요 정보를 추출하고 표시하는 방법을 보여줍니다. 초기화 과정은 다음과 같습니다: PersonalStorage "Outlook.pst" 파일의 객체를 사용하여 루트 폴더의 내용을 가져오고 각 메시지를 반복합니다. 스크립트는 제목, 발신자 정보, 수신자 주소, 전송 시간, 메시지 본문 등 상세 정보를 출력하여 지정된 PST 파일 내 각 이메일에 대한 포괄적인 개요를 제공합니다.

from aspose.email.storage.pst import *
from aspose.email.mapi import MapiMessage

pst = PersonalStorage.from_file("Outlook.pst")

folderInfo = pst.root_folder

messageInfoCollection = folderInfo.get_contents()

for messageInfo in messageInfoCollection:
   mapi = pst.extract_message(messageInfo)

   print("Subject: " + mapi.subject)
   print("Sender name: " + mapi.sender_name)
   print("Sender email address: " + mapi.sender_email_address)
   print("To: ", mapi.display_to)
   print("Cc: ", mapi.display_cc)
   print("Bcc: ", mapi.display_bcc)
   print("Delivery time: ", str(mapi.delivery_time))
   print("Body: " + mapi.body)

중첩 폴더의 재귀적 읽기

Outlook PST 파일에는 중첩 폴더가 포함될 수 있습니다. 이러한 폴더와 최상위 폴더의 메시지 정보를 얻으려면 재귀 메서드를 사용하여 모든 폴더를 읽으십시오. 다음 코드 스니펫은 Outlook PST 파일을 읽고 폴더 및 메시지 내용을 재귀적으로 표시하는 방법을 보여줍니다:

PST 폴더의 전체 항목 수 가져오기

메시지 스토어에 존재하는 전체 항목 수(예: 이메일, 약속, 작업, 연락처 등)를 가져오려면 get_total_items_count() 메서드를 사용하십시오: MessageStore 클래스. 스토어 내 데이터의 크기와 양에 대한 정보를 신속하게 수집하는 편리한 방법을 제공합니다. 다음 코드 스니펫은 PST 파일에서 전체 항목 수를 가져오는 방법을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

count = pst.store.get_total_items_count()

특정 수의 메시지 추출

PST 파일에서 지정된 수의 메시지를 추출하려면 get_contents(start_index, count) 메서드를 사용하십시오: FolderInfo 클래스. 두 개의 매개변수를 받습니다:

start_index - 시작 메시지 번호, 예를 들어 10번째;
count - 가져올 전체 메시지 수.

한 번에 필요한 메시지 하위 집합만 검색하면 대용량 이메일 데이터를 관리하는 데 유용합니다. 다음 코드 샘플은 이 기능 구현을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.root_folder.get_sub_folder("Inbox")

# Extracts messages starting from 10th index top and extract total 100 messages
messages = folder.get_contents(10, 100)

PST 파일에서 첨부 파일 작업

전체 메시지를 추출하지 않고 첨부 파일 추출

Python용 Aspose.Email을 사용하면 전체 메시지를 먼저 추출하지 않고도 PST 메시지에서 첨부 파일을 추출할 수 있습니다. 이는 다음을 사용하여 수행할 수 있습니다: extract_attachments 메서드 PersonalStorage 클래스. 다음 코드 스니펫은 .msg 파일을 건너뛰고 첨부 파일을 추출하는 방법을 보여줍니다:

from aspose.email.storage.pst import PersonalStorage

# Open the PST file 
with PersonalStorage.from_file(data_dir + "my.pst") as personal_storage:
    # Get the "Inbox" subfolder from the root folder in the personal storage
    folder = personal_storage.root_folder.get_sub_folder("Inbox")

    # Iterate over each message entry ID in the Inbox folder
    for message_info in folder.enumerate_messages_entry_id():
        # Extract attachments for the current message
        attachments = personal_storage.extract_attachments(message_info)

        # Check if the message has any attachments
        if attachments.count > 0:
            # Iterate over each attachment in the list
            for attachment in attachments:
                # Ignore attachments that are message files (.msg)
                if attachment.long_file_name and attachment.long_file_name.endswith(".msg"):
                    continue
                # Save the attachment with its original file name
                attachment.save(data_dir + attachment.long_file_name)

PST 메시지에 파일을 첨부 파일로 추가

Microsoft Outlook은 이메일, 캘린더, 작업, 연락처 및 저널 항목을 관리하는 강력한 도구입니다. 이러한 핵심 기능 외에도 PST 폴더에 파일을 추가하여 관련 문서를 포괄적으로 기록할 수 있습니다. Aspose.Email은 메시지, 연락처, 작업 및 저널 항목을 처리하는 방식과 유사하게 PST 폴더에 파일을 추가하는 과정을 간소화합니다.

다음 코드 스니펫은 Aspose.Email을 사용하여 문서를 PST 폴더에 추가하는 방법을 보여줍니다:

from aspose.email.storage.pst import PersonalStorage, FileFormatVersion

# Create a new PST file
personal_storage = PersonalStorage.create(data_dir + "AddFilesToPst_out.pst", FileFormatVersion.UNICODE)

# Add a new folder to store files
folder = personal_storage.root_folder.add_sub_folder("Files")

# Add a file to the PST folder
folder.add_file(data_dir + "FileToBeAddedToPST.txt", "")

PST 파일에서 메시지 검색 및 필터링

Personal Storage(PST) 파일에는 대량의 데이터가 포함될 수 있으며, 특정 기준에 맞는 데이터를 찾기 위해 다중 필터링이 필요합니다. 이를 위해 PersonalStorageQueryBuilder 클래스, Aspose.Email을 사용하면 정의된 검색 기준에 따라 PST에서 특정 레코드를 검색할 수 있습니다. 발신자, 수신자, 제목, 메시지 중요도, 첨부 파일 여부, 메시지 크기, 심지어 메시지 ID와 같은 매개변수를 사용해 메시지를 검색할 수 있습니다. 또한, PersonalStorageQueryBuilder 하위 폴더 내 검색에도 사용할 수 있습니다. 아래 섹션에서는 Outlook PST 파일 검색에 대한 포괄적인 가이드를 제공합니다.

Outlook 메시지 및 폴더 검색

다음 코드 스니펫은 사용 방법을 보여줍니다. PersonalStorageQueryBuilder 다양한 검색 기준에 따라 PST 내용 검색을 수행하는 클래스입니다. 특히 다음을 기준으로 PST를 검색하는 예시를 보여줍니다:

메시지 중요도.
메시지 클래스.
첨부 파일 존재 여부.
메시지 크기.
읽지 않은 메시지.
첨부 파일이 있는 읽지 않은 메시지 및 특정 하위 폴더 이름을 가진 폴더.

from aspose.email.mapi import MapiMessageFlags
from aspose.email.storage.pst import PersonalStorage, PersonalStorageQueryBuilder, MapiImportance

with PersonalStorage.from_file(data_dir + "my.pst") as personal_storage:
    folder = personal_storage.root_folder.get_sub_folder("Inbox")
    builder = PersonalStorageQueryBuilder()

    # High importance messages
    builder.importance.equals(2)
    messages = folder.get_contents(builder.get_query())
    print("Messages with High Imp:", messages.count)

    builder = PersonalStorageQueryBuilder()
    builder.message_class.equals("IPM.Note")
    messages = folder.get_contents(builder.get_query())
    print("Messages with IPM.Note:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Messages with attachments AND high importance
    builder.importance.equals(2)
    builder.has_flags(MapiMessageFlags.HASATTACH)
    messages = folder.get_contents(builder.get_query())
    print("Messages with atts:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Messages with size > 15 KB
    builder.message_size.greater(15000)
    messages = folder.get_contents(builder.get_query())
    print("Messages size > 15 KB:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Unread messages
    builder.has_no_flags(MapiMessageFlags.READ)
    messages = folder.get_contents(builder.get_query())
    print("Unread:", messages.count)

    builder = PersonalStorageQueryBuilder()
    # Unread messages with attachments
    builder.has_no_flags(MapiMessageFlags.READ)
    builder.has_flags(MapiMessageFlags.HASATTACH)
    messages = folder.get_contents(builder.get_query())
    print("Unread msgs with atts:", messages.count)

    # Folder with name 'SubInbox'
    builder = PersonalStorageQueryBuilder()
    builder.folder_name.equals("SubInbox")
    folders = folder.get_sub_folders(builder.get_query())
    print("Folder having subfolder:", folders.count)

    builder = PersonalStorageQueryBuilder()
    # Folders with subfolders
    builder.has_subfolders()
    folders = folder.get_sub_folders(builder.get_query())
    print("Folders with subfolders:", folders.count)

대소문자 구분 없는 검색

Aspose.Email을 활용하여 PersonalStorageQueryBuilder이메일 메시지에 대한 검색 조건을 지정하면서 대소문자를 무시할 수 있어 보다 유연하고 사용자 친화적인 검색 경험을 제공합니다. 다음 코드 샘플은 PST 파일을 로드하고 "Inbox" 폴더에 접근한 뒤, 발신자 정보를 기반으로 이메일을 찾기 위해 대소문자 구분 없는 검색 필터를 적용하는 방법을 보여줍니다. 이 기능은 이메일 데이터의 다양한 대소문자 처리에 특히 유용합니다.

여러 키워드로 제목 라인 검색

개인 저장 파일(PST) 또는 메시지 저장소에서 특정 메시지 또는 항목을 가져오려면 the 를 구현합니다 either(query1, query2) 메서드 PersonalStorageQueryBuilder 클래스. 두 개의 매개변수를 받아 두 개의 다른 쿼리(query1 및 query2)를 결합하고, 지정된 두 단어 중 하나와 일치하는 메시지 제목을 찾을 수 있습니다. 아래 코드 샘플을 참고하세요:

import aspose.email as ae

builder1 = ae.storage.pst.PersonalStorageQueryBuilder()
builder1.subject.contains("Review") # 'Review' is key word for the search

builder2 = ae.storage.pst.PersonalStorageQueryBuilder()
builder2.subject.contains("Error") # 'Error' is also key word for the search

builder = ae.storage.pst.PersonalStorageQueryBuilder()
# message subjects must contain 'Review' or 'Error' words
builder.either(builder1.get_query(), builder2.get_query())


pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

folder = pst.root_folder.get_sub_folder("Inbox")
messages = folder.get_contents(builder.get_query())

for message in messages:
    print(f"Message: {message.subject}")

특정 조건에 따라 PST의 이메일 필터링

특정 필터(예: 제목, 발신자, 날짜)와 일치하는 메시지만 가져오려면 using the MailQuery 클래스. 다음 코드 샘플은 Aspose.Email 라이브러리를 사용하여 PST 파일을 로드하고 특정 폴더(이 경우 "Inbox" 폴더) 내의 메시지를 필터링하는 방법을 보여줍니다:

import aspose.email as ae

# Load the PST file and access a folder
pst = ae.PersonalStorage.from_file("sample.pst")
inbox = pst.root_folder.get_sub_folder("Inbox")

# Create a MailQuery to filter messages by subject
query_builder = ae.MailQueryBuilder()
query_builder.subject.contains("Invoice")

query = query_builder.get_query()

# Enumerate filtered messages
for info in inbox.enumerate_mapi_messages(query):
    print("Subject:", info.subject)

유형별 메시지 가져오기

Aspose.Email MessageKind 오버로드를 사용하면 이메일, 약속, 연락처 등 특정 유형의 메시지만 가져올 수 있습니다. 다음 코드 샘플은 지정된 폴더에서 특정 유형의 메시지에 접근하고 필터링하는 방법을 보여줍니다:

import aspose.email as ae

# Load the PST and target folder
pst = ae.PersonalStorage.from_file("sample.pst")
inbox = pst.root_folder.get_sub_folder("Inbox")

# Retrieve only email messages (not calendar items, contacts, etc.)
for info in inbox.enumerate_mapi_messages(ae.MessageKind.MAPI_MESSAGE):
    print("Email Message:", info.subject)

대용량 PST 파일을 위한 메시지 페이징 검색

많은 메시지를 포함하는 폴더를 작업할 때, 페이지네이션을 사용하여 메시지를 청크 단위로 로드할 수 있습니다 using the start_index 및 count 매개변수. 다음 코드 샘플은 PST 파일에서 전체 메시지를 한 번에 가져오는 대신 특정 범위의 이메일 메시지에 접근하고 가져오는 방법을 보여줍니다:

import aspose.email as ae

# Load the PST and access the target folder
pst = ae.PersonalStorage.from_file("sample.pst")
inbox = pst.root_folder.get_sub_folder("Inbox")

# Retrieve messages from index 0 to 9
for info in inbox.enumerate_mapi_messages(0, 10):
    print("Paged Message:", info.subject)

Outlook PST 콘텐츠 업데이트 및 정리

폴더 간 메시지 이동

Aspose.Email를 사용하면 동일한 개인 저장소(PST) 파일 내에서 소스 폴더의 항목을 다른 폴더로 이동할 수 있습니다. 여기에는 다음이 포함됩니다:

지정된 폴더를 새 상위 폴더로 이동하기.
지정된 메시지를 새 폴더로 이동합니다.
내용을 새 폴더로 이동하기.
하위 폴더를 새 상위 폴더로 이동하기.

다음 코드 조각은 동일한 PST 파일 내에서 소스 폴더의 메시지 및 폴더와 같은 항목을 다른 폴더로 이동하는 방법을 보여줍니다.

메시지 속성 업데이트

때때로 제목 변경, 메시지 중요도 표시 등 특정 메시지 속성을 수정해야 할 필요가 있습니다. PST 파일 내에서 이러한 속성을 업데이트하려면 the 를 사용합니다 FolderInfo.change_messages Aspose.Email for Python이 제공하는 메서드. 이 문서는 PST 파일 내 여러 메시지에 걸쳐 메시지 속성을 일괄 업데이트하는 과정을 보여줍니다. 아래 코드 스니펫은 다양한 메시지 속성을 일괄 업데이트하는 방법을 설명합니다.

from aspose.email.storage.pst import PersonalStorage, PersonalStorageQueryBuilder
from aspose.email.mapi import MapiPropertyTag, MapiProperty, MapiPropertyCollection

pst_file_path = data_dir + "ya4demia04vb.pst"

# Load the Outlook PST file
with PersonalStorage.from_file(pst_file_path) as personal_storage:
    # Get the required subfolder
    inbox = personal_storage.root_folder.get_sub_folder("Inbox")

    # Find messages having From = "someuser@domain.com"
    query_builder = PersonalStorageQueryBuilder()
    query_builder.from_address.contains("someuser@domain.com")

    # Get contents from query
    messages = inbox.get_contents(query_builder.get_query())

    # Save (MessageInfo, EntryIdString) in a list
    change_list = [message_info.entry_id_string for message_info in messages]

    # Compose the new properties
    updated_properties = MapiPropertyCollection()
    updated_properties.add(
        MapiPropertyTag.SUBJECT_W,
        MapiProperty(MapiPropertyTag.SUBJECT_W, "New Subject".encode("utf-16le"))
    )
    updated_properties.add(
        MapiPropertyTag.IMPORTANCE,
        MapiProperty(MapiPropertyTag.IMPORTANCE, bytearray([0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00]))
    )

    # Update messages having From = "someuser@domain.com" with new properties
    inbox.change_messages(change_list, updated_properties)

맞춤형 MAPI 속성 수정

때때로 PST 파일 내에서 처리된 항목을 식별하고 표시해야 할 수 있습니다. Aspose.Email API는 이를 위해 다음을 사용한 솔루션을 제공합니다 MapiProperty 및 MapiNamedProperty 클래스. 이러한 클래스는 사용자 정의 속성을 할당하여 처리된 항목에 라벨을 지정할 수 있게 합니다. 아래에서는 이 라벨링 작업을 수행하는 데 특히 유용한 메서드를 찾을 수 있습니다:

MapiNamedProperty(long propertyTag, string nameIdentifier, UUID propertyGuid, bytearray[] propertyValue)
MapiNamedProperty(long propertyTag, long nameIdentifier, UUID propertyGuid, bytearray[] propertyValue)
FolderInfo.change_messages(MapiPropertyCollection updatedProperties) - 폴더 내 모든 메시지 변경
PersonalStorage.change_message(string entryId, MapiPropertyCollection updatedProperties) - 메시지 속성 변경

from uuid import UUID
from aspose.email.storage.pst import PersonalStorage
from aspose.email.mapi import MapiNamedProperty, MapiPropertyCollection
from aspose.email.mapi import MapiPropertyType, MapiProperty, MapiPropertyTag

def generate_named_property_tag(index, data_type):
    return (((0x8000 | index) << 16) | data_type) & 0x00000000FFFFFFFF

def run():
    # Load the Outlook file
    pst_file_path = data_dir + "my.pst"

    with PersonalStorage.from_file(pst_file_path) as personal_storage:
        test_folder = personal_storage.root_folder.get_sub_folder("Inbox")

        # Create the collection of message properties for adding or updating
        new_properties = MapiPropertyCollection()

        # Normal, Custom, and PidLidLogFlags named properties
        mapi_property = MapiProperty(
            MapiPropertyTag.ORG_EMAIL_ADDR_W,
            "test_address@org.com".encode("utf-16le")
        )
        named_property1 = MapiNamedProperty(
            generate_named_property_tag(0, MapiPropertyType.LONG),
            "ITEM_ID",
            UUID("00000000-0000-0000-0000-000000000000"),
            bytearray([0x7B, 0x00, 0x00, 0x00])
        )
        named_property2 = MapiNamedProperty(
            generate_named_property_tag(1, MapiPropertyType.LONG),
            0x0000870C,
            UUID("0006200A-0000-0000-C000-000000000046"),
            bytearray([0x00, 0x00, 0x00, 0x00])
        )
        new_properties.add(named_property1.tag, named_property1)
        new_properties.add(named_property2.tag, named_property2)
        new_properties.add(mapi_property.tag, mapi_property)
        test_folder.change_messages(test_folder.enumerate_messages_entry_id(), new_properties)

# Usage
run()

Outlook PST 파일에서 메시지 및 폴더 삭제

Outlook PST 파일의 콘텐츠를 관리할 때는 불필요한 메시지, 폴더 또는 여러 항목을 한 번에 제거해야 할 때가 많습니다. Aspose.Email for Python via .NET은 개별 이메일을 제거하든, FolderInfo.delete_child_item() 메서드, 또는 대량 삭제 수행, FolderInfo.delete_child_items() 메서드, 파일 관리를 개선합니다.

PST 파일에서 메시지 삭제

Aspose.Email은 다음을 제공합니다 FolderInfo 클래스는 PST 파일의 특정 폴더에 접근하기 위해 사용됩니다. 아래 코드 샘플은 이전에 로드하거나 생성한 PST 파일의 Sent 하위 폴더에서 메시지에 접근하고 삭제하는 방법을 보여줍니다. 구체적으로, 메시지 수를 가져오고 "Sent Items" 폴더의 첫 번째 항목을 삭제합니다.

"Outlook.pst" 파일을 지정된 디렉터리에서 열어 PST 객체를 초기화합니다 using PersonalStorage.from_file().
Sent Items 폴더는 다음을 사용하여 접근합니다 pst.get_predefined_folder(StandardIpmFolder.SENT_ITEMS).
그런 다음, 코드는 "Sent Items" 폴더의 내용을 다음을 사용하여 가져옵니다 folder.get_contents(), 이를 세어 이 폴더의 총 메시지 수를 출력합니다.
코드는 *msgsColl[0]*을 사용하여 "Sent Items" 폴더의 첫 번째 메시지에 접근하고, 이를 사용하여 삭제합니다 using folder.delete_child_item(msgInfo.entry_id). 이 함수는 메시지의 엔트리 ID를 사용하여 폴더에서 삭제합니다.

삭제 후, 코드는 다시 "Sent Items" 폴더의 메시지를 세어 업데이트된 개수를 출력합니다.

PST 파일에서 항목 삭제

많은 메세징 시스템이나 이메일 클라이언트에서 각 항목(예: 이메일, 약속, 작업)에는 엔트리 ID라는 고유 식별자가 할당됩니다. delete_item(entry_id) 메서드 FolderInfo 클래스는 이 엔트리 ID를 매개변수로 받아 메시지 저장소에서 해당 항목을 제거합니다. 다음 코드를 사용하여 메시지 저장소에서 항목을 삭제하세요:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

pst.delete_item(entry_id)

항목 일괄 삭제

Aspose.Email API를 사용하여 PST 파일에서 항목을 일괄 삭제할 수 있습니다. 이는 다음을 사용하여 구현됩니다: delete_child_items() 삭제할 항목을 참조하는 엔트리 ID 목록을 받아들이는 메서드. 다음 코드 스니펫은 PST 파일에서 항목을 일괄 삭제하는 방법을 보여줍니다.

PST 파일에서 폴더 삭제

Outlook PST 파일에는 더 이상 필요하지 않은 폴더가 있을 수 있습니다. Aspose.Email for Python via .NET은 이러한 폴더를 Deleted Items 폴더로 이동시켜 복구 가능하게 하거나 영구적으로 삭제할 수 있게 합니다. 다음 예제는 두 접근 방식을 모두 보여줍니다.

폴더를 Deleted Items 로 이동 (소프트 삭제)

다음은 move_item 메서드 PersonalStorage 클래스는 폴더를 영구적으로 삭제하지 않고 Deleted Items 폴더로 이동시켜 나중에 복구할 수 있게 합니다. 다음 코드 스니펫은 이 메서드를 파이썬 프로젝트에 구현하는 방법을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

deleted_items_folder = pst.get_predefined_folder(ae.storage.pst.StandardIpmFolder.DELETED_ITEMS)
empty_folder = pst.root_folder.get_sub_folder("Empty folder")
some_folder = pst.root_folder.get_sub_folder("Some folder")
pst.move_item(empty_folder, deleted_items_folder)
pst.move_item(some_folder, deleted_items_folder)

이 방법의 장점은 삭제된 폴더를 쉽게 복구할 수 있다는 점입니다.

Deleted Items에서 폴더 복원

다음은 move_item 이 메서드는 폴더가 실수로 삭제된 경우 Deleted Items에서 원래 위치로 이동시켜 복원할 수 있게 합니다.

some_folder = pst.root_folder.get_sub_folder("Some folder")
pst.move_item(some_folder, pst.root_folder)

Deleted Items에서 폴더 영구 삭제

다음은 delete_child_item 이 메서드는 Deleted Items 폴더를 우회하여 하위 폴더를 즉시 영구적으로 삭제하려는 경우 모든 폴더에 사용할 수 있습니다. 다음 코드 샘플은 폴더를 Deleted Items에서 완전히 제거하여 복구가 불가능하도록 하는 방법을 보여줍니다:

deleted_items_folder.delete_child_item(empty_folder.entry_id)

폴더를 즉시 영구 삭제

폴더를 Deleted Items 로 이동하지 않고 삭제해야 하는 경우, the delete_child_item 메서드는 즉각적이고 영구적인 삭제를 보장합니다.

some_folder = pst.root_folder.get_sub_folder("Some folder")
pst.root_folder.delete_child_item(some_folder.entry_id)

Python-Net: PST 파일 암호 보호 관리

Mon, 01 Jan 0001 00:00:00 +0000

Microsoft Outlook은 사용자가 PST 파일에 암호를 설정하여 접근을 제한할 수 있도록 합니다. Aspose.Email는 PST 파일의 암호 보호 여부를 감지할 수 있습니다.

이 문서는 다음 항목을 다룹니다:

PST 파일 암호 보호 확인
암호 보호된 PST 파일 읽기
암호 보호된 PST에서 암호 검증
PST 파일에서 암호 추가/변경/제거

PST 파일 암호 보호 확인

PST 파일이 암호로 보호되어 있는지 확인하려면, 클래스의 is_password_protected 메서드를 사용합니다. MessageStore 클래스는 아래 코드 샘플에 표시된 바와 같습니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

print(f"The storage is password protected - {pst.store.is_password_protected}")

암호 보호된 PST 파일 읽기

암호로 보호된 파일도 일반 PST 파일처럼 읽을 수 있습니다. 다음 코드 스니펫은 각 개별 메시지에 접근하고 추가 처리할 수 있게 해줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

for folder in pst.root_folder.get_sub_folders():
    for msg in folder.enumerate_messages():
    # do something

PST 비밀번호 검증

PST 파일의 비밀번호가 유효한지 확인하려면, Aspose.Email는 클래스의 is_password_valid(password) 메서드를 제공합니다. MessageStore 클래스입니다. 문자열 형식의 비밀번호를 매개변수로 받아 비밀번호가 올바르면 True, 그렇지 않으면 False를 반환합니다.

다음 코드 스니펫은 is_password_valid(password) 메서드 사용 예시를 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("my.pst")

print(f"Password is valid - {pst.store.is_password_valid('Password1')}")

PST 암호 추가, 변경 또는 제거

클래스의 change_password(password) 메서드 MessageStore 클래스는 PST 파일의 암호를 조작하는 데 사용됩니다. 다음 코드 샘플은 암호를 추가, 변경 또는 제거하는 방법을 보여줍니다:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.create("SetPasswordOnPST_out.pst", ae.storage.pst.FileFormatVersion.UNICODE)
# Add or change the password
password = "Password1"
pst.store.change_password(password)
# Remove the password
pst.store.change_password(None)

Python-Net: Outlook for Mac OLM 파일 읽기 및 폴더와 하위 폴더 정보 가져오기

Mon, 01 Jan 0001 00:00:00 +0000

OLM(Outlook for Mac Archive)은 Microsoft Outlook for Mac과 연관된 파일 형식으로, 이메일 메시지, 연락처, 일정 항목, 작업 및 기타 Outlook 데이터를 Mac 컴퓨터에 보관하고 저장하는 데 사용됩니다. OLM 파일은 백업 또는 아카이브 형식으로 작동하여 사용자가 Outlook for Mac 데이터를 추후에 참조하거나 마이그레이션할 수 있도록 저장합니다. OLM 파일은 Outlook for Mac 전용이며 Windows용 Outlook에서 사용하는 PST(Personal Storage Table) 파일 형식과 호환되지 않는다는 점에 유의해야 합니다. 다른 플랫폼 간에 Outlook 데이터를 전송하려면 변환 도구가 필요합니다. Aspose.Email은 OLM 파일을 열고, 읽고, 기타 기능을 제공하는 이러한 도구를 제공합니다.

OLM 형식 파일 열기

OLM 형식 파일은 두 가지 방법으로 열 수 있습니다:

생성자 사용
정적 ‘from_file’ 메서드를 사용하여

생성자를 통한 파일 열기

파일을 열려면, 다음의 생성자를 호출합니다 OlmStorage 클래스이며 전체 파일 이름이나 스트림을 인수로 전달합니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)

FromFile 정적 메서드를 사용한 파일 열기

파일을 열려면 해당 클래스의 정적 메서드 ‘from_file’을 사용합니다. OlmStorage 클래스이며 전체 파일 이름이나 스트림을 인수로 전달합니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)

폴더 가져오기

‘print_all_folders’ 함수를 사용하여 OLM 파일에서 가져온 폴더 계층을 시각화하고 표시할 수 있습니다. 해당 클래스의 ‘folder_hierarchy’ 속성을 인수로 사용합니다. OlmStorage 클래스와 들여쓰기 수준을 입력으로 받아, 계층을 재귀적으로 순회하며 각 폴더 이름을 적절한 들여쓰기와 함께 출력합니다. 아래 코드 샘플은 이 함수를 사용하여 OLM 파일의 폴더 계층을 표시하는 방법을 보여줍니다. 모든 폴더를 계층 순서대로 표시합니다:

import aspose.email as ae


def print_all_folders(folder_hierarchy, indent):
    for folder in folder_hierarchy:
        print(f"{indent}{folder.name}")
        print_all_folders(folder.sub_folders, indent + "-")

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_all_folders(olm.folder_hierarchy, "")

위의 코드 샘플은 재귀 함수를 통해 OLM 파일의 폴더 계층을 보다 구조적이고 읽기 쉽게 표시하도록 설계되었습니다. Aspose.Email은 또한 ‘get_folders()’ 메서드를 사용하여 OLM 파일에서 폴더 구조에 직접 접근할 수 있게 합니다. OlmStorage 클래스.

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folders = olm.get_folders()

또한, 이름으로 어떤 폴더든 가져올 수 있습니다. 다음 코드 샘플은 해당 클래스의 ‘get_folder(name, ignore_case)’ 메서드를 활용합니다. OlmStorage 클래스는 폴더 이름과 대소문자 구분 여부를 매개변수로 전달하여 해당 이름의 폴더를 가져옵니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

이메일 목록

아래 코드 스니펫은 Aspose.Email 라이브러리를 사용하여 Outlook for Mac (OLM) 파일에서 이메일 제목을 읽고 추출하는 방법을 보여줍니다. OlmFolder 클래스(폴더를 나타내는)는 이메일 목록을 가져오는 다음 메서드를 제공합니다:

’enumerate_messages()’ - 폴더의 각 이메일 메시지를 반복합니다. 이 메서드는 메시지를 해당 클래스의 인스턴스로 반환합니다. OlmMessageInfo 클래스는 각 이메일 메시지의 기본 정보(제목, 보낸 사람, 날짜 등)를 제공합니다.
’enumerate_mapi_messages()’ - 폴더의 각 이메일 메시지를 반복하지만, 이 경우 메시지를 해당 클래스의 인스턴스로 반환합니다. MapiMessage 클래스는 이메일 메시지를 보다 상세하고 MAPI 전용 방식으로 나타냅니다. 이메일 메시지의 다양한 속성 및 세부 정보를 액세스할 수 있어 보다 고급 및 특수한 처리가 가능합니다.

EnumerateMessages 메서드 사용

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    print(message_info.subject)

EnumerateMapiMessages 메서드 사용

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for msg in folder.enumerate_mapi_messages():
    msg.save(f"{msg.subject}.msg")

다른 유용한 속성

다음은 해당 클래스의 다른 유용한 속성들입니다: OlmFolder 클래스는 다음과 같습니다:

‘has_messages’ - 현재 폴더에 메시지가 있는지 여부를 나타내는 값을 가져옵니다.
‘message_count’ - 메시지 수를 가져옵니다.

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

if folder.has_messages:
   print(f"Message count: {folder.message_count}")

메시지의 수정 날짜 가져오기 또는 설정하기

이메일 메시지의 마지막 수정 시간 정보를 검색할 수 있습니다. 해당 클래스의 ‘modified_date’ 속성은 OlmMessageInfo 클래스는 메시지가 마지막으로 수정된 날짜와 시간을 나타냅니다.

다음은 해당 속성 사용을 보여주는 예시입니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    modifiedDate = message_info.modified_date

이메일 추출

이메일 저장소에서 실제 MAPI 메시지 데이터를 검색할 수 있습니다. 해당 클래스의 ’extract_mapi_message(message_info)’ 메서드 OlmStorage 클래스는 제공된 message_info를 기반으로 저장소에서 MAPI 메시지를 추출하는 데 사용됩니다.

아래 코드 샘플은 이 메서드 사용 방법을 보여줍니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info)

Traversal API를 사용하여 이메일에서 모든 항목 추출

원본 파일의 일부 데이터가 손상되었더라도 예외를 발생시키지 않고 가능한 한 모든 항목을 Outlook OLM 파일에서 추출할 수 있습니다. 이를 수행하려면 다음을 사용하세요. OlmStorage(TraversalExceptionsCallback callback) 생성자와 Load(string fileName) FromFile 메서드 대신 사용하는 메서드입니다. 생성자를 통해 콜백 메서드를 정의할 수 있습니다.

using (var olm = new OlmStorage((exception, id) => { /* Exception handling  code. */ }))

콜백 메서드는 로드 및 탐색 중 발생하는 예외를 제공하도록 합니다.

다음은 Load 파일이 성공적으로 로드되고 추가 탐색이 가능하면 메서드는 ’true’를 반환합니다. 파일이 손상되어 탐색이 불가능한 경우 ‘false’를 반환합니다.

if (olm.Load(fileName))

다음 코드 스니펫과 단계는 이 API를 사용하는 방법을 보여줍니다:

새 인스턴스를 생성합니다 OlmStorage 클래스이며, 프로세스 중 발생하는 모든 예외를 처리하기 위해 예외 처리 콜백을 전달합니다.
다음 메서드를 호출하여 OLM 파일을 로드합니다. Load OlmStorage 인스턴스의 메서드.
OLM 파일이 성공적으로 로드되면, 호출하여 폴더 계층 구조를 얻습니다. GetFolders OlmStorage 인스턴스의 메서드입니다. 이는 OlmFolder 객체 목록을 반환합니다.
OlmStorage 인스턴스와 OlmFolder 객체 리스트를 전달하여 ExtractItems 메서드를 호출합니다.
ExtractItems 메서드에서 folders 리스트의 각 폴더를 반복합니다.
폴더에 메시지(이메일)가 포함되어 있으면, Console.WriteLine(folder)를 사용하여 폴더 이름을 콘솔에 출력합니다.
OlmStorage 인스턴스에서 EnumerateMessages 메서드를 호출하고 현재 폴더를 인수로 전달하여 현재 폴더의 메시지를 반복합니다.
Console.WriteLine(msg.Subject)를 사용하여 각 메시지의 제목을 콘솔에 출력합니다.
폴더에 하위 폴더가 있는 경우, OlmStorage 인스턴스와 현재 폴더의 하위 폴더를 전달하면서 ExtractItems 메서드를 재귀적으로 다시 호출합니다.

using (var olm = new OlmStorage((exception, id) => { /* Exception handling  code. */ }))
{
    if (olm.Load(fileName))
    {
        var folderHierarchy = olm.GetFolders();
        ExtractItems(olm, folderHierarchy);
    }
}

private static void ExtractItems(OlmStorage olm, List<OlmFolder> folders)
{
    foreach (var folder in folders)
    {
        if (folder.HasMessages)
        {
            Console.WriteLine(folder);

            foreach (var msg in olm.EnumerateMessages(folder))
            {
                Console.WriteLine(msg.Subject);
            }
        }

        if (folder.SubFolders.Count > 0)
        {
            ExtractItems(olm, folder.SubFolders);
        }
    }
}

식별자를 사용한 OLM 메시지 추출

MAPI 메시지 데이터에 접근하려면 ’entry_id’ 속성을 사용하여 메시지의 고유 식별자(Entry ID)를 얻을 수 있습니다 using the OlmMessageInfo 클래스. 그런 다음, ’extract_mapi_message(id)’ 메서드를 사용할 수 있습니다 the OlmStorage 클래스는 엔트리 ID를 매개변수로 전달하여 해당 엔트리 ID와 연결된 MAPI 메시지를 가져옵니다. 아래 코드 스니펫은 이러한 기능의 사용을 보여줍니다:


import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info.entry_id)

폴더 경로 가져오기

Outlook OLM 파일 내에서 폴더의 계층 경로나 위치도 얻을 수 있습니다. Aspose.Email는 ‘path’ 속성을 제공합니다 the OlmFolder 클래스는 폴더 경로를 반환합니다. 아래 코드 스니펫은 이 속성의 사용을 보여줍니다:

import aspose.email as ae


def print_path(storage, folders):
    for folder in folders:
        # print the current folder path
        print(folder.path)

        if folder.sub_folders:
            print_path(storage, folder.sub_folders)


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_path(olm, olm.folder_hierarchy)

폴더 내 항목 수 세기

Aspose.Email는 Outlook OLM 파일의 특정 폴더에 포함된 이메일 메시지 총 수를 셀 수 있는 기능을 제공합니다. ‘message_count’ 속성은 the OlmFolder 클래스는 OLM 파일의 특정 폴더에 저장된 총 항목(이메일 메시지) 수를 반환합니다. 아래 코드 스니펫은 이 속성의 사용을 보여줍니다:

import aspose.email as ae


def print_message_count(folders):
    for folder in folders:
        print(f"Message Count [{folder.name}]: {folder.message_count}")


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_message_count(olm.folder_hierarchy)

OlmStorage의 총 항목 수 가져오기

‘get_total_items_count()’ 메서드는 the OlmStorage 클래스는 OLM 저장소에 포함된 총 메시지 항목 수를 반환합니다.

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
count = olm.get_total_items_count()

Outlook 카테고리 색상 가져오기

Aspose.Email를 사용하면 OLM 파일에 저장된 Outlook 항목 카테고리와 연결된 카테고리 색상을 손쉽게 가져오고 활용할 수 있습니다. the OlmItemCategory 클래스는 카테고리 이름과 16진수 형식으로 표시된 해당 색상에 접근할 수 있게 합니다. the OlmStorage 클래스는 OLM 저장소에서 카테고리 목록을 가져오는 ‘GetCategories()’ 메서드를 제공합니다. 아래 코드 샘플을 구현하면 OML 저장 파일에서 사용된 모든 카테고리를 손쉽게 가져와 카테고리 이름과 색상을 확인할 수 있습니다.

with OlmStorage.FromFile("storage.olm") as olm:
    categories = olm.GetCategories()
    
    for category in categories:
        print(f"Category name: {category.Name}")
        
        # Color is represented as a hexadecimal value: #rrggbb
        print(f"Category color: {category.Color}")

또한 폴더의 메시지를 반복하면서 카테고리 이름에 따라 해당 카테고리 색상을 액세스하여 특정 메시지와 연결된 카테고리 색상을 가져올 수 있습니다.

for msg in olm.EnumerateMessages(folder):
    if msg.Categories is not None:
        for msgCategory in msg.Categories:
            print(f"Category name: {msgCategory}")
            categoryColor = next((c.Color for c in categories if c.Name.lower() == msgCategory.lower()), None)
            if categoryColor is not None:
                print(f"Category color: {categoryColor}")

Python-Net: Python 애플리케이션에서 Outlook OLM 파일 관리

Mon, 01 Jan 0001 00:00:00 +0000

Outlook OLM 파일 열기

OLM 형식 파일은 두 가지 방법으로 열 수 있습니다:

생성자 사용
정적 ‘from_file’ 메서드를 사용하여

Python 생성자를 사용하여 Outlook OLM 파일 열기

파일을 열려면, 다음의 생성자를 호출합니다 OlmStorage 클래스이며 전체 파일 이름이나 스트림을 인수로 전달합니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)

Python의 정적 메서드 FromFile을 사용하여 OLM 파일 열기

파일을 열려면 해당 클래스의 정적 메서드 ‘from_file’을 사용합니다. OlmStorage 클래스이며 전체 파일 이름이나 스트림을 인수로 전달합니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)

OLM 파일의 폴더 및 이메일 관리

폴더 구조를 재귀적으로 접근

Aspose.Email API를 사용하면 print_all_folders 함수를 통해 OLM 파일에서 가져온 폴더 계층을 시각화하고 표시할 수 있습니다. 이 함수는 해당 클래스의 folder_hierarchy 속성을 인수로 받습니다. OlmStorage 클래스와 들여쓰기 수준을 입력으로 받아 계층을 재귀적으로 순회하며 각 폴더 이름을 적절한 들여쓰기와 함께 출력합니다.

아래는 print_all_folders 함수를 사용해 OLM 파일의 폴더 계층을 표시하는 코드 샘플입니다:

import aspose.email as ae


def print_all_folders(folder_hierarchy, indent):
    for folder in folder_hierarchy:
        print(f"{indent}{folder.name}")
        print_all_folders(folder.sub_folders, indent + "-")

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_all_folders(olm.folder_hierarchy, "")

위의 코드 샘플은 재귀 함수를 통해 OLM 파일의 폴더 계층을 보다 구조적이고 읽기 쉬운 형식으로 표시하도록 설계되었습니다.

폴더 구조 직접 접근

Aspose.Email을 사용하면 해당 클래스의 get_folders() 메서드를 통해 OLM 파일에서 폴더 구조에 직접 접근할 수 있습니다. OlmStorage 클래스.

아래는 폴더 구조에 직접 접근하는 코드 샘플입니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folders = olm.get_folders()

이름으로 폴더 가져오기

해당 클래스의 get_folder(name, ignore_case) 메서드를 사용하면 이름으로 어떤 폴더든 가져올 수 있습니다. OlmStorage 클래스. 이 메서드는 폴더 이름과 대소문자 구분 매개변수를 필요로 합니다.

다음은 폴더 이름으로 폴더를 가져오는 예시 코드입니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

Outlook OLM 파일에서 이메일 목록 가져오기

Aspose.Email 라이브러리를 사용하여 Outlook for Mac (OLM) 파일에서 이메일 메시지를 읽고 추출할 수 있습니다. 다음 메서드를 사용해 이메일 목록을 가져올 수 있습니다: OlmFolder 폴더를 나타내는 클래스:

enumerate_messages() - 폴더의 각 이메일 메시지를 반복합니다. 이 메서드는 메시지를 해당 클래스의 인스턴스로 반환합니다. OlmMessageInfo 클래스는 각 이메일 메시지의 기본 정보(제목, 보낸 사람, 날짜 등)를 제공합니다.
enumerate_mapi_messages() - 폴더의 각 이메일 메시지를 반복하지만, 이 경우 메시지를 해당 클래스의 인스턴스로 반환합니다. MapiMessage 클래스는 이메일 메시지를 보다 상세하고 MAPI 전용 방식으로 나타냅니다. 이메일 메시지의 다양한 속성 및 세부 정보를 액세스할 수 있어 보다 고급 및 특수한 처리가 가능합니다.

아래 코드 샘플은 *enumerate_messages()*를 사용해 기본 이메일 제목을 추출하고, *enumerate_mapi_messages()*를 사용해 메시지를 .msg 파일로 저장함으로써 Outlook OLM 파일에서 기본 이메일 제목을 추출하고 상세 이메일 메시지를 저장하는 방법을 보여줍니다.

’enumerate_messages()’ 메서드를 사용해 기본 이메일 정보 추출

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    print(message_info.subject)

’enumerate_mapi_messages()’ 메서드를 사용해 상세 이메일 메시지 저장

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for msg in folder.enumerate_mapi_messages():
    msg.save(f"{msg.subject}.msg")

OLM 폴더의 전체 메시지 수 가져오기

다음은 OlmFolder 클래스는 다음 메서드를 통해 더 많은 옵션을 제공합니다:

has_messages - 현재 폴더에 메시지가 있는지 여부를 나타내는 값을 가져옵니다.
message_count - 메시지 수를 가져옵니다.

아래 코드 샘플은 이러한 메서드 사용 방법을 보여줍니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

if folder.has_messages:
   print(f"Message count: {folder.message_count}")

Outlook OLM 메시지의 수정 날짜 가져오기 또는 설정하기

Aspose.Email을 사용하면 이메일 메시지의 마지막 수정 시간 정보를 가져올 수 있습니다. 해당 클래스의 modified_date 속성은 OlmMessageInfo 클래스는 메시지가 마지막으로 수정된 날짜와 시간을 나타냅니다.

다음은 해당 속성 사용을 보여주는 예시입니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    modifiedDate = message_info.modified_date

OLM 콘텐츠 추출

Outlook OLM 파일에서 이메일 추출

해당 클래스의 extract_mapi_message(message_info) 메서드를 사용하여 이메일 저장소에서 실제 MAPI 메시지 데이터를 가져올 수 있습니다. OlmStorage 클래스. 이 메서드는 제공된 message_info를 기반으로 저장소에서 MAPI 메시지를 추출합니다.

아래 코드 샘플은 이 메서드 사용 방법을 보여줍니다:

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info)

식별자를 사용해 OLM 파일에서 Outlook 메시지 추출

MAPI 메시지 데이터에 접근하려면, 해당 클래스의 entry_id 속성을 사용하여 메시지의 고유 식별자(Entry ID)를 얻을 수 있습니다. OlmMessageInfo 클래스. 그런 다음, 해당 클래스의 extract_mapi_message(id) 메서드를 활용할 수 있습니다. OlmStorage 클래스는 엔트리 ID를 매개변수로 전달하여 해당 엔트리 ID와 연결된 MAPI 메시지를 가져옵니다. 아래 코드 스니펫은 이러한 기능의 사용을 보여줍니다:


import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage.from_file(fileName)
folder = olm.get_folder("Inbox", True)

for message_info in folder.enumerate_messages():
    msg = olm.extract_mapi_message(message_info.entry_id)

OLM 폴더 구조 관리

Outlook OLM 파일에서 폴더 경로 가져오기

Aspose.Email을 사용하면 Outlook OLM 파일 내 폴더의 계층 경로나 위치를 가져올 수 있습니다. API는 해당 클래스의 path 속성을 제공합니다. OlmFolder 클래스는 폴더 경로를 반환합니다. 아래 코드 스니펫은 이 속성의 사용을 보여줍니다:

import aspose.email as ae


def print_path(storage, folders):
    for folder in folders:
        # print the current folder path
        print(folder.path)

        if folder.sub_folders:
            print_path(storage, folder.sub_folders)


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_path(olm, olm.folder_hierarchy)

Outlook OLM 폴더의 항목 수 세기

Aspose.Email은 Outlook OLM 파일의 특정 폴더에 포함된 이메일 메시지 총 수를 셀 수 있는 기능을 제공합니다. 해당 클래스의 message_count 속성은 OlmFolder 클래스는 OLM 파일의 특정 폴더에 저장된 총 항목(이메일 메시지) 수를 반환합니다. 아래 코드 스니펫은 이 속성의 사용을 보여줍니다:

import aspose.email as ae


def print_message_count(folders):
    for folder in folders:
        print(f"Message Count [{folder.name}]: {folder.message_count}")


fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
print_message_count(olm.folder_hierarchy)

Outlook OLM 파일의 총 항목 수 얻기

클래스의 get_total_items_count() 메서드 OlmStorage 클래스는 아래 코드 샘플에 표시된 바와 같이 OLM 저장소에 포함된 메시지 항목의 총 수를 반환합니다.

import aspose.email as ae

fileName = "my.olm"
olm = ae.storage.olm.OlmStorage(fileName)
count = olm.get_total_items_count()

Outlook 카테고리 관리

Outlook 카테고리 색상 가져오기

Aspose.Email를 사용하면 OLM 파일에 저장된 Outlook 항목 카테고리와 연결된 카테고리 색상을 손쉽게 가져오고 활용할 수 있습니다. the OlmItemCategory 클래스는 카테고리 이름과 16진수 형식으로 표시된 해당 색상에 접근할 수 있게 합니다. the OlmStorage 클래스는 OLM 저장소에서 카테고리 목록을 가져오는 GetCategories() 메서드를 제공합니다. 아래 코드 샘플을 구현하면 OML 저장소 파일에서 사용된 모든 카테고리를 손쉽게 가져오고 카테고리 이름과 색상을 확인할 수 있습니다.

with OlmStorage.FromFile("storage.olm") as olm:
    categories = olm.GetCategories()
    
    for category in categories:
        print(f"Category name: {category.Name}")
        
        # Color is represented as a hexadecimal value: #rrggbb
        print(f"Category color: {category.Color}")

for msg in olm.EnumerateMessages(folder):
    if msg.Categories is not None:
        for msgCategory in msg.Categories:
            print(f"Category name: {msgCategory}")
            categoryColor = next((c.Color for c in categories if c.Name.lower() == msgCategory.lower()), None)
            if categoryColor is not None:
                print(f"Category color: {categoryColor}")