Table of Content
Apply an automatic rule to existing events
Definition
Available in the Replay and Live workspaces this feature can be used to process events from a tagged video or recording, and perform the following actions:
- Add events to a specific montage
- Export events as clips in the background
- Publish events on a Telegram channel (see the Telegram section)
This processing is based on rules, and there are two categories of rules that you can apply to events
Manual rules are the actions that are applied to a list of events selected manually. Pick events in the event pane, click on the rule in the event pane header and those events will be processed. There are two default manual rules: "Add to current montage" and "Export in background". Add more manual rules and add events to different montages. In myDartfish Pro S, publish events to Telegram (see this article for more information).
Automatic rules are applied automatically if an event meets a condition based on its keywords. Automatic rules are available in myDartfish Pro S. Activate the automation, define the rule and every new event that meets the keyword requirements will be processed. You can also apply an automatic rule on existing events by selecting all of them and the running the rule.
Create a rule
- Tick the Rule Monitoring box and click on Manage Rules
- Open the Automatic Rules tab and click on New Rule
- Set the criteria that the events need to meet in order to be processed by the rule
- In the below example, the rule will apply to all the events that have the keyword "Foul" from the category "Last Play" and the keyword "Att 1/3" from the category "Field Zone"
- You can create rules in which events must meet all the criteria, only one of them or a combination of both
- Click on the "+" to add a new criteria
- Criterias can be based on keywords, but also on event name, description and color
Tip: when creating a rule, open a tagged video. That way, a drop-down menu will be available in the Rule Editor when selecting keywords and keyword categories
- When the criteria are defined, set the actions that will be performed. You can have more than one action by clicking on the "+"
- Click on OK to save the rule
- To activate the rule, tick the rule's checkbox and also the Enable Automatic Rules Monitoring. This allows you to prepare several rules and only use some of them based on the situation.
- Click on Close. Now, the rule is active and will apply on any new event that meets the criteria
Rules and Continuous Events
A continuous event can only be processed by a rule once the event is over and its out point is known
An automatic rule applies as soon as its set of conditions is met. Everything is pretty simple with fixed duration events. The event is created and immediately has a position and duration. However, it is not as simple with continuous events.
A continuous event is an event whose duration is only known when the event is ended by the tagger. Until that point, an artificial 0 second duration is set by Dartfish. If we now consider automatic rules, it means that the set of condition of a rule can be met while the continuous event is not ended and still has a 0 second duration. In that case, the rule will not work. To combine rules and continuous events, you have to ensure that last condition is met only after the event has ended. This can be done by adapting the tagging panel and ending the event before adding the last keyword.
Apply an automatic rule to existing events
An automatic rule is applied to any new event from the moment it has been enabled. If you want to apply the rule to events that are already tagged:
- Select all the events in the event pane (use the hotkey Ctrl+A to do it faster)
- Click on Manage Rules to open the Automation Rule Manager
- Open the Automatic Rules tab
- Select the rule in the table
- Click on Run Now
The rule is applied and a message summarizes how many events are processed.
Publish events on Telegram
One of the action a rule can perform is to publish the event meeting the condition on a Telegram channel. This requires admin access to a Telegram channel, a Telegram Bot and other information. Read this tutorial to see how to set up the Telegram channel and create the rule in Dartfish software