Accueil > Référence > Page de référence des fonctions > Fonctions Obtenir

Fonctions Obtenir

Utilisez les fonctions Obtenir dans les scripts afin de vérifier et d'empêcher l'apparition d'erreurs, de saisir des données sur le statut d'un fichier de base de données, des éléments qui le composent ou d'une action en cours d'exécution.

De nombreuses fonctions Obtenir renvoient des informations qui changent régulièrement. Par exemple, lorsque la fonction Obtenir ( HeureActuelle ) est placée dans une rubrique Calcul non mémorisé, l'heure est uniquement mise à jour lorsqu'un nouvel enregistrement est créé. Si le calcul inclut d'autres rubriques, mais que son résultat renvoie toujours l'heure actuelle, le résultat du calcul mémorisé n'est mis à jour que lorsque ces autres rubriques ont été modifiées dans l'enregistrement actif. Si l'un de ces calculs n'est pas mémorisé, l'heure est mise à jour chaque fois que nécessaire. Pour des raisons de performances, la définition d'une rubrique Calcul non mémorisé ne se révèle pas toujours judicieuse. L'utilisation des fonctions Obtenir produit les meilleurs résultats dans les scripts où les informations d'état recueillies par une fonction Obtenir sont mises à jour au moment de l'exécution du calcul.

Pour accéder à la liste des fonctions Obtenir, sélectionnez Affichage par type ou Affichage Obtention dans la boîte de dialogue Calcul. En sélectionnant un Affichage par nom, vous vous limitez aux fonctions Obtenir ( indicateur ).

Remarque  Pour plus d'informations sur les différences d'évaluation des fonctions entre l'hôte et le client, recherchez les articles correspondants dans la Base de connaissances FileMaker disponible à l'adresse suivante http://filemaker-fr.custhelp.com.

Cliquez sur un nom de fonction pour en savoir plus.

 

Fonction	Résultat
Obtenir ( PrivilègesEtendusCompte )	Liste des mots-clés des privilèges étendus, séparés par un retour chariot. La liste qui est renvoyée est basée sur le compte utilisé pour ouvrir le fichier de base de données.
Obtenir ( NomCompte )	Nom du compte authentifié utilisé pour le fichier de base de données actif.
Obtenir ( NomPrivilègesCompte )	Nom du jeu de privilèges utilisé par le compte ayant servi à ouvrir le fichier de base de données.
Obtenir ( ContenuRubriqueActive )	Contenu de la rubrique sur laquelle le curseur est positionné.
Obtenir ( NomRubriqueActive )	Nom de la rubrique sur laquelle le curseur est positionné.
Obtenir ( NomTableRubriqueActive )	Nom de la table contenant la rubrique active (la rubrique sur laquelle le curseur est positionné).
Obtenir ( NomObjetModèleActif )	Le nom de l'objet de modèle actif dans la fenêtre active du calcul.
Obtenir ( TouchesSpécialesActives )	Nombre correspondant aux touches spéciales du clavier (par exemple, Maj) enfoncées par l'utilisateur.
Obtenir ( NuméroRangéeTableExterneActive )	Numéro de la ligne de la table externe sur laquelle le curseur est positionné.
Obtenir ( NuméroRépétitionActive )	Renvoie un nombre correspondant à la valeur actuelle d'une rubrique multivaluée (valeur sur laquelle le curseur est positionné).
Obtenir ( TailleSélectionActive )	Nombre de caractères sélectionnés.
Obtenir ( DébutSélectionActive )	Nombre indiquant le premier caractère du texte sélectionné.
Obtenir ( EtatAutoriserAnnulation )	Valeur booléenne correspondant à l'état actuel des actions du script Autor. annulation utilisateur.
Obtenir ( EtatAutoriserBarreTexte )	Valeur booléenne indiquant si l'affichage des barres d'outils est autorisé.
Obtenir ( LangueApplication )	Texte correspondant à la langue de l'application ouverte (anglais par exemple).
Obtenir ( VersionApplication )	Texte correspondant à la version de l’application FileMaker.
Obtenir ( NombreRépétitionsCalcul )	Nombre correspondant à la valeur de la rubrique Calcul, actuellement en cours de calcul.
Obtenir ( EtatConnexion )	Un numéro représentant l'état de sécurité de la connexion réseau du fichier actif.
Obtenir ( DateActuelle )	Date actuelle calculée selon le calendrier du système.
Obtenir ( PrivilègesEtendusActuels )	Liste de mots-clés pour les privilèges étendus du compte utilisé pour évaluer le calcul.
Obtenir ( HorodatageHôteActif )	Date et heure actuelles de l'hôte (à la seconde près), selon l'horloge du système.
Obtenir ( NomPrivilègesActuels )	Nom du jeu de privilèges utilisé pour évaluer ce calcul dans la base de données.
Obtenir ( HeureActuelle )	Date actuelle (à la seconde près), selon l'horloge du système.
Obtenir ( HorodatageActuel )	Date et heure actuelles (à la seconde près), selon l'horloge du système.
Obtenir ( NomJeuMenuPersonnalisé )	Nom du jeu de menus personnalisé actif.
Obtenir ( CheminBureau )	Chemin d'accès du dossier du bureau de l'utilisateur actif.
Obtenir ( CheminDocuments )	Chemin d'accès du dossier Documents de l'utilisateur actif.
Obtenir ( ListingDocuments )	Liste de tous les fichiers et sous-dossiers du dossier Document renvoyé par la fonction Obtenir ( CheminDocuments ).
Obtenir ( EtatGestionErreurs )	Valeur booléenne correspondant à l'état des actions du script Gestion erreurs.
Obtenir ( CheminFileMaker )	Chemin d'accès du dossier de l'instance FileMaker Pro en cours d'exécution.
Obtenir ( NomFichier )	Nom du fichier de base de données actif.
Obtenir ( CheminFichier )	Chemin d'accès complet indiquant l'emplacement du fichier.
Obtenir ( TailleFichier )	Taille (en octets) du fichier de base de données actif.
Obtenir ( NombreEnregTrouvés )	Nombre d'enregistrements du jeu trouvé.
Obtenir ( CouleurContrasteElevé )	Nom du thème de couleurs à contraste élevé par défaut si l'option Utiliser Contraste élevé est sélectionnée dans les Options d'accessibilité du panneau de configuration de Windows.
Obtenir ( EtatContrasteElevé )	Valeur booléenne correspondant à l'état de la case à cocher Utiliser Contraste élevé dans la boîte de dialogue Options d'accessibilité.
Obtenir ( VersionApplicationHôte )	La version de FileMaker Pro ou FileMaker Server fonctionnant sur l'ordinateur qui accueille la base de données en cours d'utilisation.
Obtenir ( AdresseIPHôte )	Adresse IP de l'ordinateur hôte de la base de données active.
Obtenir ( NomHôte )	Nom de l'ordinateur hébergeant le fichier de base de données.
Obtenir ( PluginsFMInstallés )	Le nom d'affichage, le numéro de version (si disponible) et l'état d'activation des modules installés.
Obtenir ( DernièreErreur )	Numéro de l'erreur éventuelle survenue dans les actions des scripts les plus couramment exécutées.
Obtenir ( DernierChoixMessage )	Numéro associé au bouton sur lequel vous cliquez dans le cadre d'un message d'alerte affiché par l'action de script Ouvrir boîte dial. person.
Obtenir ( DernièreErreurOdbc )	Chaîne indiquant l'état de l'erreur publiée par les normes ODBC reposant sur les normes ISO/IEF.
Obtenir ( AccèsModèle )	Nombre correspondant aux privilèges d'accès des modèles affectés via la boîte de dialogue Gestion de la sécurité.
Obtenir ( NombreModèles )	Nombre total de modèles définis dans le fichier de base de données.
Obtenir ( NomModèle )	Nom du modèle affiché.
Obtenir ( NuméroModèle )	Nombre de modèles affichés, disponibles dans la liste de la boîte de dialogue Gérer les modèles.
Obtenir ( NomTableModèle )	Nom de la table depuis laquelle le modèle affiche les enregistrements.
Obtenir ( EtatVueModèle )	Informations sur l'affichage du fichier de base de données.
Obtenir ( EtatMultiUtilisateur )	Nombre correspondant à l'état multi-utilisateur actuel du fichier de base de données.
Obtenir ( ProtocoleRéseau )	Nom du protocole réseau utilisé par FileMaker Pro sur cette machine.
Obtenir ( NuméroPage )	Numéro de la page en cours d'impression ou de prévisualisation.
Obtenir ( IDPersistante )	Texte représentant un identifiant unique de l'ordinateur ou de l'appareil sur lequel FileMaker fonctionne.
Obtenir ( CheminPréférences )	Chemin d'accès du dossier de préférences de l'utilisateur actif.
Obtenir ( NomImprimante )	Chaîne identifiant le nom de l'imprimante par défaut.
Obtenir ( TexteRechercheRapide )	Texte saisi dans la zone de recherche rapide.
Obtenir ( AccèsEnreg )	Nombre correspondant aux privilèges d'accès pour l'enregistrement actuel.
Obtenir ( IDEnreg )	ID (numéro d'identification) unique de l'enregistrement actif.
Obtenir ( NombreModificationsEnreg )	Nombre total de fois au cours duquel l'enregistrement actif a été modifié.
Obtenir ( NuméroEnreg )	Numéro de l'enregistrement actif dans l'ensemble des enregistrements trouvés.
Obtenir ( NombreEnregOuverts )	Nombre total d'enregistrements ouverts et non encore enregistrés dans le jeu actif d'enregistrements trouvés.
Obtenir ( EtatEnregOuvert )	Nombre indiquant l'état de l'enregistrement actif.
Obtenir ( NombreRequêtes )	Nombre total de requêtes de recherche définies pour la table utilisée.
Obtenir ( EtatIgnorerRequête )	Valeur booléenne indiquant l'état de la case à cocher Exclure en mode Recherche.
Obtenir ( ProfondeurEcran )	Nombre de bits nécessaires à la représentation d'un pixel (couleur ou gris) sur l'écran principal.
Obtenir ( HauteurEcran )	Nombre de pixels affichés en hauteur sur l'écran sur lequel le fichier actif est ouvert.
Obtenir ( LargeurEcran )	Nombre de pixels affichés en largeur sur l'écran sur lequel le fichier actif est ouvert.
Obtenir ( NomScript )	Nom du script en cours d'exécution (ou en mode pause).
Obtenir ( ParamètreScript )	Paramètre de script passé au script actuel.
Obtenir ( RésultatScript )	Résultat de script découlant de l'exécution d'un sous-script.
Obtenir ( EtatTri )	Valeur numérique représentant l'état actuel du tri.
Obtenir ( EtatZoneOutils )	Nombre indiquant si la barre d'outils est masquée, visible, visible et verrouillée, ou masquée et verrouillée.
Obtenir ( DisqueSystème )	Lettre du lecteur (Windows) ou nom du volume (Mac OS) sur lequel réside le système d'exploitation en cours d'exécution.
Obtenir ( AdresseIPSystème )	Adresses IP de toutes les machines connectées à une carte réseau.
Obtenir ( LangueSystème )	Langue actuellement définie dans le système.
Obtenir ( AdresseNICSystème )	Adresses matérielles de toutes les cartes réseau connectées à la machine.
Obtenir ( PlateformeSystème )	Numéro indiquant la plate-forme actuelle.
Obtenir ( VersionSystème )	Version du système d'exploitation de la machine sur laquelle la fonction est exécutée.
Obtenir ( CheminTemporaire )	Le chemin d'accès au dossier temporaire utilisé par FileMaker Pro pour l'utilisateur actuel.
Obtenir ( RégletteTexteVisible )	Valeur booléenne indiquant si la réglette de texte est ou n'est pas visible.
Obtenir ( NombreEnregTotal )	Nombre d'enregistrements contenus dans la table ouverte.
Obtenir ( OngletActuelDéclencheur )	Le numéro d'index et le nom d'objet du panneau à onglets à partir duquel le changement est effectué lorsque le déclencheur de script SurChangementOnglet est activé.
Obtenir ( FrappeClavierDéclencheur )	Chaîne contenant les caractères activés par un déclencheur de script SurFrappeClavierObjet ou SurFrappeClavierModele.
Obtenir ( TouchesSpécialesDéclencheur )	Etat des touches spéciales du clavier au moment de l'activation du déclencheur de script.
Obtenir ( OngletCibleDéclencheur )	Le numéro d'index et le nom d'objet du panneau à onglets vers lequel le changement est effectué lorsque le déclencheur de script SurChangementOnglet est activé.
Obtenir ( NombreUtilisateurs )	Nombre d'utilisateurs qui accèdent actuellement au fichier.
Obtenir ( NomUtilisateur )	Nom de l'utilisateur de FileMaker Pro tel qu'il est indiqué dans l'onglet Général de la boîte de dialogue Préférences.
Obtenir ( EtatUtiliserFormatsSystème )	Valeur booléenne indiquant l'état de la commande de menu Formats du système.
Obtenir ( UUID )	Texte représentant un identifiant unique universel (UUID).
Obtenir ( HauteurContenuFenêtre )	Nombre indiquant la hauteur de la zone de contenu, en pixels.
Obtenir ( LargeurContenuFenêtre )	Nombre indiquant la largeur de la zone de contenu, en pixels.
Obtenir ( HauteurFenêtreBureau )	Nombre indiquant la hauteur de l'espace du bureau, en pixels.
Obtenir ( LargeurFenêtreBureau )	Nombre indiquant la largeur de l'espace du bureau, en pixels.
Obtenir ( HauteurFenêtre )	Nombre indiquant la hauteur en pixels de la fenêtre ouverte du fichier dans laquelle le calcul est défini.
Obtenir ( FenêtreGauche )	Nombre indiquant la distance horizontale, en pixels, entre l'angle extérieur de la fenêtre ouverte et l'angle le plus à gauche de l'écran.
Obtenir ( ModeFenêtre )	Nombre indiquant si FileMaker Pro se trouve en mode Utilisation, en mode Recherche, en mode Prévisualisation ou en cours d'impression au moment de l'évaluation de la fonction.
Obtenir ( NomFenêtre )	Nom de la fenêtre ouverte du fichier dans laquelle le calcul est défini.
Obtenir ( StyleFenêtre )	Un numéro indiquant si la fenêtre ouverte la plus haute est une fenêtre de document, une fenêtre de document flottante ou une fenêtre de boîte de dialogue.
Obtenir ( HautFenêtre )	Nombre indiquant la distance verticale, en pixels, entre l'angle extérieur de la fenêtre ouverte et l'angle inférieur de la barre de menus.
Obtenir ( FenêtreVisible )	Valeur booléenne indiquant si la fenêtre ouverte est ou n'est pas visible.
Obtenir ( LargeurFenêtre )	Nombre indiquant la largeur en pixels de la fenêtre ouverte du fichier dans laquelle le calcul est défini.
Obtenir ( NiveauZoomFenêtre )	Niveau de zoom de la fenêtre active.

Exemple de fonctions Obtenir

Ce script utilise la fonction Obtenir ( DateActuelle ) pour vérifier tous les enregistrements du jeu d'enregistrements trouvé si un compte est arrivé à échéance. Si tel est le cas, le script affiche un message et invite l'utilisateur à cliquer sur un bouton intitulé Ignorer ou Envoyer courrier (défini dans l'action du script Ouvrir boîte dial. person.). Le script saisit la réponse de l'utilisateur à l'aide de Obtenir ( DernierChoixMessage ). Puis, en fonction de la réponse fournie, le script exécute l'action demandée : il annule le reste du script, imprime une lettre informant d'un retard de versement ou envoie un email au compte concerné.

 

Activer modèle ["NomModèle"]

Afficher enreg/requête/page [Premièr(e)r]

Boucle

  Si [NomBase::Date < Obtenir ( DateActuelle ) - 30]

    Ouvrir boîte dial. person. ["30 jours de retard ou plus"]

    Si [Obtenir ( DernierChoixMessage ) = 1]

      Interrompre script

    Sinon si [Obtenir ( DernierChoixMessage ) = 2]

      Activer modèle ["Avis de retard"]

      Imprimer [ ]

    Sinon

      Envoyer courrier [à : NomBase::Client; Objet: "Avis de retard"; Message: "Votre compte est arrivé à échéance."]

    Fin de si

  Fin de si

  Afficher enreg/requête/page [Sortie après dernière, Suivant(e)]

Fin de boucle

Activer modèle [modèle d'origine]