Microsoft InfoPath 2010
The official blog of the Microsoft InfoPath team

How to Pass Querystring data into an InfoPath Form

How to Pass Querystring data into an InfoPath Form

  • Comments 32

Hi there, Daniel Broekman here. After showing you how to customize a SharePoint list with InfoPath 2010, and describing the differences between SharePoint list forms and form library forms together with Kate Everitt, I’m back with a quick tip for easily sending  a value from the browser’s query string into an InfoPath form.

Imagine one of the following scenarios:

  • You want to dynamically pull all the invoices for a specific customer into a single form. For example, you could have a link to http://server/site/ShowInvoices.aspx?Customer=Contoso, which could be set up to display a list of all the Contoso invoices in a table. If you then swap out “Contoso” with “Fabrikam” in the URL, you would see all of the Fabrikam invoices.
  • You want to track referrals for your form. You can do this by specifying a dynamic default value for the form indicating the referral source. For example, you can include a link to http://server/site/form.aspx?Referrer=Email in an email you send to users, and add a link to http://server/site/form.aspx?Referrer=Website on the homepage of your website, and capture the value of the “Referrer” parameter along with the rest of the form data.

In InfoPath 2007, you could accomplish these scenarios with code. With InfoPath 2010 and SharePoint 2010, there is a much easier way to send data from the query string into an InfoPath form. Let’s take a look.

The basic concept

Using a web part page and a part-to-part connection between a Query String (URL) Filter web part and an InfoPath Form Web Part (new in SharePoint 2010), we can easily pass a value from the browser’s query string into the form.

Step-by-step

I’m going to assume you already have a list form published to SharePoint. I just created a simple form to collect feedback on a conference presentation. As you can see, I included a “Referrer” field that will track the referral source of users filling out my form.

Conference Feedback Form

To set up the rest of the scenario, follow these steps:

  1. Create a new web part page.
  2. Add 2 web parts to the page. From the “Forms” category, add the InfoPath Form Web Part, and from the “Filters” category, add the Query String (URL) Filter web part. Web Part Adder (Forms Category)Web Part Adder (Filters Category)
  3. Configure the InfoPath Form Web Part to point to the list or library where your form is published. InfoPath Web Part Tool Pane
  4. Configure the Query String (URL) Filter web part to specify the parameter name it should look for in the URL. In this case, we want it to find “Referrer”. Query String Web Part Tool Pane
  5. Next, set up the part-to-part connection by opening the Web Part edit menu and selecting Connections > Send Filter Values To > InfoPath Form Web Part. Query String Web Part Connection Menu
  6. This brings up a dialog where you can choose the field in the form where the data should be sent. Choose the field you want, and then click Finish. In this case, we want to map the data to the “Referrer” field. Web Part Connection Dialog

Everything should be set up correctly now. Save your changes to this page, and then navigate to the page. You should see the blank form.

Saved Web Part Page

Testing the Connection

To test that everything is working correctly, add “?Referrer=email” to the end of the URL, and you should see the Referrer field being populated with the value “email”.

Testing the Query Parameter Connection

That’s it! You now have a page that passes data from the query string into an InfoPath form, set up in less than 5 minutes, and without any code.

For more advanced scenarios, you can use this as a starting point. For example, you could have a rule on the “Referrer” field that performs certain actions based on the incoming value, such as querying a secondary data source, loading a specific item, etc. In the “customer invoice” example I gave at the beginning of this post, you could have an “onchange” rule on the “Customer” field that queries a secondary data connection for all of that customer’s invoices.

One final note: the InfoPath Form Web Part only supports one incoming part-to-part connection at a time, which means that you are limited to passing one value into the form using this method.

Please leave a comment to let me know how you’re using this functionality in your forms!

Daniel Broekman

Program Manager – Microsoft InfoPath

Leave a Comment
  • Please add 7 and 6 and type the answer here:
  • Post
  • Hi,

    Have you some downloadable examples some I can restore into my environment?

    I don't understand clearly how connect web part to new-edit-display forms.

    What happens when I click on Edit button?

  • How do I filter on multiple values?  I added two Query String (URL) Filters, however when I try to attach my second filter to the InfoPath Form Web Part, the option is greyed out with a tool tip of: all compatible connection types to the InfoPath Form Web Part are in use.

  • This work great, thanks.

    However, I would also like to redirect to a different page after submitting the form. Normally I would use the Source parameter, but this doesn't work with the InfoPath form web part. Do you have any suggestions?

  • So this is an awesome feature, thanks for sharing.  

    Now, how do we take it to the next step and make it work with multiple values for multiple fields?  

    I'm hoping to be able to do this on our current site before the release of SP 15.

  • Too bad it doesn't work for lookup fields.

  • Is there a way to use more than 1 query string?

    Using your example;

    Going to the url site.com/page.aspx ... would put "email" into the Referrer box and "Very Satisfied" would go into the Overal Rating box.

    I can add one Query String box, but Sharepoint (that includes Sharepoint Designer) won't allow for more than one query string filter box.

  • This is great help.. I almost gave up on a master/detail form without this trick.  Thanks Daniel.

    Do you have a manual or all-inclusive PDF for Infopath help ?

    thanks.

  • Hi,

    How to send two or more values using query string to the Infopath forms ?

    eg. ?Referrer=Email&Id=233123

    Passing two different values using Query Strings URL Webpart is possible ???

    Regards

    Manivannan

  • Nice one Mike G. This now works a treat as I was having the same problem as Riccardo!! So much easier than putting in code!! :)

  • Can you use the query filter to change the view? I have ?view=partner which I've tried setting up to a text field that is hidden and having the form change on load but it doesn't work. (I think the onload is going before the field is changed.) Is there another way to do this?

  • Buenas tardes,a que se refiere con el referente?

  • This is a great article!  I was able to get the procedure to work using a web part page, but when I created an aspx page in SharePoint Designer, add followed the same steps, I get an error message in the browser.  

    Is there a reason that this procedure only works for web part pages, or is there another step that needs to be accomplished for aspx pages?

  • i need to paramaeter for infopath form.how can i add two queryfilter for  single infopath webpart

  • I found a solution to the limitation of passing one value. If you want to pass multiple value, you can format these values as "value1,value2,value3,value4,etc" and then running a rule on that field to read each values and populating relevant fields.

  • I am trying to figure out how to implement Parent and child relationship in InfoPath 2013. My scenario like this:

    I have two lists : Orders List and Order details list both form are in infopath and related in sharepoint with a lookup column in the order details list. I would like to manage the whole relationship in one place i.e manage in the same page the orders list et order details list.

    Please advise how i can achieve this in InfoPath 2013. Thank you.

Page 2 of 3 (32 items) 123