FicUtils 3.11 XCMD (octobre 2005)

Scripts Ficutils

Copie de fichier/dossier
Créer dossier
Déplacer
Détruire fichier ou dossier
Etat flags fichier
Modifier flags fichier
Informations fichier / dossier
Suppression Resource Fork
Lire et écrire Alias
Liste des dossiers
Liste des fichiers
Modifier Type, Creator ou Date
Renommer
Volumes
Copie et sauvegarde incrémentale
Mise à jour date d'un dossier

Des handlers d'intérêt général sonts présents dans la pile, de sorte qu'en mettant cette pile « in use » vous pouvez en bénéficier sans réécrire une ligne...
Pour interpréter les codes d'erreur retournés par le File Manager, utilisez la fonction LibErrHFS présente dans le script de la pile.

Programmation

FicUtils est une commande externe « à tout faire » qui requiert 1 à 4 paramètres selon l'usage. Le premier est le « sélecteur » - obligatoire dans tous les cas - qui peut prendre les valeurs suivantes :

SélecteurParamètres 2 à 4Description
> Rend la liste des volumes montés sur le bureau.
Chaque ligne contient :
- le nom du volume
- le n° de driver : ceci permet de différencier un disque dur, un CD-ROM, un volume réseau, une disquette, etc.
- l'état de verrouillage en écriture du volume : (true ou false).
AAliasFilePath,Mode,AliasIDLit l'alias AliasId dans le fichier AliasFilePath.
AliasFilePath : chemin d'accès au fichier qui contient les alias.
AliasID est l'ID de la ressource alias 'alis'.
Mode (en lecture) contient deux paramètres facultatifs :
- info restituée permet de ne récupérer que le nom, le serveur ou la zone sur lesquels pointe l'alias : par défaut les trois sont restitués.
- Resolve on peut en passant "dontresolve" dans ce paramètre demander à l'Alias Manager de ne pas résoudre l'alias. Par défaut, l'alias est toujours résolu.
BElementPath,FolderPathCopie l'élément dont le chemin d'accès est ElementPath vers le dossier de destination dont le chemin d'accès est FolderPath.
CAliasFilePath,ElementPath,AliasIDCrée l'alias AliasID à l'élément ElementPath dans le fichier AliasFilePath.
AliasFilePath : chemin d'accès au fichier qui contient les alias.
ElementPath est le chemin d'accès de l'élément à aliasser.
AliasID est l'ID de la ressource alias 'alis'.
DFolderPathRend la liste des dossiers à l'intérieur du dossier FolderPath (chemin d'accès).
E ElementPath1,ElementPath2La commande agit au niveau du catalogue du disque et échange les éléments ElementPath1 et ElementPath2. Les 2 fichiers (ou dossiers) doivent appartenir au même volume.
ElementPath1 et ElementPath2 sont les chemins d'accès complet à chaque élément.
Avec cette commande, vous pouvez sécuriser la mise à jour d'un fichier en travaillant sur une copie qui sera échangée avec l'original :
- copie du fichier "base de données" sous le nom "fichier temporaire"
- mise à jour de "fichier temporaire"
- échange des fichiers "base de données" et "fichier temporaire"
- suppression du fichier "fichier temporaire
FFolderPath,[types items]Liste les fichiers du dossier FolderPath.
Si types items est vide, tous les fichiers sont listés; sinon uniquement ceux dont le type appartient à la liste. La liste peut comporter jusqu'à 10 types séparés par une virgule.
GElementPath, NomFlagRend l'état du flag spécifié pour l'élément fichier/dossier dont le chemin d'accès est ElementPath
NomFlag est le nom d'un flag : alias,invisible,hasbundle,locked,stationnery,customicon,noinits,inited
Par défaut, le paramètre vaut All et rend l'état de tous les flags précédé du nom.
Pour obtenir l'état de deux flags, il faut faire deux appels avec les noms correspondant.
IElementPathRend les informations relatives à l'élément ElementPath (fichier/dossier).
K ElementPathDétruit un élément dont le chemin d'accès complet est ElementPath (fichier/dossier).
On ne peut détruire un dossier que s'il est vide : au préalable, il faut détruire son contenu. Il est préférable d'utiliser le handler "DeleteFolder" de cette pile, qui détruit le contenu du dossier, puis le dossier lui-même.
LFolderPathListe des fichiers du dossier FolderPath avec la date de modification quantifiée.
Cette date permet de déterminer, par comparaison de deux dossiers, quel est le fichier le plus récemment modifié.
MElementPath,destinationFolderPathDéplace l'élément ElementPath (fichier/dossier) vers le dossier dont le chemin d'accès est destinationFolderPath.
L'origine et la destination doivent appartenir au même volume.
OFilePathSupprime toutes les ressources du fichier dont le chemin d'accès est FilePath.
La date de modification est mise à jour.
RElementPath,NewNameRenomme NewName (nom simple de 31 caractères maxi) l'élément dont le chemin d'accès est ElementPath.
SElementPath, NomFlag,true/falseMet dans l'état le flag spécifié de l'élément dont le chemin d'accès est ElementPath.
NomFlag est le nom d'un flag : alias,invisible,hasbundle,locked,stationnery,customicon,noinits,inited
TElementPath,TypeEtCréateurPermet de modifier le Type, le Creator et la date de modification d'un élément dont le chemin d'accès est ElementPath.
TypeEtCréateur comporte 3 rubriques séparées par une virgule :
- le type du fichier à changer (4 caractères);
- le creator du fichier à changer (4 caractères);
- l'heure de modification à changer sous la forme standard ou convertie en secondes. (Pour mettre l'heure et le jour actuels, prendre "the Time" converti en secondes).
- pour ne pas modifier une rubrique, ne pas l'alimenter.
VFolderPath,[TemplatefolderPath]Crée le dossier dont le chemin d'accès est FolderPath.
TemplatefolderPath est le chemin d'accès à un dossier modèle dont on veut reprendre les caractéristiques.