ObtenirIDEnregistrementDansJeuTrouvé

Renvoie les ID d'enregistrement du jeu trouvé actuel sous forme de liste ou de tableau JSON.

Format 

ObtenirIDEnregistrementDansJeuTrouvé ( type )

Paramètres 

type : une expression numérique qui spécifie le format des ID d'enregistrements renvoyés. Consultez la section Description.

Résultat 

Texte

Provient de la version 

22.0

Description 

Cette fonction renvoie les ID d'enregistrements de tous les enregistrements dans le présent jeu trouvé dans leur ordre actuel. Les ID d'enregistrements sont des identifiants uniques qu'un client FileMaker attribue à chaque enregistrement d'une table lorsque l'enregistrement est créé. Ils ne peuvent pas être modifiés.

Le paramètre type détermine le format des données renvoyées. Utilisez le nom de la constante ou la valeur numérique pour spécifier le type.

Paramètre type Renvoie les ID d'enregistrements sous forme de Exemples

nombreDeValeurs (0)

Liste de valeurs séparées par retours chariot
Copier 
1
5
21
22
23
7

JSONString (1)

Tableau JSON de valeurs sous forme de chaînes
Copier 
["1","5","21","22","23","7"]

JSONNumber (2)

 Tableau JSON de valeurs sous forme de nombres
Copier 
[1,5,21,22,23,7]

plagesDeNombreDeValeurs (3)

Liste des valeurs avec des plages1
Copier 
1
5
21-23
7

plagesDeChaîneJSON (4)

Tableau JSON sous forme de chaînes avec des plages1
Copier 
["1","5","21-23","7"]

  1. Pour plagesDeNombreDeValeurs et plagesDeChaîneJSON, les ID d'enregistrements consécutifs sont compressés dans des plages pour aider à réduire la taille des données renvoyées.

Remarques 

  • Les ID d'enregistrements renvoyés peuvent être utilisés avec l'action de script Accéder à la liste des enregistrements pour recréer le même jeu trouvé lors de la spécification d'un modèle basé sur la même table.

  • Si aucun jeu n'est trouvé, cette fonction renvoie un résultat vide dans le format spécifié. Pour une liste de valeurs vide, elle renvoie une chaîne vide (""). Pour un tableau JSON vide, elle renvoie "[]".

Exemple 1 - Obtenir des ID d'enregistrements sous la forme d'une liste de valeurs

Renvoie les ID d'enregistrements sous forme de liste séparée par retours chariot.

Copier 
ObtenirIDEnregistrementDansJeuTrouvé ( nombreDeValeurs )

Si le jeu trouvé actuel contient des enregistrements avec les ID 101, 102 et 105, cet exemple renvoie :

Copier 
101
102
105

Exemple 2 - Enregistrer le jeu trouvé pour le recréer plus tard

Enregistre dans une rubrique globale un objet JSON contenant les ID d'enregistrements du jeu trouvé actuel et le nom du modèle actuel.

Copier 
Définir variable [ $IDEnregistrement ; Valeur: ObtenirIDEnregistrementDansJeuTrouvé ( plagesDeChaîneJSON ) ]
Définir variable [ $modèleActuel ; Valeur: Obtenir ( NomModèle ) ]

Définir variable [ $infoJeuTrouvé ; Valeur: 
  JSONSetElement ( "{}" ; 
    [ "IDEnregistrement" ; $IDEnregistrement ; JSONArray ] ; 
    [ "modèle" ; $modèleActuel ; JSONString ] 
  )
]

Définir rubrique [ Global::DernièreRecherche ; $infoJeuTrouvé ]

Pour un jeu trouvé sur le modèle Contacts, l'objet JSON enregistré dans Global::DernièreRecherche pourrait ressembler à ceci :

Copier 
{
  "IDEnregistrement": ["1-3", "5", "7-9"],
  "modèle": "Contacts"
}

Plus tard, un autre script peut accéder aux mêmes modèle et jeu trouvé à l'aide de l'action de script Accéder à la liste des enregistrements.

Copier 
Définir variable [ $infoJeuTrouvé ; Valeur: Global::DernièreRecherche ]
Définir variable [ $IDEnregistrement ; Valeur: JSONGetElement ( $infoJeuTrouvé ; "IDEnregistrement" ) ]
Définir variable [ $nomModèle ; Valeur: JSONGetElement ( $infoJeuTrouvé ; "modèle" ) ]

Accéder à la liste des enregistrements [ Liste d’ID d’enregistrements: $IDEnregistrement ; Utilisation du modèle: $nomModèle ; Animation: Aucune ]

Rubriques connexes