Script de copie — structure et commandes

TABLE DES MATIÈRES

• Introduction
• Fichier script.txt
• Section d’en-tête [HEADER]
• Section de commandes [COMMANDS]
• E.IV. Section de commentaires [COMMENTS]
• E.V. Exemples
  • Exemple 1 – Script complet
  • Exemple 2 – Script minimal
• 
  
  • Exemple 2 – Script minimal

Introduction

La fonction « Script » est utilisée pour la gestion du contenu à partir de :

• Un périphérique de stockage tiers, voir : Utilisation d’un script de copie avec un périphérique de stockage amovible (page 48).
• Un serveur FTP, voir : Utilisation d’un script de copie avec un serveur FTP (page 47).

Le principe consiste à gérer le contenu du Main Media à l’aide d’un fichier de script de copie (script.txt) et du nouveau contenu à ajouter. Ce fichier décrit :

• Quels fichiers et dossiers seront créés, supprimés ou renommés sur le Main Media.
• Quels fichiers et dossiers seront ajoutés au Main Media depuis le nouveau contenu.
• Il peut également fournir des informations complémentaires comme la date, le nom et la version de la mise à jour.

3 méthodes pour créer un script de copie

Fichier script.txt

• Format : Fichier texte brut (sans formatage), nommé script.txt.
• Encodage : ANSI (jeu de caractères ASCII 7 bits uniquement).
• Caractères autorisés:

  0-9, A-Z, a-z, ! # $ % & ' ( ) + , - . ; = @ [ ] ^ _ ` { } ~ (Espace)

• Structure: 3 sections possibles :
  1. [HEADER] (optionnelle) : Métadonnées (nom, date, version).
  2. [COMMANDS] (obligatoire) : Commandes de gestion des fichiers/dossiers.
  3. [COMMENTS] (optionnelle) : Commentaires libres.

Règles générales :

• Les lignes commençant par * sont des commentaires (ignorées).
• Les lignes vides sont ignorées.
• Les paramètres vides sont ignorés ou remplacés par des valeurs par défaut.
• Une seule commande par ligne.

Section d’en-tête [HEADER]

Fournit des informations affichées sur la page d’accueil du serveur Web embarqué (voir : Page d’accueil, page 83). Format : NOM_INFORMATION=valeur

Note : Si le script est interrompu, les informations de l’en-tête ne seront pas mises à jour.

Section de commandes [COMMANDS]

Décrit les actions à exécuter sur les fichiers/dossiers du Main Media. Format : COMMANDE "paramètre1" "paramètre2" ... Chemin : Commence par \ (ex: \MUSIC\Dossier).

Section de commentaires [COMMENTS]

Zone libre pour ajouter des notes ou des informations supplémentaires.

Exemples

Exemple 1 – Script complet

[HEADER]
UPDNAME=MY UPDATE
UPDDATE=26/01/17
UPDVERSION=V02.10

[COMMANDS]
DEL "\MUSIC\MUS067 Jazz"
COPY "\New Soul" "\MUSIC\MUS045 New Soul"
DEL "\MUSIC\MUS002 Rock\80s\Magic Song.mp3"
REN "\PLAYLIST\PLS001 New" "\PLAYLIST\PLS200 Saved"
COPY "\New Playlist" "\PLAYLIST\PLS001 New"
MKDIR "\SPOT\SPT151 Adv 2017"
COPY "\Advertising 2017\First Adv 2017.mp3" "\SPOT\SPT151 Adv 2017"
COPY "\Advertising 2017\Second Adv 2017.mp3" "\SPOT\SPT151 Adv 2017"

[COMMENTS]
The Smart Company
Copyright © 2017
New advertising campaign for shopping centers

Dans cet exemple :

1. Des informations d’en-tête (nom, date, version) sont transmises au lecteur.
2. Le sous-dossier MUS067 Jazz est supprimé.
3. Le dossier New Soul est copié vers \MUSIC\MUS045 New Soul.
4. Le fichier Magic Song.mp3 est supprimé.
5. Le dossier PLS001 New est renommé en PLS200 Saved.
6. Le dossier New Playlist est copié vers \PLAYLIST\PLS001 New.
7. Un nouveau dossier SPT151 Adv 2017 est créé.
8. Les fichiers First Adv 2017.mp3 et Second Adv 2017.mp3 sont copiés vers \SPOT\SPT151 Adv 2017.
9. Des commentaires sont ajoutés.

Exemple 2 – Script minimal

[COMMANDS]
DELALL
COPYALL

Effet :

1. Tous les fichiers et dossiers du Main Media sont supprimés.
2. Tous les fichiers et dossiers de la source sont copiés dans le Main Media.