Mail Merge Template da Mustache Sintassi

Aspose.Words consente di creare modelli con sintassi mustache in aggiunta ai modelli familiari. Un Mustache è una variante alternativa della sintassi del modello che consiste in nomi di tag racchiusi da un oggetto modello che contiene i dati per il modello.

La sintassi Mustache è l’unica opzione da utilizzare con i modelli che non contengono campi, ad esempio i modelli HTML e TXT. Con i modelli Word, hai due opzioni per usare i campi o la sintassi Mustache.

La sintassi Mustache supporta il tag foreach, che è un’alternativa per l’utilizzo di Mail Merge con le regioni. Quindi il vantaggio è che puoi usare la sintassi mustache se per qualche motivo non sei in grado o semplicemente non vuoi usare campi di unione e regioni di unione.

Puoi anche combinare i campi Mail Merge con alcuni campi aggiuntivi usando il tag foreach come mostrato nell’immagine qui sotto.

Creare un modello Mustache

Il primo punto importante da chiarire è che Mustache non è un motore di template. Mustache è un’altra variante di sintassi disponibile per qualsiasi modello in un load format supportato da Aspose.Words. Pertanto, è possibile creare un modello di questo tipo sia a livello di programmazione che tramite un’interfaccia, è sufficiente includere una certa sintassi e rispettare le specifiche Mustache.

Supponiamo che sia necessario inviare la stessa email a 50 destinatari per personalizzare il saluto con i loro nomi corrispondenti. È possibile sostituire il nome del destinatario con un segnaposto come segue:

Dear {{FirstName}}

I hereby…

La domanda qui: come è possibile creare 50 e-mail da 1 singolo modello Mustache? Per rispondere a ciò, è necessario eseguire un Mail Merge con regioni per riempire le parentesi graffe per i segnaposto nel modello con dati effettivi e generare un documento di output.

Come si nota dall’esempio precedente, in Mustache è necessario utilizzare parentesi graffe per segnaposto che assomigliano a mustache quando si ruotano le parentesi graffe di 90 gradi in senso orario.

Lavorare con Mustache Sintassi

Mustache è rappresentato come un ordine senza logica in quanto manca di istruzioni di flusso di controllo specifiche come for loop e if e else condizioni. Ma è possibile utilizzare i tag di sezione che elaborano elenchi e lambda per ottenere la valutazione condizionale e il loop. Quindi, per includere la sintassi Mustache all’interno dell’operazione Mail Merge, è necessario utilizzare la proprietà UseNonMergeFields e impostarne il valore su True.

Il seguente esempio di codice mostra come sostituire i tag Mustache con dati specifici:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Mail merge destinations - Vendor.docx");

// Loop through each row and fill it with data.
DataTable dataTable = new DataTable("list");
dataTable.Columns.Add("Number");
for (int i = 0; i < 10; i++)
{
    DataRow dataRow = dataTable.NewRow();
    dataTable.Rows.Add(dataRow);
    dataRow[0] = "Number " + i;
}

// Activate performing a mail merge operation into additional field types.
doc.MailMerge.UseNonMergeFields = true;

doc.MailMerge.ExecuteWithRegions(dataTable);

doc.Save(ArtifactsDir + "WorkingWithXmlData.MustacheSyntaxUsingDataTable.docx");

È possibile notare la differenza tra il documento prima di eseguire Mail Merge con le regioni e l’applicazione della proprietà UseNonMergeFields:

Una sezione inizia con una libbra e termina con una barra. Cioè, {{#foreach list}} inizia una sezione “foreach” mentre {{/foreach list}} la termina.

E dopo aver applicato il Mail Merge con le regioni:

Utilizzare i campi IF per rendere Mail Merge intelligente

Aspose.Words consente di utilizzare i campi Mail Merge e i tag Mustache con l’istruzione IF. I campi IF possono essere utilizzati in qualsiasi documento Mail Merge per eliminare spazi e virgole indesiderati se un campo è vuoto.

La formula del campo IF è mostrata sotto:

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

Qui, la Condizione può essere un campo di unione o un tag Mustache.

Ad esempio, è possibile utilizzare i campi IF se è necessario inserire “his”," her"," he “o” she " a seconda del genere come segue:

{ IF { MERGEFIELD Gender } = “MALE” “testo vero” “testo falso” }

{ IF “{{ GENDER }}” = “MALE” “testo vero” “testo falso” }

Il seguente esempio di codice mostra come eseguire un’operazione Mail Merge con i tag Mustache e i campi IF:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Mail merge destinations - Mustache syntax.docx");

doc.MailMerge.UseNonMergeFields = true;
doc.MailMerge.Execute(new[] { "GENDER" }, new object[] { "MALE" });

doc.Save(ArtifactsDir + "BaseOperations.IfElseMustache.docx");

È possibile notare la differenza tra il documento prima di applicare la proprietà UseNonMergeFields:

E dopo aver applicato la proprietà UseNonMergeFields: