Many customers have asked for a way to include file uploads as a part of a Zingtree decision tree session. Some use cases include:

• Attaching a screenshot.
• Including a photo.
• Uploading a document.
  
  Try a Demo

Overview

Using Data Entry Fields, you can pick the File Upload field type. This allows you to include one or more files in the session data gathered by Zingtree. When the end-user uploads a file, here’s what happens:

1. The file is copied from the end-user’s computer to a Zingtree file storage server.
2. Zingtree assigns a variable to the URL where the new file resides.

Security note: Each file uploaded has a random 7-digit prefix or session ID attached to it, so that files with the same name aren’t overwritten, and the file names cannot easily be discovered by hackers.

How It Works

When the end-user reaches a node with a file upload, they will see something like this:

Clicking Upload Document File allows them to choose a file on their computer. Once a file is chosen, the button changes:

How to Set up File Uploads

When editing a node, do the following:

1. Go to Data Entry Fields, and select Add:

   

2. Choose File Upload as the field type, and enter a variable name and label for the upload button:

   

3. Click Add Field.
4. Now click Save Changes to save changes in the node you were editing.

It’s that simple! This gallery example shows how a simple file upload tree is built.

Secure Authenticated Downloads

After uploading a file, you can opt to create a link to it that is securely accessible via https and requires an agent login. The URL for this file would look like this:

https://zingtree.com/authenticated-download.php?var=file&session_id=50ea4a20ea534fabb467b3652ce14153

The parameters:

• var= is the name of the variable for the uploaded file URL.
• session_id= is the session ID. You would insert #session‌# to display this.

Single Sign-on: If your account has single sign-on enabled, you can add a third parameter to the URL to require SSO login to access the file:

• sso_org=123 = where 123 is the ID for your organization. Locate this from Account, Organizations and Billing.
  
  

Examine this Gallery Tree to see how this works.

Uploading and Displaying Images

If you're uploading an image file, and want to display it on another node, here's a trick. As an example, if the image upload variable is image1, you would add an image placeholder with an id of image1. For this example, you would put this HTML code (using code view) into the node that displays the image:

<img id="image1" class="img-responsive">

• Data Entry Field Variables: Adding Input Forms to your Trees

Many customers have asked for a way to include file uploads as a part of a Zingtree decision tree session. Some use cases include:

• Attaching a screenshot.
• Including a photo.
• Uploading a document.
  
  Try a Demo

Overview

Using Data Entry Fields, you can pick the File Upload field type. This allows you to include one or more files in the session data gathered by Zingtree. When the end-user uploads a file, here’s what happens:

1. The file is copied from the end-user’s computer to a Zingtree file storage server.
2. Zingtree assigns a variable to the URL where the new file resides.

Security note: Each file uploaded has a random 7 digit prefix or session ID attached to it, so that files with the same name aren’t overwritten, and the file names cannot easily be discovered by hackers.

How It Works

When the end-user reaches a node with a file upload, they will see something like this:

Clicking Upload Document File allows them to choose a file on their computer. Once a file is chosen, the button changes:

How to Set up File Uploads

When editing a node, do the following:

1. Go to Data Collection Form Fields, and select Add Form Field:

   

2. Choose File as the field type, and enter a variable name and label for the upload button:

   

It’s that simple! This gallery example shows how a simple file upload tree is built.

Secure Authenticated Downloads

After uploading a file, you can opt to create a link to it that is securely accessible via https and requires an agent login. The URL for this file would look like this:

https://zingtree.com/authenticated-download.php?var=file&session_id=50ea4a20ea534fabb467b3652ce14153

The parameters:

• var= is the name of the variable for the uploaded file URL.
• session_id= is the session ID. You would insert #session?# to display this.

Uploading and Displaying Images

If you're uploading an image file, and want to display it on another node, here's a trick. As an example, if the image upload variable is image1, you would add an image placeholder with an id of image1. For this example, you would put this HTML code (using code view) into the node that displays the image:

<img id="image1" class="img-responsive">

• Data Entry Field Variables: Adding Input Forms to your Trees

Throughout 2022 Zingtree will be upgrading customers to our new faster and more modern user experience! Here's how to tell which experience your Zingtree Authors are currently using.

Log in to your Zingtree Author account and navigate to My Trees. How does your current My Trees page look?

Zingtree Classic

New User Experience