Documentation – OLM 파일 작업

Net: OLM 파일 열기

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

Aspose.Email for .NET은 Outlook for Mac 저장소 파일을 OlmStorage 클래스. 이 문서에서는 경로나 스트림에서 OLM 파일을 여는 방법과 손상될 수 있는 파일을 안전하게 로드하는 방법을 보여줍니다.

OLM 파일 열기

OLM 파일을 여는 방법은 두 가지가 있습니다:

생성자를 사용;
정적을 사용 FromFile 메서드.

이 두 접근 방식 사이에는 폴더 계층 구조 초기화 방식에 차이가 있습니다. 자세히 보기 OLM 폴더 탐색 자세한 내용은 확인하십시오.

생성자 사용

파일을 열려면 OlmStorage 클래스를 사용하고 전체 파일 이름을 인수로 전달합니다. 왜냐하면 OlmStorage 구현합니다 IDisposable, 이를 using 구문으로 파일 핸들이 작업이 끝난 후 해제되도록 합니다.

var fileName = "MyStorage.olm";
using (var olm = new OlmStorage(fileName))
{
    // work with the storage
}

정적 FromFile 메서드 사용

파일을 열려면 정적 FromFile 메서드를 사용하고 전체 파일 이름을 인수로 전달합니다:

var fileName = "MyStorage.olm";
using (var olm = OlmStorage.FromFile(fileName))
{
    // work with the storage
}

스트림에서 OLM 파일 열기

OLM 데이터가 로컬 경로에서 오지 않을 때—예를 들어 데이터베이스, 네트워크 리소스, 클라우드 저장소 등에서 받아오는 경우—다음과 같이 직접 스트림에서 열 수 있습니다 Stream. 다음을 사용합니다 OlmStorage(Stream) 생성자 또는 정적 FromStream 메서드.

using (var stream = File.OpenRead("MyStorage.olm"))
using (var olm = new OlmStorage(stream))
{
    // work with the storage
}

정적 메서드도 동일하게 작동합니다:

using (var stream = File.OpenRead("MyStorage.olm"))
using (var olm = OlmStorage.FromStream(stream))
{
    // work with the storage
}

스토리지를 액세스하는 동안 소스 스트림을 계속 열어 두십시오. 폴더와 메시지를 읽는 작업을 마치기 전에 스트림을 폐기하면 읽기 오류가 발생합니다.

손상된 OLM 파일 열기

파일이 부분적으로 손상될 수 있는 경우 첫 번째 오류에서 중단하지 않고 가능한 한 많은 데이터를 추출할 수 있습니다. 이를 위해 OlmStorage 인스턴스를 사용하여 파일을 로드합니다. OlmStorage(TraversalExceptionsCallback callback) 생성자를 대신해 파일을 로드합니다. Load 메서드를 사용하고 FromFile.

콜백은 로드 및 순회 중 발생한 예외를 받아 로그를 남기거나 무시할 수 있게 합니다. 해당 Load 메서드가 반환합니다 true 파일이 성공적으로 로드되고 탐색이 가능한 경우 및 false 파일이 너무 손상되어 순회가 불가능한 경우.

using (var olm = new OlmStorage((exception, id) =>
{
    // Exception handling code.
    Console.WriteLine($"Failed to process item '{id}': {exception.Message}");
}))
{
    if (olm.Load(fileName))
    {
        // The file was loaded and can be traversed.
        var folderHierarchy = olm.GetFolders();
    }
    else
    {
        Console.WriteLine("The OLM file is corrupted and cannot be traversed.");
    }
}

손상된 파일에서 항목을 추출하는 전체 예제는 OLM 메시지 읽기 및 추출.

Net: OLM 폴더 탐색

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

OLM 파일은 데이터를 폴더 트리 구조로 구성하며, 각 폴더는 OlmFolder 객체. 이 문서에서는 폴더 계층을 열거하고, 이름으로 특정 폴더를 검색하고, 하위 폴더를 탐색하며, 폴더 경로를 읽는 방법을 보여줍니다.

폴더 계층 검색

파일을 연 후 다음을 통해 디렉터리 구조에 접근합니다: FolderHierarchy 속성. 이 속성은 목록을 반환합니다: OlmFolder 객체는 OLM 파일의 최상위 디렉터리를 각각 나타냅니다. 더 깊이 탐색하려면 SubFolders 각 폴더의 속성으로 하위 디렉터리를 반환합니다. 이 두 멤버를 사용하면 전체 계층을 탐색할 수 있습니다.

아래 예제는 계층 순서대로 모든 폴더를 인쇄합니다:

using (var olm = new OlmStorage(fileName))
{
    PrintAllFolders(olm.FolderHierarchy, string.Empty);
}

private void PrintAllFolders(IEnumerable<OlmFolder> folderHierarchy, string indent)
{
    foreach (var folder in folderHierarchy)
    {
        Console.WriteLine($"{indent}{folder.Name}");
        PrintAllFolders(folder.SubFolders, indent + "-");
    }
}

FolderHierarchy 및 FromFile 메서드

파일을 여는 방식에 따라 FolderHierarchy 동작합니다:

생성자를 사용해 파일을 열면 FolderHierarchy 속성이 자동으로 초기화됩니다.
파일을 열면 FromFile 메서드, FolderHierarchy 는 기본적으로 초기화되지 않으며 null. 이 경우 GetFolders 메서드를 명시적으로 호출하여 계층을 초기화하고 디렉터리 목록을 가져옵니다:

using (var olm = OlmStorage.FromFile(fileName))
{
    var folders = olm.GetFolders();
}

이름으로 폴더 가져오기

이름으로 단일 폴더를 검색하려면 GetFolder 메서드. 첫 번째 인수로 폴더 이름을, 두 번째 인수로 검색 시 대소문자를 무시할지 여부를 나타내는 부울 값을 전달합니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    // get the Inbox folder by name, ignoring case
    OlmFolder folder = olm.GetFolder("Inbox", true);
}

이름으로 하위 폴더 가져오기

각 OlmFolder 또한 GetSubFolder 메서드. 하위 폴더 이름과 대소문자를 무시할지 여부를 전달합니다. 기존에 상위 폴더를 보유하고 전체 계층을 다시 스캔하지 않고 하위 폴더로 들어갈 때 유용합니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    OlmFolder inbox = olm.GetFolder("Inbox", true);

    // get a sub-folder of Inbox by name
    OlmFolder archive = inbox.GetSubFolder("Archive", true);

    if (archive != null)
    {
        Console.WriteLine($"Found sub-folder: {archive.Name}");
    }
}

폴더 경로 검색

다음 OlmFolder.Path 속성. 다음 스니펫은 파일의 모든 폴더 경로를 인쇄합니다:

using (var storage = new OlmStorage("SampleOLM.olm"))
{
    PrintPath(storage.FolderHierarchy);
}

public static void PrintPath(IEnumerable<OlmFolder> folders)
{
    foreach (OlmFolder folder in folders)
    {
        // print the current folder path
        Console.WriteLine(folder.Path);

        PrintPath(folder.SubFolders);
    }
}

Net: OLM 메시지 읽기 및 추출

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

OLM 파일을 열고 폴더를 찾은 후 해당 폴더의 메시지를 나열하고, 짧은 메시지 정보를 읽고, 큰 폴더를 필터링 및 페이지 처리하며, 개별 메시지를 다음과 같이 추출할 수 있습니다 MapiMessage 객체. 이 문서에서는 이러한 모든 작업을 다룹니다.

폴더 내 메시지 목록

다음은 OlmFolder 클래스는 포함된 메시지를 반복하는 두 가지 방법을 제공합니다:

EnumerateMessages 다음을 반환합니다 OlmMessageInfo 각 반복 시 객체를 반환합니다. 이 객체는 메시지에 대한 짧은 정보를 보유하고 있으며 폴더를 스캔하는 가장 효율적인 방법입니다.
EnumerateMapiMessages 전체를 반환합니다 MapiMessage 각 반복 시 객체에 메시지의 모든 속성이 로드됩니다.

EnumerateMessages 사용

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);
    foreach (var messageInfo in folder.EnumerateMessages())
    {
        Console.WriteLine(messageInfo.Subject);
    }
}

EnumerateMapiMessages 사용

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (var msg in folder.EnumerateMapiMessages())
    {
        // save the message in MSG format
        msg.Save($"{msg.Subject}.msg");
    }
}

메시지 정보 읽기

각 OlmMessageInfo object는 전체 내용을 로드하지 않고도 메시지를 설명하는 일련의 읽기 전용 속성을 노출합니다. 이는 목록 보기를 만들거나 어떤 메시지를 추출할지 결정하는 가장 효율적인 방법입니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (OlmMessageInfo messageInfo in folder.EnumerateMessages())
    {
        Console.WriteLine($"Subject: {messageInfo.Subject}");
        Console.WriteLine($"From: {messageInfo.From}");
        Console.WriteLine($"To: {string.Join("; ", messageInfo.To)}");
        Console.WriteLine($"Date: {messageInfo.Date}");
        Console.WriteLine($"Modified: {messageInfo.ModifiedDate}");
        Console.WriteLine($"Has attachments: {messageInfo.HasAttachments}");
        Console.WriteLine($"Message class: {messageInfo.MessageClass}");
        Console.WriteLine(new string('-', 30));
    }
}

메시지 수정 날짜 가져오기

수정 날짜는 OLM 메시지가 마지막으로 수정된 날짜와 시간을 나타냅니다. 다음을 사용합니다 OlmMessageInfo.ModifiedDate 속성을 읽어야 합니다:

foreach (OlmMessageInfo messageInfo in inboxFolder.EnumerateMessages())
{
    DateTime modifiedDate = messageInfo.ModifiedDate;
}

쿼리로 메시지 필터링

대형 폴더의 경우 모든 항목을 반복하는 대신 기준에 맞는 메시지만 검색할 수 있습니다. MailQuery 에게 EnumerateMessages(MailQuery query) 오버로드. 쿼리를 사용해 MailQueryBuilder.

다음 예제는 지난 7일 동안 수신된 메시지 중 제목에 "Invoice"가 포함된 메시지만 열거합니다:

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    var builder = new MailQueryBuilder();
    builder.InternalDate.Since(DateTime.Now.AddDays(-7));
    builder.Subject.Contains("Invoice");
    MailQuery query = builder.GetQuery();

    foreach (var messageInfo in folder.EnumerateMessages(query))
    {
        Console.WriteLine(messageInfo.Subject);
    }
}

메시지 페이지 처리

폴더에 많은 메시지가 있을 경우 EnumerateMessages(int skip, int count) 오버로드. skip 매개변수는 건너뛸 메시지 수이며, count 는 반환할 메시지 수입니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    const int pageSize = 50;
    int pageIndex = 0;

    while (true)
    {
        var page = folder.EnumerateMessages(pageIndex * pageSize, pageSize).ToList();
        if (page.Count == 0)
        {
            break;
        }

        foreach (var messageInfo in page)
        {
            Console.WriteLine(messageInfo.Subject);
        }

        pageIndex++;
    }
}

MapiMessage로 메시지 추출

다음은 OlmStorage class는 다음을 제공합니다 ExtractMapiMessage 메서드는 전체 MapiMessage 에서 폴더를 처음 스캔할 때 유용합니다. OlmMessageInfo 객체. 이는 EnumerateMessages 그리고 실제로 필요한 메시지만 추출합니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    foreach (var messageInfo in folder.EnumerateMessages())
    {
        if (messageInfo.Date.Date == DateTime.Today)
        {
            // extract today's messages from Inbox
            var msg = olm.ExtractMapiMessage(messageInfo);
            msg.Save($"{msg.Subject}.msg");
        }
    }
}

식별자를 통한 메시지 추출

때때로 식별자를 사용해 선택된 메시지를 추출해야 할 수 있습니다. 예를 들어, 애플리케이션이 데이터베이스에 식별자를 저장하고 필요할 때마다 전체 저장소를 탐색하지 않고 메시지를 추출할 수 있습니다. EntryId 속성 OlmMessageInfo 메시지 엔트리 식별자를 제공하고, 오버로드된 ExtractMapiMessage(string id) 메서드는 해당 식별자를 통해 메시지를 검색합니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    var olmFolder = olm.GetFolder("Inbox", true);

    foreach (OlmMessageInfo msgInfo in olmFolder.EnumerateMessages())
    {
        // store msgInfo.EntryId somewhere, then later:
        MapiMessage msg = olm.ExtractMapiMessage(msgInfo.EntryId);
    }
}

탐색 API를 사용한 항목 추출

OLM 파일에서 가능한 한 모든 항목을 예외를 발생시키지 않고 추출할 수 있습니다, 원본 파일의 일부 데이터가 손상된 경우에도 가능합니다. 이를 위해 OlmStorage 인스턴스를 사용하여 파일을 로드합니다. OlmStorage(TraversalExceptionsCallback callback) 생성자를 사용하고 Load 메서드. 콜백은 로드 및 탐색 예외를 노출합니다.

다음은 Load 메서드가 반환합니다 true 파일이 성공적으로 로드되고 탐색이 가능한 경우 및 false 파일이 손상되어 탐색이 불가능한 경우. 폴더별로 항목을 탐색할 때 저장소의 EnumerateMessages(OlmFolder folder) 메서드에 폴더를 인수로 전달합니다.

단계는 다음과 같습니다:

새로운 OlmStorage 인스턴스를 사용하고 예외 처리 콜백을 전달합니다.
다음 메서드를 호출하여 OLM 파일을 로드합니다. Load 메서드.
파일이 성공적으로 로드되면 다음을 호출하여 폴더 계층을 가져옵니다: GetFolders.
각 폴더를 재귀적으로 반복합니다. 메시지가 있는 폴더의 경우 저장소의 EnumerateMessages 메서드와 각 폴더를 처리합니다.
하위 폴더가 있으면 재귀적으로 탐색합니다.

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, IEnumerable<OlmFolder> folders)
{
    foreach (var folder in folders)
    {
        if (folder.HasMessages)
        {
            Console.WriteLine(folder);

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

        ExtractItems(olm, folder.SubFolders);
    }
}

Net: 항목 수 세기 및 카테고리 작업

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

개별 메시지를 읽는 것 외에도 Aspose.Email for .NET을 사용하면 OLM 파일이나 폴더에 포함된 항목 수를 확인하고 파일에 저장된 Outlook 카테고리(색상 포함)를 읽을 수 있습니다. 이 문서는 둘 다 다룹니다.

폴더에 메시지가 있는지 확인

다음은 OlmFolder.HasMessages 속성은 폴더에 메시지가 있는지 여부와 OlmFolder.MessageCount 속성은 개수를 반환합니다.

using (var olm = OlmStorage.FromFile(fileName))
{
    var folder = olm.GetFolder("Inbox", true);

    if (folder.HasMessages)
    {
        Console.WriteLine($"Message count: {folder.MessageCount}");
    }
}

각 폴더의 항목 수 세기

다음 사용 OlmFolder.MessageCount 파일의 각 폴더에 있는 항목 수를 보고하는 속성:

using (var storage = new OlmStorage("SampleOLM.olm"))
{
    PrintMessageCount(storage.FolderHierarchy);
}

public static void PrintMessageCount(IEnumerable<OlmFolder> folders)
{
    foreach (OlmFolder folder in folders)
    {
        Console.WriteLine($"Message Count [{folder.Name}]: {folder.MessageCount}");

        PrintMessageCount(folder.SubFolders);
    }
}

저장소에 있는 항목 총 수 가져오기

다음은 OlmStorage 클래스에 GetTotalItemsCount() 전체 OLM 저장소에 포함된 메시지 항목 총 수를 반환하는 메서드:

using (var olm = new OlmStorage("storage.olm"))
{
    var count = olm.GetTotalItemsCount();
    Console.WriteLine($"Total items: {count}");
}

Outlook 카테고리 색상 가져오기

OLM 파일에 저장된 Outlook 항목 카테고리를 사용하려면 Aspose.Email이 다음을 제공합니다:

그 OlmItemCategory 클래스 - Outlook 항목 카테고리를 나타내며, 해당 Name 및 연관된 색상, 16진수 형식으로 표시됩니다;
그 GetCategories() 메서드 OlmStorage 클래스 - 저장소에 사용된 카테고리 목록을 검색합니다.

다음 샘플은 저장소에서 사용된 모든 카테고리와 해당 색상을 나열합니다:

using (var olm = OlmStorage.FromFile("storage.olm"))
{
    var categories = olm.GetCategories();

    foreach (var category in categories)
    {
        Console.WriteLine($"Category name: {category.Name}");

        // Color is represented as a hexadecimal value: #rrggbb
        Console.WriteLine($"Category color: {category.Color}");
    }
}

메시지의 카테고리 색상 얻기

특정 메시지에 할당된 카테고리를 저장소의 카테고리 목록과 비교하여 각 카테고리의 색상을 확인할 수 있습니다. 아래 예제는 폴더의 모든 메시지에 대한 카테고리를 읽고 각 카테고리의 색상을 출력합니다:

using (var olm = OlmStorage.FromFile("storage.olm"))
{
    var categories = olm.GetCategories();
    var folder = olm.GetFolder("Inbox", true);

    foreach (var msg in folder.EnumerateMapiMessages())
    {
        if (msg.Categories != null)
        {
            foreach (var msgCategory in msg.Categories)
            {
                Console.WriteLine($"Category name: {msgCategory}");

                var category = categories
                    .FirstOrDefault(c => c.Name.Equals(msgCategory, StringComparison.OrdinalIgnoreCase));

                Console.WriteLine(category != null
                    ? $"Category color: {category.Color}"
                    : "Category color: Not found");
            }
        }
    }
}

Net: OLM을 PST로 변환

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

OLM 는 Microsoft Outlook for Mac에서 사용하는 데이터베이스 파일 형식입니다. OLM 파일은 이메일 메시지, 캘린더 데이터, 연락처 및 애플리케이션 설정을 저장하며 Windows용 Outlook에서는 지원되지 않습니다. Outlook for Mac에서 Windows용 Outlook으로 메일함을 마이그레이션하려면 OLM 파일을 Outlook PST 형식. Aspose.Email for .NET을 사용하면 Microsoft Outlook이 설치되지 않아도 코드를 통해 수행할 수 있습니다.

변환 작동 방식

OLM 파일을 PST로 변환하려면 다음 단계를 따르세요:

다음의 인스턴스를 생성합니다. OlmStorage 소스 OLM 파일을 여는 클래스.
다음 옵션을 사용하여 새 PST 파일을 생성합니다: PersonalStorage.Create 메서드.
구현 GetContainerClass 메시지 클래스를 해당 폴더(컨테이너) 클래스로 매핑하는 메서드, 따라서 각 폴더가 PST에 올바른 유형으로 생성됩니다.
구현 AddToPst 메서드는 OLM 파일에서 각 폴더와 메시지를 재귀적으로 읽습니다 - 사용 EnumerateMapiMessages - 그리고 동일한 순서대로 PST에 추가합니다, AddSubFolder 및 AddMessage 의 메서드 FolderInfo.

코드 샘플

다음 코드는 OLM 파일을 PST로 변환하는 방법을 보여줍니다.

Main 메서드:

// create an instance of OlmStorage class to open the source OLM
using (var olm = new OlmStorage("my.olm"))
// create a new PST file
using (var pst = PersonalStorage.Create("my.pst", FileFormatVersion.Unicode))
{
    // recursively read each folder and its messages
    // and add them to the PST in the same order
    foreach (var olmFolder in olm.FolderHierarchy)
    {
        AddToPst(pst.RootFolder, olmFolder);
    }
}

GetContainerClass 메서드:

public string GetContainerClass(string messageClass)
{
    if (messageClass.StartsWith("IPM.Contact") || messageClass.StartsWith("IPM.DistList"))
    {
        return "IPF.Contact";
    }

    if (messageClass.StartsWith("IPM.StickyNote"))
    {
        return "IPF.StickyNote";
    }

    if (messageClass.StartsWith("IPM.Activity"))
    {
        return "IPF.Journal";
    }

    if (messageClass.StartsWith("IPM.Task"))
    {
        return "IPF.Task";
    }

    if (messageClass.StartsWith("IPM.Appointment") || messageClass.StartsWith("IPM.Schedule.meeting"))
    {
        return "IPF.Appointment";
    }

    return "IPF.Note";
}

AddToPst 메서드:

public void AddToPst(FolderInfo pstFolder, OlmFolder olmFolder)
{
    FolderInfo pstSubFolder = pstFolder.GetSubFolder(olmFolder.Name);

    foreach (var msg in olmFolder.EnumerateMapiMessages())
    {
        if (pstSubFolder == null)
        {
            pstSubFolder = pstFolder.AddSubFolder(olmFolder.Name, GetContainerClass(msg.MessageClass));
        }

        pstSubFolder.AddMessage(msg);
    }

    if (pstSubFolder == null)
    {
        pstSubFolder = pstFolder.AddSubFolder(olmFolder.Name);
    }

    foreach (var olmSubFolder in olmFolder.SubFolders)
    {
        AddToPst(pstSubFolder, olmSubFolder);
    }
}

반대 방향( PST에서 OLM) 변환은 지원되지 않으며, OLM 파일은 Outlook for Mac에서 계정을 추가하고 메일 서버와 동기화할 때만 생성됩니다.