Hromadná korespondence

Ten Aspose.Words Mail Merge for .NET plugin umožňuje vývojářům generovat personalizované dokumenty—jako jsou e‑maily, faktury, adresáře, štítky a zprávy—definováním jediné šablony a naplněním dynamickými daty. Postaven na jádrovém motoru pro zpracování dokumentů Aspose.Words poskytuje výkonné, škálovatelné a přizpůsobitelné řešení pro hromadné vytváření dokumentů v aplikacích .NET.

Instalace a nastavení

  1. Nainstalujte Aspose.Words for .NET balíček přes NuGet nebo konzoli Package Manager Console. ( Průvodce instalací )
  2. Konfigurujte Měřené licencování před spuštěním operací mail-merge. ( Měřené licencování ).
  3. Reference Aspose.Words.dll ve vašem projektu.

Kompatibilní s Windows, Linux, macOS a mobilní platformy používající .NET Framework, .NET nebo Mono. Podporovaná IDE zahrnují Visual Studio (2010–2026), Xamarin a MonoDevelop 2.4+.

IDE: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.

Podporované šablony / výstupní formáty: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML a Word 2007 XML.

Klíčové funkce a vlastnosti

Generování dokumentů na základě šablony

  • Vytvářejte šablony v libovolném podporovaném formátu.
  • Vložit sloučovací pole (např., «FieldName») k reprezentaci dynamických zástupců dat.
  • Udržujte šablony znovupoužitelné a snadno spravovatelné napříč různými případy použití.

Naplnění dat na úrovni pole

  • Vyplňte slučovací pole pomocí textu, obrázků, čárových kódů nebo formátovaného obsahu.
  • Ovládejte číslování, odrážky a styly tak, aby sloučený obsah odpovídal firemnímu designu.

Vnořené oblasti a podmíněné oblasti

  • Opakujte tabulky, seznamy nebo odstavce pro každý datový záznam pomocí regionů.
  • Používejte podmíněné oblasti k dynamickému zahrnování/odstraňování sekcí (např. zobrazit doručovací adresu jen pokud je vyžadována).

Připojení k datovému zdroji

  • Navázat na libovolný zdroj kompatibilní s ADO.NET například DataTable, DataReader, DataSet, pole, nebo vlastní objekty.
  • Implementovat IMailMergeDataSource pro plnou kontrolu nad průchodem dat.
  • Snadno pracujte s hierarchickými datovými zdroji a sloučením rodič‑potomek.

Vlastní zpracování událostí

  • Zpracovávejte události jako MergeField, MergeImageField, a MergeRegion.
  • Použít transformace (např. formátovat data, generovat QR kódy nebo dynamicky nahrazovat zástupné znaky).

Výkon a škálovatelnost

  • Optimalizováno pro rozsáhlé, vysokokapacitní sloučení.
  • Streamovat výsledky přímo na disk nebo do HTTP odpovědí, aby se minimalizovalo využití paměti.
  • Dávkové zpracování, odložené vyhodnocování polí a opětovné použití oblastí zvyšují propustnost.

Lokalizace a internacionalizace

  • Generujte vícejazyčné zprávy svázáním lokalizovaných hodnot.
  • Použít kulturně specifické formátování pro čísla, měny a data.
  • Podporuje jazyky psané zprava doleva a správné zacházení s kódováním.

Kompatibilita a podpora formátů

  • Podporuje všechny hlavní formáty Wordu (DOCX, DOC, RTF) a exportovat do stejných nebo jiných formátů pomocí Aspose.Words konverzních API.
  • Zpracovat sloučené výsledky po spojení pomocí standardních funkcí Aspose.Words: konverze, porovnání, AI funkce, a další.

Jak vytvořit zprávu pomocí Mail Merge 

// Load template
doc = new Document("InvoiceTemplate.docx");

// Example DataTable as data source
DataTable orders = new DataTable("Orders");
orders.Columns.Add("CustomerName");
orders.Columns.Add("Item");
orders.Columns.Add("Quantity");
orders.Rows.Add("John Doe", "Laptop", "1");
orders.Rows.Add("Jane Smith", "Phone", "2");

// Execute Mail Merge
doc.MailMerge.ExecuteWithRegions(orders);

// Save the result
doc.Save("InvoiceReport.docx");

Běžné případy použití

  • Hromadné dopisy & e‑maily: Automatizovat personalizovanou korespondenci.
  • Faktury & účtenky: Sloučit data o zákaznících a transakcích do šablon faktur.
  • Zprávy: Generujte strukturované zprávy se seskupenými nebo podmíněnými daty.
  • Štítky a obálky: Vytvářejte poštovní materiály připravené k odeslání ve velkém množství.
  • Složky a katalogy: Sestavujte hierarchická nebo tabulková data do strukturovaných dokumentů.

Tipy a osvědčené postupy

  • Použijte jasné pojmenovací konvence pro merge fields ke zlepšení udržovatelnosti.
  • Minimalizujte hluboce vnořené oblasti — zploštěte data, kde je to možné.
  • Definujte a stylizujte formátování v šabloně, aby byla zajištěna konzistence.
  • Ověřte zdroje dat před spuštěním, aby se předešlo chybám za běhu.
  • Použijte obslužné rutiny událostí pro vlastní logiku, jako je vkládání obrázků nebo podmíněné formátování.
  • Spravujte šablony pomocí verzování a pravidelně je testujte s ukázkovými daty.
  • Zaznamenávejte průběh slučování a chyby pro audit a monitorování výkonu.

Často kladené otázky

  1. Co je hromadná korespondence pro .NET? Rámec pro generování personalizovaných dokumentů z šablon s slučovacími poli, naplněných datovými zdroji, jako jsou databáze nebo kolekce.
  2. Jaké datové zdroje jsou podporovány? DataTable, DataSet, IDataReader, pole a vlastní objekty pomocí IMailMergeDataSource.
  3. Funguje to s hierarchickými daty? Ano. Vnořené oblasti vám umožňují slučovat struktury dat rodič-dítě.
  4. Lze obrázky vkládat dynamicky? Ano. Použijte MergeImageField události pro vkládání obrázků (např. profilové fotografie, QR kódy).
  5. Podporuje to sloučení ve velkém měřítku? Ano. Optimalizováno pro zpracování velkých objemů ve šaržích s nízkou spotřebou paměti.
 Čeština