Triggering FileCopy jobs via commands
FileCopy jobs can be triggered via commands from other PlayoutONE applications like Data Controller, allowing stations to automate tasks which would otherwise need to be done manually.
🚦 Commands
FileCopy can execute the following commands:
| Start job | filecopy_startjob=[A job's Public ID] |
| Stop job | filecopy_stopjob=[A job's Public ID] |
| Start recording | filecopy_startrecording=[A job's Public ID] |
| Pause recording | filecopy_pauserecording=[A job's Public ID] |
| Resume recording | filecopy_resumerecording=[A job's Public ID] |
| Stop recording | filecopy_stoprecording=[A job's Public ID] |
| Cart number | cartnumber=[optional UID you want the item to have] |
For example, a command with an automatically generated Public ID, imported with the LatestNews UID could be started using the following command:
filecopy_startjob=90354dce-026e-424a-8ea2-550ab7c34ddc&cartnumber=LatestNews
📡 Triggering a command via Data Controller
You can also trigger commands to execute when an incoming signal is received in Data Controller. Just select the appropriate Outgoing Command and specify which job you want to trigger:
⚙️ Configuring FileCopy to receive TCP/HTTP commands
You can also trigger commands without using Data Controller. Firstly, open FileCopy and set up the job/action as you need. The Public ID can be changed if you want to make the command easier to identify, but each job must have a unique public ID.
In the Schedule tab, set the job to run On Demand, as an external signal will trigger it.
If you are setting up your first command-triggered job, go to FileCopy's Settings, click 'Connectivity', then make sure the TCP Server is enabled and the correct port is selected:
Once that is done, the next step will be setting up your command.
⌨️ Triggering a TCP/IP command
In PlayoutONE, open the Command Manager and create a new IP Command:
| Friendly Name | An easy-to-recognise name for the command |
| IP / Host | The IP address or hostname of the computer FileCopy is running on |
| Port | The port number FileCopy's TCP server is monitoring (The default is 7008) |
| Command | The command you want FileCopy to execute |
🌐 Triggering a HTTP command
As well as using Data Controller or IP commands, you can also enable FileCopy's HTTP server from the Connectivity screen shown above and receive commands via any HTTP client.
These should be directed to the IP address or hostname of the computer running FileCopy, including the open HTTP port (the default is 8085) like:
http://P1-XMPL-SRV1:8085?filecopy_startjob=90354dce-026e-424a-8ea2-550ab7c34ddc