Recherche dans le projet pour TIA Portal
Sur cette page
Ce que fait la fonction
La recherche dans le projet trouve du texte à l'intérieur des blocs du projet TIA Portal ouvert, qu'il soit connecté via TIA Portal ou ouvert hors ligne depuis le disque. Saisissez un mot, un nom de variable ou une expression : la recherche parcourt le contenu de chaque OB, FB, FC, DB, type de données d'automate (UDT) et table des variables d'automate, y compris les éléments à l'intérieur des Software Unit. Dans les tables des variables, la recherche porte sur les noms de variables, les types de données, les adresses, les commentaires et les constantes utilisateur. Chaque résultat est listé avec sa ligne et peut être ouvert directement.
Elle permet de répondre à des questions comme :
- « Où la variable
tempRampStepest-elle utilisée dans le projet ? » - « Quels blocs déclarent une entrée nommée
enable? » - « Où le code compare-t-il avec
T#500MS? »
Elle complète les autres recherches : l'Ouverture rapide (F7) trouve les blocs par leur nom, Find in Project liste les références croisées d'un bloc, et la recherche dans le projet est la seule qui parcourt le contenu textuel des blocs.
Comment l'ouvrir
| Déclencheur | Action |
|---|---|
| Barre d'activité | Cliquez sur l'icône Recherche dans le projet (la loupe avec une ligne ondulée) |
| Menu Affichage | Choisissez Recherche dans le projet |
| Palette de commandes | Exécutez Recherche dans le projet |
La page de recherche dans le projet s'ouvre immédiatement dans la zone de l'éditeur et laisse la barre latérale telle quelle : si l'arborescence du projet est affichée, elle reste visible à côté de la recherche. Un nouveau clic sur l'icône ramène la page ouverte au premier plan.
La recherche fonctionne pour un projet connecté via TIA Portal et pour un projet ouvert hors ligne depuis le disque. Sans projet ouvert, la page affiche "Connect to a TIA project to search the content of its blocks." avec un bouton Connecter, et Rechercher reste indisponible jusqu'à l'ouverture d'un projet.
Lancer une recherche
Saisissez le texte à rechercher et appuyez sur Enter ou cliquez sur Rechercher. Trois boutons à bascule dans le champ de recherche affinent la requête :
- Respecter la casse distingue exactement les majuscules et les minuscules.
- Mot entier ne trouve le texte que sous forme de mot complet.
- Utiliser une expression régulière traite le texte comme une expression régulière.
La première recherche prépare les sources du projet et peut prendre un moment. Pendant son exécution, un affichage de progression avec un compteur sur tous les éléments et le temps écoulé apparaît à côté de l'arborescence du projet et dans la barre d'état, les deux permettant d'annuler. Les recherches suivantes ne reprennent que les blocs modifiés depuis la dernière recherche et sont rapides. Les sources préparées restent avec le projet après la fermeture de Studio : la première recherche d'une nouvelle session vérifie seulement quels blocs ont changé entre-temps.
Filtrer, avant et après la recherche
Deux rangées de filtres, chaque pastille indique le nombre de résultats qu'elle représente :
- Type : OB, FB, FC, DB, UDT, Tags. Cliquez sur une pastille pour n'afficher que ces éléments, cliquez de nouveau pour la relâcher.
- Interface ou code : Interface conserve les résultats situés dans la section de déclaration d'un bloc, les déclarations de variables avant
BEGIN(VAR_INPUT,VAR_OUTPUT,VAR,VAR_TEMP, constantes). Code conserve les résultats situés dans l'implémentation aprèsBEGIN. Les blocs de données, les types de données d'automate et les tables des variables comptent entièrement comme interface.
Les pastilles de type peuvent aussi être choisies avant de lancer la recherche : seuls les types sélectionnés sont alors préparés, ce qui accélère la recherche. Si vous activez d'autres types après une recherche restreinte, un message vous invite à relancer la recherche pour les inclure.
Ainsi, une recherche sur un nom de variable avec la pastille Interface active répond à « où est-elle déclarée », et avec la pastille Code active à « où est-elle utilisée dans la logique ».
Lire les résultats
Les résultats sont regroupés par bloc : une ligne de bloc avec l'icône, le type, le chemin dans le projet et le nombre de résultats du bloc, et en dessous une ligne par résultat avec le numéro de ligne, une étiquette Interface ou Code et la ligne trouvée, avec l'occurrence mise en évidence.
Après une recherche, les blocs sont réduits, de sorte que la liste se lit comme une vue d'ensemble. Cliquez sur une ligne de bloc (ou appuyez sur Enter dessus) pour la développer ou la réduire ; les deux boutons à l'extrémité droite de la rangée de filtres développent ou réduisent tous les blocs à la fois. Cliquez sur un résultat (ou appuyez sur Enter) pour ouvrir le bloc avec la ligne trouvée sélectionnée ; un résultat dans une table des variables ouvre cette table des variables.
Un clic droit sur un résultat propose d'autres actions : Ouvrir, Ouvrir sur le côté, Afficher dans l'explorateur de projet, la copie de la ligne, du nom ou du chemin, et Retirer des résultats pour enlever les entrées que vous avez déjà traitées (la recherche suivante ramène tout).
Remplacer dans tout le projet
La petite flèche à gauche du champ de recherche ouvre une ligne Remplacer, qui transforme la page en recherche et remplacement à l'échelle du projet. Le remplacement nécessite le forfait Pro. Saisissez le texte à rechercher, le texte de remplacement, puis lancez la recherche. Choisissez ensuite votre rythme :
- Remplacer tout modifie en une fois tous les résultats affichés. Une confirmation résume combien de résultats dans combien de blocs vont changer ; les blocs modifiés sont importés dans le projet TIA Portal et compilés, puis la recherche est relancée pour vous montrer ce qui reste. Les filtres s'appliquent : seuls les résultats actuellement affichés sont remplacés.
- Résultat par résultat : les boutons fléchés de la ligne Remplacer passent au résultat précédent ou suivant, chaque saut le sélectionne dans la liste et affiche le bloc à côté de la recherche, à cette ligne. Le bouton Remplacer modifie le résultat actuel et passe au suivant, vous pouvez donc parcourir toute la liste en cliquant plusieurs fois sur Remplacer. Cela fonctionne aussi par ligne de résultat : survolez un résultat et cliquez sur son icône de remplacement (également dans le menu contextuel, avec Remplacer tout dans le bloc). Le bloc s'ouvre à côté des résultats de recherche avec le remplacement déjà effectué et sélectionné, pour que vous puissiez le vérifier, l'annuler ou continuer à modifier ; rien ne change dans le projet tant que vous n'enregistrez pas le bloc, et l'enregistrement l'importe comme toute autre modification de bloc.
Si un bloc a changé dans TIA Portal depuis la recherche, ses résultats sont ignorés avec une remarque ; relancez la recherche pour les actualiser. Les résultats dans des blocs en lecture seule ne peuvent pas être remplacés. Remplacer tout ignore aussi les résultats dans les types de données d'automate de sécurité et les nomme dans sa confirmation ; remplacez-les plutôt un par un : le remplacement est placé dans le document source ouvert, et son enregistrement nécessite la connexion au programme de sécurité, comme toute autre modification d'un type de données de sécurité. Avec Utiliser une expression régulière actif, les références de groupe de type $1 fonctionnent dans le texte de remplacement.
Les résultats dans les tables des variables d'automate sont également remplacés, y compris les tables des variables à l'intérieur des Software Unit : les types de données, les adresses et les commentaires des variables, le nom, la valeur, le type de données et le commentaire des constantes utilisateur, et à partir de TIA Portal V20 également les noms de variables et le nom de la table des variables elle-même. Comme une table des variables n'a pas d'éditeur de texte, un remplacement dans une table des variables est écrit immédiatement dans le projet TIA Portal ; Remplacer, Remplacer la correspondance et Remplacer tout dans le bloc sur une table des variables demandent d'abord votre confirmation. Une variable ou une constante renommée conserve ses utilisations dans les blocs, si bien que remplacer un ancien nom par un nouveau modifie ensemble la table des variables et le code ; avec Remplacer tout, les tables des variables sont modifiées d'abord, puis les blocs. Une table des variables renommée conserve son éditeur ouvert et affiche son nouveau nom dans l'Explorateur de projet. Une table des variables ouverte affiche le nouvel état ; si elle contient encore des modifications de votre part qui ne sont pas chargées, chargez-les ou abandonnez-les avant d'y effectuer un remplacement. Les noms sont uniques dans toutes les tables des variables d'un automate, donc un remplacement qui donnerait à une variable ou à une constante un nom déjà utilisé, ou la laisserait sans nom, est listé comme ignoré. Les noms de variables et les noms de tables des variables restent inchangés avant TIA Portal V20, la table des variables par défaut conserve son nom, et une variable de sécurité ne peut être modifiée qu'après la connexion au programme de sécurité.
Remarques
- Les blocs graphiques (LAD, FBD, GRAPH) sont recherchés via leur forme textuelle à partir de TIA Portal V20 ; un clic sur un tel résultat ouvre le bloc dans cette forme textuelle, à la ligne concernée. Sur les versions plus anciennes de TIA Portal, ces blocs ne sont pas recherchés dans leur texte et restent trouvables par leur nom via l'Ouverture rapide.
- Les tables des variables sont relues à chaque recherche, les modifications faites dans TIA Portal sont donc toujours prises en compte ; désélectionnez la pastille Tags si vous n'en avez pas besoin et souhaitez la recherche répétée la plus rapide.
- Les blocs protégés par know-how ne sont pas recherchés.
- Un type de données d'automate de sécurité est recherché via son texte source à partir de TIA Portal V20 tant que Ouvrir les UDT en .udt est activé dans les paramètres de l'éditeur ; un clic sur un tel résultat l'ouvre en modification à la ligne concernée, comme tout autre type de données, et l'enregistrement fonctionne comme lorsque le type est ouvert depuis l'Explorateur de projet. Si l'option est désactivée, sur les versions plus anciennes de TIA Portal, dans un projet ouvert hors ligne ou pour un type de données à l'intérieur d'une Software Unit, il est recherché dans sa forme XML et un résultat l'ouvre en lecture seule à la ligne concernée.
- Un projet ouvert hors ligne depuis le disque est également recherché. Ses blocs sont recherchés en tant que texte ; les blocs de données, les types de données d'automate et les tables des variables sont recherchés dans la forme XML que l'éditeur affiche pour eux, et un résultat ouvre cette forme à la ligne concernée. Les blocs graphiques (LAD, FBD, GRAPH) ne sont pas recherchés dans leur texte dans un projet ouvert hors ligne.
- Le remplacement dans les tables des variables nécessite un projet connecté via TIA Portal ; dans un projet ouvert hors ligne, les tables des variables sont en recherche seule.
- Le remplacement dans un projet ouvert hors ligne conserve les blocs modifiés pour la session en cours ; exportez-les ou enregistrez-les sous forme de fichiers pour conserver les modifications.
- La recherche est incluse à partir du forfait Basic ; le remplacement nécessite le forfait Pro.