Importer enregistrements

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

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 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 n'importe quel 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 utilisera le premier chemin d'accès qu'il identifiera en tant que dossier à importer. Consultez les sections Importation de l'intégralité 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 rubrique 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 l'action de script Gestion erreurs est définie sur Oui, cette action se comporte comme si le serveur était indisponible.

Provient de la version 

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

Remarques 

• Dans FileMaker Go :
  • Seule l'importation depuis un fichier FileMaker Pro vers un autre fichier FileMaker Pro 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 de formats de fichiers FileMaker Pro, 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 et 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 correspondant à des noms de rubriques ; si l'option Avec boîte de dialogue est définie sur Oui, seule 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.

• Dans l'option Source de données, si vous indiquez une variable,
• Pour spécifier un chemin d'accès du fichier variable au moment de choisir les options Source de données et Ordre d'importation, placez la variable en premier dans la liste des chemins d'accès du fichier, puis un chemin d'accès au fichier local, au format d'important de votre choix. Lorsque vous choisissez l'option Ordre d'importation, l'action de script utilise le premier chemin d'accès du fichier qu'elle peut localiser. Étant donné que l'action de script ne peut pas évaluer la variable avant l'exécution du script, elle utilise le chemin d'accès du fichier suivant dans la liste (le fichier local), vous permettant ainsi de choisir les options. Toutefois, au moment de l'exécution du script, l'action de script utilise le chemin d'accès du fichier défini par la variable, si cette dernière peut être évaluée.

  Si vous n'indiquez qu'une variable et que vous ne voulez pas utiliser les options Ordre d'importation, alors la boîte de dialogue Première rangée s'affiche et vous permet d'indiquer ou pas si la première rangée contient les noms de rubrique.

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