Charger/Enregistrer fichier

www.altova.com Imprimer cette rubrique Page précédente Un niveau supérieur Page suivante

Accueil >  Actions > Sources de pages >

Charger/Enregistrer fichier

Vous pouvez régler l'action sur : (i) charger des données depuis un fichier, ou (ii) enregistrer les données sur un fichier. Pour spécifier s'il s'agit d'une action de chargement ou d'enregistrement qui va être effectuée, sélectionnez le bouton radio approprié (voir captures d'écran ci-dessous).

 

Charger depuis fichier

Pour chaque action ChargerDepuisFichier, vous pouvez sélectionner une source de page depuis la liste de choix de l'action (voir capture d'écran ci-dessous).  En alternative, vous pouvez utiliser une expression XPath qui situe le nœud racine de la source de page (par exemple : $XML1). Vous pouvez ensuite spécifier un fichier à partir duquel vous pourrez charger des données pour cette source de page lorsque l'événement est déclenché.

MTDLoadFromFile

Pour charger des données pour des sources de page multiples lorsque l'événement est déclenché, ajouter des actions ChargerDepuisFichier multiples, comme montré dans la capture d'écran ci-dessus.

 

Traitement d'erreur

 

L'option sur erreur vous permet de définir les actions à exécuter en cas d'erreur :

Abandonner le script : en cas d'erreur, toutes les actions suivantes de l'événement déclenché sont terminées. Il s'agit là de l'action par défaut si une erreur se produit. Si vous souhaitez continuer malgré une erreur, sélectionner l'option Continuer ou Throw.
Continuer : les actions ne sont pas terminées. Au lieu, vous pouvez sélectionner ce que vous souhaitez faire dans les cas variés : en cas d'absence d'erreur (Sur succès), ou en cas d'erreur (Sur erreur). Par exemple, si vous souhaitez afficher une fenêtre de messages indiquant si un chargement de page a été effectué avec succès ou pas.
Throw: si une erreur est détectée, cette option lance une exception qui sera stockée dans la variable de l'action Try/Catch. La partie Catch de l'action Try/Catch est utilisée pour spécifier quelle action effectuer en cas d'erreur. Si aucune erreur ne se produit, l'action suivante sera traitée. Voir la section action Try/Catch pour plus de détails.

 

Enregistrer sous fichier

Enregistre les données depuis la source de page sélectionnée ou dans le nœud de source de page (tous deux sont sélectionnés par le biais de l'expression XPath) vers le fichier XML spécifié dans le champ Chemin de FIchier de serveur (voir capture d'écran ci-dessous). Le codage du fichier XML est spécifié dans le champ Encodage. Pour enregistrer des données pour des sources de données multiples, ajouter plusieurs actions SaveToFile. Veuillez noter que vous disposez de l'option pour sélectionner sous l'ensemble de la source de page complète (Utiliser source de page) ou une sous-arborescence d'une source de page (Utiliser nœud de source).

MTDSaveToFile

Note :L'action EnregistrerSousFichier ne peut pas être utilisée pour enregistrer sur des BD. Pour ce faire, utiliser l'action Enregistrer et sélectionner la source de page BD que vous souhaitez enregistrer ou utiliser l'action DBExecute.

 

Traitement d'erreur

 

L'option sur erreur vous permet de définir les actions à exécuter en cas d'erreur :

Abandonner le script : en cas d'erreur, toutes les actions suivantes de l'événement déclenché sont terminées. Il s'agit là de l'action par défaut si une erreur se produit. Si vous souhaitez continuer malgré une erreur, sélectionner l'option Continuer ou Throw.
Continuer : les actions ne sont pas terminées. Au lieu, vous pouvez sélectionner ce que vous souhaitez faire dans les cas variés : en cas d'absence d'erreur (Sur succès), ou en cas d'erreur (Sur erreur). Par exemple, si vous souhaitez afficher une fenêtre de messages indiquant si un chargement de page a été effectué avec succès ou pas.
Throw: si une erreur est détectée, cette option lance une exception qui sera stockée dans la variable de l'action Try/Catch. La partie Catch de l'action Try/Catch est utilisée pour spécifier quelle action effectuer en cas d'erreur. Si aucune erreur ne se produit, l'action suivante sera traitée. Voir la section action Try/Catch pour plus de détails.

 

Emplacements de fichier

Lorsque vous cliquez sur le bouton Dialogue supplémentaire du champ Chemin d'accès du fichier de l'action Charger/Enregistrer (voir capture d'écran ci-dessus), le dialogue Spécifier fichier apparaît. Dans ce dialogue, spécifiez si le fichier se trouve sur le serveur ou sur le client en sélectionnant le bouton radio correspondant (voir capture d'écran ci-dessous).

 

 

Le fichier est situé sur le serveur

Si le fichier est situé sur le serveur, vous pouvez soit chercher son emplacement (Chemin absolu/relatif) ou spécifier le fichier via une ressource globale (Alias de fichier ou Alias de dossier). Sélectionnez l'option que vous souhaitez.

MTDSpecifyFileServer

Chemin absolu/relatif : vous pouvez saisir un chemin, rechercher un fichier ou saisir une expression XPath qui génère le chemin vers le fichier. Utiliser le bouton Actualiser pour supprimer l'entrée actuelle. Le chemin peut être relatif au fichier de design ou absolu. Si le fichier est déployé vers le serveur avec le fichier de design, le chemin relatif/absolu spécifié dans le dialogue sera utilisé en interne (dans la base de données du serveur) pour accéder au fichier. Si le fichier n'est pas déployé, il doit être stocké dans un directoire sur le serveur. Dans ce cas : (i) si un chemin relatif est sélectionné dans le dialogue Spécifier fichier, pendant l'exécution, ce chemin relatif sera résolu sur le serveur en référence au Répertoire de travail (défini dans les paramètres MobileTogether Server ; (ii) le chemin dans le dialogue Spécifier fichier est absolu, le dossier contenant le fichier sur le serveur doit être un descendant du Répertoire de travail. Voir la section Emplacement des fichiers de projet pour plus de détails. Lors de l'enregistrement des fichiers, vous pouvez spécifier en option une extension de fichier par défaut ; celle-ci sera utilisée si aucune autre n'est spécifiée avec le nom du fichier.

 

Créer automatiquement des sous-fichiers à l'enregistrement du fichier : Si des dossiers intermédiaires sont manquants dans le serveur, ils seront créés lorsque le fichier est enregistré.

Cette option est uniquement pertinente lors de l'enregistrement ; elle est absente lorsque l'action se limite au chargement de fichier.

 

Alias du fichier Ressource globale : sélectionner un alias de fichier depuis les alias de fichier disponibles dans la liste de choix. Les alias de fichier disponibles seront ceux actuellement définis dans le fichier Définitions des ressources globales. Chaque fichier effectue un mappage vers des ressources de fichier différentes selon la configuration actuellement active dans MobileTogether Designer (sélectionnée par le biais de la commande Outils | Configuration active ). Voir la section Ressources globales Altova pour plus de détails.

 

 

Alias du dossier ressource globale avec fragment du chemin d'accès : sélectionner un alias de dossier depuis ceux disponibles dans la liste de choix (voir capture d'écran ci-dessous).
 
MTDSpecifyFileGRFolderAliases
 

Les alias de fichier disponibles seront ceux actuellement définis dans le fichier Définitions des ressources globales. Chaque fichier effectue un mappage vers des ressources de fichier différentes selon la configuration actuellement active dans MobileTogether Designer (sélectionnée par le biais de la commande Outils | Configuration active ). Le fragment de chemin spécifie le reste du chemin vers la ressource de fichier. Voir la section Ressources globales Altova pour plus de détails.

 

 

Le fichier est situé sur le client

Si le fichier est situé sur le client, veuillez spécifier le chemin y menant en saisissant/sélectionnant l'emplacement ou en construisant le chemin d'accès avec une expression XPath. Utiliser le bouton Actualiser pour supprimer la saisie actuelle.

MTDSpecifyFileClient

Le fichier à charger/enregistrer peut être spécifié par vous, le designer, ou bien il peut être spécifié par l'utilisateur final. Si vous spécifiez le fichier, cette information sera stockée dans la solution et le fichier sera chargé/enregistré lorsque l'action est déclenchée. Si vous choisissez de laisser l'utilisateur final choisir le fichier à charger/enregistrer, lorsque l'action sera déclenchée, un dialogue de navigation s'ouvrira sur l'appareil client et l'utilisateur final pourra saisir/sélectionner le fichier à charger/enregistrer.

 

Note :L'option permettant de laisser l'utilisateur final le choix du fichier à charger/enregistrer est disponible pour les actions suivantes : Imprimer sous (options Fichier source et Fichier cible), Charger/enregistrer le fichier, Charger/enregistrer l'image et Charger/enregistrer fichier binaire.

 

Note :Les fichiers sur le client peuvent aussi être enregistrés sur une carte SD sur l'appareil mobile.

 

Le nom du fichier est défini ci-dessous (par le designer de la solution)

 

Extension de fichier par défaut pour l'enregistrement de fichier : Lors de l'enregistrement des fichiers, vous pouvez spécifier en option une extension de fichier par défaut ; celle-ci sera utilisée si aucune autre n'est spécifiée avec le nom du fichier.

 

Créer des sous-dossiers automatiquement à l'enregistrement du fichier : Si des fichiers intermédiaires dans le chemin d'accès au fichier sont manquants sur le client, ils seront créés lors que le fichier sera enregistré. Cette option n'est pertinente qu'à l'enregistrement ; elle est absente si l'action est une action de chargement de fichier.

 

Répertoires dépendants de l'appareil : sélectionner le répertoire d'appareil depuis la liste déroulante. Sur Windows Phone/RT et iOS, les répertoires permis sont prédéterminés. Sur les appareils Android, outre les répertoires dans la liste déroulante de la liste de choix Android, vous pouvez saisir le dossier que vous voulez. Sur Android et Windows Phone/RT, si vous sélectionnez Défaut, (donc la sélection par défaut), le répertoire de sandbox de l'appli de MobileTogether est sélectionné. Sur les appareils iOS, MobileTogether crée deux répertoires : (i) un répertoire sauvegardé pour les fichiers enregistrés sur le iCloud, et devront ensuite être re-téléchargés; (ii) un répertoire non-sauvegardé pour les fichiers qui ne nécessitent pas de sauvegarde. Sélectionner Répertoire sauvegardé ou Répertoire non-sauvegardé selon vos besoins. Dans les navigateurs web, les fichiers se situent selon la sandbox du navigateur.

 

Emplacement de fichiers pour les simulations : puisque les fichiers situés sur le client ne seront pas disponibles pendant les simulations, vous pouvez spécifier un dossier qui prendra la place du dossier client pendant les simulations. Bien entendu, les fichiers se trouvant dans ce dossier devront porter les mêmes noms que les fichiers spécifiés dans le design. Ce dossier est spécifié dans l'onglet Simulation du dialogue Options (Outils | Options).

 

Note :  Sur les clients web, les fichiers sont stockés temporairement sur le serveur. Ils en sont supprimés lorsque la session de serveur expire. Une session de serveur expire à l'issue d'une période d'inactivité spécifiée ; cette période est définie dans les paramètres de Sessions contenus dans le volet Divers de l'onglet Paramètres de serveur (voir le Manuel d'utilisateur MobileTogether Server).

 

Le nom du fichier est défini par l'utilisateur final (sur l'appareil client)

 

Extension de fichier par défaut pour l'enregistrement de fichier : Lors de l'enregistrement des fichiers, vous pouvez spécifier en option une extension de fichier par défaut ; celle-ci sera utilisée si aucune autre n'est spécifiée avec le nom du fichier.

 

Filtre de fichier optionnel : le dialogue de navigation qui s'ouvre sur l'appareil client filtrera le type de fichier à charger/enregistrer de manière à ce que seules les extensions de fichier que vous avez définies soient permises. Vous pouvez saisir : (i) une liste d'extensions séparée par des virgules ou des points-virgules (par exemple : txt,html,xml), ou (ii) une expression XPath qui retourne une séquence d'items de chaîne où chaque item de chaîne est une extension de type de fichier (voici par exemple, une séquence contenant trois items de chaîne : 'txt','html,'xml').

 

Fichier par défaut optionnel : vous pouvez saisir un nom de fichier par défaut, soit directement soit par le biais d'une expression XPath pour guider l'utilisateur final

 

Fenêtre Message Web : avant d'ouvrir le dialogue Ouvrir/Enregistrer fichier, une fenêtre de messages est affichée. Vous pouvez y saisir un texte directement ou avec une expression XPath pour substituer le texte par défaut de la fenêtre de messages.

 

Créer automatiquement des sous-dossiers à l'enregistrement du fichier : si des fichiers intermédiaires dans le chemin d'accès du fichier manquent sur le client, ils seront créés lors de l'enregistrement du fichier. Cette option n'est pertinente qu'à l'enregistrement ; elle est absente si l'action est une action de chargement de fichier.

 

Note :  Sur les appareils iOS, permettre à l'utilisateur de sélectionner le fichier sur l'appareil fonctionne uniquement en tant qu'importation/        exportation depuis iCloud ; les utilisateurs ne sont pas autorisés à parcourir le dossier sauvegardé ou non sauvegardé.

 

 

Traitement d'erreur

 

L'option sur erreur vous permet de définir les actions à exécuter en cas d'erreur :

Abandonner le script : en cas d'erreur, toutes les actions suivantes de l'événement déclenché sont terminées. Il s'agit là de l'action par défaut si une erreur se produit. Si vous souhaitez continuer malgré une erreur, sélectionner l'option Continuer ou Throw.
Continuer : les actions ne sont pas terminées. Au lieu, vous pouvez sélectionner ce que vous souhaitez faire dans les cas variés : en cas d'absence d'erreur (Sur succès), ou en cas d'erreur (Sur erreur). Par exemple, si vous souhaitez afficher une fenêtre de messages indiquant si un chargement de page a été effectué avec succès ou pas.
Throw: si une erreur est détectée, cette option lance une exception qui sera stockée dans la variable de l'action Try/Catch. La partie Catch de l'action Try/Catch est utilisée pour spécifier quelle action effectuer en cas d'erreur. Si aucune erreur ne se produit, l'action suivante sera traitée. Voir la section action Try/Catch pour plus de détails.

 


© 2019 Altova GmbH