ObtenirIDEnregistrementDansJeuTrouvé

Renvoie les ID d'enregistrement du jeu trouvé actuel sous forme de liste ou de tableau JSON. Afin d'obtenir des identifiants pour les enregistrements liés, spécifiez le nom d'une occurrence de table ou d'une table externe.

Format 

ObtenirIDEnregistrementDansJeuTrouvé ( type { ; occurrenceTableOuTableExterne } )

Paramètres 

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

occurrenceTableOuTableExterne : une expression textuelle qui spécifie le nom d'une occurrence de table liée ou le nom d'objet d'une table externe sur le modèle actuel.

Les paramètres situés entre deux accolades { } sont facultatifs.

Résultat 

Texte

Provient de la version 

22.0

Description 

Cette fonction renvoie les ID d'enregistrement de tous les enregistrements du jeu trouvé actif dans leur ordre actuel, ou les ID de tous les enregistrements liés à l'enregistrement actuel par l'occurrence de table ou la table externe spécifiée. 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.

Pour obtenir les ID d'enregistrements liés dans une occurrence de table, utilisez le paramètre occurrenceTableOuTableExterne pour spécifier le nom d'une occurrence de table liée. Les ID d'enregistrement liés sont renvoyés dans l'ordre de tri spécifié par la relation. Consultez la section Création et modification de rubriques.

Pour obtenir les ID des enregistrements liés dans une table externe sur le modèle actuel, utilisez le paramètre occurrenceTableOuTableExterne pour spécifier le nom de l'objet de la table externe (consultez la section Attribution d'un nom à un objet). Les ID d'enregistrement renvoyés sont filtrés et triés en fonction des paramètres de la table externe dans sa boîte de dialogue de configuration. Consultez la rubrique Création de tables externes destinées à afficher les enregistrements liés.

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 "[]".

  • Si le paramètre occurrenceTableOuTableExterne est spécifié, cette fonction essaie d'abord de faire correspondre sa valeur à un nom d'occurrence de table. Si cela échoue, elle essaie de faire correspondre la valeur au nom de l'objet d'une table externe. Si aucune correspondance n'est trouvée, cette fonction 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 - Obtenir des ID d'enregistrement liés à partir d'une table externe sous la forme d'un tableau JSON de nombres

Renvoie les ID d'enregistrement liés sous la forme d'un tableau JSON de nombres depuis l'objet de table externe nommé TableExterneContacts.

Copier 
ObtenirIDEnregistrementDansJeuTrouvé ( JSONNumber ; "TableExterneContacts" )

Si la table externe dans l'enregistrement actuel comprend trois enregistrements liés que la table externe trie et filtre pour obtenir les ID 1101, 702 et 1015, cet exemple renvoie :

Copier 
[1101,702,1015]

Exemple 3 - 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