xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse 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
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 KPI definition - the catalog row that names a measurable performance indicator (kpiName, label) and declares where its numbers come from: triggerObjectName/triggerEvent point at the source entity and event, and the *FieldName pointers (accountFieldName, branchFieldName, dateFieldName, itemFieldName, partnerFieldName, resourceFieldName, valueFieldName/valueFieldName2 with valueFunction, rewardFieldName with rewardFunction) map source-entity fields into the KPI dimensions and measures. Child KPIRules rows add filter conditions on the source records. Definitions can be grouped hierarchically: kPIConfigurationId points at a parent configuration and isGroup marks group nodes. Scoping lookups restrict applicability (accountGroupId, partnerAccountGroupId, itemGroupId). This is the KPI that Rewards configuration points at: IncentiveTarget, IncentiveResourceTarget, CompensationLine and CompensationSlab rows all carry a kpiConfigurationId identifying which KPI their target or slab measures. Aggregated results land in KPIData rows (kpiConfigurationId links back); lastExecutedSystemModstamp records the high-water mark of the last calculation pass.

Fields

FieldLabelTypeRequiredWhat it does
AccountFieldNameAccount Field NameText
AccountGroupIdAccount GroupLookup → AccountGroup
BranchFieldNameBranch Field NameText
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DateFieldNameDate Field NameTextYes
FirstNRecordsInclude First N RecordsNumber
IdIdGuidYes
IncludeChildResourcesInclude Child ResourcesBooleanYes
IncludeLastNRecordsInclude Last N RecordsNumber
IsActiveIs ActiveBooleanYes
IsGroupIs GroupBooleanYes
ItemFieldNameItem Field NameText
ItemGroupIdItem GroupLookup → ItemGroup
JobQueueIdJob QueueLookup → InterfaceQueue
KPIConfigurationIdKPI ConfigurationLookup → KPIConfigurationSelf-referencing parent lookup: points at a parent KPIConfiguration, building a group hierarchy of KPI definitions (isGroup marks the group nodes). Not to be confused with the field of the same name on KPIData/KPIRules, where it links a result or rule to its definition.
KPINameKPI NameText
LastExecutedSystemModstampLast Executed System ModstampDateAndTime
MemberTypeMember TypePickListYesValues: Branch, Resource, Customer.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextYes
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountGroupIdAccount GroupLookup → AccountGroup
PartnerFieldNamePartner Account Field NameText
RecordTypeIdRecord TypeGuid, hidden
ResourceFieldNameResource Field NameText
ResultRewardFieldNameFormula Reward Field NameText
ResultValueFieldNameFormula Value Field NameText
RewardFieldNameReward Field NameText
RewardFunctionReward FunctionPickListValues: Sum.
RuleSuccessCriteriaRule Success CriteriaPickListValues: Always (No Criteria).
RuleSuccessCustomLogicRule Success Custom LogicText
TriggerEventTrigger EventPickListValues: Scheduled, AFTER_INSERT, AFTER_UPDATE, AFTER_DELETE.
TriggerObjectNameTrigger Object NameText
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
ValueFieldNameValue Field NameText
ValueFieldName2Value Field NameText
ValueFunctionValue FunctionPickListValues: Count, Average, Formula.

Actions

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