Mail Merge szablon
Często używa się szablonu scalania jako dokumentu podstawowego dla operacji Mail Merge, jeśli jest to prosty Mail Merge lub Mail Merge z regionami. Mail merge z regionami jest potężniejszy i bardziej popularny niż prosty mail merge. Prosty Mail Merge jest uważany za Szczególny przypadek Mail Merge z regionami, w których region jest całym dokumentem. Wszystko wyjaśniono bardziej szczegółowo w następnym artykule “rodzaje operacji Mail Merge”.
Szablon zapewnia prawidłowe sformatowanie tekstu w wynikowym scalonym dokumencie, a operacja Mail Merge gwarantuje prawidłowe wprowadzenie tekstu ze źródła danych do szablonu scalania.
Aspose.Words zapewnia możliwość utworzenia szablonu Mail Merge w celu zdefiniowania stałej zawartości, a następnie wygenerowania dokumentów scalania przy użyciu pól scalania. W ten sposób szablon scalania będzie zawierał niezbędny tekst, który jest taki sam we wszystkich dokumentach wyjściowych, oraz pola scalania, aby wypełnić zmieniającą się zawartość. W rezultacie informacje z określonego źródła danych zostaną dodane do szablonu scalania za pośrednictwem tych pól podczas generowania scalonego dokumentu.
Co To jest szablon Mail Merge
Szablon Mail Merge to spersonalizowany dokument zawierający stałe Dane i scalone pola, w których ma znajdować się tekst zmiennej. Szablon scalania może mieć dowolny format obsługujący pola, na przykład, DOC, DOCX, DOT, DOTX, RTF. Ponadto możesz również użyć szablonu mustache, który jest wyjaśniony bardziej szczegółowo w artykule “składnia szablonuMustache”.
Szablon scalania można utworzyć jako model dla nowych dokumentów i powinien on zawierać tekst główny, który musi być taki sam dla każdej wersji scalonego dokumentu. Dodanie pól scalania wewnątrz szablonu będzie reprezentować dane personalizacji, takie jak nazwy lub adresy pobierane ze źródła danych. Operacja Mail Merge automatycznie wstawi dane personalizacji ze źródła danych do dokumentu szablonu scalania.
Ponadto możesz dodać region Mail Merge do szablonu, wstawiając dwa pola Mail Merge, aby zaznaczyć początek i koniec regionu poczty. Następny artykuł “rodzaje operacji Mail Merge” wyjaśnia to bardziej szczegółowo.
Utwórz szablon Mail Merge
Możesz utworzyć szablon i dodać do niego określone pola scalania, które zostaną zastąpione wartościami ze źródła danych ręcznie, na przykład przy użyciu Microsoft Word lub programowo przy użyciu Aspose.Words. W tym artykule przyjrzymy się programowemu sposobowi tworzenia szablonu.
Użyj klasy DocumentBuilder, aby utworzyć wymagany szablon scalania za pomocą Aspose.Words. Możesz dołączyć tekst, pole scalania i podział wiersza do takiego szablonu za pomocą metod InsertTextInput, InsetField i InsertParagraph.
Poniższy przykład kodu pokazuje, jak utworzyć szablon Mail Merge:
Poniższy obrazek pokazuje utworzony szablon:
Dostosowywanie właściwości szablonu Mail Merge
Aspose.Words pozwala dostosować szablon za pomocą wielu właściwości. Dostosowanie szablonu zostanie opisane poniżej na przykładzie dostosowania niektórych właściwości obrazów i tekstu.
Dostosuj Właściwości Obrazu
Właściwości obrazu można określić za pomocą klasy ImageFieldMergingArgs. Pamiętaj, że możesz wstawić obraz z bazy danych w sposób opisany w Aspose.Words GitHub.
Poniższy przykład kodu pokazuje, jak określić nazwę pliku obrazu i rozmiar obrazu:
Dostosuj Właściwości Tekstu
Możesz użyć właściwości Text, aby wstawić tekst do dokumentu dla bieżącego pola scalania. Możesz także zmienić formatowanie tekstów i akapitów w szablonie za pomocą klas Font i ParagraphFormat. Możesz obsłużyć tekst, który ma zostać wstawiony przed lub po polu scalania, używając właściwości TextBefore i TextAfter, które są zawarte w klasie FieldMergeField.
Poniższy przykład kodu pokazuje, jak wstawić pola wyboru lub HTML podczas operacji Mail Merge:
Możesz pobrać przykładowy plik tego przykładu z Aspose.Words GitHub.
Możesz również sprawdzić implementację klasy HandleMergeField
z Aspose.Words GitHub.
Zobacz także
- Aby uzyskać więcej informacji na temat ręcznego tworzenia szablonów w Microsoft Word, Sprawdź Utwórz szablon artykuł w dokumentacji Microsoft