Managing employee documents

  • Release version: Zurich
  • Updated July 31, 2025
  • 10 minutes to read
  • Use Employee Document Management to search, create, move, or manage legal holds on employee documents.

    Employee Document Management is your virtual file cabinet containing any or all your organization's employee documents. With Employee Document Management, you can:
    • Search for employee documents: There are many ways you can use to narrow down your search for employee documents.
    • Create employee documents:
      • Employee documents can be added directly to the document repository.
      • When combined with HR Service Delivery, HR agents can move documents from an HR case or add directly to the document repository.
    • Place an HR profile or document type on legal hold: Placing an HR profile or document type on legal hold prevents associated employee documents from being purged after the retention period has been reached.
    • Move employee documents: When employee documents are attached to an HR case, you can manually move them to the document repository. Or, you can configure HR services to automatically move employee documents when the case is closed/complete.
    • View employee documents: Employees can view their own employee documents on the service portal or Employee Center. Here Define policies for a document type is how you give them access by document type. The base system provides example document types.

    Searching for employee documents

    Search for and view employee documents using different filters from the employee document repository. You can also download documents for audit purposes.

    Before you begin

    Role required: sn_hr_ef.document_reader

    About this task

    Employee Documents is the repository for employee documents. No matter how large your repository of employee documents is, you can search on the fly or set up pre-set search filters to find the documents you need quickly.

    Procedure

    1. Navigate to All > HR Profile > Employee Documents > Search Documents.
    2. Use the column filters to identify documents you are looking for.
      For example, sorting on the Employee column shows all documents by employee.
    3. To download documents, select the check the box next to the documents and then select Download from the Actions choice list.
      Downloading multiple documents with the same name appends each document with the employee name. A number is added when documents are still duplicated.
    4. To view more information about a document, click the document name.
      If Yes is checked in thesn_hr_ef.enable_document_viewer Employee Document Property, the employee document appears.

    Create or modify an employee document

    With the employee document writer [sn_hr_ef.document_writer] role, you can create or upload an employee document directly to the employee document management repository.

    Before you begin

    Role required: sn_hr_ef.document_writer

    About this task

    Documents can also be uploaded from the HR case form and then moved to the document repository.
    Note:
    Employee documents can also be moved from the HR case form automatically when the case is closed by configuring the HR service. For information on configuring this feature, see Configure an HR service.

    Procedure

    1. Navigate to All > HR Profile > Employee Documents > Create New Document.
    2. On the form, fill in the fields.
      Table 1. Employee Document form
      Field Description
      Document Employee document to upload.
      Click Choose File to upload an employee document.
      Note:
      By default, the maximum size of a document allowed is 30 MB. The default can be changed from the Maximum file upload size in megabytes field in Employee Document Properties. For more information, see Properties for Employee Document Management application.

      After selecting a document, the read-only fields show the file size, file format, created on, and created by.

      The viewer within the UI only supports viewing .pdf documents. Other types of documents can be downloaded and then viewed.

      For optimal search results, do not use dashes (-) in the name of the document. Using full words separated by spaces or underbars provides better search results.

      The Enable "Document Viewer" to preview pdf documents in the Employee Documents property must be checked Yes to view .pdf documents.
      Note:
      Viewing documents is not supported for FedRAMP, on-premise customers, mobile devices, customers using edge encryption, or encryption support.
      Description Description of the employee document.
      Employee Name of the employee the document is associated with.
      Payroll country Payroll country of the employee at the time of document creation.
      Note:
      When you upload the document or move the case attachments to employee file, the value in the Payroll country field defaults to the user profile of the employee.
      Document type Document type associated with the employee document.
      Document types provide categorization and the retention policy.
      Note:
      • You can read and write a document only if you fulfill the read or write configuration requirement of at least one security policy associated with the document type.
      • You can purge a document only if you fulfill the purge authorization configuration requirement of at least one security policy associated with the document type.
      • You can receive a purge notification only if you fulfill the purge authorization or notification configuration requirement of at least one security policy that is associated with the document type.
      Effective date Date and time from when the employee document is valid. In general, effective date takes the date of document creation, except in cases of contractual agreements. For example, the pay increase or promotion might come into effect from a date different from the date of the performance appraisal.
      HR case HR case number the employee document is associated with when moved from an HR case.
      Purge hold Purge hold status of a document.
      • Pending purge authorization: Purge notification has been sent out, but authorization has not been received.
      • Purge Approved: Purge authorization was received, the document is scheduled to be purged.
      • Purged Rejected: Purge authorization was rejected, the document is not scheduled to be purged.
        The security policy associated with a document type sets purge authorization. The following roles have permission to change purge authorization:
        • EF admin [sn_hr_ef.admin]
        • Employee File Management Manager [sn_hr_ef.manager]
      Expiration date Option to set an expiration date for a document. Email notifications will be sent to document owners, managers, or HR representatives (as per expiration policies) when the document expires or is nearing its expiration.
      Note:
      This option is enabled only when an administrator enables the Expiration date check box.
    3. Click Submit to create the employee document record.
      The Employee Document Audit Trail related list tab appears.

      Provides view of all actions for an employee document from creation or uploaded to the time it is purged.

      The following actions are captured:
      • Record created
      • Fields updated
      • Attachment removed
      • Attachment updated
      • Attachment renamed
      • Platform tag added
      • Platform tag removed
      • Document viewed
      • Document downloaded
      • Document downloaded by employee on Employee Center

    Move employee documents to the document repository

    You can move employee documents from an HR case to the employee document repository. You can also move employee documents automatically by HR service when an HR case is closed complete.

    Before you begin

    Role required: sn_hr_ef.document_writer or sn_hr_core.case_reader

    About this task

    Employee documents can also be added directly to the employee document repository. The employee document repository provides a central repository for quick and easy identification using different sorting features. See Create or modify an employee document.

    Procedure

    1. Navigate to All > HR Case Management > All HR Cases.
    2. Select a case that has employee documents attached.
      From the list view, there is no way to identify HR cases with employee documents attached. The HR case number or the Opened for person are required to locate an HR case.
    3. From the form header, click Move Attachments.
      The Move Attachments to Employee File menu appears.
    4. Select the check box next to the documents you want to move.
      The Select COE for attachments to be moved and Topic Detail fields can be modified, but only if the document was added under the wrong type of HR case.
    5. Select the Document Type for each document.
      The document type determines categorization, who can access it, and the retention policy. If no document type appears for the associated topic detail, one should be created to ensure correct categorization. See Define policies for a document type.
    6. Click Move Selected.

    Result

    The employee documents move from the HR case to the employee document repository. After an employee document is moved, the file name, format, and size are copied from the attachment to the document.
    Note:
    You can also automate this process by checking the Automatically move attachments box from HR services. See Configure an HR service.

    What to do next

    Once you have moved the attachments, the attachments are displayed in the Employee Documents section in the case.

    Add legal hold to multiple HR profiles

    Add legal hold to multiple HR profiles at one time. Legal or litigation holds prevent the deletion of employee documents for an HR profile.

    Before you begin

    Role required: sn_hr_ef.admin, sn_hr_ef.manager, sn_hr_core.profile_writer, sn_hr_ef.legal_hold_writer

    Procedure

    1. Navigate to All > HR Profile > HR Profiles.
    2. In the list view, select all the HR profiles on which you intend to apply legal hold.
    3. In Actions on selected rows, select Add Legal Hold.
    4. In the Add legal hold dialog box:
      1. In the Reason field, select a value.
      2. In the Comments field, add more details.
      3. Click OK.
      Employee documents of selected HR profiles are placed on legal hold and are not purged based on retention policy.

    Add legal hold to multiple document types

    Add legal hold to multiple document types at one time. Legal or litigation holds prevent the deletion of documents related to a document type.

    Before you begin

    Role required: sn_hr_ef.admin, sn_hr_ef.manager, sn_hr_core.profile_writer, sn_hr_ef.legal_hold_writer

    Procedure

    1. Navigate to All > HR Administration > Document Types.
    2. In the list view, select all documents on which you intend to apply legal hold.
    3. In Actions on selected rows, select Add Legal Hold.
    4. In the Add legal hold dialog box:
      1. In the Reason field, select a value.
      2. In the Comments field, add more details.
      3. Click OK.
      Documents associated with selected Document Types are placed on legal hold and are not purged based on the retention policy.

    View employee document purge logs

    For optimal system performance and depending on your internal processes, employee documentation is purged based on the security policy established by your company.

    Before you begin

    Role required: sn_hr_ef.manager

    About this task

    Purging permanently deletes employee documents from the instance. Purging frees up overall storage.
    • The purge log shows what documents were deleted.
    • Attributes of the deleted documents are stored.
    • The default attributes that identify deleted documents are employee and HR case number. You can change the default in the Properties for Employee Document Management.

    See Properties for Employee Document Management application.

    Procedure

    Navigate to All > HR Administration > Employee Documents > Purge Logs.
    A list of purged documents with the fields specified in the These fields will be included in the purge logs if enabled of Properties for Employee Document Management Application appear.