Fonctions Obtenir

Les fonctions Obtenir surveillent les erreurs de script ou capturent des informations sur l'état des fichiers ou les actions 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 stockée, l'heure est mise à jour uniquement 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 stocké 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 dans lesquels les informations d'état recueillies par une fonction Obtenir sont mises à jour au moment de l'exécution du calcul.

Fonction

Résultat

Obtenir ( PrivilègesEtendusCompte )

Renvoie une liste des mots-clés pour les privilèges étendus activés d'après le compte utilisé pour ouvrir le fichier.

Obtenir ( NomGroupeCompte )

Renvoie le nom de groupe du compte actif.

Obtenir ( NomCompte )

Renvoie le nom de compte authentifié dont se sert l'utilisateur actuel du fichier.

Obtenir ( NomPrivilègesCompte )

Renvoie le nom du jeu de privilèges utilisé par le compte ayant servi à ouvrir le fichier.

Obtenir ( TypeCompte )

Renvoie le type d'authentification du compte actif.

Obtenir ( ContenuRubriqueActive )

Renvoie le contenu de la rubrique sur laquelle le curseur est positionné.

Obtenir ( NomRubriqueActive )

Renvoie le nom de la rubrique sur laquelle le curseur est positionné.

Obtenir ( NomTableRubriqueActive )

Renvoie le nom de l'occurrence de table contenant la rubrique sur laquelle le curseur est positionné.

Obtenir ( NomObjetModèleActif )

Renvoie le nom de l'objet de modèle sur lequel le curseur est positionné dans la fenêtre actuelle du calcul.

Obtenir ( TouchesSpécialesActives )

Renvoie un nombre pour les touches spéciales du clavier actuellement pressées par l'utilisateur.

Obtenir ( NuméroRangéeTableExterneActive )

Renvoie un nombre représentant la ligne de table externe sur laquelle le curseur est positionné.

Obtenir ( NuméroEnregActif )

Renvoie un nombre représentant l'enregistrement sur lequel le curseur est positionné dans le jeu d'enregistrements trouvé.

Obtenir ( NuméroRépétitionActive )

Renvoie un nombre représentant la valeur sur laquelle est positionné le curseur dans une rubrique multivaluée.

Obtenir ( TailleSélectionActive )

Renvoie un nombre correspondant aux caractères sélectionnés.

Obtenir ( DébutSélectionActive )

Renvoie un nombre correspondant au premier caractère du texte sélectionné.

Obtenir ( EtatAutoriserAnnulation )

Renvoie 1 (vrai) si l'action de script Autor. annulation utilisateur est en cours ; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( EtatAutoriserBarreTexte )

Renvoie 1 (vrai) si l'affichage de la barre de texte est autorisé; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( ArchitectureApplication )

Renvoie l'architecture d'application actuelle.

Obtenir ( LangueApplication )

Renvoie du texte correspondant à la langue de l'application actuelle.

Obtenir ( VersionApplication )

Renvoie le nom et la version du client FileMaker.

Obtenir ( NombreRépétitionsCalcul )

Renvoie un nombre correspondant à la valeur de la rubrique Calcul actuellement en cours de calcul.

Obtenir ( AttributsConnexion )

Renvoie le nom d'hôte du fichier actif et l'autorité de certification ayant émis le certificat SSL utilisé pour sécuriser la connexion.

Obtenir ( EtatConnexion )

Renvoie un numéro représentant l'état de sécurité de la connexion réseau du fichier actuel.

Obtenir ( DateActuelle )

Renvoie la date du jour en fonction du calendrier du système.

Obtenir ( PrivilègesEtendusActuels )

Renvoie une liste des mots-clés pour les privilèges étendus activés d'après le compte utilisé pour évaluer ce calcul.

Obtenir ( HorodatageHôteActuel )

Renvoie la date et l'heure actuelle de l'hôte selon l'horloge du système (à la seconde près).

Obtenir ( NomPrivilègesActuels )

Renvoie le nom du jeu de privilèges utilisé pour évaluer ce calcul dans le fichier.

Obtenir ( HeureActuelle )

Renvoie l'heure actuelle (à la seconde près), selon l'horloge du système.

Obtenir ( HorodatageActuel )

Renvoie la date et l'heure actuelles (à la seconde près), selon l'horloge du système.

Obtenir ( HeureActuelleUTCMillisecondes )

Renvoie l'heure actuelle en Temps universel coordonné (UTC) à la milliseconde près.

Obtenir ( NomJeuMenuPersonnalisé )

Renvoie le nom de l'ensemble de menus personnalisé actif.

Obtenir ( CheminBureau )

Renvoie le chemin d'accès du dossier du bureau de l'utilisateur actif.

Obtenir ( Appareil )

Renvoie un numéro représentant le type de l'ordinateur ou de l'appareil mobile exécutant actuellement le produit FileMaker.

Obtenir ( CheminDocuments )

Renvoie le chemin d'accès du dossier Documents de l'utilisateur actif.

Obtenir ( ListingDocuments )

Renvoie la liste de tous les fichiers et sous-dossiers du dossier Document renvoyé par la fonction Obtenir ( CheminDocuments ).

Obtenir ( EtatCryptage )

Renvoie une valeur représentant l'état de cryptage actuel du fichier.

Obtenir ( EtatGestionErreurs )

Renvoie 1 (vrai) si l'action de script Gestion Erreurs est en cours ; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( ElémentsLocaleFichier ) Renvoie un objet JSON contenant des informations à propos des paramètres régionaux du fichier actif.

Obtenir ( CheminFileMaker )

Renvoie le chemin d'accès du dossier de l'instance en cours d'exécution d'un produit FileMaker.

Obtenir ( NomFichier )

Renvoie le nom du fichier actif, sans fournir l'extension du nom du fichier.

Obtenir ( CheminFichier )

Renvoie le chemin d'accès complet du fichier actif.

Obtenir ( TailleFichier )

Renvoie la taille (en octets) du fichier actif.

Obtenir ( NombreEnregTrouvés )

Renvoie le nombre d'enregistrements contenus dans le jeu d'enregistrements trouvés.

Obtenir ( EtatContrasteElevé )

Renvoie 1 (vrai) si le contraste élevé est disponible et actif ; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( VersionApplicationHôte )

Renvoie le nom et la version de l'hôte FileMaker.

Obtenir ( AdresseIPHôte )

Renvoie l'adresse IP de l'ordinateur hôte du fichier actif.

Obtenir ( NomHôte )

Renvoie le nom de l'hôte actif.

Obtenir ( PluginsFMInstallés )

Renvoie le nom, le numéro de version et l'état d'activation des plug-ins installés.

Obtenir ( PluginsFMInstallésAuFormatJSON ) Renvoie un objet JSON avec les attributs des plug-ins installés.

Obtenir ( DernièreErreur )

Renvoie un nombre correspondant à l'erreur dans l'exécution de l'action de script.

Obtenir ( DétailDernièreErreurExterne )

Renvoie du texte au sujet des erreurs externes à la plateforme FileMaker, telles que renvoyées par Obtenir ( DernièreErreur ).

Obtenir ( DernierChoixMessage )

Renvoie le numéro du bouton sur lequel vous cliquez dans un message d'alerte affiché par l'action de script Ouvrir boîte dial. person.

Obtenir ( AccèsModèle )

Renvoie un numéro basé sur les privilèges d'accès à l'enregistrement, disponibles sur le modèle actif.

Obtenir ( NombreModèles )

Renvoie le nombre total de modèles dans le fichier.

Obtenir ( NomModèle )

Renvoie le nom du modèle affiché.

Obtenir ( NuméroModèle )

Renvoie le nombre du modèle (spécifié dans la boîte de dialogue Gérer les modèles) affiché.

Obtenir ( NomTableModèle )

Renvoie le nom de l'occurrence de table qui affiche les enregistrements dans le modèle actuel.

Obtenir ( EtatVueModèle )

Renvoie un numéro correspondant à l'affichage du fichier actif.

Obtenir ( EtatBarreMenus )

Renvoie un numéro représentant l'état actuel de la barre de menus.

Obtenir ( RubriquesModifiées )

Renvoie la liste des rubriques ayant été modifiées dans l'enregistrement actif de la table actuelle.

Obtenir ( EtatMultiUtilisateur )

Renvoie un nombre correspondant au niveau de partage du fichier utilisant le réseau FileMaker.

Obtenir ( ProtocoleRéseau )

Renvoie le nom du protocole de réseau (TCP/IP) qu'un client FileMaker utilise sur cette machine.

Obtenir ( TypeRéseau )

Dans FileMaker Go, renvoie un nombre indiquant le type de réseau utilisé pour accéder au fichier actif.

Obtenir ( InfoFichierDonnéesOuvert )

Renvoie l'ID de fichier et le chemin de chaque fichier de données ouvert.

Obtenir ( NombrePages )

Renvoie un nombre correspondant au nombre total de pages de la tâche d'impression en cours.

Obtenir ( NuméroPage )

Renvoie le numéro de la page en cours d'impression ou de prévisualisation.

Obtenir ( IDPersistant )

Renvoie du texte représentant un identifiant unique de l'ordinateur ou de l'appareil exécutant un client FileMaker.

Obtenir ( CheminPréférences )

Renvoie le chemin d'accès du dossier des préférences et des options par défaut de l'utilisateur actif.

Obtenir ( NomImprimante )

Renvoie un texte identifiant le nom de l'imprimante par défaut.

Obtenir ( TexteRechercheRapide )

Renvoie le texte stocké dans la zone de recherche rapide.

Obtenir ( AccèsEnreg )

Renvoie un numéro représentant les privilèges d'accès de l'enregistrement actif via la fenêtre Privilèges personnalisés d'accès aux enregistrements.

Obtenir ( IDEnreg )

Renvoie le numéro d'identification unique de l'enregistrement actif.

Obtenir ( NombreModificationsEnreg )

Renvoie le nombre total de modifications effectuées dans l'enregistrement actif.

Obtenir ( NuméroEnreg )

Renvoie un nombre représentant une position d'enregistrement dans le jeu d'enregistrements trouvé.

Obtenir ( NombreEnregOuverts )

Renvoie le nombre total d'enregistrements ouverts et non encore enregistrés dans le jeu d'enregistrements trouvés actif.

Obtenir ( EtatEnregOuvert )

Renvoie une valeur indiquant l'état de l'enregistrement actif.

Obtenir ( EvénementsSurveillanceZone )

Renvoie les événements qui ont causé l'exécution du script défini dans l'action de script Configurer un script de surveillance de zone.

Obtenir ( NombreRequêtes )

Renvoie le nombre total de requêtes de recherche définies pour la table utilisée.

Obtenir ( EtatIgnorerRequête )

Renvoie 1 (vrai) si Ignorer est sélectionné dans la requête de recherche actuelle ; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( ProfondeurEcran )

Renvoie le nombre de bits nécessaires à la représentation d'un pixel (couleur ou gris) sur l'écran principal.

Obtenir ( HauteurEcran )

Renvoie la hauteur, en points, de l'écran dans lequel la fenêtre du fichier actif est ouverte.

Obtenir ( FacteurEchelleEcran )

Renvoie le format de l'écran dans lequel le fichier actif est ouvert.

Obtenir ( LargeurEcran )

Renvoie la largeur, en points, de l'écran dans lequel la fenêtre du fichier actif est ouverte.

Obtenir ( EtatAnimationScript )

Renvoie 1 (vrai) si les animations sont activées pour le script actuel ; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( NomScript )

Renvoie le nom du script en cours d'exécution (ou en pause).

Obtenir ( ParamètreScript )

Renvoie le paramètre de script passé au script actuel.

Obtenir ( RésultatScript )

Renvoie le résultat de script découlant de l'exécution d'un sous-script.

Obtenir ( IdentifiantSession )

Renvoie la valeur définie par l'action de script Définir un identifiant de session.

Obtenir ( EtatTri )

Renvoie une valeur booléenne représentant l'état actuel du tri.

Obtenir ( EtatZoneOutils )

Renvoie un numéro correspondant à l'état de la barre d'outils active.

Obtenir ( ApparenceSystème )

Renvoie le nom de l'apparence actuelle du système d'exploitation.

Obtenir ( DisqueSystème )

Renvoie la lettre du lecteur (Windows) ou le nom du volume (macOS) sur lequel réside le système d'exploitation en cours d'exécution.

Obtenir ( AdresseIPSystème )

Renvoie la liste des adresses IP de tous les ordinateurs connectés à une carte réseau.

Obtenir ( LangueSystème )

Renvoie la langue définie sur le système utilisé.

Obtenir ( ElémentsLocaleSystème ) Renvoie un objet JSON contenant des informations à propos des paramètres régionaux du système client.

Obtenir ( AdresseNICSystème )

Renvoie les adresses matérielles de toutes les cartes réseau connectées à l'ordinateur.

Obtenir ( PlateformeSystème )

Renvoie un numéro correspondant à la plateforme actuelle.

Obtenir ( VersionSystème )

Renvoie la version du système d'exploitation utilisé.

Obtenir ( CheminTemporaire )

Renvoie le chemin d'accès au dossier temporaire FileMaker actif.

Obtenir ( RégletteTexteVisible )

Renvoie la valeur 1 (vrai) si la réglette de texte est affichée, et la valeur 0 (faux) dans le cas contraire.

Obtenir ( NombreEnregTotal )

Renvoie le nombre total d'enregistrements dans la table active.

Obtenir ( EtatClavierTactile )

Renvoie 1 (vrai) si le clavier tactile s'affiche automatiquement lorsque c'est nécessaire; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( PanneauActuelDéclencheur )

Renvoie l'index et le nom d'objet du panneau depuis lequel basculer si le déclencheur de script SurChangementPanneau est activé.

Obtenir ( ÉvénementExterneDéclencheur )

Dans FileMaker Go, renvoie un numéro correspondant à l'événement qui a activé un déclencheur de script SurRéceptionCommandeExterne.

Obtenir ( InfoMouvementDéclencheur )

Renvoie des détails sur le geste ayant activé un déclencheur de script SurGesteAppui.

Obtenir ( FrappeClavierDéclencheur )

Renvoie les caractères qui ont activé un déclencheur de script SurFrappeClavierObjet ou SurFrappeClavierModele.

Obtenir ( TouchesSpécialesDéclencheur )

Renvoie l'état des touches spéciales du clavier lors de l'activation d'un déclencheur de script SurFrappeClavierObjet ou SurFrappeClavierModele.

Obtenir ( PanneauCibleDéclencheur )

Renvoie l'index et le nom d'objet du panneau vers lequel basculer si le déclencheur de script SurChangementPanneau est activé.

Obtenir ( NombreUtilisateurs )

Renvoie le nombre de clients en train d'accéder au fichier.

Obtenir ( NomUtilisateur )

Renvoie le nom de l'utilisateur de FileMaker, tel qu'indiqué dans l'onglet Général de la boîte de dialogue Préférences.

Obtenir ( EtatUtiliserFormatsSystème )

Renvoie 1 (vrai) si Formats du système est activé dans le menu Format ; dans le cas contraire, renvoie la valeur 0 (faux).

Obtenir ( UUID )

Renvoie du texte représentant un identifiant unique universel (UUID).

Obtenir ( UUIDnombre )

Renvoie un numéro représentant un grand identifiant unique universel (UUID).

Obtenir ( HauteurContenuFenêtre )

Renvoie la hauteur, en points, de la zone de contenu de la fenêtre.

Obtenir ( LargeurContenuFenêtre )

Renvoie la largeur, en points, de la zone de contenu de la fenêtre.

Obtenir ( HauteurFenêtreBureau )

Renvoie la hauteur, en points, de l'espace du bureau.

Obtenir ( LargeurFenêtreBureau )

Renvoie la largeur, en points, de l'espace du bureau.

Obtenir ( Hauteur Fenêtre )

Renvoie la hauteur, en points, de la fenêtre sur laquelle le script agit.

Obtenir ( FenêtreGauche )

Renvoie la distance horizontale en points entre l'angle extérieur de la fenêtre sur laquelle le script agit et l'angle le plus à gauche de l'écran.

Obtenir ( ModeFenêtre )

Renvoie un nombre correspondant au mode utilisé par le produit FileMaker au moment de l'évaluation de la fonction.

Obtenir ( NomFenêtre )

Renvoie le nom de la fenêtre sur laquelle le script agit.

Obtenir ( OrientationFenêtre )

Renvoie une valeur correspondant à l'orientation de la fenêtre sur laquelle le script agit.

Obtenir ( StyleFenêtre )

Renvoie le style de la fenêtre sur laquelle le script agit.

Obtenir ( HautFenêtre )

Renvoie la distance verticale, en points, entre l'angle extérieur de la fenêtre sur laquelle le script agit et l'angle supérieur de l'écran sous Windows, ou l'angle inférieur de la barre de menus sous macOS.

Obtenir ( FenêtreVisible )

Renvoie 1 (vrai) si la fenêtre est visible ; renvoie 0 (faux) si la fenêtre est masquée avec Masquer la fenêtre.

Obtenir ( LargeurFenêtre )

Renvoie la largeur, en points, de la fenêtre sur laquelle le script agit.

Obtenir ( NiveauZoomFenêtre )

Renvoie le pourcentage de zoom de la fenêtre active.

Exemple 1 

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 de script Ouvrir boîte dial. person.). Le script saisit la réponse de l'utilisateur à l'aide de Obtenir ( DernierChoixMessage ). Ensuite, en fonction de la réponse de l'utilisateur, le script exécute une action : il annule le reste du script, imprime une lettre de rappel ou envoie un e-mail au compte associé.

Copier
Activer modèle ["NomModèle"]
Afficher enreg/requête/page [Premièr(e)]
Boucle
  Si [NomBases::Date < Obtenir ( DateActuelle )30 - 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"]
      Impression []
    Sinon
      Envoyer courrier [Envoyer via client de messagerie électronique; Avec boîte de dialogue: Non; Destinataire: NomBase::Client; Objet: "Avis de retard"; Message: "Votre compte est arrivé à échéance."]
    Fin de si
  Fin de si
  Afficher enreg/requête/page [Suivant(e); Sortie après dernière: Oui]
Fin de boucle
Activer modèle [modèle d'origine]