Action Exécuter une commande utilitaire

L'action Exécuter une commande utilitaire exécute le PlayIt CLI intégré – PlayIt.Cli.exe, situé dans le dossier PlayIt.Cli de votre installation PlayIt Live – avec les paramètres que vous fournissez. Elle est généralement utilisée comme étape dans un événement planifié pour mettre en place des fichiers audio ou des fichiers journaux, par exemple en copiant le dernier enregistrement dans un dossier ou en téléchargeant des fichiers depuis un serveur FTP, avant qu'une autre action ne les importe.

Paramètres

Nom – un libellé pour la commande qui vous permettra de la reconnaître dans la liste des actions.
Paramètres – la ligne de commande transmise au PlayIt CLI : le nom de la commande suivi de ses options (voir ci-dessous).
Attendre la fin – lorsque cette case est cochée, l'événement planifié attend la fin de la commande avant d'exécuter l'action suivante. Cochez cette option lorsqu'une action ultérieure dépend de la présence du fichier.

Chaque commande enregistre sa progression dans le journal des événements, et les fichiers sont copiés ou téléchargés via un fichier temporaire qui est renommé à son emplacement définitif une fois terminé, de sorte qu'un fichier à moitié écrit ne sera jamais récupéré par un dossier surveillé.

Commandes disponibles

copy-file

Copie un seul fichier vers un autre emplacement.

Option	Requis	Description
`--source`	Oui	Le chemin du fichier source.
`--destination`	Oui	Le dossier de destination ou un chemin de fichier complet. Les dossiers manquants sont créés.

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

copy-newest-file

Copie le fichier le plus récent d'un dossier vers un autre emplacement. Utile lorsqu'un système externe écrit un nouveau fichier à chaque fois et que vous n'avez besoin que du plus récent.

Option	Requis	Description
`--source`	Oui	Le dossier source.
`--destination`	Oui	Le dossier de destination ou un chemin de fichier complet.
`--filter`	Non	Un filtre avec caractères génériques pour déterminer quels fichiers prendre en compte, par exemple `*.mp3`.
`--regex-filter`	Non	Un filtre par expression régulière, par exemple `Part [0-9]+`.
`--strategy`	Non	Comment le "plus récent" est déterminé : `LastModifiedDate` (par défaut), `CreatedDate` ou `FileNameAlpha` (ordre alphabétique inverse – utile lorsque les fichiers sont nommés dans un format triable tel que `YYYYMMDDHHMMSS`).

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

download-ftp-file

Télécharge un seul fichier depuis un serveur FTP ou FTPS.

Option	Requis	Description
`--host`	Oui	Le nom d'hôte du serveur.
`--port`	Non	Le numéro de port (par défaut `21`).
`--username`	Non	Le nom d'utilisateur.
`--password`	Non	Le mot de passe.
`--remote-file-path`	Oui	Le chemin du fichier sur le serveur.
`--local-file-path`	Oui	L'emplacement local où enregistrer le fichier.
`--encryption-mode`	Non	Pour FTPS : `None` (par défaut), `Implicit`, `Explicit` ou `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

Télécharge les fichiers d'un répertoire depuis un serveur FTP ou FTPS.

Option	Requis	Description
`--host`	Oui	Le nom d'hôte du serveur.
`--port`	Non	Le numéro de port (par défaut `21`).
`--username`	Non	Le nom d'utilisateur.
`--password`	Non	Le mot de passe.
`--remote-directory-path`	Oui	Le répertoire distant à télécharger.
`--local-directory-path`	Oui	Le dossier local dans lequel télécharger les fichiers.
`--filter`	Non	Un filtre avec caractères génériques pour déterminer quels fichiers télécharger, par exemple `*.mp3`.
`--regex-filter`	Non	Un filtre par expression régulière.
`--encryption-mode`	Non	Pour FTPS : `None` (par défaut), `Implicit`, `Explicit` ou `Auto`.

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

Associez cette action à un dossier surveillé ou à une action Insérer/Importer un journal/une liste de lecture externe pour intégrer automatiquement l'audio copié ou téléchargé dans votre bibliothèque ou votre Playout Log.