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".

Source Language (PDF, Microsoft Word, and HTML Documents)

Choose the language for the Document Metadata labels and other system-generated content like page numbering. The following example shows the Document metadata labels translated to Spanish.

Document metadata labels translated to spanish. The labels read "Numero de Referencia", "Nombre del remitente", "Nombre del formulario", and "Fecha del envio".

When you choose a Source Language, the system automatically shows a list of fonts that work for that language. You can choose a different Font from the list, or change the Font Size.

Info:If your team has the Multi-Language add-on, refer to the topic How Multi-Language Documents Work.

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.

    Dropdown menu next to the document name. The option to "preview" is highlighted.

  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 new copy of the document in the current FormSpaceClosed FormSpaces are where forms are stored and organized in the TrueContext Web Portal. A TrueContext 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.

Note:Any document that uses a custom template provided by the TrueContext Professional Services team is designed to work with a specific form. If you copy this document, it might not work with other forms.

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 as New.

    Dropdown menu next to the document name. The option to "Copy as New" is highlighted.

  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 to an existing Document

    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).

    Note:Any document that uses a custom template provided by the TrueContext Professional Services team is designed to work with a specific form. If you copy the configuration of this document, it might not work with other forms.

    To Copy the Document configuration:

    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 to Existing.

      Dropdown menu next to the document name. The option to "Copy to Existing" is highlighted.

    4. Select one or more PDF, Word, or HTML 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.

    Note:If you have a Multi-Language Document, the system copies any additional languages set up in your source document. If any of your target documents have languages already set up, the source document languages will overwrite them.

    Move a Document

    Note:
    • Documents that are “In Use” by a form cannot be moved.

    • Any document that uses a custom template provided by the TrueContext Professional Services team is designed to work with a specific form. If you move this document, it might not work with other forms.

    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.

      Dropdown menu next to the document name. The option to "Move" is highlighted.

    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.

      Dropdown menu next to the document name. The option to "Delete" is highlighted.

    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.

    Data Destinations that Require a Document

    The following table describes the Data Destinations that support or require a document.

    Requires a Document Can have a Document, but is not required Not compatible with Documents
    Microsoft SharePoint Server Amazon Glacier Amazon SNS
    Salesforce Apex REST Amazon S3 Google Sheets
    ShareFile Box Dispatch
    WebDav (HTTP PUT) Customer Feedback Microsoft SharePoint List
      Dropbox SMS
      Email Zendesk Ticket
      FTP/Secure FTP  
      Google Drive
      HTTP  
      HTTP File Upload  
      Microsoft OneDrive  
      Microsoft OneDrive for Business  
      Microsoft SharePoint Document Library  
      Salesforce (except Apex REST)  
      ServiceNow Table  

    Note:You can’t attach documents to a Repeatable DestinationClosed A Repeatable Destination is a TrueContext 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.