Data Export to a Custom PDF: Export Using a Selected Connection

Before you begin

The following procedure requires that you have a PDF version of your form.

About this task

Keep the forms that work for you. With SOTI Snap, you can build apps that export data to your company's current PDF forms. Whether you are moving an activity solely to an app or want to keep the option to fill out a form manually, there is no need to change your documents. SOTI Snap works with your methods to present information your way.

Data connection rules determine where your exports are sent, what data is mapped to your PDF, and how export records are filtered.

To create a new a new connection rule and map your app fields, you will need to select a connection destiniation for your .pdf data output. You can select from the following set of connection destination options from the list below:
  • Gmail Connection
  • Google Drive Connection
  • Microsoft OneDrive Connection
  • Microsoft SharePoint Connection
  • Email Connection
  • FTP/SFTP Connection

To export data to a custom PDF using one of (Gmail/Google Drive/Microsoft OneDrive/Microsoft SharePoint/SMTP email/{FTP or SFTP}) connection, you must:

  1. Set Up the Connection
  2. Map App Fields to Your PDF
  3. Select the Export Details
Note: If you choose to Cancel during this process, you will have the option to Save Draft. You may return and continue setting up your connection at any time.

Step 1: Set Up the Connection

About this task

Procedure

  1. Select the Apps tab. The App Manager opens, showing available apps.
  2. Select the app name. The editor opens.
  3. Select the Data Connection Rules tab.
  4. Under Data Export Rule, select New Data Export Rule. The Create Data Export window opens.
  5. Under Name, provide a descriptive name for the rule.
  6. For the selected connection, proceed with the following steps:
    Connection Procedure
    Gmail

    To create a Gmail connection:

    1. Select Gmail. Select Next twice.
    2. Select an existing Google account or add a new one.
    3. To add a new Google account, select Create New.
      1. In Connection Name, enter a name for the connection. Do not use an email address.
      2. Select Sign in with Google. A Google account sign-in browser window opens.
      3. Follow Google's sign-in prompts to verify the email account to use with SOTI Snap.
    4. Select Next. The Create Data Export — Gmail window opens.
    5. Select a form within your app and fill in the Email Template Settings fields.
      • To: Enter at least one email address. Use macros to dynamically populate the recipients field based on the app's contents.
      • Subject: Enter a subject line for the email message. Use macros and metadata to dynamically populate the subject line from the app's contents.
      • Message: Enter text for the body of the email message. Use macros and metadata to populate the subject line from the app's contents dynamically.
    6. Select Test Connection to verify that you can send an email under this configuration. Once confirmed, select Next.
    Google Drive

    To create a Google Drive connection:

    1. Select Google Drive. Select Next twice.
    2. Select an existing Google account or add a new one.
    3. Optional: To add a new Google account, select Create New.
      1. In Connection Name, enter a name for the connection. Do not use an email address.
      2. Select Sign in with Google. A Google account sign-in browser window opens.
      3. Follow Google's sign-in prompts to verify the email account you are using with SOTI Snap.
    4. Select Next.
    Microsoft OneDrive

    To create a Microsoft OneDrive connection:

    1. Select OneDrive. Select Next twice.
    2. Select an existing Microsoft OneDrive account or add a new one.
    3. Optional: To add a new Microsoft OneDrive account, select Create New.
      1. In Microsoft account name, enter an account name for the connection.
      2. Select Authenticate. A Microsoft account sign-in browser window opens.
      3. Follow Microsoft's sign-in prompts to verify the account you are using with SOTI Snap.
    Microsoft SharePoint

    To create a Microsoft SharePoint connection:

    1. Select SharePoint. Select Next twice.
    2. Select an existing Microsoft SharePoint account or add a new one.
    3. Optional: To add a new SharePoint connection, select Create New.
      • In Microsoft account name, enter a name for the connection. Do not use an email address.
      • Select Authenticate. A Microsoft account sign-in browser window opens.
      • Follow Microsoft's sign-in prompts to verify the account you are using with SOTI Snap.
    4. Select Next.
    Email

    To create an email connection:

    1. Select Email. Select Next twice.
    2. Select an existing SMTP account or add a new one.
    3. Optional: To add a new SMTP account, select Create New.
      1. Complete the following connection details:
        • SMTP account name
        • Hostname
        • Port number
        • Username
        • Password
        • Sender email
        • Sender name
      2. Select Test Connection. Once confirmed, select Next. The Create Data Export — Email window opens.
    4. Select a form within your app and fill in the Email Template Settings fields.
      • To: Enter at least one email address. Use macros to dynamically populate the recipients field based on the app's contents.
      • Subject: Enter a subject line for the email message. Use macros and metadata to dynamically populate the subject line from the app's contents.
      • Message: Enter text for the body of the email message. Use macros and metadata to populate the subject line from the app's contents dynamically.
    FTP/SFTP

    To create an FTP/SFTP connection:

    1. Select FTP/SFTP. Select Next twice.
    2. Select an existing FTP/SFTP connection or add a new one.
    3. Optional: To add a new FTP/SFTP connection, select Create New.
      1. Complete the following connection details:
        • Connection Name
        • FTP/SFTP Server Address
        • Port#
        • Username
        • Password
      2. Select Test Connection. Once confirmed, select Next.
  7. Select Browse File.
  8. Navigate to and select your custom .pdf form.
  9. Select Next.

Step 2: Map App Fields to Your PDF

Map App Fields to Your PDF

Before you begin

The following procedure requires that you have a PDF version of your form.
Note: See The PDF Mapper to review the workspace elements.

About this task

The following video demonstrates how to map app fields to your custom PDF:

To map app fields to your custom PDF.

Procedure

  1. Optional: Set field format defaults.
    Note: Text boxes, check boxes, and radio buttons have default formats for fonts and sizes. You may change these settings later. Changes do not affect fields already placed on the PDF form. SOTI recommends that you set the defaults first.
    1. Select the Set default styles button Set default styles button. The Set Default Styles window opens.
    2. Update the Default Field Settings as required to set properties such as font, size, and color.
  2. Go to the Unmapped tab to find available fields, not on the form. If the field you need is absent, go to the Mapped tab.
    Note: Fields appear in the Mapped tab after they are used in the PDF form. For fields used more than once, the number of uses appears in brackets beside the field name.
  3. From the left toolbar, drag the desired field to your PDF. Place it in the space where the data goes. Use the handles on the perimeter of the field to resize it.
  4. Optional: Change individual Field Settings as required.
    Note: This is not the same as changing default settings. These changes only affect the current field.
  5. Repeat steps 2 to 4 for each field you place on the form.
  6. Optional: Select the Preview exported PDF button Preview exported PDF button to download a draft version of the PDF. Inspect the PDF to determine if changes are required.
    Note: If you review your exported PDF and decide the PDF template is not correct, you may replace your PDF template by selecting the Replace PDF button Replace PDF button.
  7. Select Next.

Step 3: Select the Export Details

Procedure

  1. For the selected connection, proceed with the following step(s):
    Connection Procedure
    • Gmail
    • Email
    • FTP/SFTP

    Use a filter to select only the necessary records to export:

    In the Create Data Export window, select the File Name field. Provide the name for the exported PDF file. You can use macros to dynamically generate a more specific file name based on the record's contents. Choose a macro from the macro list (select Dropdown button) to add data such as form field values or metadata.

    • Google Drive
    • Microsoft OneDrive
    • Microsoft SharePoint

    To complete the export configuration, select the Google Drive/Microsoft OneDrive/Microsoft Sharepoint destination and filter the data to export.

    1. In the Create Data Export - Google Drive/OneDrive/Sharepoint window, select Select Google Drive/OneDrive/Sharepoint Site and folder. Navigate to the destination folder for your .pdf exports.
    2. Select the File Name field. Provide the name for the exported PDF file when saved to your Google Drive/Microsoft OneDrive/Microsoft Sharepoint folder. You can use macros to dynamically generate a more specific file name based on the record's contents. Choose a macro from the macro list (select Dropdown button) to add form field values or metadata such as Created by device name to the file name.
  2. Select Next.
  3. Determine which data from the app to export to this destination.
    • Choose Every new record to export all new app data.
    • Choose Filter records to export only a subset of the app's data.
    Export record filtering options
  4. If you select Filter records, do the following:
    1. Specify if the record must meet all or any of the defined export conditions.
    2. Select the field where you want to apply the condition. Use the Operator and Value fields to set your conditions.
    3. Select Add to add more conditions.
  5. Optional: Select Export & delete to delete the records chosen by the filter after the export operation is complete. Records will be removed from the SOTI Snap server and devices with local copies.
  6. Once you are satisfied with all your conditions, select Next.
  7. Review the settings of the data connection to ensure you are satisfied. Select Finish to save your data connection or Back to return to a previous screen and make edits.

Results

New data connections are immediately active and appear under their respective tabs in the Data Connection Rules view.

What to do next

To edit an established connection or field mappings, see Edit the PDF Connection and Field Mappings.