External Systems Integration Parameters Page

Use the External systems integration parameters page to set up the parameters for enabling integration of Anthology Finance & HCM with external systems subscribed to Anthology Finance & HCM Azure Service Bus (ASB) topics.

Access Method

Click Modules > Human resources > Integration with external systems > Setup > External systems integration parameters

Roles and Privileges

  • Human resource assistant / Human resource manager - To view the Integration with external systems menu in the Human resources module.

  • Human resource manager / System administrator / Payroll administrator- To set up the parameters for enabling integration with external systems for all legal entities and enable the options to use the accruals data from external systems.

Task(s) that use this Form

The following tables provide descriptions of controls on this page.

Integration with external systems Tab

Field Description
Enable integration with external systems Indicates whether the integration is enabled for external systems subscribed to Anthology Finance & HCM Azure Service Bus topics.

It has the following values:

  • Yes - Indicates the integration is enabled.
  • No - Indicates the integration is disabled. It is the default value.

When this field is set to Yes, the following tab / fields become available for editing:

Field / tab namePage nameNavigation path

  • OT1

  • OT2

Positions pageHuman resources > Positions > Positions > Select a position from the list
Manage changes pagePayroll > Positions > Positions > Changes timeline > Manage changes > Payroll tab
Earning code typeEarning Codes pagePayroll > Setup > Earnings > Earning Codes
Benefit accruals from an external system tabPay Statement pagePayroll > Pay statements > All pay statements > click on a Pay statement number from the list
Integration setting
Connection string for Azure Service Bus The connection string generated for the Azure Service Bus (ASB) namespace.
Topics and Subscriptions
HUMAN RESOURCE
Topic name for human resource records The ASB topic name for sending the human resource records.
Topic name for the acknowledgment of human resource records The ASB topic name for receiving the acknowledgment of human resource records.
Subscription name for the acknowledgment of human resource records The subscription name for the acknowledgment of human resource records.
PAYROLL
Topic name for payroll records The ASB topic name for receiving the payroll records.
Subscription name for payroll records The subscription name for payroll records.
Topic name for the acknowledgment of payroll records The ASB topic name for sending the acknowledgment of payroll records.
Human resources and Payroll publishing date interval  
Date interval code

Select the date interval that you configured to define the date range of records to publish to external systems.

Note: This field is editable.

See Date interval topic to configure this date range.
Description Displays the description for selected Date interval.
From Date

Displays the From date as calculated from the selected Date interval.
To Date Displays the To date as calculated from the selected Date interval.
 

Warning Messages upon selecting Date Interval:

  • If a you select a date interval that does not include the current date, then the system displays an alert saying "You must select a date interval that includes the current date."

    • Note: The date entered will be saved.

  • If you modify the settings, the system displays an alert message "Because you are changing the date range covered by the integration, you should schedule a Full run of Send human resource records using the button in the 'Configure synchronization' section of this form."
Configure synchronization  
Send human resource records Opens the Send human resource records page to configure the parameters and recurrence for the batch job.

This batch job sends human resource records to ASB.

Note: The size of the messages that are sent are dynamically retrieved from the table and not set as a static value.

For more information, see Enable Integration with External Systems Subscribed to ASB Topics.
Get acknowledgment for human resource records Opens the Get acknowledgment for human resource records page to configure the recurrence for the batch job.

This batch job gets the acknowledgment details for the human resource records from ASB.

Get payroll records Opens the Get payroll records page to configure the recurrence for the batch job.

This batch job gets the payroll records from ASB.

The 'Get payroll records' process retrieves EarningLines records from the ASB, which may include hours-based, unit-based, or amount-based codes. If an earning line record is linked to a position designated as an FWS position, the process generates FWS earning lines. However, it is important to note that unit-based or amount-based earning codes are considered as invalid by this process.
Send acknowledgement for payroll records Opens the Send acknowledgement for payroll records page to configure the recurrence for the batch job.

This batch job sends acknowledgment details for the earning lines and accrual lines to ASB in the following scenarios:

  • When new / updated / canceled earning lines are received from external systems.

  • When new / updated accrual lines are received from external systems.

  • When earning lines from external systems are processed (i.e., pay statement is generated and submitted) in Anthology Finance & HCM.

The batch job displays the following validations on Quantity, EarningRate and Amount on the earning code's unit type. The corresponding messages are listed below:

Earning Unit TypeError Validation Message

 

Amount

Quantity is null or 0"[EarningCodeID]” is amount-based on [EarningDate]. Quantity is not either 0 or null.
EarningRate is not either 0 or null “[EarningCodeID]” is amount-based on [EarningDate]. Earning rate must be 0 or null.
Amount is null or 0 “[EarningCodeID]” is amount-based on [EarningDate]. Amount must have a non-zero value.
HoursQuantity is null or 0“[EarningCodeID]” is hours-based on [EarningDate]. Quantity must have a non-zero value.
UnitsQuantity is null or 0“[EarningCodeID]” is unit-based on [EarningDate]. Quantity must have a non-zero value.

Accruals data from external systems Tab

Field Description
Enable processing of accruals data for payroll Indicates whether the accruals data from external systems must be used for processing the payroll.

It has the following values:

  • Yes
    • Enables the Review availability of accruals data option in the Earning Lines From External Systems Page.
    • Displays accruals data in the Benefit accruals from an external system, when pay statement for an employee with earning lines from external system is submitted.
  • No