PST Extractor

• Sử dụng để đọc hàng loạt file Outlook PST và lấy ra tệp đính kèm. Lưu ý: Chỉ đọc được những file nhỏ hơn 4GB, nếu file lớn hơn 4GB, hãy dùng Microsoft Outlook hoặc công cụ Split Outlook để tách ra thành nhiều file nhỏ.
• Được tham khảo từ @calvin-commer/pst-parser và IJMacD/pst-parser

Môi trường

1. Tải và cài đặt Node.js tại Node.js Official Website.

• Sau khi cài đặt xong, chạy cmd để kiểm tra version và biến môi trường node có chưa, đảm bảo là phiên bản mới, hiện tại đang là node v20 LTS:

  node -v
  npm -v

• Nếu chưa có git thì tải tại Git Offical Website.

2. Install package global để có thể dùng ở bất cứ đâu (nếu ko được thì chạy với quyền admin)

   npm install -g outlook-parser
   

Chạy package

1. Tạo thư mục PSTFolder tại vị trí muốn chạy cmd, copy toàn bộ file PST vào thư mục PSTFolder. Toàn bộ output sẽ được lưu vào thư mục PSTOutput.
2. Tham số:

• --dir=<đường dẫn đọc file PST> (mặc định là PSTFolder)
• --rm (cờ để xóa PSTOutput, ErrorLog trước khi chạy, mặc định là false)`
• --rt (cờ để chạy lại những file PST đã lỗi trước đó trong folder ErrorLog, mặc định là false. Khi cờ này được bật, --dir sẽ đọc mặc định ở PSTFolder, --rm sẽ là false)
• --ct (cờ để đếm số lượng file theo định dạng trogn folder PSTOutput sau khi chạy để thống kê)
• --help (cờ để mở hướng dẫn sử dụng)

3. Mở Command Prompt (CMD) và chạy lệnh:

   outlook-parser

• Câu lệnh này sẽ đọc file PST ở thư mục PSTFolder, không xóa log cũ ở PSTOutput.

• Lưu ý: nếu ko install package global mà chỉ install ở dev thì thêm npx vào đầu mỗi câu lệnh:

   npx outlook-parser

• Nếu chỉ cần test 1 hoặc 2 file .pst (trong trường hợp file bị lỗi), copy chúng vào một thư mục cùng cấp và chạy lệnh:

  outlook-parser --dir=<thư mục vừa tạo>
  

• Ví dụ, khi cần test file abc.pst, tạo một thư mục tên test và copy file đó vào, sau đó chạy lệnh:

  outlook-parser --dir=test
    

• Trường hợp muốn đọc pst ở folder test xóa đi log ở PSTOutput:

  outlook-parser --dir=test --rm

• Trường hợp muốn retry những file đã bị lỗi trước đó ở ErrorLog:

  outlook-parser --rt

• Khi chạy đủ 3 arguments như câu lệnh dưới đây, 2 argument --dir và --rm sẽ bị vô hiệu hóa và đọc giá trị mặc định để tiến hành retry ở folder ErrorLog:

  outlook-parser --dir=test --rm --rt

• Khi chạy xong quá trình phân tích file PST và đã có data ở PSTOutput, dùng argument --ct để đếm file theo định dạng, sau khi chạy log sẽ ghi vào folder Reports:

  outlook-parser --ct
  

4. Trong PSTOutput có:

• File ghi lại toàn bộ nội dung của tệp PST.
• Folder MailContents chứa nội dung của toàn bộ email đã gửi và nhận, thư rác, thư nháp,...
• Folder Attachments chứa toàn bộ tệp đính kèm từ email. Vì một số lý do liên quan đến encode, nên file .word, .pptx mở lên bị lỗi encode cần phải xác nhận OK để bật.

5. Trường hợp muốn phát triển thêm chức năng, tham khảo file test.js hoặc đọc file JS core trong folder ./src.

• Logic chỉnh sửa chủ yếu là từ PSTInternal.js.
• XXBlock bao gồm nhiều tập hợp XBlock, XBlock bao gồm nhiều DataBlock, Datablock chính là class chứa thông tin của Mail, XXBlock thường xuất hiện ở các file lớn.
• SubnodeIntermediateBlock bao gồm nhiều tập hợp SubnodeLeafBlock, logic #getSubNodeAccessor(bidSub) getSubEntry được chỉnh sửa để bổ sung thêm 1 vòng lặp lớn tìm kiếm internalNid.