Accéder à la liste des enregistrements

Accède à un modèle et renvoie le jeu trouvé spécifié par une liste d'ID d'enregistrement.

Options 

• Liste d'ID d'enregistrements correspond à la liste des identifiants associés aux enregistrements. L'ordre des ID d'enregistrements spécifie l'ordre à utiliser pour le jeu trouvé. Les ID d'enregistrements doivent être des identifiants valides dans la table associée au modèle spécifié. Pour connaître les formats de liste pris en charge, consultez la section Description.

• Afficher les enregistrements à l'aide du modèle spécifie le modèle du fichier actuel qui sera utilisé pour afficher les enregistrements de la liste. Si aucun modèle n'est spécifié, le modèle actuel est utilisé.

• L'option Afficher dans une autre fenêtre présente les enregistrements liés dans une nouvelle fenêtre et vous permet de paramétrer cette dernière. Consultez l'action de script Nouvelle fenêtre.

  Conseil  Pour mettre automatiquement la nouvelle fenêtre au premier plan, ajoutez l'action de script Sélectionner fenêtre.

• Animation spécifie l'animation à utiliser lors de l'affichage des enregistrements (FileMaker Go uniquement).

Provient de la version 

22.0

Description 

Cette action de script accède au modèle spécifié dans la fenêtre actuelle (ou dans une nouvelle fenêtre). Elle change ensuite le jeu d'enregistrements trouvé et l'ordre de tri pour ceux spécifiés par la Liste d'ID d'enregistrements et accède au premier enregistrement de ce jeu.

Vous pouvez spécifier l'option Liste des ID d'enregistrements dans l'un de ces formats :

1
5
21
22
23
7

1
5
21-23
7

[1,5,21,22,23,7]

["1","5","21","22","23","7"]

["1","5","21-23","7"]

[
  {
    "recordId" : "1"
  },
  {
    "recordId" : "5"
  },
  {
    "recordId" : "21"
  },
  {
    "recordId" : "22"
  },
  {
    "recordId" : "23"
  },
  {
    "recordId" : "7"
  }
]

Les ID d'enregistrement consécutifs peuvent être donnés sous forme de plage (deux nombres séparés par un trait d'union) dans une liste de valeurs (par exemple, 21-23) ou dans un tableau JSON de chaînes (par exemple, ["21-23"]). Une plage dans un tableau JSON de nombres constitue un JSON non valide, ce qui provoque le renvoi d'une erreur par cette action de script.

Si l'un des ID d'enregistrements spécifiés ne peut pas être trouvé (par exemple, si les enregistrements ont été supprimés), ces ID sont ignorés et le jeu trouvé ne contiendra que les enregistrements qui ont été localisés avec succès. Les enregistrements du jeu trouvé résultant sont affichés dans un ordre qui correspond à la séquence des ID d'enregistrements fournis. Dans la boîte de dialogue Trier des enregistrements, ce statut de tri est indiqué par <Ordre prédéfini>.

Remarques 

• Les ID d'enregistrements doivent être des identifiants valides attribués par le client FileMaker lors de la création des enregistrements. Ce sont les mêmes ID d'enregistrements utilisés ailleurs, tels que ceux renvoyés par les fonctions Obtenir ( IDEnreg ) et ObtenirIDEnregistrementDansJeuTrouvé et par les appels FileMaker Data API et OData API. Les valeurs de rubrique de clé primaire ou d'autres identifiants personnalisés ne sont pas prises en charge.

• Si l'un des enregistrements spécifiés ne peut pas être trouvé, cette action de script renvoie le code d'erreur 101 ("Enregistrement manquant") ou 401 ("Aucun enregistrement ne correspond à cette requête"), qui peut être capturé avec la fonction Obtenir ( DernièreErreur ).

• Lorsque cette action de script ouvre une nouvelle fenêtre, cette dernière n'active pas le déclencheur de script SurOuverturePremiereFenetre ou le déclencheur de script SurOuvertureFenetre, car il est possible que le script déclenché n'active pas la vue ou le modèle souhaité. Si vous souhaitez qu'un script soit exécuté après que cette action de script ouvre une nouvelle fenêtre, ajoutez Exécuter script comme action de script suivante.

• L'option Animation est prise en charge uniquement dans FileMaker Go :

  • Vous pouvez utiliser les animations uniquement pour la fenêtre sélectionnée.

  • Vous ne pouvez pas utiliser les animations pour passer d'un enregistrement à un autre avec le curseur ou les boutons de la barre d'outils.

Exemple 1 - Accéder aux enregistrements dans une liste de valeurs

Accède au modèle Contacts et affiche les enregistrements spécifiés par une liste d'ID d'enregistrements délimitée par retour chariot.

Définir variable [ $listeEnregistrement ; Valeur: "15¶8¶23¶4¶12" ]
Accéder à la liste des enregistrements [ Liste d’ID d’enregistrements: $listeEnregistrement ; Utilisation du modèle: "Contacts" (Contacts) ]

Exemple 2 - Accéder aux enregistrements à partir d'une recherche sémantique enregistrée

La recherche sémantique effectuée dans l'Exemple 2 d'Effectuer une recherche sémantique a enregistré la liste des enregistrements dans $$result en tant que tableau JSON d'objets avec des paires clé-valeur recordId. Notez que le format JSON du résultat enregistré est compatible avec celui d'Accéder à la liste des enregistrements. Plus tard, dans la même session client FileMaker, ce script ouvre une nouvelle fenêtre, accède au même modèle (Détails de la réunion) et affiche le même jeu trouvé. En cas d'échec, le script affiche un message d'erreur.

Accéder à la liste des enregistrements [ Liste d’ID d’enregistrements: $$result ; Utilisation du modèle: "Détails de la réunion" (Meetings) ; Nouvelle fenêtre ]

Si [ Obtenir ( DernièreErreur ) ≠ 0 ]
    Ouvrir boîte dial. person. [ "Erreur" ; "Impossible d'accéder aux enregistrements spécifiés. Erreur : " & Obtenir ( DernièreErreur ) ]
Fin de si

Exemple 3 - Recréer le jeu trouvé du client sur l'hôte

Effectue une recherche sur le client FileMaker pour les produits à faible inventaire (< 50), puis obtient les ID d'enregistrements du jeu trouvé à l'aide de la fonction ObtenirIDEnregistrementDansJeuTrouvé. Le script client appelle ensuite un script sur l'hôte et lui transmet la liste des ID d'enregistrements.

Activer modèle [ "Produits (Produits) ; Animation: Aucune ]
Mode Recherche [ Pause: Non ]
Définir rubrique [ Produits::Inventaire ; "<50" ]
Exécuter la recherche [ ]

Définir variable [ $IDJeuTrouvé ; Valeur: ObtenirIDEnregistrementDansJeuTrouvé ( plagesDeNombreDeValeurs ) ]

Exécuter script sur serveur [ "Script hôte" ; Spécifié: Depuis liste ; Paramètre: $IDJeuTrouvé ; Attendre la fin: Oui ]

Ouvrir boîte dial. person. [ "Résultat" ; Obtenir ( RésultatScript ) ]

Le script hôte accède à la liste des enregistrements sur le modèle Produits, calcule le résultat, puis transmet le résultat au script client.

Définir variable [ $IDEnregistrement ; Obtenir ( ParamètreScript ) ]
Accéder à la liste des enregistrements [ Liste d’ID d’enregistrements: $IDEnregistrement ; Utilisation du modèle: "Produits" (Produits) ; Animation: Aucune ]

# Traite les enregistrements du jeu trouvé et renvoie $result
Fin de script [ Texte de résultat: $result ]

Rubriques connexes 

• Fonction ObtenirIDEnregistrementDansJeuTrouvé

• Action de script Effectuer une recherche sémantique

• Action de script Exécuter FileMaker Data API

• Page de référence des actions de script