xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/KPI Configuration — entity reference
REFERENCE · Last reviewed

KPI Configuration — entity reference

A measure an incentive plan can pay on. When the configuration is active and names an object in Trigger Object Name, saved records of that object that pass its KPI rules are accrued by a background job (Accrue KPI configuration data) into KPI Data rows: one per configuration, approved plan, open period and member, holding the value sum, record count and reward sum. Incentive targets linked to the configuration are scored from those rows by Process Compensation. A configuration with no Trigger Object Name accrues nothing and only labels and groups targets and quotas. Approved and Posted periods are never changed, and re-saving or deleting a record corrects its own contribution.

Fields

FieldLabelTypeRequiredWhat it does
AccountFieldNameAccount Field NameTextThe technical name of the customer field to credit when Member Type is Customer, for example AccountId.
AccountGroupIdAccount GroupLookup → AccountGroupIntended customer-group scope. Not read by the accrual.
BranchFieldNameBranch Field NameTextThe technical name of the branch field to credit when Member Type is Branch, for example BranchId.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DateFieldNameDate Field NameTextYesThe technical name of the date that places each record in an incentive period, for example DocumentDate. Required; a record without a date counts nowhere.
FirstNRecordsInclude First N RecordsNumberIntended sampling limit. Not read by the accrual.
IdIdGuidYes
IncludeChildResourcesInclude Child ResourcesBooleanYesIntended roll-up of subordinates' figures to their manager. Not read by the accrual.
IncludeLastNRecordsInclude Last N RecordsNumberIntended sampling limit. Not read by the accrual.
IsActiveIs ActiveBooleanYesWhether the configuration accrues. Only active configurations with a Trigger Object Name accrue KPI Data; turning it off stops accrual and keeps existing KPI Data, which linked targets still score from.
IsGroupIs GroupBooleanYesMarks a grouping configuration. Not read by the accrual or by scoring.
ItemFieldNameItem Field NameTextThe field naming the record's item. Stored only; the accrual does not read it.
ItemGroupIdItem GroupLookup → ItemGroupIntended item-group scope. Not read by the accrual.
JobQueueIdJob QueueLookup → InterfaceQueueA job tracking link. Not read when KPI Data is accrued.
KPIConfigurationIdKPI ConfigurationLookup → KPIConfigurationA parent configuration, for grouping. Not read by the accrual or by scoring.
KPINameKPI NameTextThe display name plan authors see when they pick the configuration on a target. Also used as the label of new KPI Data rows.
LastExecutedSystemModstampLast Executed System ModstampDateAndTimeThe progress marker for scheduled accrual: the start time of the last fully successful scheduled run. The next run reads records changed after it.
MemberTypeMember TypePickListYesWho gets the credit: Resource, Partner, Branch or Customer (Account is accepted as Customer). Decides which member field is read. Must match the incentive plan's Member Type, because scoring finds the member's KPI Data row by the plan's type. Values: Branch, Resource, Customer.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYesThe record name. Filled from the KPIC document numbering series only when that numbering setting is switched on (it is off in the standard setup); otherwise it must be supplied, and the standard create form has no Name box.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountGroupIdAccount GroupLookup → AccountGroupIntended company-group scope. Not read by the accrual.
PartnerFieldNamePartner Account Field NameTextThe technical name of the company field to credit when Member Type is Partner, for example PartnerAccountId.
RecordTypeIdRecord TypeGuid, hidden
ResourceFieldNameResource Field NameTextThe technical name of the person field to credit when Member Type is Resource, for example SalesExecutiveResourceId on Invoice. May follow a lookup, such as InvoiceId.SalesExecutiveResourceId on a line.
ResultRewardFieldNameFormula Reward Field NameTextThe KPI Data field read as the reward when Reward Function is Formula.
ResultValueFieldNameFormula Value Field NameTextThe KPI Data field read as the achieved value when Value Function is Formula. The accrual fills only KPI Value Sum, KPI Value Count and Reward Value Sum.
RewardFieldNameReward Field NameTextThe technical name of a numeric field carrying a reward on each record. Summed into the KPI Data row's Reward Value Sum, which slabs of type KPI Reward Value or KPI Reward Value Percentage pay from.
RewardFunctionReward FunctionPickListHow the reward figure is worked out from the KPI Data row, with the same choices as Value Function; empty or Sum = Reward Value Sum. A Custom Reward Value typed on the row above 0 wins. Values: Sum.
RuleSuccessCriteriaRule Success CriteriaPickListHow the configuration's KPI rules combine: empty or Always (No Criteria) ignores the rules and counts every record; All Rules Are Met, Any Rule Is Met or Custom Logic Is Met apply them. A rule that cannot be read makes the whole configuration skip, with the reason in the job summary. Values: Always (No Criteria).
RuleSuccessCustomLogicRule Success Custom LogicTextThe rule combination for Custom Logic Is Met, such as {0} AND ({1} OR {2}), where {0} is the first rule by Sequence Number. Only {N}, AND, OR, NOT and parentheses are allowed.
TriggerEventTrigger EventPickListWhich saves of the object accrue: AFTER_INSERT (new records), AFTER_UPDATE (changes), AFTER_UPSERT or AFTER_ALL (both), Scheduled (only from a scheduled Accrue KPI configuration data job). An empty value or AFTER_DELETE accrues nothing on save. Deleted records give their contribution back whatever this is set to, while an active configuration measures the object. Values: Scheduled, AFTER_INSERT, AFTER_UPDATE, AFTER_DELETE.
TriggerObjectNameTrigger Object NameTextThe technical name of the entity whose records are measured, for example Invoice or ServiceOrder. Typed, not picked. Leave it empty for a configuration that only groups targets.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
ValueFieldNameValue Field NameTextThe technical name of the numeric field whose values are measured, on the object or through a lookup (InvoiceId.TotalLineAmount). For the Count Distinct function it is the key whose distinct values are counted, such as AccountId. On the standard form it is the second box labelled Value Field Name.
ValueFieldName2Value Field NameTextA second numeric value read from each record and stored on its KPI Data detail. It is not rolled up or used for scoring. On the standard form it is the first box labelled Value Field Name.
ValueFunctionValue FunctionPickListHow a member's figure is worked out from the KPI Data row: empty or Sum = KPI Value Sum, Count = number of records, Average = sum divided by count, Formula = the KPI Data field named in Formula Value Field Name, Count Distinct = number of distinct Value Field Name values. A Custom KPI Value typed on the row above 0 wins. Values: Count, Average, Formula.

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditInLineEditEditEdit
NewNewNewNew