💡 完全な動作例は GitHub で入手できます: convert-email-and-attachments-to-pdf-dotnet
Email-to-PDF 変換は .NET 用の GroupDocs.Conversion ワークフローで、Outlook メッセージとその添付ファイルを 1 つまたは複数の PDF ファイルに変換し、添付ファイルが互いに上書きされたり、サポートされていないファイルが全体の実行を中断したりしません。手動でエクスポートして名前を変更する手順を、各アイテムの元の場所と変換の成否を把握した数行のコードに置き換えます。
以前の方法は苦痛だった
サポート用の受信トレイを想像してください。各ケースのメールには 2〜3 個の添付ファイルが付いており、レポートやスクリーンショット、時にはチームの誰も認識できないファイル形式が混在しています。これは珍しいことではありません。そのケースを処理するには、メッセージを開き、各添付ファイルを手作業で保存し、report.csv のように 2 つのシステムが同じ名前でエクスポートしたファイルは名前を変更し、さらに PDF ビューアが開けない形式が混ざっていないか確認しなければなりません。これを週に 50 回行うと、「クイックエクスポート」が仕事の中で最も遅い工程になり、最も急がれがちな工程となります。ちょうどそのときにミスが起きやすくなるのです。
手作業で行うと時間がかかるだけでなく、ファイルが静かに失われることもあります。report.csv という同名の添付ファイルを 2 つ同じフォルダーに名前変更せずに保存すると、2 番目の保存が 1 番目を上書きします。誰も気付かず、9 月の数値が見つからなくなるまで気付かれません。変換できない形式の添付ファイルが 1 つでもあると、全体のエクスポートが止まってしまいます。
手作業で行う実際のコスト: 名前が変更され上書きされた添付ファイルはエラーを出さず、ただ静かに消えてしまいます。ケースファイルは完了したように見えますが、必要なデータが失われています。
より良い方法があります
GroupDocs.Conversion for .NET はこれを数行のコードに変換します。手動で名前を変更する必要はありません。EmailLoadOptions クラスでメッセージ、添付ファイル、またはその両方を変換するかを制御でき、SaveContext コールバックは各出力アイテムを十分に記述します。そのため、report.csv という同名の添付ファイルが衝突することはなく、PDF 変換ルートがない添付ファイルが残りの処理を止めることもありません。コールバックは各呼び出しで ItemIndex(1 から始まる連番)、HierarchyLevel(メッセージは 0、添付は 1)、SourceFileName(元のファイル名)を報告し、余分な帳簿管理を書かずに衝突しない出力名を構築するのに十分なコンテキストを提供します。
開始する前に必要なもの:
- .NET SDK 8.0 以降
- GroupDocs.Conversion for .NET 26.10.0(無料の一時ライセンス で評価制限を解除)
- 変換対象の Outlook
.msgまたは.emlメッセージ
1 行でインストール:
dotnet add package GroupDocs.Conversion --version 26.10.0
新しい方法: メッセージとその添付ファイルの変換
以下は同じタスクを GroupDocs.Conversion で実装した例です。Outlook メッセージとそのすべての添付ファイルを個別の PDF に変換し、ファイル名が決して衝突しません。
ステップ 1 - 何を変換するか決める
EmailLoadOptions.ConvertOwner と ConvertOwned はメッセージと添付ファイルの変換を個別にオンオフできます。Depth(デフォルト 2)はネストされた添付ファイルの追跡深さを制限します。
// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
ステップ 2 - SaveContext からすべての出力に名前を付ける
Converter.Convert に固定の出力パスではなく SaveContext コールバックを渡します。コールバックはアイテムごとに一度呼び出され、ItemIndex は同名の添付があってもアイテムごとに一意です。
using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
converter.Convert((SaveContext item) =>
{
// ItemIndex is 1 for the message, then counts up per attachment
string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());
}
ステップ 3 - PDF 変換ルートがない添付ファイルの処理
すべての添付が PDF になるわけではありません。SaveContext.TargetFormat が FileType.Unknown かどうかを確認し、変換できない場合は元の名前で保存します。
converter.Convert((SaveContext item) =>
{
bool passedThrough = item.TargetFormat == FileType.Unknown;
string baseName = $"{item.ItemIndex:D2}-{item.SourceFileName}";
string name = passedThrough
? baseName
: $"{baseName}.{item.TargetFormat.Extension}";
return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());
このコードを、report.csv という同名の添付が 2 つと、サポートされていない形式の添付が 1 つあるサンプルサポートメールに適用すると、3 つの PDF が生成されます:メッセージ本体と 2 つの CSV レポート。サポートされていないファイルはそのまま保存され、元のファイルと並べて開くと 32 バイトすべてが一致します。
同じファイル名を持つ添付ファイルが上書きされないようにするには?
ファイル名だけでは安全なキーになりません。2 つの添付が同一の名前を持つことがあるからです。SaveContext.ItemIndex と SaveContext.SourceFileName を組み合わせて名前を作成すれば、report.csv という 2 つの添付が同じディスク領域を競合しなくなります。各添付はゼロ埋めされたプレフィックス(サンプルでは 02- と 03-、メッセージは 01-)と元の名前で保存されます。
並列比較: 変更前 vs. 変更後
| 変更前(手動) | 変更後(GroupDocs.Conversion) | |
|---|---|---|
| 時間 | メッセージごとに数分、手作業 | 数行のコードで、メッセージ数に制限なし |
| 重複した名前 | 黙って上書き | ItemIndex により別々に保持 |
| サポートされていない添付ファイル | 変換全体が失敗(26.10 以前) | 独自の名前で保存され、処理は続行 |
| 出力 | PDF ビューアが保存できるもの | 整理された PDF で、ファイル化やインデックス化が可能 |
サンプルのサポートメールは、同名の月次 CSV エクスポートが 2 つと、コンバータが認識しないキャプチャファイル 1 つという構成です。
実務例: サポートケースのアーカイブ
サポートチームは顧客ケースをメールとして記録し、1 つ以上のスプレッドシート添付を含めます。ケース追跡システムは、各添付をメッセージ本体とは別の検索可能な PDF として保存する必要があります。KeepAttachmentsWithoutPdfRoute を受信ケースごとに 1 回呼び出すだけで、メッセージと添付を番号付きのファイルセットに変換し、レポート名が同じでも添付が上書きされることはありません。2 つの月次 report.csv と 1 つの変換できないキャプチャファイルを含むケースメールは、メッセージ本体、2 つの CSV レポート(PDF 化)、キャプチャファイル(元の名前で保存)の計 4 ファイルとして出力されます。何も失われず、結合も上書きもありません。
// One call per case e-mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
GroupDocs.Conversion for .NET で他にできることは?
メッセージと添付の分離以外にも、EmailLoadOptions はメッセージ自体に関するさまざまな設定をカバーしています。
- フィールドの表示:
DisplayHeaderと関連するDisplay*オプションでヘッダーとFrom、To、Cc、Bcc行を表示または非表示にできます(CcとBccはデフォルトで非表示)。 - ローカライズされたヘッダー:
FieldTextMapを使用して各EmailFieldを別のキャプションにマッピングできます。例としてSubjectとAttachmentsを別の言語に翻訳できます。 - 日付書式:
Sent行は変換を実行するマシンのカルチャに従い、TimeZoneOffsetはメッセージの日付に使用する UTC オフセットを設定します。 - メッセージのみの出力: PDF がメッセージの代わりだけでよい場合は
ConvertOwnedをfalseに設定し、添付ファイル名はヘッダーに参照として残ります。
すべてのオプションについては、完全な EmailLoadOptions リファレンス をご覧ください。
結論
かつてはメッセージを開き、添付を手作業で保存し、上書きされた重複を再確認する必要がありましたが、今や SaveContext コールバックと数行のコードで完了します。GroupDocs.Conversion for .NET は、メッセージと各添付に衝突しない名前を付け、PDF 変換ルートがない添付は失敗せずに保存します。ConvertOwner、ConvertOwned、SaveContext コールバックという 3 つの基本ブロックは、単一のサマリ PDF からメッセージとすべての添付を安全に分解するフルワークフローまでスケールし、受信トレイの需要に合わせて小規模から拡大できます。
メールから PDF へのワークフローを自動化する準備はできましたか?