logo
Documents & Forms
Microsoft 365 & SharePoint Tools
Classic SharePoint Tools
Documents
Aug 12
Assign aliases for long tokens and use filtration to manipulate data
Angelika Cherina
Angelika Cherina
Lead Marketing Specialist

We're glad to tell you about new handy features implemented for the templating syntax of Plumsail Documents - Alias and Filtration operators. Hope, they will make your experience using Plumsail templating solution more convenient. See how you can use it.

Assign aliases to shorten long tokens

alias how it works

In case your document template includes some long or nested tokens, you may want to do something with that to simplify them.

Say you have a list of employees with details in many places of your document template. Something like this:

{{requestedData.employees.name}}

{{requestedData.employees.title}}

{{requestedData.employees.department}}

{{requestedData.employees.manager}}

You can assign an alias for "requestedData.employees" part of the token right inside the template:

{{e=requestedData.employees}}

Don't worry! This formula for assigning the alias won't appear in the resulting document.

Now you can use pretty short tokens instead of long and complicated ones:

{{e.name}}

{{e.title}}

{{e.department}}

{{e.manager}}

Use this approach to shorten complex tokens with a lot of nesting or with just long words inside.

Learn more details in the documentation.

Use filtration operators to conditionally hide data

Use aliases together with filtration operators in your document template syntax to hide particular data on a certain condition. You can conditionally hide table rows, list items, and so on.

filtration example

Suppose you have a table in your document template listing employees and departments they work in. You need a list of employees working in all departments except the development department.

You can assign an alias and apply a filter to it:

{{nonDev = employees|filter(value.department != "development")}}

Learn details on how to write conditions and assign aliases to filtered data in the documentation.

We’ll hope you’d like these new features. If you have any questions or suggestions, we’ll be more than happy to help. Just drop us a line at [email protected].

Getting started

Sign up for a one-month free trial, if you’re new to Plumsail Documents.

Have any questions?
Join our community or contact the support team: