Référence > Page de référence des actions de script > Actions de script Enreg. > Importer enregistrements
 
Importer enregistrements
Objet 
Importe les enregistrements d'un fichier ou source de données indiqués.
Voir aussi 
Format 
Importer enregistrements [Vérifier les certificats SSL; Avec boîte de dialogue: Oui/Non; "<source ou nom du fichier>"; Ajouter/Mettre à jour existant/Mettre à jour correspondant; <plateforme et jeu de caractères>]
Options 
L'option Vérifier les certificats SSL permet de valider le certificat SSL du serveur indiqué dans une requête HTTP pour les données XML. S'il est impossible de vérifier le certificat, les utilisateurs peuvent néanmoins choisir de se connecter ou d'annuler pour ignorer cette action de script. S'il est impossible de vérifier le certificat et que action de script Gestion erreurs est définie sur Oui, cette action se comporte comme si le serveur était indisponible.
Avec boîte de dialogue indique si afficher les boîtes de dialogue liées à l'importation au moment de l'exécution de l'action de script. Toutefois, si aucun fichier de source de données n'a été spécifié, la boîte de dialogue Ouvrir fichier apparaît à l'exécution d'un script.
Source de données spécifie le fichier ou la source des données à importer. En fonction du fichier ou de la source choisie, une boîte de dialogue s'ouvre vous demandant de préciser les options supplémentaires suivantes :
 
Sélection
Faites ceci
Fichier
Dans la boîte de dialogue Fichier, sélectionnez le fichier à importer ou les chemins d'accès des fichiers, directement dans la liste. Spécifiez un seul chemin d'accès par ligne. FileMaker Pro utilisera le premier chemin d'accès qu'il identifiera en tant que fichier à importer. Consultez la section Création de chemins d'accès.
Dossier
Dans la boîte de dialogue Options d'importation de dossiers, sélectionnez le dossier des fichiers images ou texte à importer, ou entrez directement le chemin d'accès du dossier dans la liste. Spécifiez un seul chemin d'accès par ligne. FileMaker Pro utilisera le premier chemin d'accès qu'il identifiera en tant que dossier à importer. Pour plus d’informations, consultez les rubriques Importation de la totalité d'un dossier de fichiers et Création de chemins d'accès. Cette option n'est pas prise en charge dans FileMaker WebDirect ni dans les scripts côté serveur.
Données XML
Dans la boîte de dialogue Définir les options XML et XSL, sélectionnez la source des données XML à importer, puis la feuille de style XSLT si vous souhaitez en appliquer une avant l'importation. La source XML et XSLT peut correspondre à un fichier, au résultat d'une requête HTTP ou au calcul généré par un chemin d'accès de fichier ou une requête HTTP. Pour plus d’informations, consultez la section Importation de données XML.
Données ODBC
Indiquez le nom et l'emplacement de la source de données, l'ID utilisateur et le mot de passe (s'il a été défini), ainsi que la requête SQL à exécuter. Vous pouvez saisir directement une requête ou définir un calcul pour la générer. Pour plus d’informations, consultez la section Automatisation de l'importation ODBC à l'aide de l'action de script Importer enregistrements.
La longueur des instructions SQL est limitée à 256 000 caractères (512 Ko).
Remarque  Si vous utilisez l'action de scripts Importer enregistrements pour importer des données ODBC contenant des chaînes Unicode, votre pilote ODBC doit prendre en charge le format Unicode. Dans le cas contraire, les résultats pourraient se révéler incohérents.
Ordre d'importation informe FileMaker Pro d'utiliser un ordre d'importation prédéfini. Le dernier ordre utilisé dans le fichier s'affiche par défaut et peut être modifié. Cette option vous permet également de choisir entre conserver ensemble les données des rubriques multivaluées ou créer un enregistrement pour chacune des valeurs. Enfin, elle permet de déterminer s'il convient d'ajouter de nouveaux enregistrements, de remplacer les données dans le jeu d'enregistrements trouvés actif ou d'importer les données dans une nouvelle table.
Remarque  Lorsque les rubriques sources et cibles de l'importation sont mises en correspondance d'après leurs noms, la concordance du nom de la rubrique s'effectue de façon dynamique chaque fois que l'action de script est exécutée.
Compatibilité 
 
A l’exécution de l’action de script 
Prises en charge 
FileMaker Pro 
Oui 
FileMaker Server 
Partielle 
FileMaker Go 
Partielle 
Publication Web personnalisée 
Non 
FileMaker WebDirect 
Partielle 
Runtime solution 
Oui 
Provenance 
FileMaker Pro 6.0 ou version antérieure
Description 
Vous pouvez définir l'ordre d'importation et utiliser l'option Ordre d'importation ou exécuter l'action de script depuis la boîte de dialogue, de sorte que l'utilisateur puisse définir de nouveaux critères, tels que l'importation des données dans une nouvelle table.
Si le fichier source est ouvert, le jeu d'enregistrements trouvés est importé ; dans le cas contraire, tous les enregistrements de la table source sont importés.
Si vous insérez cette action de script dans un script côté serveur et que vous ne définissez pas l'option Avec boîte de dialogue sur Non, la mention (NON compatible) apparaît après l'action de script. Toutefois, le script s'exécute. Son comportement est le même que si l'action Avec boîte de dialogue était définie sur Non. Pour plus d'informations, consultez le fonction Obtenir ( ListingDocuments ).
Vous recevrez un message d'erreur si vous exécutez un script côté serveur pour :
importer des enregistrements dans une nouvelle table ;
importer des enregistrements depuis un dossier ;
importer des images dans une rubrique Conteneur.
Remarques 
Dans FileMaker Pro, si un chemin d'accès absolu n'est pas défini dans un script qui sera exécuté dans FileMaker Pro, ce chemin d'accès est considéré comme relatif à l'emplacement du fichier de base de données à partir duquel le script a été exécuté. Par exemple, si un script contenant l'action de script Exporter enregistrements est exécuté et que son chemin d'accès est fichier:/export.tab, alors le fichier exécutant le script est /MesFichiers/Bibliothèque/Books.fmp12, et le fichier exporté créé sera /MesFichiers/Bibliothèque/export.tab.
La prise en charge de l'importation de photos à partir d'un appareil photo numérique ou d'un appareil a été supprimée de FileMaker Pro.
Si un script créé dans une version antérieure de FileMaker Pro contient une action de script Importer enregistrements [Appareil photo numérique], l'action est commentée comme étant obsolète. Vous pouvez supprimer l'action, mais vous ne pouvez pas la modifier.
Si un bouton fait référence à une action de script Importer enregistrements [Appareil photo numérique], le bouton est désactivé et l'action de script Importer enregistrements est commentée comme étant obsolète dans la boîte de dialogue Configuration du bouton.
Les scripts exécutés par FileMaker Server adoptent le comportement des chemins de fichier FileMaker Server. Consultez la section Chemins d'accès dans les scripts côté serveur.
FileMaker Go ne prend en charge que l'importation depuis un fichier FileMaker Pro vers un autre fichier FileMaker Pro.
FileMaker Go ne prend pas en charge l'importation vers une nouvelle table.
Lorsque vous utilisez cette action de script dans FileMaker WebDirect, n'oubliez pas les points suivants :
FileMaker WebDirect ne prend pas en charge cette action de script dans les navigateurs mobiles.
FileMaker WebDirect ne prend pas en charge l'option Source de données. Les utilisateurs doivent indiquer un fichier accessible par le navigateur Web.
FileMaker WebDirect prend uniquement en charge l'importation depuis des formats de fichiers FileMaker Pro, valeurs séparées par des virgules, valeurs séparées des tabulations, DBF, Merge et Excel.
Exemple 1 
Importe les informations depuis Nouveau catalogue produits.xlsx en tant que nouveaux enregistrements sans en avertir l'utilisateur.
Activer modèle ["Produits"]
Importer enregistrements [Avec boîte de dialogue: Non; Source: "Nouveau catalogue produits.xlsx"; Feuille de calcul: "Stock"; Ajouter; Mac Roman]
Exemple 2 
Met à jour les enregistrements existants à l'aide des informations du fichier Nouveau catalogue produits.xlsx.
Activer modèle ["Produits"]
Trier enregistrements [Rétablir; Avec boîte de dialogue: Non]
Afficher enreg/requête/page [Premièr(e)]
Importer enregistrements [Avec boîte de dialogue: Non; Source: "Nouveau catalogue produits.xlsx"; Feuille de calcul: "Stock"; Mettre à jour enreg. correspondants; Mac Roman]
Exemple 3 
Définit la valeur en série suivante après l'importation d'enregistrements. Cette action est utile lorsque l'option Entrer automatiquement les val. prévues pdt. import. n'est pas sélectionnée afin de préserver les dates et autres valeurs saisies automatiquement.
Activer modèle ["Produits"]
Importer enregistrements [Avec boîte de dialogue: Non; Source: "Nouveau catalogue produits.xlsx"; Feuille de calcul: "Stock"; Ajouter; Mac Roman]
Définir valeur en série suiv. [Factures::N° facture; Obtenir ( NombreEnregTotal ) + 1]
Trier enregistrements [Rétablir; Avec boîte de dialogue: Non]
Afficher enreg/requête/page [Premièr(e)]
Rubriques connexes 
Action de script Définir valeur en série suiv.
Action de script Exporter enregistrements
Page de référence des actions de script (liste alphabétique)
Page de référence des actions de script (liste des catégories)