Skip to main content

Personal Data Changes from the Portal

Extension - SMART Employee Self-Service (add-on to SMART Payroll)

In the portal, an employee can add, change and delete records of their education, family members and identity documents (with attached files), and change their profile photo. These changes are not written to Business Central at once: each of them arrives as a change request that HR reviews. Only an approved change is applied to the person's data.

Changes of the employee's own contact data (phone, address, name) are not sent as change requests.

How it works​

  1. The employee saves a change in the portal. The synchronization service creates a change request with the Pending status in Business Central; files are added to a request that changes a document or the photo.
  2. While the request is pending, the portal shows the employee their version of the data.
  3. HR opens the request, compares the current and the requested values, and approves or rejects it.
  4. After the next synchronization, the portal shows the result:
    • Approved — the change was applied to the person's data, and the portal shows the data from Business Central.
    • Rejected — the portal shows the data from Business Central again: a new record disappears, a changed record gets its previous values back, a deleted record returns.

If the employee changes the same record again while the previous request is pending, the previous request gets the Cancelled status, and the files of a document request move to the new request. If the employee deletes a record that has not been approved yet, the request to add it is cancelled.

What an approved request changes​

EntityData in Business Central
Educationthe person's education
Family Memberthe person's relatives
Documentthe person's identity documents; the files of the request are added as attachments of the document
Photothe person's picture; Payroll copies it to the cards of the person's employees

A request is applied completely or not at all: if a value does not pass the Business Central validation, the error is shown, nothing is changed, and the request stays Pending.

Portal Change Requests page​

Path: Self-Service Portal Setup — the Portal Change Requests action. On the person card, the Portal Change Requests action opens only the requests of that person.

The list opens filtered on the Pending status; the Show All action shows the requests in all statuses. The files of the selected request are shown in the FactBox.

FieldDescription
Entry No.The number of the change request.
Created AtWhen the request was received from the portal.
Employee No.The employee who requested the change in the portal.
Person No.The person whose data the request changes.
EntityWhich data the request changes: Education, Family Member, Document or Photo.
OperationInsert, Modify or Delete of a record.
DescriptionA summary of the change: the entity, the record and the operation.
StatusPending, Approved (the change was applied), Rejected or Cancelled.
Rejection ReasonWhy HR rejects the request. Filled in before rejecting.
No. of AttachmentsHow many files are attached to the request.
Decided At, Decided ByWhen and by whom the request was approved, rejected or cancelled. If the employee cancelled the request, Decided By is empty.

Request card​

The Requested Changes group shows the fields of the request with the captions of the Business Central fields: the Current Value of the record and the Requested Value. A modification shows only the fields that change, a deletion shows the current values of the record. The files of the request are shown in the Files part; the Download action opens a file.

The portal does not always send the relative code of a new family member or the person document type of a new document. In that case, fill in the Relative Code or Person Document Type field on the card of the pending insert request — without them, the request cannot be approved.

Actions​

ActionDescription
ApproveApplies the requested change to the person's data.
RejectRejects the request. Fill in the Rejection Reason field first.
Cancel RequestCancels the request without applying it, for example when it is no longer relevant.
PersonOpens the card of the person whose data the request changes.
Show PayloadShows the requested values as they were received from the portal (JSON).

Permissions​

Assign the ESS Portal HR Approval (SMA ESS PORTAL HR) permission set to the HR staff who review the requests, in addition to their usual permission sets (see Permission Sets).

© 2008 - 2026 SMART business