Aktion „Dienstprogrammbefehl ausführen"
Die Aktion Dienstprogrammbefehl ausführen führt die integrierte PlayIt CLI – PlayIt.Cli.exe, im Ordner PlayIt.Cli Ihrer PlayIt Live-Installation – mit den von Ihnen angegebenen Parametern aus. Sie wird typischerweise als Schritt in einem geplanten Ereignis verwendet, um Audio- oder Protokolldateien an die richtige Stelle zu bringen, beispielsweise die neueste Aufnahme in einen Ordner zu kopieren oder Dateien von einem FTP-Server herunterzuladen, bevor eine andere Aktion sie importiert.
Parameter
- Name – eine Bezeichnung für den Befehl, damit Sie ihn in der Aktionsliste erkennen können.
- Parameter – die Befehlszeile, die an die PlayIt CLI übergeben wird: der Befehlsname gefolgt von seinen Optionen (siehe unten).
- Auf Abschluss warten – wenn aktiviert, wartet das geplante Ereignis auf den Abschluss des Befehls, bevor die nächste Aktion ausgeführt wird. Aktivieren Sie diese Option, wenn eine spätere Aktion davon abhängt, dass die Datei vorhanden ist.
Jeder Befehl schreibt seinen Fortschritt in das Ereignisprotokoll, und Dateien werden über eine temporäre Datei kopiert oder heruntergeladen, die nach dem Abschluss in den endgültigen Pfad umbenannt wird. Dadurch wird eine halb geschriebene Datei nie von einem überwachten Ordner aufgegriffen.
Verfügbare Befehle
copy-file
Kopiert eine einzelne Datei an einen anderen Speicherort.
| Option | Erforderlich | Beschreibung |
|---|---|---|
--source | Ja | Der Pfad der Quelldatei. |
--destination | Ja | Der Zielordner oder ein vollständiger Dateipfad. Fehlende Ordner werden erstellt. |
copy-file --source "C:\Recordings\latest.mp3" --destination "D:\Playout\Imports"
copy-newest-file
Kopiert die neueste Datei in einem Ordner an einen anderen Speicherort. Nützlich, wenn ein externes System jedes Mal eine neue Datei schreibt und Sie nur die aktuellste benötigen.
| Option | Erforderlich | Beschreibung |
|---|---|---|
--source | Ja | Der Quellordner. |
--destination | Ja | Der Zielordner oder ein vollständiger Dateipfad. |
--filter | Nein | Ein Platzhalterfilter für die zu berücksichtigenden Dateien, z. B. *.mp3. |
--regex-filter | Nein | Ein Filter mit regulären Ausdrücken, z. B. Part [0-9]+. |
--strategy | Nein | Wie „neueste" bestimmt wird: LastModifiedDate (Standard), CreatedDate oder FileNameAlpha (umgekehrt alphabetisch – nützlich, wenn Dateien in einem sortierbaren Format wie YYYYMMDDHHMMSS benannt sind). |
copy-newest-file --source "C:\Incoming\News" --destination "D:\Playout\News.mp3" --filter *.mp3
download-ftp-file
Lädt eine einzelne Datei von einem FTP- oder FTPS-Server herunter.
| Option | Erforderlich | Beschreibung |
|---|---|---|
--host | Ja | Der Hostname des Servers. |
--port | Nein | Die Portnummer (Standard 21). |
--username | Nein | Der Benutzername. |
--password | Nein | Das Passwort. |
--remote-file-path | Ja | Der Pfad der Datei auf dem Server. |
--local-file-path | Ja | Wo die Datei lokal gespeichert werden soll. |
--encryption-mode | Nein | Für FTPS: None (Standard), Implicit, Explicit oder 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
Lädt die Dateien in einem Verzeichnis von einem FTP- oder FTPS-Server herunter.
| Option | Erforderlich | Beschreibung |
|---|---|---|
--host | Ja | Der Hostname des Servers. |
--port | Nein | Die Portnummer (Standard 21). |
--username | Nein | Der Benutzername. |
--password | Nein | Das Passwort. |
--remote-directory-path | Ja | Das herunterzuladende Remote-Verzeichnis. |
--local-directory-path | Ja | Der lokale Ordner, in den die Dateien heruntergeladen werden sollen. |
--filter | Nein | Ein Platzhalterfilter für die herunterzuladenden Dateien, z. B. *.mp3. |
--regex-filter | Nein | Ein Filter mit regulären Ausdrücken. |
--encryption-mode | Nein | Für FTPS: None (Standard), Implicit, Explicit oder Auto. |
download-ftp-directory --host ftp.example.com --username user --password pass --remote-directory-path /adverts --local-directory-path "D:\Playout\Adverts" --filter *.mp3
Kombinieren Sie diese Aktion mit einem überwachten Ordner oder einer Aktion Externes Protokoll/Wiedergabeliste einfügen/importieren, um die kopierten oder heruntergeladenen Audiodateien automatisch in Ihre Bibliothek oder Ihren Playout Log zu importieren.