Boucle

Répète un ensemble d'actions de script pour effectuer des processus par lots.

Options 

Purge : spécifie quand purger les relations mises en cache et mettre à jour les dépendances pendant la boucle :

  • Systématique : pour chaque étape de la boucle qui modifie les données, purge systématiquement toutes les relations mises en cache et met à jour toutes les dépendances. Il s'agit de l'option par défaut et garantit que les données liées sont disponibles comme prévu.

  • Minimale : pour chaque étape de la boucle qui modifie les données, purge les relations mises en cache et met à jour les dépendances sur les données liées qui ne sont qu'à une relation de l'occurrence de la table actuelle.

  • Différée : lorsque la boucle démarre, utilise les relations et les données actuellement mises en cache. Attend que la boucle se termine pour purger les relations mises en cache et mettre à jour les dépendances.

Compatibilité 

Produit Prise en charge
FileMaker Pro Oui
FileMaker Go Oui
FileMaker WebDirect Oui
FileMaker Server Oui
FileMaker Cloud Oui
FileMaker Data API Oui
Publication Web personnalisée Oui

Provient de la version 

6.0 ou version antérieure

Description 

L'action de script Boucle permet, par exemple, d'exporter le contenu de la rubrique Conteneur de tous les enregistrements d'un jeu d'enregistrements trouvés. Cette action de script et l'action de script Fin de boucle marquent respectivement le début et la fin de la répétition des actions de script. Le script exécute les actions de script englobées dans la boucle jusqu'à ce que l'une des situations suivantes se présente :

Toute action Boucle doit être associée à une action Fin de boucle, définie après et au même niveau. Pour toute action de script Boucle définie, le volet de modification de script entre automatiquement une action de script Fin de boucle.

Remarques 

  • La modification de l'option Purge dépend de la conception de votre base de données. En général, si votre boucle ne modifie pas les données qui affectent les relations, alors Différée peut être l'option la plus rapide. Si elle modifie ces données et que les données ne sont qu'à une seule relation, essayez plutôt Minimale. Sinon, restez sur le paramètre Systématique. Pour obtenir des informations supplémentaires, consultez cet article du Claris Engineering Blog.

Exemple 1 

Copie le contenu de Clients::Téléphone professionnel dans Client::Contact en journée dans tous les enregistrements.

Copier
Afficher enreg/requête/page [ Premièr(e) ]
Boucle [ Purge: Systématique ]
    Définir rubrique [ Clients::Contact en journée ; Clients::Téléphone professionnel ]
    Afficher enreg/requête/page [ Suivant(e) ; Sortie après dernière: Oui ]
Fin de boucle

Exemple 2 

Fait une boucle dans les enregistrements pour exporter des fichiers se trouvant dans la rubrique Conteneur.

Copier
Définir variable [ $PATH ; Valeur: Obtenir ( CheminDocuments ) & Produits::Conteneur ]
Afficher enreg/requête/page [ Premièr(e) ]
Boucle [ Purge: Systématique ]
    Exporter contenu de rubrique [ Produits::Conteneur ; "$PATH" ; Créer dossiers: Non ]
    Afficher enreg/requête/page [ Suivant(e) ; Sortie après dernière: Oui ]
Fin de boucle