Obtenir infos de fichier
L'action Obtenir infos de fichier (capture d'écran ci-dessous) ajoute l'information concernant le fichier spécifié (ou dossier) dans une source de page appelée $MT_FILEINFO. Une source de page $MT_FILEINFO est créée soit quand une action Lire dossier ou une action Obtenir info de fichier est ajoutée au design, peu importe laquelle est ajoutée en premier. Dans les paramètres de l'action, sélectionnez le fichier duquel vous souhaitez obtenir des informations.
Veuillez noter qu'il n'y a qu'une source de page $MT_FILEINFO par page. Donc, si de multiples actions Obtenir info de fichier sont déclenchées durant le traitement d'une page lors de son exécution, alors $MT_FILEINFO contiendra à tout moment des informations de la dernière action Obtenir info de fichier qui a été déclenchée.
Structure de l'arborescence $MT_FILEINFO
La structure de l'arborescence $MT_FILEINFO est telle qu'affichée dans la capture d'écran ci-dessous. L'élément Racine a un nombre d'attributs qui seront remplis avec les informations du fichier spécifié dans l'action déclenchée. Des descriptions des attributs sont indiquées ci-dessous.
•Chemin : le chemin d'accès complet du fichier rapporté.
•Taille : la taille du fichier en bytes.
•Heure de création : l'heure à laquelle le fichier a été créé à son emplacement actuel. Si un fichier est copié dans un nouvel emplacement, l'heure à laquelle il a été copié sera son heure de création. Dans ces cas, l'heure de création pourrait être ultérieure à l'Heure d'écriture.
•Heure d'accès : l’heure du dernier accès au fichier.
•Heure d'écriture : l’heure de la dernière écriture sur le fichier.
•IsDirectory : elle peut prendre la valeur true ou false.
•isReadOnly : elle peut prendre la valeur true ou false.
| Note : | les données lues par l'action "Obtenir infos de fichier" sont passées dans les attributs de $MT_FILEINFO/Root (comme décrit ci-dessus). En revanche, le nœud $MT_FILEINFO/Root, a aussi des éléments enfant : éléments File répétitifs, qui reçoivent des données par le biais d’une autre action, Lire dossier. L'action Lire Dossier remplit les éléments File avec des métadonnées sur des fichiers dans un dossier spécifié. |
Exemple
Un fichier d'exemple nommé ReadFolderGetFileInfo.mtd montre comment utiliser l'action Obtenir infos (voir capture d'écran de la simulation ci-dessous). Ce fichier est disponible dans le dossier (Mes) Documents Altova\MobileTogetherDesigner10\MobileTogetherDesignerExamples\Tutorials\Actions.
L'exemple fonctionne comme suit :
•L'utilisateur final saisit le nom d'un fichier dans le champ d'édition à gauche de la touche Obtenir infos de fichier.
•Le nom du fichier est écrit dans le nœud Root/File de l'arborescence $PERSISTENT (voir capture d'écran).
•La touche Obtenir infos de fichier a une action Obtenir infos de fichier définie pour son événement SurClicDeTouche qui cible le fichier (ou dossier) stocké dans $PERSISTENT/Root/File.
•En cliquant sur Obtenir infos de fichier, l'information du fichier ciblé est lue et passée à la source de page $MT_FILEINFO en tant que les valeurs des attributs de $MT_FILEINFO/Root.
•Ces valeurs d'attribut sont affichées dans les cellules d'une table statique.
Fonctions d'extension de MobileTogether
MobileTogether fournit une série de fonctions d'extension XPath qui ont été créées spécifiquement pour l'utilisation dans les designs MobileTogether. Quelques fonctions peuvent être particulièrement utiles avec des actions spécifiques. Par exemple, mt-available -languages() renvoie les langues dans lesquelles la solution est disponible et pourrait, par exemple, être utilisée avec l'action Boîte de messages. Si une fonction est particulièrement pertinente pour cette action, elle se trouvera dans la liste ci-dessous. Pour une liste complète de ces fonctions d'extension et leurs descriptions, voir la page <Fonctions d'extension MobileTogether.
mt-cache-update-dateTime()
mt-extract-file-extension()
mt-extract-file-name()