Référence > Page de référence des actions de script > Actions de script Enreg. > Importer enregistrements
 

Importer enregistrements

Importe les enregistrements d'un fichier ou source de données indiqués.

Voir aussi 

Options 

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 Advanced 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.

Si la boîte de dialogue Première rangée s'affiche après avoir spécifié une source de données, vous pouvez indiquer si vous souhaitez utiliser la première rangée pour les noms de rubriques. Cependant, si vous utilisez l'option Ordre d'importation, vous pouvez choisir un enregistrement à utiliser pour les noms de rubriques lors de l'importation depuis certains formats de fichiers indiqués dans la section Formats de fichier d'importation/exportation pris en charge.

Si vous spécifiez un fichier utilisant un délimiteur de rubrique personnalisé dans la boîte de dialogue Fichier, pour Type de fichier, choisissez Valeurs séparées par un caractère personnalisé et indiquez le délimiteur de rubrique.

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 Advanced utilisera le premier chemin d'accès qu'il identifiera en tant que dossier à importer. Consultez les sections 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. 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. 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 script 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 détermine l'ajout, la mise à jour ou le remplacement des enregistrements du jeu d'enregistrements trouvés actif et la mise en correspondance des rubriques sources avec les rubriques cibles, lors de l'exécution du script. Consultez la section Définition de l'opération d'importation et mise en correspondance des rubriques pendant l'importation.

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.

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.

Compatibilité 

 

Produit 

Format 

FileMaker Pro Advanced 

Oui 

FileMaker Go 

Partielle 

FileMaker WebDirect 

Partielle 

FileMaker Server 

Partielle 

Produit FileMaker Cloud 

Partielle 

FileMaker Data API 

Non 

Publication Web personnalisée 

Non 

Solution d'exécution 

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 définissez l'option Avec boîte de dialogue sur Oui, l'option est grisée ; toutefois cette action de script sera exécutée. 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 ).

Une erreur est renvoyée 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.

Consultez la section Importation de données dans FileMaker Pro Advanced.

Remarques 

Dans FileMaker Go :

Seule l'importation depuis un fichier FileMaker Pro Advanced vers un autre fichier FileMaker Pro Advanced est prise en charge.

L'importation vers une nouvelle table n'est pas prise en charge.

Dans FileMaker WebDirect :

Cette action de script n'est pas prise en charge dans les navigateurs mobiles.

L'option Source de données n'est pas prise en charge. Les utilisateurs doivent indiquer un fichier accessible par le navigateur Web.

Seule l'importation depuis des formats de fichiers FileMaker Pro Advanced, de valeurs séparées par des virgules, de valeurs séparées par des tabulations, DBF, Merge et Excel est prise en charge.

Les scripts côté serveur ne peuvent accéder qu'à certains fichiers. Consultez la section Chemins d'accès dans les scripts côté serveur.

Les scripts côté serveur, FileMaker Go et FileMaker WebDirect prennent en charge les options suivantes uniquement si l'option Avec boîte de dialogue est définie sur Non :

les fichiers sources au format de valeurs séparées par un caractère personnalisé ;

toute rangée pour les noms de rubriques ; si l'optionAvec boîte de dialogue est définie sur Oui, uniquement la première rangée peut être spécifiée ;

l'utilisation des options de saisie automatique pour les rubriques individuelles.

Dans FileMaker WebDirect, si ces options sont prédéfinies dans cette action de script et que l'option Avec boîte de dialogue est définie sur Oui, les options choisies par les utilisateurs lors de l'exécution de l'action de script écrasent les options prédéfinies.

Exemple 1 

Importe les informations depuis Nouveau catalogue produits.xlsx en tant que nouveaux enregistrements sans en avertir l'utilisateur.

Activer modèle [ "Produits" (Produits) ; Animation: Aucune ]
Importer enregistrements [ Avec boîte de dialogue: Non ; Table: Produits ; Source: "Nouveau catalogue produits.xlsx" ; Feuille de calcul: "Stock" ; Ajouter ; Mac Roman ]

Exemple 2 

Remplacr les enregistrements existants à l'aide des informations du fichier Nouveau catalogue produits.xlsx.

Activer modèle [ "Produits" (Produits) ; Animation: Aucune ]
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 ; Table: Produits ; Source: "Nouveau catalogue produits.xlsx" ; Feuille de calcul: "Stock" ; Remplace ; 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 Utiliser les options de saisie automatique lors de l'importation n'est pas sélectionnée afin de préserver les dates et autres valeurs saisies automatiquement.

Activer modèle [ "Produits" (Produits) ; Animation: Aucune ]
Importer enregistrements [ Avec boîte de dialogue: Non ; Table: Produits ; Source: "Nouveau catalogue produits.xlsx" ; Feuille de calcul: "Stock" ; Ajouter ; Mac Roman ]
Définir valeur en série suiv. [ Produits::N° produit ; 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)