Notice: Box will no longer be used by MSU starting March 2022. We will provide an alternative option as soon as we have one.
If you need your form to accept file submissions, you have found the right piece of documentation!
While it might look like a long list of steps, this is not that difficult. You can do it! We have just made each step granular enough so it's easier to follow.
The CMS's Form Builder itself will not accept submissions (security issues, technical issues...) However, you can use a folder in your UIT-provided Box account and create an Upload Embed Widget which will appear after the form has been submitted, so your visitor can upload their file.
After you implement this, the visitor will fill out the text portion of your form, submit that data, and then be forwarded to another page to upload their file (could be an image, PDF, Word doc, Excel sheet, etc.) We suggest prompting them to use the same email address in the upload submission as they did in the form.
Steps for adding a Box Upload Embed Widget to your form's flow
- Create and publish a page (you can leave blank for now). This will be your Upload Page.
- On your form asset (after it has been created) change the "Success Message" to "URL Redirect"
- E.g. If my Upload Page link looks like "/sitesection/upload.html" and my website homepage is http://montana.edu/usp/, my new link would be "/usp/sitesection/upload.html".
- In the "URL" field, use the navigate button () to find your Upload Page. Click to highlight the page and then click the "Choose File" button.
- Add your website directory name (the part of your site name in the URL) onto the beginning of the link that the Choose File pop-up has spit out, with a beginning slash.
- Save and re-publish your form asset.
- Open your Box account in your web browser (we recommend Google Chrome.)
- If you don't have a folder set aside already, create one dedicated to receive these uploads.
- While viewing the folder in Box, hover your mouse over its entry and click the "...", then mouse-down to "File Request". (See Figure 1 below.)
- A pop-up window will appear with your options. Edit your Title, Instructions, and decide if you will allow users to add descriptions. We highly recommend selecting "Require Email Address for Uploads" and informing the user to provide the same email address as their prior textual submission so you can keep the entries straight later.
- Click the "Preview" link to see how the uploader looks.
- When you're ready, click the "Copy upload embed widget" button which copies the code for you.
- Back in the CMS, navigate to Assets.
- Create a new source code asset.
- Set your Name and Access settings for this asset
- Paste the code from Box into the "Asset Content" box below
- In the "Asset Content" window, click the magnifying glass icon to open the "Find and Replace" dialogue
- In the "Find" box, add "&". (No quotes)
- In the "Replace" box, type "&" (No quotes. Can you tell we're replacing all of the ampersands for their ASCII code counterparts?)
- Click the "Replace All" button.
- If there are any other attributes that are not assigned a value, they should ="true" like this:
- Code before they equal true
- ... width="500" height="400" frameborder="0" allowfullscreen webkitallowfullscreen msallowfullscreen></iframe>
- Code once you have added ="true"
- ... width="500" height="400" frameborder="0" allowfullscreen="true" webkitallowfullscreen="true" msallowfullscreen="true"></iframe>
- Code before they equal true
- At the bottom, click "Create" then Publish this asset.
- Within the CMS, navigate to the page you created as your Upload Page.
- Edit the content region you wish to add the Upload Embed Widget.
- Add the asset you created containing the Widget.
- Publish! Done!
- Check your published page to make sure it displays and test the uploader yourself to make sure it is uploading to the correct folder.
- Grab a glass/cup of your favorite hot beverage, because you're done