Go to Contents
Page
précédente
Page
suivante
Table des matières > Page de référence des fonctions (liste alphabétique) > Fonctions d'obtention

Fonctions d'obtention
Utilisez les fonctions d'obtention 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 d'obtention renvoient des informations qui changent régulièrement. Par exemple, lorsque la fonction Obtenir(HeureActuelle) est placée dans une rubrique de type 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 d'obtention produit les meilleurs résultats dans les scripts où les informations d'état recueillies par une fonction d'obtention sont mises à jour au moment de l'exécution du calcul.
Pour accéder à la liste des fonctions d'obtention, 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 l'exécution des scripts dans des environnements client/serveur et point à point, consultez la rubrique Exécution de calculs sur une machine hôte.
Cliquez sur un nom de fonction pour en savoir plus.
Fonction Résultat
Obtenir ( NomCompte )
Nom du compte authentifié utilisé pour le fichier de base de données actif.
Obtenir ( ContenuRubriqueActive )
Contenu de la rubrique sur laquelle le curseur pointe.
Obtenir ( NomRubriqueActive )
Nom de la rubrique sur laquelle le curseur pointe.
Obtenir ( NomTableRubriqueActive )
Nom de la table contenant la rubrique active (la rubrique sur laquelle le curseur pointe actuellement).
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éroRépétitionActive)
Nombre correspondant à la valeur activée dans une rubrique multivaluée.
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 ( EtatAutoriserBarreOutils )
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 Pro.
Obtenir ( NombreRépétitionsCalcul )
Nombre correspondant à la valeur de la rubrique Calcul, actuellement en cours de calcul.
Obtenir ( DateActuelle )
Date actuelle calculée selon le calendrier du système.
Obtenir ( HorodatageHôteActif )
Date et heure actuelles de l'hôte (à la seconde près), selon l'horloge du système.
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 de documents de l'utilisateur actif.
Obtenir ( EtatGestionErreurs )
Valeur booléenne correspondant à l'état des actions du script Gestion erreurs.
Obtenir ( PrivilègesEtendus )
Liste des mots-clés des privilèges étendus, séparés par un retour chariot.
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ée 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 ( 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 Gérer les comptes et privilèges.
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, disponible dans la liste de la boîte de dialogue Ordre des 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 ( NuméroRangéeTableExterne )
Numéro de la rangée sélectionnée dans la table externe active.
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 ( NomPrivilèges )
Nom du jeu des privilèges utilisés par l'utilisateur actuel.
Obtenir ( AccèsEnregistrement )
Nombre correspondant aux privilèges d'accès pour l'enregistrement actuel.
Obtenir ( IDEnregistrement )
ID (numéro d'identification) unique de l'enregistrement actif.
Obtenir ( NombreModificationsEnregistrement )
Nombre total de fois au cours duquel l'enregistrement actif a été modifié.
Obtenir ( NuméroEnregistrement )
Numéro de l'enregistrement actif dans l'ensemble des enregistrements trouvés.
Obtenir ( NombreEnregistrementsOuverts )
Nombre total d'enregistrements ouverts et non encore enregistrés dans le jeu actif d'enregistrements trouvés.
Obtenir ( EtatEnregistrementOuvert )
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 booléenne représentant l'état actuel du tri.
Obtenir ( EtatZoneEtat )
Nombre indiquant si la zone d'état 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 ( NombreEnregistrementsTotal )
Nombre d'enregistrements contenus dans la table ouverte.
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 ( 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 ( 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 ou de la barre d'outils.
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 d'obtention
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 le 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 courrier électronique au compte concerné.

Mode Utilisation []

Activer modèle [ "NomModèle" ]

Afficher enreg/requête/page [ Premier ]

Boucle

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

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

    Si [ Obtenir ( DernierChoixMessage ) = 1 ]

      Interrompre le 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 [ Fin de script après dernière, Suivant ]

Fin de boucle

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

Table des matières > Page de référence des fonctions (liste alphabétique) > Fonctions d'obtention
Page
précédente
Page
suivante