Skip to main content

Introduction

 

Repeating sections are very powerful if you want to create 1 to many relationships within your Nintex Forms. However, they come with some caveats when you need to parse, use and display the data stored within them. This blog post introduces you to the Repeating Section Control, explains the parsing issue in depth and explains some existing solutions that was created earlier by the Nintex community. At the end of the post, I will introduce you to a Custom Field Type that I created to help non-technical users quickly display the Repeating Sections Data in List Views without creating Workflows or getting their hands dirty with XML, XSLT or Java script.

 

So, what is the repeating section control?

Control.png

The repeating section control is basically a container, which means that any controls added in the repeating section in the design time will be replicated in the runtime when the end-user clicks to add a new row. The end-user can also click the “x” icon to remove rows. Using Repeating Sections in Nintex Forms, you can create dynamic forms allowing the end users filling out the form to enter multiple values for a single field on a form. This is useful when you are collecting data and you do not exactly know in the design time how many records need to be collected each time the form is filled out.

 

DesignTineRS.png

RunTineRS.png

With the Repeating Section control, you can achieve a 1 to many relationship within your forms. Here are some examples:

  • Multiple products within the same order.
  • Multiple destinations, flights and hotels within the same travel request.
  • Multiple days off (with different types) within the same leave request.

 

The Problem

 

Despite how useful and cool the control is, there is no way OOB to parse the repeating section data if you need to do something with it. Why would you do that? Here are some scenarios / use cases:

  1. Interacting with the repeating section data from a Workflow.
  2. Saving the Repeating section data in another list and hence creating a Master-Detail or a Parent-Child relationship between two lists.
  3. Displaying the repeating section data in SharePoint List Views.

Basically, when an end-user fills out a form and submits it to the underlying list, an XML representation of the entire form is saved in a hidden field called "FormData". If we have a repeating section within the form, its data is also XML serialized and stored within this hidden field.  If you need this data for one or more of the three scenarios above, you need to retrieve the value of this hidden field then query the XML to parse the repeating section data. Osama Mourad has written a very useful post around that, you can check it from here.

 

The Solution

 

Luckily, Vadim Tabakman wrote a very good post documenting a workaround he came up with to simplify the steps above. Basically, he created a UDA (User Defined Action) to extract the XML of the repeating section from the FormData field then he used the “Loop” workflow action to loop through each record in the repeating section using an incremental index. Using Vadim’s workaround, you can read the records the end-user filled in the Repeating Section and interact with them within the workflow.

 

What if you want to save this data to another list and hence create a Master-Detail relationship between two lists? Eric Harris has used Vadim’s workaround, added his magic and showed us in an excellent blog post how to do that.

 

What Vadim and Eric have done is all based on Nintex Workflows. What if you don’t have the Nintex Workflow Product? What if you just need to display the repeating section data in List Views and you don’t want to create a Workflow just for that? Enter The “Nintex Repeating Section Data” Field Type.

 

“Nintex Repeating Section Data” Field Type

 

The “Nintex Repeating Section Data” is a custom field type that I created in my free time to easily display the records of a repeating section in SharePoint List Views without the need of creating complex workflows. After you create your Nintex Form using the standard best practices for repeating sections, you only need to create a Column of type “Nintex Repeating Section Data”, enter the name of the Repeating Section you want to display in the field creation page, add it to any view and BOOM … The repeating section data is displayed in a neat table! All the heavy lifting is taken care of for you. Below are a few screenshots to help you understand the idea:

 

Here is the “Orders” list :

1.png

And here is the Ninext Form, it contains a Repeating Section called “Products”, note that I'm not connecting the repeating section to a column.

2.png

Now, I’ll create a Column of the new type “Nintex Repeating Section Data”. In the additional column settings, I will put in the name of the Repeating Section in the form.

3.png

Once the column is added to the view, here is what you are going to get :

5.png

Pretty cool, eh? happy.png

 

You can download the WSP for SharePoint 2013 from the attachments below. The SharePoint 2010 one will be released soon.

Update (Aug 13th, 2015): SharePoint 2010 Version is now available, you can download it from here.

 

 

Notes:

  • The “Nintex Repeating Section Data” Field Type for SharePoint 2013 was created in my free time and is NOT a Nintex product. If you have any feedback, please feel free to post it here or ping me on Twitter @AymanElHattab .
  • You can create as many columns based on the new custom field type as needed. For instance, If you have 3 repeating sections (Flights, Hotels and Events) in your travel request form, you can create 3 columns to display the repeating sections' records in your View. Just make sure not to connect your Repeating Sections to list columns (as shown in the screenshots above)
  • IE7+, Chrome (Latest) and Firefox (Latest) are supported.
  • Nested Repeating Sections are not supported (yet).

No problem .. Glad it worked for you


very nice post

anyone tried to export the list with Nintex column to excel?

Nintex column that you created is empty when i export the list to excel.

any idea why? Ayman El-Hattab


Hi Ibrahim,

Yes, this is not supported.


Hi

This post is very useful, But I'm new in Nintex, I don't know how to use this field  because after deploy I can't find any new feature and I can't see this Nintex repeating section, after that I want to know value of this field can crawl with SharePoint search and can I use this field in content hub?

Thank you

Naeemeh


Hi Naeemeh,

You don't need to activate a feature .. Once you deploy the WSP, you should find a new field type called "Nintex Repeating Section Data" in the column creation pages.

Indexing is not supported at this stage but will be added in later versions of the solution.

Thanks


Hi Ibrahim,

Unfortunately, the solution is only available for SharePoint on-prem. If there is enough demand, I will create something for Office 365.


Hi El-Hattab

I deployed this solution after Installed but this field didn't add to my column how can I do?

Thanx


Hi Naeemeh,

How did you deploy the solution?


Hi El-Hattab

Yes I deploy it But after I remove this solution this field became appear, I can use it but I removed that solution for testing, I don't know why this happened appear on my server.

Thanx


Hi,

I have not yet tried this (not allowed to install the wsp yet) but it seems pretty nice.

One question: I need to have a view that presents the data in a way that is "Export to Excel" friendly. How would I go about doing such a thing?

Regards

Leif


hi Leif,

this solution does not support export to excel,

if add the column to the list view and export it to excel, it will appear as blank.

if you don't have a complex form, check this blog Repeated Section to Plain Text


Ran into an issue where I"m not seeing the option to activate on the site collection.

I have it deployed globally to all sites:

Capture.PNG

But I'm not seeing it as an option to activate on the site collection level. I retracted and deployed again and it is still not showing up. Have you came across this? SP Foundation 2013.


Hi Leif,

SharePoint Custom Field Types are not supported in the Excel View unfortunately.


Hi Michael,

You don't have to activate any features for a custom field type. Once the WSP is deployed, you can create columns based on the new custom field type (Nintex Repeating Section Data).


This is a great solution...especially the .wsp file. IF I can get my enterprise SharePoint support to apply it to the farm/Central admin., is this field available for insertion into a Nintex workflow notification action email template?


This worked great for One of my list however when I attempted to perform the same on another list it fails to display the table. Have you had this error before?


Same things happens to me. Simple repeating table with a few fields and my list column is completely empty after a new form is submitted.


Same situation for me as well.


Hi Ayman El-Hattab​ I have noticed that your solution has stopped working. One of the lists I use it on no longer shows the tables. I just removed the wsp file then redployed it, did an iis reset, created a new list and still nothing shows up. I updated my licence a few weeks ago - would that affect it?

Thanks

Andrew


Nice, user friendly!


I deploy the wsp file but  column does not appear


Sorry, I already had to restart IIS

Unfortunately I'm having the same issue - did anyone work out how to resolve? (Willy Noviandy Jeffrey Oliver  ) Thanks!


Excuse me, I followed the instruction and it's show like this how can I fix it?

repeating section data in list view has problem.

Thanks.


This is a nice solution , but I'm getting below heading without space (fig 1) despite I've configured both text-box values to 'First Name' and 'Last Name' respectively (fig 2,3 & 4).  Can you please suggest workaround?  

fig 1 (View)

fig 2

fig 3

fig 4


Reply