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.

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 :

• une action de script Fin de boucle si ;

• une action de script Afficher enreg/requête/page ou une action de script Activer rangée externe lorsque l'option Sortie après dernièr(e) est sélectionnée.

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.

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.

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

Rubriques connexes 

• Exemples d'une structure en boucle
• Page de référence des actions de script