Community
Connect with us and enhance your M-Files experience using Extension Kit for M-Files. Here is how to get started.

Hello.
We have some issues setting up rule to monitor changes on object document (single-file object in this case). Customer wants to prohibit document content changes and only allow metadata changes on object. If document is changed in specific state a set of actions is executed. We configured orchestrator rule with "File changed" trigger type but rule seems to execute for any change on object. I compared pdf files from source version and version that triggered rule, they are identical and even file hash matches. Please advise on how to properly configure rule for such scenario.
Rule configuration:
Event log how trigger was detected:
026-09-19 20:16:39.5085 (v26.7.0) Unitfly.ExtensionKit.Common.Triggers.FileChangedTrigger Info: "FileChanged trigger" matched. Rule='"sprememba dokumenta pri potrjevalcih"'. Obj="(0-12153)" Ver="(0-12153-16)" Action=ContentUpdated
2026-09-19 20:16:39.5085 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Debug: There are 1 rules to execute on source "(0-12153)": "sprememba dokumenta pri potrjevalcih (runs in BackgroundTransaction mode)".
2026-09-19 20:16:39.5085 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Debug: There are 0 event handler rules to execute on source "(0-12153)": .
2026-09-19 20:16:39.5085 (v26.7.0) MFiles.VAF.AppTasks.TaskManager Info: Task added to queue. Queues:Unitfly.ExtensionKit.VAF.VaultApplication.Rules TaskType:ExecuteRuleTransaction Transactional:True IDs:30375
Our team has investigated the described scenario, but we haven't encountered any issues. The rules are triggered only when the file changes. This includes changes to the file name, but apart from the object name, changes to other properties should not trigger the rule.
Could you please specify whether you've noticed this behavior with a particular property, or whether any property change causes the rule to trigger?
It would also be helpful if you could share the JSON configuration of your rule. That way, I can check whether there are any leftovers from a previous configuration or anything else that might be causing this behavior.
Best regards,
Nika
Hi @nikatilic
We observed that orchestrator triggers rule only when specific multiline text property is set programatically in legacy VAF application (VAF=2.1.0.5) from another related assignment (vault.ObjectPropertyOperations.SetProperty(objVer.ObjVer, SmartUpdateProperty(allComms_PD, allComments, vault));)
Changing that exact comments property manually in m-files client does not trigger orchestrator rule. Any hint what can we check additionally?
Here is also full configuration of orchestrator:
{
"Enabled": true,
"ConfigurationMode": "Advanced",
"RuleGroups": [
{
"Name": "pravni posli",
"Rules": [
{
"Name": "sprememba dokumenta pri potrjevalcih",
"Description": "Če se vsebina dokumenta v času potrejvanja kakorkoli spremeni, je potrebno potrjevanje razveljaviti in ponovno potrditi iz strani vseh potrditeljev.",
"ConfigurationMode": "Advanced",
"Trigger": "FileChanged",
"Source": {
"ObjType": "0",
"Class": "CL.PravniPosliInAkti"
},
"Conditions": {
"BasicConditions": [
{
"ConditionFor": "Source",
"SearchConditions": [
{
"conditionType": "equal",
"expression": {
"type": "propertyValue",
"propertyDef": "{2A9D33A6-E923-411D-A68A-A4BBCB58033A}",
"indirectionLevels": []
},
"typedValue": {
"dataType": "multiSelectLookup",
"value": {
"lookups": [
{
"item": {
"state": "WFS.Pravni posli in akti potek.Pri pregledovalcih"
}
},
{
"item": {
"state": "WFS.PravniPosliPotek.Pravni vidik pregledovalci"
}
}
]
}
}
},
{
"conditionType": "equal",
"expression": {
"type": "propertyValue",
"propertyDef": "PD.DatumVeljavnostiDO",
"indirectionLevels": []
},
"typedValue": {
"dataType": "date",
"value": {
"date": "2016-09-01"
}
}
}
]
}
],
"MathConditions": []
},
"ActAsUser": {
"Type": "LastActualUserModified"
},
"BusinessCritical": true,
"Enabled": true,
"ExecuteWhenConditionsTrue": [
{
"RuleModule": "CopyProperties",
"CopyPropertiesRuleAlias": "NedovoljenaSpremembaDokumenta",
"Name": "Nedovoljena sprememba dokumenta"
}
],
"ExecutionMode": "BackgroundTransaction"
}
],
"Enabled": true
}
]
}
FYI i removed custom code to transfer comment from assignment to related document and configured new rule with Property operation module to do the same. File changed trigger is executed in this case aswell.
Rule configuration:
{
"Name": "transfercomment",
"Description": "transfer comment from separate assignment (CL.Potrjevalci) to related document",
"ConfigurationMode": "Advanced",
"Trigger": "ObjectChanged",
"MonitoredProperties": [
{
"Property": "PD.VsiKomentarji"
}
],
"CopyMode": "FromSourceToTarget",
"Source": {
"ObjType": "{55E1CA21-DE4D-4ED1-A1DD-5EC2E0597E8B}",
"Class": "CL.Potrjevalci"
},
"Target": {
"Reference": "PD.Dokument",
"Properties": [
{
"Property": "PD.VsiKomentarji",
"Value": {
"Mode": "Dynamic",
"DynamicValue": "%PROPERTY_{PD.VsiKomentarji}%"
}
}
]
},
"ExecutionMode": "EventHandler",
"Enabled": true
}
Here is also log execution trace with all rules combined. You can see "File changed" trigger beeing executed within property operation "transfercomment" rule execution.
2026-09-23 13:26:09.3430 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Debug: There are 0 rules to execute on source "(10-7630)": .
2026-09-23 13:26:09.3430 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Checking if object "(10-7630)", version "(10-7630-6)", matches rule source conditions
2026-09-23 13:26:09.3586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Object "(10-7630)", version "(10-7630-6)" matches rule source conditions
2026-09-23 13:26:09.3586 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Executing Property Operations event handler action for object (10-7630), version (10-7630-6)" started
2026-09-23 13:26:09.3586 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Execution of rule for object (10-7630), version (10-7630-6)" started
2026-09-23 13:26:09.3586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Info: "Executing rule transfercomment" started
2026-09-23 13:26:09.3586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Object "(10-7630)", version "(10-7630-6)" matches rule conditions as source.
2026-09-23 13:26:09.3586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get source and target objects for rule transfercomment" started
2026-09-23 13:26:09.3743 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Source object "(10-7630)", version "(10-7630-6)" has 1 targets: "(0-12199)".
2026-09-23 13:26:09.3743 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get source and target objects for rule transfercomment" completed in 00:00:00.0350236
2026-09-23 13:26:09.3743 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get property modifications for rule transfercomment" started
2026-09-23 13:26:09.3743 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get property modifications for rule transfercomment" completed in 00:00:00.0499724
2026-09-23 13:26:09.3743 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Info: "Executing rule transfercomment" completed in 00:00:00.0350100
2026-09-23 13:26:09.3743 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Committing property modifications for rule transfercomment" started
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Common.Triggers.FileChangedTrigger Info: "FileChanged trigger" matched. Rule='"sprememba dokumenta pri potrjevalcih"'. Obj="(0-12199)" Ver="(0-12199-12)" Action=ContentUpdated
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Debug: There are 1 rules to execute on source "(0-12199)": "sprememba dokumenta pri potrjevalcih (runs in EventHandler mode)".
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Debug: There are 1 event handler rules to execute on source "(0-12199)": (Unitfly.ExtensionKit.Modules.Orchestrator.Config.OrchestratorRule`1[Unitfly.ExtensionKit.VAF.Orchestrator.Configuration.OrchestratedRule], Source).
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Executing Orchestrator event handler action for object (0-12199), version (0-12199-12)" started
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Execution of rule for object (0-12199), version (0-12199-12)" started
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Info: "Executing orchestrator rule sprememba dokumenta pri potrjevalcih for (0-12199), version (0-12199-12)" started
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Debug: Conditions matched on source object "(0-12199)", version "(0-12199-12)": false.
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Modules.Orchestrator.OrchestratorModuleBase`1 Info: "Executing orchestrator rule sprememba dokumenta pri potrjevalcih for (0-12199), version (0-12199-12)" completed in 00:00:00.0495703
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Execution of rule for object (0-12199), version (0-12199-12)" completed in 00:00:00.0495235
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Executing Orchestrator event handler action for object (0-12199), version (0-12199-12)" completed in 00:00:00.0495057
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Checking if object "(0-12199)", version "(0-12199-12)", matches rule source conditions
2026-09-23 13:26:10.4368 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Object "(0-12199)", version "(0-12199-12)" does not match rule source conditions
2026-09-23 13:26:10.5774 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Checking if object "(0-12199)", version "(0-12199-12)", matches rule source conditions
2026-09-23 13:26:10.5774 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Object "(0-12199)", version "(0-12199-12)" does not match rule source conditions
2026-09-23 13:26:10.6086 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Info: Rule updated object "(0-12199)", version "(0-12199-12)".
2026-09-23 13:26:10.6086 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Committing property modifications for rule transfercomment" completed in 00:00:01.1834239
2026-09-23 13:26:10.6086 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Execution of rule for object (10-7630), version (10-7630-6)" completed in 00:00:01.1993791
2026-09-23 13:26:10.6086 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Executing Property Operations event handler action for object (10-7630), version (10-7630-6)" completed in 00:00:01.1994061
2026-09-23 13:26:10.8273 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Checking if object "(10-7630)", version "(10-7630-6)", matches rule source conditions
2026-09-23 13:26:10.8430 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Object "(10-7630)", version "(10-7630-6)" matches rule source conditions
2026-09-23 13:26:10.8430 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Executing Property Operations event handler action for object (10-7630), version (10-7630-6)" started
2026-09-23 13:26:10.8430 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Execution of rule for object (10-7630), version (10-7630-6)" started
2026-09-23 13:26:10.8430 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Info: "Executing rule transfercomment" started
2026-09-23 13:26:10.8430 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Object "(10-7630)", version "(10-7630-6)" matches rule conditions as source.
2026-09-23 13:26:10.8430 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get source and target objects for rule transfercomment" started
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: Source object "(10-7630)", version "(10-7630-6)" has 1 targets: "(0-12199)".
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get source and target objects for rule transfercomment" completed in 00:00:00.0396883
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get property modifications for rule transfercomment" started
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Debug: "Get property modifications for rule transfercomment" completed in 00:00:00.0465441
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Modules.PropertyOperations.PropertyOperationsModule Info: "Executing rule transfercomment" completed in 00:00:00.0396738
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Committing property modifications for rule transfercomment" started
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Committing property modifications for rule transfercomment" completed in 00:00:00.0474305
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Execution of rule for object (10-7630), version (10-7630-6)" completed in 00:00:00.0396305
2026-09-23 13:26:10.8586 (v26.7.0) Unitfly.ExtensionKit.Module.Modules.TriggerBased.TriggerBasedModule`4 Debug: "Executing Property Operations event handler action for object (10-7630), version (10-7630-6)" completed in 00:00:00.0396060
We tested the described scenario, and I can confirm the reported bug. The fix has been added to our roadmap and will most likely be included in our October release. Thank you for reporting the issue and for providing us with all the necessary details!



