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
- 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.
- While the request is pending, the portal shows the employee their version of the data.
- HR opens the request, compares the current and the requested values, and approves or rejects it.
- 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
| Entity | Data in Business Central |
|---|---|
| Education | the person's education |
| Family Member | the person's relatives |
| Document | the person's identity documents; the files of the request are added as attachments of the document |
| Photo | the 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.
| Field | Description |
|---|---|
| Entry No. | The number of the change request. |
| Created At | When 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. |
| Entity | Which data the request changes: Education, Family Member, Document or Photo. |
| Operation | Insert, Modify or Delete of a record. |
| Description | A summary of the change: the entity, the record and the operation. |
| Status | Pending, Approved (the change was applied), Rejected or Cancelled. |
| Rejection Reason | Why HR rejects the request. Filled in before rejecting. |
| No. of Attachments | How many files are attached to the request. |
| Decided At, Decided By | When 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
| Action | Description |
|---|---|
| Approve | Applies the requested change to the person's data. |
| Reject | Rejects the request. Fill in the Rejection Reason field first. |
| Cancel Request | Cancels the request without applying it, for example when it is no longer relevant. |
| Person | Opens the card of the person whose data the request changes. |
| Show Payload | Shows 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).