How to create adaptive sections in a template

Finding suitable data for the collection expression and the current item is dependent on the external system being used.

• How to find the data available from the Salesforce App Connector?
• How to find the data available from the SharePoint App Connector?

Example with Salesforce:  The array for the Collection Expression is highlighted in red, and the objects that can be used with CurrentItem are highlighted in green: 

Finding suitable data for the collection expression and the current item will be possible from the Admin Center or directly within Template Designer.

The Collection Expression (highlighted in red) must be an array on the first level in the external data source, in the Admin Center, arrays will be represented with square brackets [], in Template Designer, arrays will be represented with this icon when using a Data connector form response smart field. The Repeating Item must be part of the Collection Expression array and can be located either on the first level (highlighted in yellow) under the array or several levels deep inside the array (highlighted in green). In the Template Designer, the Repeating Item will only be visible once the repeating group has been created by drilling down the array originating from the Data connector form response smart field. 

Creating adaptive sections in Word using a Data Connector can be achieved following these steps:

1. In Template Designer, navigate to the Template tab.
2. Select the table row or line of text (with or without a bullet) that should contain the items that will be repeated.
3. Click Add smart field.
   This step doesn't apply if you are adding the very first smart field in the template.
4. Click on Form responses.
5. Drill down the data connector question and click on the array represented with .
6. Optionally edit the Display Name.
   The display name will be displayed in the Template tab once the smart field has been added.
7. Optionally, perform additional actions on the repeating group.
   • Allow Insert And Delete Items will allow users to manually add a repeating row using the Repeating Section Content Control in Word once the template has been generated. By default, this option isn't checked.
   • Edit binding: Allow editing of the binding syntax to tailor the smart field to specific needs by using functions, conditions, and operators to create more complex use cases. By default, the basic binding syntax will be used.
   • Visibility: Edit the visibility of the smart field based on specific conditions.
8. Click on Add to template. The repeating group has been successfully created and will be displayed in the Template tab. The actual items (CurrentItem) that should be repeated inside the document can now be created.
9. Select the text inside the previously created repeating group that represents an item that should be repeated column from the data sources that should be used in the smart field.
10. Click Add smart field.
11. Click Repeating item.
    The Repeating item smart field will only be displayed if the cursor is located inside the repeating group.
12. Select the desired data that should be repeated.
13. Optionally, perform additional actions on the smart fields.
    • Edit binding: Allow editing of the binding syntax to tailor the smart field to specific needs by using functions, conditions, and operators to create more complex use cases. By default, the basic binding syntax will be used.
    • Visibility: Edit the visibility of the smart field based on specific conditions.
    • Remove and keep content: this will remove the content control will be removed upon document generation and will effectively disable the document content updater on the smart field.
    • Format (for dates only): Specify which date format should be used for this date in the template.
14. Click on Add to template
    The Repeating item will be injected into the template and will be displayed in the Template tab as part of the repeating group created in step 6.
15. Repeat steps 8 to 13 as many times as necessary to add all the relevant items that should be repeated.
    

Creating adaptive sections in Word using an App Connector can be achieved following these steps: 

1. In Template Designer, navigate to the Template tab.
2. Select the table row or a line of text (with or without a bullet) that should contain the items that will be repeated.
3. Click Add smart field.
   This step doesn't apply if you are adding the very first smart field in the template.;
4. Click on Advanced.
5. Click on Custom repeating group.
6. Optionally edit the Display Name.
   The display name will be displayed in the Template tab once the smart field has been added.
7. Manually type in the Collection expression for the array containing the items that should be repeated.
   For a Collection expression originating from an App Connector, the expecting binding will be {{HostSystem.ArrayName}}.
8. Optionally, perform additional actions on the repeating group
   • Allow Insert And Delete Items: Will allow users to manually add a repeating row using the Repeating Section Content Control in Word once the template has been generated. By default, this option isn't checked.
   • Edit binding: Allow editing of the binding syntax to tailor the smart field to specific needs by using functions, conditions, and operators to create more complex use cases. By default, the basic binding syntax will be used.
   • Visibility: Edit the visibility of the smart field based on specific conditions.
9. Click on Add to template.
   The repeating group has been successfully created and will be displayed in the Template tab. The actual items (CurrentItem) that should be repeated inside the document can now be created.
10. Select the text inside the previously created repeating group that represents an item that should be repeated column from the data sources that should be used in the smart field.
11. Click Add smart field.
12. Click More.
13. Click Custom text binding (or Custom image binding to insert an image).
14. Optionally edit the Display Name.
    The display name will be displayed in the Template tab once the smart field has been added.
15. Manually type in the Binding for the item that should be repeated.
    For binding originating from an App Connector, the expecting binding will be {{CurrentItem.ItemName}} for an item on the first level. If the item is located on a deeper level of the array, the level must be specified prior to the item that should be repeated, example of an item located on the second level {{CurrentItem.NameLevel1.LevelName2.ItemName}}.
16. Optionally, perform additional actions on the smart fields.
    
    • Visibility: Edit the visibility of the smart field based on specific conditions.
    • Remove and keep content: This will remove the content control will be removed upon document generation and will effectively disable the document content updater on the smart field.
    • Inherit Dimensions, Width, Height (for images only): Specify the dimensions of the image that will be inserted. 
17. Click on Add to template.
    The Custom text binding for the CurrentItem will be inserted into the template and will be displayed in the Template tab as part of the repeating group created in step 9.
18. Repeat steps 11 to 17 as many times as necessary to add all the relevant items that should be repeated.
    

Data from Salesforce used from the above example, the array OpenActivities is highlighted in red and the current items (ActivityDate and Subject) are highlighted in green: 

Creating adaptive sections in PowerPoint using a Data Connector can be achieved following these steps:

1. In the Template Designer, navigate to the Template.
2. Select the table that should contain the items that will be repeated.
3. Click Add smart field.
   This step doesn't apply if you are adding the very first smart field in the template 
4. Click on Form responses.
5. Drill down the data connector question and click on the array represented with .
6. Enter the Display Name.
   The display name will be displayed in the Template tab once the smart field has been added.
7. Optionally, perform additional actions on the repeating group:
   • Allow Insert And Delete Items: Will allow users to manually add a repeating row using the Repeating Section Content Control in PowerPoint once the template has been generated. By default, this option isn't checked.
   • Edit binding: Allow editing of the binding syntax to tailor the smart field to specific needs by using functions, conditions, and operators to create more complex use cases. By default, the basic binding syntax will be used. 
   • Visibility: Edit the visibility of the smart field.
8. Click on Add to template.
   The repeating group has been successfully created and will be displayed in the Template tab. The actual items (CurrentItem) that should be repeated inside the document can now be created.
9. Place your cursor inside a cell and manually type the desired binding.
   The expecting binding will be {{CurrentItem.ItemName}} for an item on the first level. If the item is located on a deeper level of the array, the level must be specified prior to the item that should be repeated, example of an item located on the second level {{CurrentItem.NameLevel1.LevelName2.ItemName}}.
10. Repeat step 9 to populate the rest of the cells on the table row.
    All CurrentItem elements created on the table must be located in the same table row.
    

Creating adaptive sections in PowerPonint using an App Connector can be achieved following these steps: 

1. In the Template Designer, navigate to the Template tab.
2. Select the table that should contain the items that will be repeated.
3. Click Add smart field.
   This step doesn't apply if you are adding the very first smart field in the template.
4. Click on Advanced.
5. Click on Custom repeating group.
6. Optionally edit the Display Name.
   The display name will be displayed in the Template tab once the smart field has been added.
7. Manually type in the Collection expression for the array containing the items that should be repeated.
   For a Collection expression originating from an App Connector, the expecting binding will be {{HostSystem.ArrayName}}
8. Optionally, perform additional actions on the repeating group:
   • Allow Insert And Delete Items: Will allow users to manually add a repeating row using the Repeating Section Content Control in Word once the template has been generated. By default, this option isn't checked.
   • Edit binding: Allow editing of the binding syntax to tailor the smart field to specific needs by using functions, conditions, and operators to create more complex use cases. By default, the basic binding syntax will be used. 
   • Visibility: Edit the visibility of the smart field based on specific conditions. 
9. Click on Add to template.
   The repeating group has been successfully created and will be displayed in the Template tab. The actual items (CurrentItem) that should be repeated inside the document can now be created.
10. Place your cursor inside a cell and manually type the desired binding.
    The expecting binding will be {{CurrentItem.ItemName}} for an item on the first level. If the item is located on a deeper level of the array, the level must be specified prior to the item that should be repeated, example of an item located on the second level {{CurrentItem.NameLevel1.LevelName2.ItemName}}.
11. Repeat step 10 to populate the rest of the cells on the table row.
    All CurrentItem elements created on the table must be located in the same table row.
    

Data from Salesforce used from the above example, the array OpenActivities is highlighted in red and the current items (ActivityDate and Subject) are highlighted in green: