Troubleshooting Custom Forms

This article provides suggestions for troubleshooting issues with custom form documents and tips for making requests to Campus Support:

  • Tips for Creating a Custom Form
    • Recommended Text Field Properties
      • Other Best Practices
  • Tips for Submitting Issues to Campus Support
    • Identify the Form
  • Editing a Secured PDF Using Adobe
  • Other Common Custom Forms Errors/Tips

Tips for Creating a Custom Form

Any time you create a Custom Form Document, optimize the form to reduce size and eliminate unexpected metadata and hidden information that may have come from a previous application such as Microsoft Word. When forms are created in these other applications and then converted to PDF files, there is often a great deal of formatting code added behind the scenes. This extra data makes the file much larger than necessary and could result in printing inconsistencies.

 These tips apply to Adobe Acrobat Professional. Other versions of Adobe may not have equivalent functionality.

All Custom Forms should be run through the Action Wizard prior to deployment.

Complete the following setup to create a customized Action in the Action Wizard:

  1. In Adobe, navigate to Tools > Action Wizard
  2. Click Create New Action. The Create New Action menu displays.
  3. In the Create New Action Menu, navigate to Protection and select Remove Hidden Information.
     
  4. Click Specify Settings and unmark the following options:
    • Form Fields
    • Deleted or Cropped Content
    • Links, Actions, and Javascripts
    • In the Create New Action menu, navigate to Document Processing and mark Reduce File Size.
  5. Save the Action.

Once all form fields are added and formatted as desired, run your customized Action on the completed form and save the resulting file. The form is now ready to be uploaded and used.

Recommended Text Field Properties

  • Text field properties should never include scrolling long text.
  • Multi-line text should only be used for text fields that are taller than one line.
  • Using unsupported fonts may cause text to be unreadable. Supported fonts include:
    • Helvetica
    • Times New Roman
    • Times Roman
    • Courier

Other Best Practices

  • Use checkboxes instead of radio buttons because a radio button cannot be unmarked once selected.
  • List Boxes, Signature fields, and Bar Codes are not supported field types.
  • Limit the use of Buttons or javascript.
  • Form field names should be as short as possible. Do not let Adobe automatically name form fields.
  • Do not use the Form Field Recognize wizard offered when editing an form with no form fields. Decline this offer and add forms manually.
  • Use the Reserved Names document to upload and test all the reserved name fields.
  • Only use multi-line text fields when fields should have multiple lines of text. This may cause forms to print unnecessary pages. Users should select auto-font for text fields that should not print on a second page, such as names, dates, addresses, etc.

Tips for Submitting Issues to Campus Support

To simplify the process of submitting a case with Campus Support, please collect the following information:

Identify the Form

Campus Support needs to know if the form in question is one created by the user or the district. Additionally, Support needs the name of the actual file in question, rather than the name that displays in the Documents tabs in Student Information. The file name is found in System Administration > Module (such as Special Ed) > Custom Forms > Document Name.

In this example, the display Name is Counselor Meeting Notes, but the Document Name of the file is Counselor Meeting Notes_2017-04-03-15-35-56.pdf:

The Uploaded by field is also useful for determining if the file is maintained by Campus or a particular district:

If the file is maintained by the district, the person submitting the case to Campus Support will need to attach the original form to the case (not just a screenshot).

Editing a Secured PDF Using Adobe

  1. Confirm the document is secured by opening the document and selecting Tools > Edit. An error appears indicating the form cannot be edited.
  2. Go to File > Print.
  3. Select the "Microsoft XPS Document Writer" in the Printer dropdown. Click Print.
     
  4. A progress bar displays:
     
  5. A "Save the file as" screen displays. Determine the location and file name of the document and then click save. The document will be saved as an XPS document.
     
  6. Close the document in Adobe.
  7. Open the document using XPS Viewer by double-clicking the document.
  8. Click File > Print.
  9. Select the "Adobe PDF" in the Printer options window. Click Print.
  10. A "Save the file as" screen displays. Determine the location and file name of the document and then click save. The document will be saved as an executable PDF document.
     
  11. The new PDF displays in Adobe. Go to Tools > Edit to edit the document. Complete the updates as needed and save the PDF. 

Other Common Custom Forms Errors/Tips

  • Admin should create the form in Word. Using Google Docs is not supported.
  • List box, digital signature, and bar code fields are not supported.
  • Admin should remove all custom print and save buttons on the form.

  • Only use multi-line text fields when fields should have multiple lines of text. Using multi-line text fields for single line text may cause forms to print unnecessary pages. Users should select auto-font for text fields that should not print on a second page, such as names, dates, addresses etc.
  • Recommended fields to use for parent's name:
    • Contacts.lastName
    • Contacts.firstName
    • Contacts.relationship
  • Recommended fields to use for Special Ed:
    • teamMember.lastName
    • teamMember.firstName
    • teamMember.title



ProblemPossible Diagnosis

Student Information > [Module] > General > Documents

Text is disappearing when the form is printed.

This problem may be caused by the following:

  • Form has a border color around the text field.
  • Form has a fill color in a text field.
  • Form has symbols or special characters that are not supported.
  • Overflow text exceeds 1 MB per field.
  • User is using an unsupported font type. Supported font types include:
    • Helvetica
    • Times New Roman
    • Times Roman
    • Courier

System Administration > [Module] > Custom Forms

A Form Admin is unable to upload a form.

This problem may be caused by the following:

  • The form file is larger than 4 MB.
  • The form has the wrong file name extension (needs to be .pdf).
  • The field names are too long. Field names cannot exceed 300 characters.
Extra pages are printing

The multi-line text option has been selected when the form was created. Multi-line should not be used for names, dates, or addresses.

Use the auto-font option or a standard font size instead of the multi-line option when creating the form.

Empty space is printing after text fields

This problem may be caused by the following:

  • a browser setting for Chrome at Settings > Appearances > Font Size. Make sure the Font Size is set to the recommended setting (Medium).
Overflow text fields are not working.The overflow field in Adobe should be formatted with auto-font, multi-line, and scroll long text.