StringJoin()

About this article

StringJoin() is a function that joins multiple pieces of text together with a separator in between.

Pre-requisites

Syntax

Example 1

Using the StringJoin() function to join two pieces of text with a dash in between.

Example 2

Using the StringJoin() function to join 3 pieces of text with a slash in between.

Example 3

Insert an address and allow the user to define their own separator in a form.

Example 4

Insert an address with the Form.Zipcode being empty or containing a value.

Example 5

Using the IfElse() function to include a StringJoin() footer address if a checkbox is checked. Otherwise, add a blank content control.

Example 6

Using the IfElse() function in combination with StringJoin() to hide text (using a Group element) if both questions 1 and 2 are empty.

Example 7

Using a nested StringJoin() function in combination with IfElse() to show plain text ("E:", "P:" and "W:") combined with the value of the user profile field.

Example 8

Using a nested StringJoin() function in combination with IfElse() to show plain text depending on the document language, combined with the value of the user profile field.

This is the same binding used in example 7, but with the plain text ("E:", "P:" and "W:") replaced by the Translate() function. The Translations data source looks like this:

Example 9

If a binding looks like this {{StringJoin(" ", UserProfile.Email, UserProfile.Phone, UserProfile.Website)}}, then in the document the result will show all values on one line. To show each value on a separate line, you can use the escape sequence \n for a new line. However you cannot type \n in the Binding field in Dynamics Designer directly. Instead, follow the steps below:

Word:

1. In the Binding field create this binding: {{StringJoin(" ", UserProfile.Email, UserProfile.Phone, UserProfile.Website)}}.
2. Open the properties of the content control on the Developer tab.
3. In the Tag field, change the part {{StringJoin(\" \", to {{StringJoin(\"\n\",.
4. The result looks like this:
   
   
   
   

   Note that the Binding field in Dynamics Designer will not show the \n in the binding.

    

PowerPoint:

1. In the Master View select the Shape.
2. In the Binding field create this binding: {{StringJoin(" ", UserProfile.Email, UserProfile.Phone, UserProfile.Website)}}.
3. Right-click the Shape and select Edit Alt Text.
4. In the Alt Text task pane, change the part {{StringJoin(\" \", to {{StringJoin(\"\n\",.
5. The result looks like this:
   
   
   
   
   

   Note that the Binding field in Dynamics Designer will not show the \n in the binding.

    

Related articles