Create and Manage Documents

Contents

Create a Document

  1. Hover over Manage Forms, and then select Documents.

  2. From the Documents page, select Create Document.

  3. Choose a document type.

  4. Fill out the Document Basics, as described below.

  5. There will be settings specific to your document type; review the documentation for specific document type for more details.

Settings: Document Basics

Name/Description

Give the document a unique name. Optionally provide a description.

Filename

This name applies to all instances of the document, including downloaded documents and documents sent by Data Destinations.

Tip:A recognizable file name can help you quickly search for and identify files when:
  • You download files from multiple form submissions so that you can work locally.

  • You or your customers receive multiple messages generated by Email Destinations.

  • Use Data Reference Expression Language to reference answers in your forms.
  • Static text can also be included.
  • For example, %r -- %a[Customer Name] would name the file like "20140812-180001002 -- John Smith".

  • Some Data Destinations will overwrite files with duplicate names. Make sure file names are unique by including one or more of:
    • %r - the submission's reference number -- for example, 20140920-1815562464
    • %r[id] - the submission's ID - for example, 1815562464
    • %t - the time the form was submitted

Document Time Zone Source

Choose a document time zone source. This is the time zone for all dates and times in your document.

  • Team Preference Setting: Will use the time zone chosen for the team
  • Form Submission: Will use the time zone the form submission is made from (as chosen on the mobile device).
  • Custom: Choose a time zone.

Preview a Document

View a preview of the document. Questions will be answered with placeholders.

  1. Hover over the Manage Forms tab and select Documents.

  2. Select the document from the list.

  3. Hover over the dropdown beside the document name and select Preview.

  4. The file will download to your computer. Open it to view it.

Edit a Document

  1. Go to the desired document.

  2. Select Edit Document beside the document's name.

Copy a Document

Make a copy of the document in the current FormSpaceClosed FormSpaces are where forms are stored and organized in the ProntoForms Web Portal. A ProntoForms Team may have multiple FormSpaces, depending on their needs. Admins can set FormSpace permissions to control which users have access to the forms in that FormSpace. or copy it to another FormSpace.

To Copy the Document:

  1. Hover over the Manage Forms tab and select Documents.

  2. Select the document from the list.

  3. From the drop-down menu beside the document name, select Copy.

  4. Select the Target FormSpace and document name.

  • Target FormSpace: The FormSpace the new document will be created in.
  • Target Document Name: The name of the new document.
  • After completing the required fields, select Copy.
  • Copy Document Configuration

    The configuration of visual documents may be complex, and users may want to use the same configuration in another visual document, especially other visual document types (PDF to Word, Word to HTML, for example).

    To Copy the Document:

    1. Hover over Manage Forms, and then select Documents.

    2. Select the document from the list.

    3. From the drop-down menu beside the document name, select Copy Configuration.

    4. Select one or multiple documents from the list. The document configuration will be copied to all documents in this list.

    5. After completing the required fields, select Copy Configuration.

    Move a Document

    Note:Documents that are "In Use" by a form cannot be moved.

    To Move a Document:

    1. Hover over Manage Forms, and then select Documents.

    2. Select the document from the list.

    3. From the drop-down menu beside the document name, select Move.

    4. Required fields are highlighted with an asterisk.

    • Target FormSpace: The FormSpace the document will move to.
    • Target Document Name: Re-names the document when moved.
  • After completing the required fields, select Move.
  • Delete Document

    Note:Documents that are "In Use" by a form cannot be deleted. Deleting a document is permanent.

    To Delete a Document:

    1. Hover over Manage Forms, and then select Documents.

    2. Select the document from the list.

    3. From the drop-down menu beside the document name, select Delete.

    4. A pop-up window will appear to confirm your action. Select OK to delete.

    Link a Document to Forms and Data Destinations

    Documents are connected to Data Destinations at the form level. When editing a form, this option can be found in the Destinations tab. Read here for more information.

    Note:You can’t attach documents to a Repeatable DestinationClosed A Repeatable Destination is a ProntoForms Data Destination that sends data from a Repeatable Section to a field-based, third-party system.. This prevents duplication of the same document across multiple records.

    Auto-Link a Document to a Data Destination

    There is also an auto-link option at the Data DestinationClosed A Data Destination specifies where to send data from a submitted form. You can use Data Destinations to automate data sharing and storage, routing data to a specific service (such as email or cloud storage) in several different formats. level in the Destination Basics tab. This can save time if most of your forms should be sent to the same location and send the same documents. Note that these options only apply to forms created after this option has been selected.

    1. Select Auto-Link new forms.... New forms created or imported (in the same FormSpace) will automatically be linked to this Data Destination.

      autolink.png

    2. When Auto-Link new forms... is selected, a box to Auto-Link documents to the Data Destination appears. When the destination is auto-linked to a form, the Data Destination will automatically be able to send these documents.

      autolink2.png

    Link a New Document to an Old or Existing Form Version

    When deploying a form, it's easy to forget to attach certain destinations or documents, resulting in a backlog of hundreds of form submissions that haven't gone to the correct place, or have the wrong document attached.

    Now, it's possible to attach the correct Data Destinations and documents to an existing form version, saving yourself time by automatically queuing the form submissions for re-processing. The process is simple:

    1. Navigate to the Form Versions page of your desired form.

      2019-02-11-WP-FormVersionBacklog01.png

    2. Select the applicable version of your form (the one with the form submissions made to it) from the listing.

      2019-02-11-WP-FormVersionBacklog03.png

    3. Select the Form Outputs tab, and then Edit Form Outputs.

      2019-02-11-WP-FormVersionBacklog02.png

    4. Attach the correct Destinations and/or Documents, and select Update.

    5. The original form submissions will join a queue for re-processing with the correct documents and destinations, ensuring a timely and stress-free experience.