How can we help you today?

Menu

    Document Templates

    Avatar
    OrangeHRM Administrator
    • Updated
    Follow

    Refer to this article if your version is above 7.4.1

    Today organization’s internal processes are more challenging and comprehensive than ever in the past. One of the biggest effects that modern technology has on business operations revolves around the depletion of paper documents by incorporating document management software into the organization. From time to time employees requires various types of official documents such as employment confirmation, Salary confirmation letters from the employer to present to various stakeholders. Document preparation can be time-consuming and prone to human errors.

    The OrangeHRM Document Manager module facilitates creating and adding documents based on given templates for employees in their profiles.

    These Document Templates can be created within the following Section of an employee profile.

    • PIM - Personal Details

    • PIM - Contact Details

    • PIM - Job

    • PIM - Salary

    The Document Template Manager is a tool that manages the document templates efficiently in an organization. The Admin can create document templates by defining the PIM section, paper size, margins, tokens, and supporting images. When those templates are created, both Admin (on behalf of employees) and ESS users can view them as pdf documents addressed to the individual employees.

    In order to view the PIM document template list Select PIM >Configuration>Document Templates from the Main Menu.

    Step 1 - Click the ‘Add’   button on the Document Template Screen. The Add Document Template Screen will appear.

    screencapture-orangehrm-demo-7x-orangehrmlive-client-2021-09-27-11_17_31.png

    Step 2 – Complete the following fields and sections.

    Field

    Description

    Name

    Name of the Document template

    Link to Section

    The document can be linked to any of the four sections below.

    •  Personal Details

    •  Contact Details

    •  Job

    •  Salary

    Description

    Description of the template

    Text Area

    Add the body of the template. Use the WYSIWYG editor to style and format the document.

    Tokens

    Token is the data field in the employee profile. Place the cursor in the text area where you want the token placed and select the token from the drop-down list.

    Image

    Click the ‘Image’ button to add an image to the document or click the toggle tool bar  too.pngand click 'Upload Image'. 

    Paper size

    Set the paper size. (A4, A3, Etc..)

    Margins

    If you leave these 4 fields blank, by default the margins will be set at 10mm. you can override them by specifying values to the fields.

     

    Step 3 – Click ‘Save and then you will see the new template in the Tab you have specified.

     

    Example of Document Manager

    If a document template is created under PIM-Job, the job section of the employee details will contain an additional button as "Create Document" right before the "Termination Employment".

    Upon clicking on the "Create Document" button, the system displays a window to download the document via PDF or if you want to edit the document further, you can use the "DOCX" option to download and open with Microsoft Word.  

     

    a drop-down list is shown with a list of templates that were created earlier. Any template can be chosen and a PDF document is created for that employee based on the employee details. 

    iz.png

     

    The document will be opened in a separate tab that can be printed or saved. Following is the sample letter created for 'Employee Job Confirmation'. 

    eaa.png

     

    Tokens that can be used in Document Templates

    Tokens are used to import information from the employee information to the document without being needed to manually add them.

    An example for a token would be #empWorkEmail#. If we use this token in a statement of document templates, the system will find the relevant value for the given token and use add it to the document instead of the term #empWorkEmail#.  

    Therefore the statement with Token "You can get in touch with our employee through #empWorkEmail#" would reflect in the document as "You can get in touch with our employee through rickraymond@orangehrm.com".

     

    Below is the list of Tokens that can be used with Document Templates in the PIM Module.

     

    Token

    Token Description

    #empFirstName#

    Employee First Name

    #empLastName#

    Employee Last Name

    #empMiddleName#

    Middle Name

    #empId#

    Employee ID

    #empLicenseNumber#

    Drivers License Number

    #empLicenseExpiryDate#

    License Expiry Date

    #empBirthday#

    Date of Birth

    #empNationality#

    Nationality

    #empMaritialStatus#

    Marital Status

    #empGender#

    Gender

    #empAddressStreet1#

    Address Street 1

    #empAddressStreet2#

    Address Street 2

    #empCity#

    City

    #empState#

    State/Province

    #empZipCode#

    Zip/Postal Code

    #empCountry#

    Country

    #empHomeTelephone#

    Home Telephone

    #empMobile#

    Mobile

    #empWorkTelephone#

    Work Telephone

    #empWorkEmail#

    Work Email

    #empOtherEmail#

    Other Email

    #empJoinedDate#

    Joined Date

    #empProbationEndDate#

    Probation End Date

    #empDateOfPermanency#

    Date of Permanency

    #empJobTitle#

    Job Title

    #empEmploymentStatus#

    Employment Status

    #empJobCategory#

    Job Category

    #empSubUnit#

    Sub Unit

    #empLocation#

    Location

    #empEffectiveDate#

    Effective Date

    #empContractStartDate#

    Contract Start Date 

    #empContractEndDate#

    Contract End Date 

     

    Also, if any custom fields are created in the system, now it is possible to include those as tokens in the document that you have created. 

     

     

     

     

    Related articles