Mail Merge șablon din Mustache sintaxă

Aspose.Words vă permite să creați șabloane cu mustache sintaxă în plus față de șabloanele familiare. A Mustache este o variantă alternativă a sintaxei șablonului care constă din nume de etichete închise de și este susținută de un obiect model care conține datele pentru șablon.

Sintaxa Mustache este singura opțiune de utilizat cu șabloane care nu conțin câmpuri, cum ar fi HTML și TXT șabloane. Cu Word șabloane, aveți două opțiuni fie pentru a utiliza câmpuri sau Mustache sintaxă.

Sintaxa Mustache suportă eticheta foreach, Care este o alternativă pentru utilizarea Mail Merge cu regiuni. Deci, avantajul este că puteți utiliza mustache sintaxă dacă din anumite motive nu puteți sau pur și simplu nu doriți să utilizați câmpuri de îmbinare și regiuni de îmbinare.

De asemenea, puteți combina câmpurile Mail Merge cu unele câmpuri suplimentare folosind eticheta foreach așa cum se arată în imaginea de mai jos.

Creați un șablon Mustache

Primul punct important de clarificat este că Mustache nu este un motor de șablon. Mustache este o altă variantă de sintaxă care este disponibilă pentru orice șablon dintr-un load format suportat de Aspose.Words. Prin urmare, puteți crea un astfel de șablon atât programatic, cât și printr-o interfață, trebuie doar să includeți o anumită sintaxă și să respectați specificația Mustache.

Să presupunem că trebuie să trimiteți același e-mail către 50 de destinatari pentru a personaliza salutul cu prenumele corespunzătoare. Puteți înlocui prenumele destinatarului cu un substituent, după cum urmează:

Dear {{FirstName}}

I hereby…

Întrebarea aici: cum puteți crea 50 de e-mailuri de la 1 singur Mustache șablon? Pentru a răspunde la aceasta, trebuie să efectuați un Mail Merge cu regiuni pentru a umple acoladele pentru substituenții din șablon cu date reale și pentru a genera un document de ieșire.

După cum observați din exemplul de mai sus, în Mustache trebuie să utilizați acolade pentru substituenți care arată ca un mustache atunci când rotiți acoladele cu 90 de grade în sensul acelor de ceasornic.

Lucrați cu Mustache sintaxă

Mustache este reprezentat ca o ordine fără logică, deoarece nu are instrucțiuni specifice de flux de control, cum ar fi for bucle și if și else condiții. Dar puteți utiliza secțiunea etichete liste de procesare și lambdas pentru a realiza evaluarea condiționată și looping. Deci, pentru a include sintaxa Mustache în cadrul operației Mail Merge, va trebui să utilizați proprietatea UseNonMergeFields și să setați valoarea acesteia la True.

Următorul exemplu de cod arată cum să înlocuiți etichetele Mustache cu date specifice:

Puteți observa diferența dintre document înainte de a executa Mail Merge cu regiuni împreună cu aplicarea proprietății UseNonMergeFields:

O secțiune începe cu o lire și se termină cu o bară oblică. Adică, {{#foreach list}} începe o secțiune “foreach” în timp ce {{/foreach list}} o termină.

Și după aplicarea Mail Merge cu regiuni:

Utilizați `IF` câmpuri pentru a face un Mail Merge inteligent

Aspose.Words vă permite să utilizați câmpurile Mail Merge și etichetele Mustache cu instrucțiunea IF. Câmpurile IF pot fi utilizate în orice document Mail Merge pentru a suprima spațiile și virgulele nedorite dacă un câmp este gol.

Formula câmpului IF este prezentată mai jos:

{ IF [Condition] [Display Result 1] [Display Result 2] }

Aici, condiția poate fi fie un câmp de îmbinare, fie o etichetă Mustache.

De exemplu, puteți utiliza câmpurile IF dacă trebuie să inserați “lui”, “ei”," el “sau” ea " în funcție de sex, după cum urmează:

{ IF { MERGEFIELD Gender } = “MALE” “Text adevărat” “text fals”}

{ IF “{{ GENDER }}” = “MALE” “Text adevărat” “text fals”}

Următorul exemplu de cod arată cum se efectuează o operație Mail Merge cu Mustache etichete și IF câmpuri:

Puteți observa diferența dintre document înainte de a aplica proprietatea UseNonMergeFields: