Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 68 Next »

Custom forms can be imported into USPS-R to be used for printing PDF forms like direct deposits and salary notices. To create a custom form, users would create their own Word template and upload it to the Report Manager. 

Customize Template Form in Word

A custom form can be created using merge fields in a Word Template document. 

Templates for USPS-R transactions:

Several template forms can be found in the Public Shared Reports Library>Custom Form Templates section.  Click here for a list of available downloadable forms.

Create Forms in Report Manager

This is done from the Reports>Report Manager view, using the Create Form option:

  • Report Name - Will be what users see when they select the form to use for printing
  • Description - Will be visible in the Reports Manager grid (optional)
  • Tag - A user defined way to categorize reports. Can be utilized to filter records within the grid (optional)
  • Entity Type - Select the Entity type that corresponds with the Form that is being added 
    • Payee - CheckPaymentDetail
    • Payroll Direct Deposits - PaymentDetailPayrollDirectDeposit
    • Payroll Checks - PaymentDetailPayrollCheck
    • Salary Notices - NewContract
  • Filename - Click Select Form and select the custom form file from your computer

Click on  to Save the Form or Cancel to exit. Once saved, the custom form will show in the Reports Manager grid. 

If non-Admin user need to use this form for printing, use the share icon to grant access to other USPS Roles. 

Use Custom Forms When Printing PDF Forms

When printing direct deposits and salary Notices, users will have an option to select the form to be used from a drop down list. The drop down option will appear after selecting "PDF."

Example of Printing Direct Deposits with a Custom Form:


Example of Printing Salary Notices with a Custom Form:

How to Customize a Form

When editing the template forms in Word, "fields" are used with the USPS property names. For official documentation on how to use fields in Microsoft Word, please refer to the Microsoft Support/Documentation. 

Word Formatting Tips

The template form is set up in a table format to keep everything in its proper spot. Before you begin customizing your forms, you can display borders and/or markups (hidden formatting) on the Word form in order to see the placement of the fields better. 

    • To display markups:
      • Go to File>Options>Display, and checkmark 'Show all formatting marks.' Click OK.  This will display the 'hidden formatting' markups on the form.  
        • NOTE: Markups will not appear on the printed or emailed form.  If you wish to turn off markups in Word, uncheck the 'Show all formatting marks' under File>Options>Display.
    • To display borders: 
      • Go to Home>Select>Select All (Ctrl+A) to select the entire form.
      • Next, go to Home and click on the dropdown to the right of the borders option and select 'All Borders.' .  This will display borders on the form.
        • NOTE: You must remove the borders before saving changes to the Word document or else the borders will appear on the printed/emailed form.

Adding a Field

  • Insert the merge field(s).  
    • Place your cursor where you'd like the new field to be placed.
    • Go to Insert>Quick Parts>Field.  When the pop-up box appears, select MergeField.  In the Field Name, enter the appropriate field name. 
      •  i.e.  ${d.amount}
    • Click OK.  
    • Save the changes made to the form.


Editing a Field

  • Right-click on the field and select Edit Field.
  • Edit Field name value.
  • Click OK.
  • Save the changes made to the form.


  • If creating one salary notice, <<[/#list]>> can be at the bottom of the document as the last field.
  • If creating multiple salary notices at once and the generated notices are not advancing to the next page properly, ensure <<[/#list]>> is at the very top of the next page.
  • To insert a logo (image), go to Insert>pictures.  Ensure the logo is inserted after the first field of the form, «[#list modelObjects! as row]», and is positioned as ‘in line with text’ so Word recognizes it as part of the document.

Crosswalk of Direct Deposit Notification XML

The property names are case-sensitive and should be entered as listed below. For a printable version, please click here.  

Available Salary Notice Fields

DescriptionField NameMerge Field Name
Employee NumberemployeeNumber${(row.employeeNumber)!}
First NamefirstName${(row.firstName)!}
Middle NamemiddleName${(row.middleName)!}
Last NamelastName${(row.lastName)!}
Street 1street1${(row.street1)!}
Street 2street2${(row.street2)!}
Citycity${(row.city)!}
Statestate${(row.state)!}
Zipzip${(row.zipCode)!}
Position NumberpositionNumber${(row.positionNumber)!}
Position DescriptionpositionDescription${(row.positionDescription)!}
Compensation LabelcompensationLabel${(row.compensationLabel)!}
Contract AmountcontractAmount${(row.contractAmount?string(",##0.00"))!}
Contract Work DayscontractWorkDays${(row.contractWorkDays)!}
Number Of PaysnumberOfPays${(row.numberOfPays)!}
Compensation Start DatecompensationStartDate${(row.compensationStartDate)!}
Hours In DayhoursInDay${(row.hoursInDay)!}
Pay PlanpayPlan${(row.payPlan)!}
Pay Per PeriodpayPerPeriod${(row.payPerPeriod)!}
Appointment TypeappointmentType${(row.appointmentType)!}
School YearschoolYear${(row.schoolYear)!}
Statement DatestatementDate${(row.statementDate)!}
District NamedistrictName${(row.districtName)!}
District StreetdistrictStreet${(row.districtStreet)!}
District CitydistrictCity${(row.districtCity)!}
District StatedistrictState${(row.districtState)!}
District ZipdistrictZip${(row.districtZip)!}
Include District Info On NoticeincludeDistrictInfoOnNotice${(row.includeDistrictInfoOnNotice)!}
Name For NoticenameForNotice${(row.nameForNotice)!}
Salary Scheduled IdsalaryScheduleId

${(row.salaryScheduleId)!}


Salary Schedule ColumnsalaryScheduleColumn${(row.salaryScheduleColumn)!}
Salary Schedule StepsalaryScheduleStep

${(row.salaryScheduleStep)!}


Raterate

${(row.rate?string(",##0.00#"))!}

${(row.rate?string(",##0.00"))!}

3-digit rounding

2-digit rounding

Rate TyperateType${(row.rateType)!}
District YearsdistrictExperience${(row.districtExperience)!}
Building YearsbuildingExperience

${(row.buildingExperience)!}


Accred Dist YearsaccredDistrictExperience${(row.accredDistrictExperience)!}
Military YearsmilitaryExperience${(row.militaryExperience)!}
Trade YearstradeExperience

${(row.tradeExperience)!}


Retire System YearsretireSystemExperience${(row.retireSystemExperience)!}
Ohio Public YearsohioPublicExperience

${(row.ohioPublicExperience)!}


Ohio Private YearsohioPrivateExperience ${(row.ohioPrivateExperience)!}

Non Ohio Public Years

nonOhioPublicExperience${(row.nonOhioPublicExperience)!}
Non Ohio Private YearsnonOhioPrivateExperience

${(row.nonOhioPrivateExperience)!}


Purchased YearspurchasedExperience

${(row.purchasedExperience)!}


Authorized YearsauthorizedExperience${(row.authorizedExperience)!}
Total YearstotalExperience

${(row.totalExperience)!}


Principal YearsprincipalExperience

${(row.principalExperience)!}


Degree TypedegreeType${(row.degreeType)!}
Degree Type DescdegreeTypeDescription

${(row.degreeTypeDescription)!}


For more information on creating custom forms, click here to be taken to the FWF: Custom Forms recording.




  • No labels