Actie Hulpprogrammaopdracht uitvoeren

De actie Hulpprogrammaopdracht uitvoeren voert de ingebouwde PlayIt CLI uit – PlayIt.Cli.exe, te vinden in de map PlayIt.Cli van uw PlayIt Live-installatie – met de parameters die u opgeeft. Deze actie wordt doorgaans gebruikt als stap in een gepland evenement om audio- of logbestanden op de juiste plaats te krijgen, bijvoorbeeld door de nieuwste opname naar een map te kopiëren of bestanden van een FTP-server te downloaden, voordat een andere actie ze importeert.

Parameters

Naam – een label voor de opdracht zodat u deze kunt herkennen in de actielijst.
Parameters – de opdrachtregel die aan de PlayIt CLI wordt doorgegeven: de opdrachtnaam gevolgd door de opties (zie hieronder).
Wacht op voltooiing – wanneer aangevinkt, wacht het geplande evenement tot de opdracht klaar is voordat de volgende actie wordt uitgevoerd. Vink dit aan wanneer een latere actie afhankelijk is van de aanwezigheid van het bestand.

Elke opdracht schrijft de voortgang naar het gebeurtenislogboek, en bestanden worden gekopieerd of gedownload via een tijdelijk bestand dat na voltooiing wordt hernoemd naar de definitieve locatie, zodat een half geschreven bestand nooit wordt opgepikt door een bewaakte map.

Beschikbare opdrachten

copy-file

Kopieert een enkel bestand naar een andere locatie.

Optie	Vereist	Beschrijving
`--source`	Ja	Het pad van het bronbestand.
`--destination`	Ja	De doelmap of een volledig bestandspad. Ontbrekende mappen worden aangemaakt.

copy-file --source "C:\Recordings\latest.mp3" --destination "D:\Playout\Imports"

copy-newest-file

Kopieert het nieuwste bestand in een map naar een andere locatie. Handig wanneer een extern systeem elke keer een nieuw bestand schrijft en u alleen het meest recente wilt.

Optie	Vereist	Beschrijving
`--source`	Ja	De bronmap.
`--destination`	Ja	De doelmap of een volledig bestandspad.
`--filter`	Nee	Een jokertekenfilter voor de te beschouwen bestanden, bijvoorbeeld `*.mp3`.
`--regex-filter`	Nee	Een filter met reguliere expressies, bijvoorbeeld `Part [0-9]+`.
`--strategy`	Nee	Hoe "nieuwste" wordt bepaald: `LastModifiedDate` (standaard), `CreatedDate` of `FileNameAlpha` (omgekeerd alfabetisch – handig wanneer bestanden zijn benoemd in een sorteerbaar formaat zoals `YYYYMMDDHHMMSS`).

copy-newest-file --source "C:\Incoming\News" --destination "D:\Playout\News.mp3" --filter *.mp3

download-ftp-file

Downloadt een enkel bestand van een FTP- of FTPS-server.

Optie	Vereist	Beschrijving
`--host`	Ja	De hostnaam van de server.
`--port`	Nee	Het poortnummer (standaard `21`).
`--username`	Nee	De gebruikersnaam.
`--password`	Nee	Het wachtwoord.
`--remote-file-path`	Ja	Het pad van het bestand op de server.
`--local-file-path`	Ja	Waar het bestand lokaal moet worden opgeslagen.
`--encryption-mode`	Nee	Voor FTPS: `None` (standaard), `Implicit`, `Explicit` of `Auto`.

download-ftp-file --host ftp.example.com --username user --password pass --remote-file-path /news/bulletin.mp3 --local-file-path "D:\Playout\bulletin.mp3"

download-ftp-directory

Downloadt de bestanden in een map van een FTP- of FTPS-server.

Optie	Vereist	Beschrijving
`--host`	Ja	De hostnaam van de server.
`--port`	Nee	Het poortnummer (standaard `21`).
`--username`	Nee	De gebruikersnaam.
`--password`	Nee	Het wachtwoord.
`--remote-directory-path`	Ja	De externe map die moet worden gedownload.
`--local-directory-path`	Ja	De lokale map waarin de bestanden worden gedownload.
`--filter`	Nee	Een jokertekenfilter voor de te downloaden bestanden, bijvoorbeeld `*.mp3`.
`--regex-filter`	Nee	Een filter met reguliere expressies.
`--encryption-mode`	Nee	Voor FTPS: `None` (standaard), `Implicit`, `Explicit` of `Auto`.

download-ftp-directory --host ftp.example.com --username user --password pass --remote-directory-path /adverts --local-directory-path "D:\Playout\Adverts" --filter *.mp3

Combineer deze actie met een bewaakte map of een actie Extern log/afspeellijst invoegen/importeren om de gekopieerde of gedownloade audio automatisch in uw bibliotheek of Playout Log te importeren.