Création d'une app personnalisée > Création de chemins d'accès
 

Création de chemins d'accès

Vous pouvez définir des chemins d'accès vers une source de données FileMaker externe. Chaque fichier ou source de données FileMaker nommée peut être composé d'un ou de plusieurs chemins d'accès. Utilisez plusieurs chemins d'accès lorsque vous souhaitez que les clients FileMaker recherchent dans une liste de fichiers potentiels.

Pour plus d'informations sur l'ajout d'une source de données FileMaker et sur la définition de chemins d'accès, consultez la section Connexion à des sources de données externes.

Les clients FileMaker prennent en charge les chemins de fichiers dans des formats FileMaker spéciaux :

 

Type de chemin d'accès

Description

Format

Relatif

Chemin d'accès d'un fichier cible spécifié à partir de l'emplacement de la base de données active ou du dossier Documents de l'utilisateur (voir les remarques ci-dessous)

file:NomRépertoire/NomFichier

filemac:NomRépertoire/

filewin:../NomFichier

Local ou distant complet (macOS)

Chemin d'accès absolu d'un fichier ou d'un dossier cible, local ou sur un volume distant, commençant au premier niveau du système de fichiers

filemac:/NomVolume/NomRépertoire/NomFichier

filemac:/NomVolume/NomRépertoire/

Local complet (Windows)

Chemin d'accès absolu d'un fichier ou dossier cible sous Windows, commençant au premier niveau du système de fichiers

filewin:/LettreLecteur:/NomRépertoire/NomFichier

filewin:/LettreLecteur:/NomRépertoire/

Distant complet (Windows)

Chemin d'accès absolu d'un fichier ou dossier cible sur un volume Windows partagé à l'aide du partage de fichier Windows

filewin://NomOrdinateur/NomPartage/NomRépertoire/NomFichier

filewin://NomOrdinateur/NomPartage/NomRépertoire/

Réseau FileMaker

Chemin d'accès réseau vers un fichier FileMaker Pro Advanced partagé

fmnet:/NomOuAdresseIPHote/NomFichier

A propos des préfixes de chemin d'accès

Un préfixe de chemin d'accès détermine les conditions d'utilisation d'un chemin d'accès par les clients FileMaker :

Les préfixes commençant par file, image ou movie indiquent le type de données du fichier. Les actions de script qui utilisent uniquement des types de données spécifiques nécessitent le préfixe image ou movie (voir ci-dessous) ; sinon utilisez file.

Les préfixes se terminant par win, mac ou linux indiquent la plateforme sur laquelle le chemin d'accès peut être utilisé.

Le préfixe fmnet spécifie un chemin d'accès réseau à un fichier FileMaker Pro Advanced partagé.

Vous pouvez utiliser les préfixes qui commencent par file pour n'importe quel chemin d'accès complet ou relatif. Le préfixe file peut être utilisé sur n'importe quelle plateforme.

Comme il peut être difficile de créer plusieurs chemins d'accès spécifiques à une plateforme, en règle générale, il est plus facile d'utiliser uniquement le préfixe file (sans terminer par la plateforme) avec la fonction Obtenir ( CheminTemporaire ) ou la fonction Obtenir ( CheminDocuments ) pour spécifier un chemin d'accès unique comme variable. Au moment de l'exécution, un chemin d'accès variable utilisant ces fonctions fonctionne exclusivement sur la plateforme du client actuel. Par exemple, une variable définie avec l'expression suivante indique le fichier monfichier.txt dans le dossier temporaire du client :

"file:" & Obtenir ( CheminTemporaire ) & "monfichier.txt"

Le tableau suivant répertorie tous les préfixes de chemin d'accès pris en charge et indique des exemples d'utilisation.

 

Préfixe de chemin d'accès

Utilisé pour

file

filemac

filewin

filelinux

Importation et exportation de données à l'aide de l'action de script Importer enregistrements et l'action de script Exporter enregistrements, sources de données FileMaker, fichiers insérés dans des rubriques Conteneur à l'aide de l'action de script Insérer fichier, et actions de script qui utilisent des fichiers de données

image

imagemac

imagewin

imagelinux

Fichiers image ou PDF insérés dans des rubriques Conteneur à l'aide de l'action de script Insérer PDF ou de l'action de script Insérer image, respectivement

movie

moviemac

moviewin

movielinux

Fichiers audio/vidéo insérés dans des rubriques Conteneur à l'aide de l'action de script Insérer audio/vidéo

Exemples de chemins d'accès multiples

Pour ajouter des sources de données externes ou créer des scripts qui accèdent à ces fichiers, vous pouvez utiliser plusieurs chemins d'accès lorsque vous souhaitez que les clients FileMaker recherchent dans une liste de fichiers potentiels. La recherche sur les chemins d'accès se fait selon l'ordre dans lequel ils apparaissent. Un client FileMaker ouvre le premier fichier qu'il trouve et la recherche est terminée. Chaque chemin de fichier doit figurer sur une ligne séparée.

Exemple 1 : dans cet exemple, une base de données FileMaker Pro Advanced doit fonctionner sous deux systèmes d'exploitation différents : un système Windows et un système macOS accédant aux fichiers locaux. Sur les deux plates-formes, la base de données doit accéder à un fichier local nommé test.xlsx.

filewin:/C:/FichiersExcel/Hébergés/test.xlsx
filemac:/DDMacintosh/FichiersExcel/Hébergés/test.xlsx

Si le dossier Hébergés se trouve dans le dossier Documents des deux systèmes, vous pouvez utiliser une variable définie avec cette expression pour indiquer un chemin d'accès unique qui fonctionne sur les deux plateformes :

"file:" & Obtenir ( CheminDocuments ) & "Hébergés/test.xlsx"

Consultez la section « Exemples d'utilisation de variables dans les chemins d'accès » ci-dessous.

Exemple 2 : dans cet exemple, une base de données FileMaker Pro Advanced doit accéder à un fichier hébergé pour une importation d'enregistrement par script. Toutefois, l'hôte pouvant ne pas être disponible, vous référencez également deux fichiers de remplacement, l'un hébergé sur un autre serveur et l'autre stocké en local sur votre disque dur. Si le premier fichier réseau n'est pas disponible, les clients FileMaker recherchent le deuxième. Si le deuxième fichier réseau n'est pas disponible, les clients FileMaker recherchent le fichier local.

fmnet:/hôte1.domaine.com/Databases/test.fmp12
fmnet:/hôte2.domaine.com/Databases/test.fmp12
file:../Databases/test.fmp12

Exemples d'utilisation de variables dans les chemins d'accès

Les variables vous permettent de spécifier des chemins d'accès de fichier ou de dossier de façon dynamique dans de nombreuses actions de script telles que l'action de script Insérer fichier et l'action de script Importer enregistrements. Consultez la section Utilisation de variables.

Dans les exemples ci-dessous, supposons les variables suivantes :

$NomFichier = "test.xlsx"
$NomUtilisateur = "JeanMartin"
$RépCible = "Documents/Clients"
$TypeChoisi = "filewin"
$$Source = "file:Documents/2019/fichiers démo"
$LettreLecteur = "G:"
$CheminFichierDocs = "file:" & Obtenir ( CheminDocuments ) & "test.xlsx"
$ListeRecherche = "file:anciens résultats.txt
               file:../archives/anciens résultats.txt"

 

Pour

Entrée de liste de chemins d'accès

Liste de chemins d'accès résolue

Spécifier uniquement un nom de fichier

file:test/$NomFichier

file:test/test.xlsx

Spécifier un ou plusieurs répertoires dans un chemin d'accès

file:$NomUtilisateur/$NomFichier

file:JeanMartin/test.xlsx

Spécifier un fichier dans le dossier Documents sur n'importe quelle plateforme prise en charge

$CheminFichierDocs

Windows : file:/C:/Utilisateurs//Jean Martin/Documents/test.xlsx

macOS : file:/Macintosh HD/Utilisateurs/jeanmartin/Documents/test.xlsx

Spécifier des chemins d'accès absolus ou relatifs, avec différents préfixes de type de chemin d'accès

filewin:/$LettreLecteur/$RépCible/contacts.txt

imagemac:../$RépCible/photo.jpg

movie:$RépCible/movie.mp4

filewin:/G:/Documents/Clients/contacts.txt

imagemac:../Documents/Clients/photo.jpg

movie:Documents/Clients/movie.mp4

Spécifier un préfixe de type de chemin d'accès de façon dynamique ou au sein d'un chemin d'accès plus long

$TypeChoisi:/$LettreLecteur/$RépCible

$$Source/$NomFichier

filewin:/G:/Documents/Clients

file:Documents/2019/fichiers démo/test.xlsx

Spécifier un ou plusieurs chemins d'accès complets

$ListeRecherche

file:anciens résultats.txt

file:../archives/anciens résultats.txt

Spécifier un répertoire (et non un fichier)

file:$RépCible/

$$Source/

file:$RépCible/$NomUtilisateur/

file:Documents/Clients/

file:Documents/2019/fichiers démo/

file:Documents/Clients/JeanMartin/

Remarques 

Pour accéder à un fichier situé sur un volume Windows partagé, utilisez le format de chemin d'accès réseau. Ce format n'est compatible qu'avec les volumes partagés Windows. Il n'est compatible ni avec les volumes macOS partagés ni avec le partage réseau FileMaker.

Pour accéder à un fichier situé sur un volume macOS distant, vérifiez que ce volume est monté en premier et que son chemin d'accès commence par filemac. Par exemple, pour exporter des enregistrements vers le fichier appelé test.xlsx dans le dossier Clients du volume Home sur le serveur myhost, le chemin d'accès doit être filemac:/Home/Clients/test.xlsx si vous avez monté le volume Home sur myhost.

N'utilisez pas d'astérisque (*) en tant que caractère générique dans les chemins d'accès réseau, car cela ralentit le trafic réseau FileMaker. Dans la mesure du possible, remplacez les astérisques par l'adresse IP appropriée ou utilisez des variables dans les chemins d'accès.

Dans une liste de chemins d'accès, utilisez les caractères suivants en guise de séparateurs : « / », « : » ou retour chariot.

Vous pouvez utiliser des variables dans les références de sources de données FileMaker. Consultez la section Modification de sources de données FileMaker.

Si la base de données actuelle est ouverte en local, un chemin d'accès relatif pointe vers un fichier cible spécifié à partir de l'emplacement de la base de données active. Si la base de données actuelle est ouverte à distance, un chemin d'accès relatif pointe vers un fichier cible spécifié à partir des emplacements suivants :

l'adresse réseau de l'hôte, s'il s'agit d'un chemin d'accès à un fichier FileMaker Pro Advanced (tous les dossiers dans le chemin d'accès sont ignorés) ;

le dossier Documents de l'utilisateur, s'il s'agit d'un chemin d'accès à un fichier de tout autre type.

L'accès aux fichiers varie selon le client :

Pour FileMaker Pro Advanced et FileMaker Go, l'accès aux fichiers locaux est limité uniquement par le système d'exploitation.

Pour les scripts côté serveur, l'accès est restreint au dossier Documents et au dossier temporaire. Consultez la section Chemins d'accès dans les scripts côté serveur.

FileMaker WebDirect, FileMaker Data API et la Publication Web personnalisée ne peuvent pas accéder au système de fichiers du serveur.