Création de chemins d'accès

Dans de nombreuses boîtes de dialogue FileMaker Pro, vous pouvez définir des chemins d'accès vers un fichier externe ou une source de données FileMaker. Dans la plupart des cas, chaque fichier ou source de données FileMaker nommés peuvent être composés d'un ou de plusieurs chemins d'accès. Utilisez plusieurs chemins d'accès lorsque vous souhaitez que les clients FileMaker fassent des recherches 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 et hôtes FileMaker prennent en charge les chemins de fichiers dans un format FileMaker spécial :

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 actuelle 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 partagé

fmnet:/nom ou adresse IP de l'hôte/nomFichier

À 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é. Si aucune de ces fins n'est définie, le chemin d'accès peut être utilisé sur n'importe quelle plateforme.
  • Le préfixe fmnet spécifie un chemin d'accès réseau à un fichier FileMaker Pro 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.

Étant donné que la création de plusieurs chemins d'accès spécifiques à une plateforme peut s'avérer difficile, en règle générale, il est recommandé 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 de l'action de script Exporter enregistrements, de sources de données FileMaker, de fichiers insérés dans les rubriques Conteneur à l'aide de l'action de script Insérer fichier et d'actions de script qui utilisent des fichiers de données.

image

imagemac

imagewin

imagelinux

Fichier image ou PDF insérés dans les 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 utiliser des actions de script qui accèdent à ces fichiers, vous pouvez utiliser plusieurs chemins d'accès lorsque vous souhaitez que les clients FileMaker effectuent des recherches 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 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 plateformes, la base de données doit accéder à un fichier local nommé test.xlsx.
    filewin:/C:/FichiersExcel/Hébergés/test.xlsx
    filemac:/MacintoshHD/FichiersExcel/Hébergés/test.xlsx

    Alternativement, 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 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.domain.com/Databases/test.fmp12
    fmnet:/hôte2.domain.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 fichiers ou de dossiers 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 convertir un chemin d'accès FileMaker au format URL ou de système d'exploitation standard, utilisez la fonction ConvertFromFileMakerPath (par exemple, pour convertir un chemin d'accès FileMaker au format URL à utiliser dans l'action de script Insérer depuis URL). À l'inverse, utilisez la fonction ConvertToFileMakerPath pour convertir un chemin d'accès standard au format FileMaker.
  • 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 le nom de domaine entièrement qualifié de l'hôte ou utilisez des variables dans les chemins d'accès.
  • 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 actuelle. 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 (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 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.