Vous êtes sur la page 1sur 35

Abonnez-vous à DeepL Pro pour traduire des fichiers plus volumineux.

Visitez www.DeepL.com/pro pour en savoir plus.

StudioTM
AVEVA PML 1.1
Guide de l'utilisateur
AVEVA Solutions Limited

Clause de non-responsabilité
1.1 AVEVA ne garantit pas que l'utilisation du logiciel AVEVA sera ininterrompue, exempte d'erreurs ou de virus.
1.2 AVEVA n'est pas responsable la perte de profits ; la perte d'affaires ; l'épuisement du fonds de commerce et/ou des
pertes similaires ; la perte d'économies anticipées ; la perte de biens ; la perte de contrat ; la perte d'utilisation ; la perte
ou la corruption de données ou d'informations ; toute perte spéciale, indirecte, consécutive ou purement économique, les
coûts, les dommages, les frais ou les dépenses qui peuvent être subis par l'utilisateur, y compris toute perte subie par
l'utilisateur résultant de l'inexactitude ou de l'invalidité de toute donnée créée par le logiciel AVEVA, que ces pertes
soient subies directement ou indirectement, ou qu'elles résultent d'un contrat, d'un délit (y compris la négligence) ou
d'une autre manière.
1.3 La responsabilité totale d'AVEVA, qu'elle soit contractuelle, délictuelle (y compris la négligence) ou autre, liée à
l'utilisation du logiciel AVEVA, est limitée à 100 % des frais de licence payés au cours de l'année où la réclamation de
l'utilisateur a été introduite.
1.4 Les clauses 1.1 à 1.3 s'appliquent dans toute la mesure permise par la loi.
1.5 En cas de conflit entre les clauses ci-dessus et les clauses analogues de la licence de logiciel sous laquelle le
logiciel AVEVA a été acheté, les clauses de la licence de logiciel priment.

Droit d'auteur
Les droits d'auteur et tous les autres droits de propriété intellectuelle relatifs à ce manuel et au logiciel associé, ainsi que
toute partie de celui-ci (y compris le code source, le code objet, toutes les données qu'il contient, le manuel et toute
autre documentation fournie avec celui-ci) appartiennent à AVEVA Solutions Limited ou à ses filiales, ou font l'objet
d'une licence en bonne et due forme de leur part.
Tous les droits sont réservés à AVEVA Solutions Limited et à ses filiales. Les informations contenues dans ce document
sont commercialement sensibles et ne doivent pas être copiées, reproduites, stockées dans un système d'extraction ou
transmises sans l'autorisation écrite préalable d'AVEVA Solutions Limited. Lorsqu'une telle autorisation est accordée,
elle exige expressément que cet avis de copyright et la clause de non-responsabilité ci-dessus soient affichés de
manière visible au début de chaque copie effectuée.
Le manuel et la documentation associée ne peuvent être adaptés, reproduits ou copiés, sous quelque forme matérielle
ou électronique que ce soit, sans l'autorisation écrite préalable d'AVEVA Solutions Limited. L'utilisateur n'est pas
autorisé à désosser, décompiler, copier ou adapter le logiciel. Ni l'ensemble ni une partie du logiciel décrit dans cette
publication ne peut être incorporé dans un logiciel, un produit, une machine ou un système tiers sans l'autorisation écrite
préalable d'AVEVA Solutions Limited, sauf dans les cas autorisés par la loi. Toute action non autorisée de ce type est
strictement interdite et peut donner lieu à des responsabilités civiles et à des poursuites pénales.
Le logiciel AVEVA décrit dans ce guide doit être installé et utilisé en stricte conformité avec les termes et conditions des
licences logicielles respectives, et conformément à la documentation utilisateur correspondante. L'utilisation non
autorisée ou sans licence du logiciel est strictement interdite.
Copyright 2012 à l'année en cours. AVEVA Solutions Limited et ses filiales. Tous droits réservés. AVEVA n'est pas
responsable de toute violation ou infraction aux droits de propriété intellectuelle d'un tiers lorsque cette violation résulte
de la modification par un utilisateur du logiciel AVEVA ou de la documentation associée.
AVEVA Solutions Ltd, High Cross, Madingley Road, Cambridge, CB3 0HB, Royaume-Uni

Marque déposée
AVEVA™, AVEVA Everything3D™ et AVEVA E3D™ sont des marques déposées d'AVEVA Solutions Limited ou de ses
filiales. L'utilisation non autorisée des marques AVEVA™, AVEVA Everything3D™ et AVEVA E3D™ est strictement
interdite.
Les noms des produits/logiciels AVEVA sont des marques commerciales ou des marques déposées d'AVEVA Solutions
Limited ou de ses filiales, enregistrées au Royaume-Uni, en Europe et dans d'autres pays (dans le monde entier).

Logiciels tiers
Les droits d'auteur, les droits de marque ou autres droits de propriété intellectuelle sur tout autre produit ou logiciel, son
nom ou son logo appartiennent à leur propriétaire respectif.
Les logiciels tiers suivants sont inclus dans certains des produits AVEVA contenus dans cette aide en ligne :
• Basé sur Teigha® de l'Open Design Alliance.
• Interface utilisateur Microsoft® Office Fluent™. Fluent est une marque déposée de Microsoft Corporation et l'interface
utilisateur Fluent est sous licence de Microsoft Corporation. L'interface utilisateur Microsoft Office fait l'objet d'une
protection en vertu des lois américaines et internationales sur la propriété intellectuelle et est utilisée par AVEVA Solutions
Limited sous licence de Microsoft.
• Les produits redistribuables DevExpress® sont utilisés par AVEVA sous licence de Developer Express Inc. Copyright ©
2000-2014 Developer Express Inc.
Guide de l'utilisateur AVEVA
PML Studio

Fiche de révision

Date Version Commentaires / Remarques

Mai 2015 1.1 Première publication


Guide de l'utilisateur AVEVA
PML Studio
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1 Introduction

AVEVA PML Studio™ sera mis à la disposition des clients d'AVEVA qui souhaitent
augmenter leur productivité et améliorer la qualité et la maintenabilité de leurs précieuses
personnalisations PML. AVEVA PML Studio™ ne sera pas un produit commercial, il s'agira
d'un outil non supporté et librement distribuable pour aider les programmeurs PML
expérimentés à travailler plus efficacement.
AVEVA PML Studio™ prend en charge les types de fichiers suivants :
• Fichiers de fonction PML (*.pmlfnc)
• Fichiers objets PML (*.pmlobj)
• Fichiers de formulaires PML (*.pmlfrm)
• Fichiers de commande PML (*.pmlcmd)
Il existe également un certain soutien pour :
• Fichiers de macros PML (*.pmlmac)
• Fichiers de données PML (*.pmldat)
• Fichiers de débogage PML (*.pmldbg)
Les caractéristiques disponibles sont les suivantes :
• Vérification des erreurs
• Autocomplétion
• Intellisense
• Mise en évidence de la syntaxe
• Mise en retrait intelligente
• Code pliant
• Avertissements sur le code
• Navigation par thème
• Autoformatage
• Retour d'information en temps réel
• Des infobulles intelligentes
• Vérification de l'orthographe
• Navigation dans les fichiers/méthodes/membres PML

1.1 Prérequis
AVEVA PML Studio™ est basé sur Microsoft Visual Studio 2010 Shell (Isolated) et il est
indispensable de l'installer avant d'installer PML Studio. Cliquez ici pour télécharger.

Copyright 2012 à l'année en cours. 1 :1 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.2 Structure du guide


Le guide de l'utilisateur d'AVEVA PML Studio est divisé en plusieurs sections :

Questions fréquemment poséesDonne une liste de questions que l'utilisateur peut poser.
Menu PML Le menu PML vous permet d'accéder facilement aux
commandes PML.
Explorateur PML L'explorateur PML vous offre une vue organisée de
votre PMLLIB ainsi qu'un accès à la plupart des
commandes qui s'y rapportent.
Éditeur de texte L'éditeur est le traitement de texte de l'environnement
de développement intégré (IDE).

Liste d'erreurs Affiche les erreurs, les avertissements et les messages pour un fichier
PML.
Sortie Affiche les résultats des outils externes, par exemple
PML Doc et PML Cop.
Propriétés Affiche les propriétés d'un fichier PML, par exemple la
description du fichier et la date de sa dernière
modification.

Barre de navigation Permet de naviguer facilement dans un fichier PML.


PMLCop PMLCop est une application console qui vérifie les
fichiers PML et imprime un rapport dans la fenêtre de
sortie.
Documentation PML PMLDoc est une application console qui documente les documents
PML
fichiers. Il crée un dossier de fichiers html pour chaque fichier PML.
Contrôle de l'aptitude à la production Contrôle spécifique AVEVA avec PML Cop et cmCheckWix.
Vérifie si le fichier est prêt pour la production.
Note : cette option est seulement disponible
pour les employés d'AVEVA.
Vérificateur d'orthographe Vérifie l'orthographe des commentaires et des chaînes
de caractères dans un fichier PML.
Vérificateur de grammaire Vérifie la grammaire des commentaires et des chaînes de caractères
dans un fichier
Fichier PML.
Stylisation Styliser les fichiers PML en corrigeant la casse,
l'indentation et en ajoutant des crochets.

Snippets Extraits de code PML insérables et réutilisables.


Modèles La présentation standard et les composants d'un fichier
PML sont stockés dans un fichier modèle

1.3 Questions fréquemment posées

Copyright 2012 à l'année en cours. 1 :2 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
• AVEVA PML Studio est-il sous licence ? Introduction
Non, il s'agit d'un outil d'édition PML sans licence.
• Quel est le coût d'AVEVA PML Studio ?

Copyright 2012 à l'année en cours. 1 :3 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

AVEVA PML Studio est un outil gratuit.


• Comment obtenir une copie ?
AVEVA PML Studio peut être téléchargé via les canaux habituels et distribué gratuitement.
• Dois-je inclure AVEVA PML Studio dans mon contrat existant (ou similaire) ?
AVEVA PML Studio n'est pas un produit commercial, vous n'avez donc pas besoin
d'un fichier de licence pour l'utiliser.
• Ai-je besoin d'une implémentation complète de Microsoft Visual Studio® ?
Non. La condition préalable est que Microsoft Visual Studio Isolated Shell soit
installé. AVEVA Pml Studio fonctionne dans Microsoft Visual Studio Isolated Shell qui
peut être téléchargé à partir de Link. Microsoft Visual Studio Isolated Shell est
également gratuit.
• Sera-t-il pris en charge comme les autres produits, c'est-à-dire qu'il bénéficiera de corrections de
défauts ?
Le logiciel est fourni tel quel, sans garantie. Il s'agit d'un outil qui ne sera pas pris en
charge et les demandes de correction de bogues, de développement, etc. ne
s'appliqueront pas.
Pour l'instant, il n'y a pas de feuille de route ou de plan pour une version ultérieure.
• Existe-t-il des exigences en matière de formation ?
Non. Un document simple est fourni avec l'outil. L'outil est destiné à être utilisé par
des programmeurs PML compétents et devrait être facilement adopté par des
utilisateurs ayant une expérience de la syntaxe de notre langage macro
programmable.
• Y a-t-il une limite au nombre de copies qu'une entreprise peut
avoir ? Non. Il peut être distribué librement.
• Dispose-t-il d'un concepteur de formulaires PML ?
Non.
• Peut-on déboguer le code, c'est-à-dire insérer des points d'arrêt et
interroger les valeurs des variables ? Non.
• Peut-on exécuter PML directement à partir d'AVEVA PML Studio ?
Non. Vous devez toujours l'exécuter dans l'application principale.
• Est-il lié au cryptage PML ? Non.
• S'intègre-t-il aux applications PML .NET développées dans Visual Studio ?
Les appels de PML vers le code .NET sont pris en charge, mais les fonctions telles
que Go to Declaration ne seront pas transférées vers le code .NET.
• AVEVA PML Studio est-il compatible avec les anciens produits et versions ?
AVEVA PML studio est compatible avec tous les produits supportés qui peuvent
actuellement utiliser la personnalisation PML ; cela inclut AVEVA Everything3D™,
AVEVA PDMS™, AVEVA Marine™, AVEVA Engineering™ et AVEVA Diagrams™.

1.4 Menu PML


Le menu PML vous permet d'accéder facilement aux commandes PML.

Copyright 2012 à l'année en cours. 1 :4 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Explorateur PML Ouvre PML Explorer. Reportez-vous à PML Explorer pour plus d'informations.
des informations.
Style Sous-menu contenant les options de stylisation du fichier PML. Se référer à
Styling pour plus d'informations.
Production Ready Checks (Contrôles prêts pour la production) Exécute le contrôle de la production prête sur
le fichier PML en cours.
Pour plus d'informations, reportez-vous à la section Contrôle de l'état de préparation de la
production.
Document Exécute PML Doc sur le fichier PML en cours ou sur la
PMLLIB dans l'explorateur PML. Pour plus d'informations,
reportez-vous à la documentation PML.

Voir l'aide PML Ouvre un navigateur web contenant l'aide HTML.


A propos de PML Studio Ouvre une boîte de dialogue contenant des informations sur PML Studio.
y compris le numéro de version.

1.5 Explorateur PML


L'explorateur PML vous offre une vue organisée de votre PMLLIB ainsi qu'un accès à de
nombreuses commandes qui s'y rapportent. L'explorateur PML se trouve dans le menu
Affichage et PML.

Copyright 2012 à l'année en cours. 1 :5 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Barre d'outils
Les options disponibles sont les suivantes :

Select Folder Ouvre une boîte de dialogue pour sélectionner un dossier.


Sélectionnez votre dossier PMLLIB ou tout autre dossier
contenant des fichiers PML. Le dossier sera ajouté à
l'explorateur.

Rafraîchir tout Rafraîchit tous les dossiers et fichiers de l'explorateur PML. Utilisé
pour mettre à jour les modifications effectuées en dehors
de PML Studio.

Réduire toutRéduit l 'arborescence des dossiers et fichiers PML.

Configuration La fenêtre de configuration s'affiche et vous permet de définir des


extensions supplémentaires. Il existe un format spécifique
pour définir les extensions, elles doivent commencer par '.'
et se terminer par ';', le ';' faisant office de séparateur.
Plusieurs extensions peuvent être définies, par exemple,
'.png ;.txt;'.

RechercherPermet de rechercher un fichier PML dans l'arborescence de


l'explorateur PML.

Copyright 2012 à l'année en cours. 1 :6 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Vue de l'arbre
Affiche une arborescence de tous les dossiers et fichiers acceptables dans le dossier
sélectionné. Les fichiers acceptables sont les fichiers PML ou les fichiers dont l'extension
est définie dans la boîte de dialogue Configuration.

FolderIcon pour tous les dossiers.

Fichier PML Icône pour tous les fichiers PML.

Objet, Icône pour la déclaration principale d'un fichier PML, par


Form exemple, Objet pour un fichier pmlobj.
e, fonction,
commandement
Membre Icône pour les membres. Ne devrait se trouver que dans pmlobj, pmlfrm
et
fichiers pmlcmd.
Méthode Icône pour les méthodes. Ne doit figurer que dans les
fichiers pmlobj, pmlfrm et pmlcmd.
Autre fichier Icône pour tous les autres fichiers. Voici les extensions définies
par l'utilisateur dans la boîte de dialogue Configuration.

Menu contextuel
Les options disponibles sont les suivantes :

HideHide n'est disponible que pour le dossier racine. Il supprime le dossier de


l'explorateur PML.
Ouvrir Ouvre les fichiers PML dans PML Studio et les autres
fichiers dans leurs éditeurs par défaut.
Afficher dans Ouvre l'explorateur Windows au niveau du fichier ou du dossier
l'explorateur
sélectionné.
Windows

Actualiser Actualise tous les dossiers et fichiers situés sous le


dossier ou le fichier sélectionné. L'explorateur PML ne se
met pas automatiquement à jour, il doit donc être utilisé
lorsque les dossiers et les fichiers sont modifiés de
l'extérieur ou pour ajouter ou supprimer des méthodes et
des membres dans les fichiers PML.

Ajouter Ajoute des fichiers existants ou nouveaux. Uniquement


disponible pour les dossiers.

SupprimerSupprime les dossiers ou les fichiers.

Exécuter PML CopUniquement visible si PML Cop est installé. Se référer à PMLCop
pour
plus d'informations.
ation de l'état de préparation
Production
Vérific

Copyright 2012 à l'année en cours. 1 :7 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
AVEVA. PourGuide
plus d'informations, reportez-vous
de l'utilisateur à la section
AVEVA
Uniquement visible sur les machines
Vérification de l'état de préparation à la production.
PML Studio
Document Visible uniquement si PML Doc est installé. Se référer à PML
Introduction
Documentation pour plus d'informations.

Copyright 2012 à l'année en cours. 1 :8 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.5.1 Référence PMLNet


Pour disposer d'intellisense pour les objets PMLNet, un dossier PMLNet doit être identifié.

Barre d'outils
Les options disponibles sont les suivantes :

Sélectionner un dossier PMLNet Ouvre une boîte de dialogue pour sélectionner un dossier.
Sélectionner un dossier
contenant vos DLL PMLNet, qui est probablement votre
dossier PDMS/E3D. Ce dossier sera utilisé pour ajouter
l'intellisense aux objets PMLNet dans le code PML.
Rafraîchir Actualise les dll de PMLNet. Doit être utilisé, par
exemple, lorsqu'une DLL PMLNet est ajoutée au
dossier. PMLNet intellisense n'est pas automatiquement
mis à jour.

Supprimer Supprime la référence PMLNet.

1.6 Éditeur de texte


L'éditeur de texte est le traitement de texte de l'environnement de développement intégré (IDE).

1.6.1 Mise en évidence de la syntaxe


PML Studio met en évidence différentes parties du code pour en améliorer la lisibilité. Il
existe six types de texte différents dans un fichier PML, affichés dans la fenêtre de l'éditeur
de texte.
Mot-clé : BLEU
définir, configurer, .....

Commentaire : VERT FONCÉ


--, $(, $), $*

String : MAROON
',

Numéro : NOIR

Copyright 2012 à l'année en cours. 1 :9 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
[0-9] Introduction

Copyright 2012 à l'année en cours. 1 :10 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Identifiant : NOIR
!variable, .refreshDraftCanvas, ...

Texte : NOIR
=, *, ...

Ces couleurs et polices peuvent être modifiées dans Outils, Options, Environnement,
Polices et Couleurs. Les noms des éléments d'affichage correspondent aux noms ci-
dessus.

1.6.2 Mise en évidence de la parenthèse


Surligne les parenthèses lorsque le curseur est placé à gauche d'une parenthèse ouverte
ou à droite d'une parenthèse fermée. La couleur du surlignage peut être modifiée dans
Outils, Options, Environnement, Polices et Couleurs. Modifier la couleur d'arrière-plan de
l'élément pour la correspondance des accolades (rectangle).

Copyright 2012 à l'année en cours. 1 :11 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

De Microsoft : Lorsque vous tapez une parenthèse fermante, celle-ci et la parenthèse


correspondante restent en surbrillance pendant quelques secondes, ou jusqu'à ce que
vous tapiez une autre touche ou déplaciez le curseur. Cela facilite l'identification visuelle
des blocs de code. En outre, cela peut aider à identifier les parenthèses mal assorties ou
manquantes.

1.6.3 Mise en évidence des variables


Met en évidence toutes les références à la même variable locale lorsque le curseur est
placé sur une variable locale. Il met également en évidence les références dans les
chaînes de caractères. La couleur du surlignage peut être modifiée au même endroit que
le surlignage des parenthèses.

1.6.4 Erreurs, avertissements et messages


Les erreurs, les avertissements et les messages sont affichés dans l'éditeur de texte en
traçant des lignes de couleur différente sous le texte concerné.

1.6.5 Info-bulles
Indique le type et la description d'un objet. La description est tirée des commentaires dans
l'en-tête du fichier et au-dessus des méthodes et des membres.

Copyright 2012 à l'année en cours. 1 :12 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.6.6 Auto-complétion
Liste de complétion après ' ! Variables locales, variables globales et '!this'.

Liste d'achèvement après '.' Tous les membres et méthodes de l'objet précédent, y compris
les méthodes intégrées telles que '.eq'.

Liste d'achèvement complète appelée avec CTRL+SPACEBAR, ALT+ROUGE DROITE ou


CTRL+J. Variables locales, variables globales, "!this" et blocs de code communs (i.e. IF).
Elle peut également être activée dans le menu Édition -> IntelliSense -> Membres de la
liste.

Copyright 2012 à l'année en cours. 1 :13 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.6.7 Conseil de méthode


Affiche des informations sur la méthode ou la fonction et les paramètres possibles. Ces
informations s'affichent lors de la saisie des paramètres (en particulier '(' et ',') ou lorsque
vous appuyez sur les touches CTRL+SHIFT+SPACEBAR. Elle peut également être activée
dans le menu Édition -> IntelliSense.
-> Parameter Info.

1.6.8 Aller à la déclaration


Variables locales
Pris en charge. Va jusqu'à la première apparition de la variable locale dans le fichier.
Formulaires, objets, fonctions, commandes
Pris en charge. Tant qu'ils ne sont pas construits (c'est-à-dire ARRAY) et que les
fichiers sont locaux (c'est-à-dire qu'ils se trouvent tous deux dans le même
répertoire PMLLIB).
Méthodes et membres
Pris en charge. Tant qu'il ne s'agit pas de membres et de méthodes de types intégrés
(ARRAY, par exemple) et que les fichiers sont locaux (c'est-à-dire qu'ils se trouvent
tous deux dans le même répertoire PMLLIB).
Variables globales
Non pris en charge.

Copyright 2012 à l'année en cours. 1 :14 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

La fonction Aller à la déclaration est accessible via le menu contextuel de l'éditeur de texte.
Il est désactivé pour les textes sans déclaration et ne fonctionne pas avec les types
intégrés tels que ARRAY.

1.6.9 Aller à la référence


Pas encore pris en charge. Ouvre la documentation du fichier PML créé par PML Doc.

1.7 Liste d'erreurs


Affiche les erreurs, les avertissements et les messages relatifs à un fichier PML. Il est
possible de naviguer vers ces messages et de les trier.

Les erreurs sont signalées par un soulignement rouge. Quelques exemples d'erreurs :
ENDIF manquant, parenthèses non appariées, ' !" manquant.

Copyright 2012 à l'année en cours. 1 :15 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Les avertissements sont signalés par un soulignement bleu. Quelques exemples


d'avertissements : parenthèses manquantes dans IF, variables inutilisées, fautes
d'orthographe, fautes de grammaire.

Les messages ne sont pas soulignés. Un exemple de message est le code déprécié.

1.8 Sortie
Affiche les résultats d'outils externes tels que PML Doc et PML Cop.
Remarque : pour l'instant, ce service n'est disponible qu'au sein d'AVEVA.

1.8.1 Sortie PMLCop


La sortie de PMLCop vous permet de naviguer vers les erreurs, les avertissements et les
messages en double-cliquant sur la ligne portant le nom du fichier et le numéro de la ligne.

Copyright 2012 à l'année en cours. 1 :16 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.9 Propriétés
Affiche les propriétés d'un fichier PML, telles que la description du fichier et la date de sa
dernière modification.

Note : Les propriétés ne sont pas modifiables.

1.9.1 Propriétés du fichier


Seules la date de la dernière modification, la taille et l'état en lecture seule sont extraits des
propriétés du fichier et affichés dans la fenêtre Propriétés.

Copyright 2012 à l'année en cours. 1 :17 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.9.2 Informations d'en-tête PML


Seuls le nom de l'auteur, la date de création et la description sont extraits de l'en-tête du
fichier et affichés dans la fenêtre Propriétés.

1.10 Barre de navigation


Permet de naviguer facilement dans un fichier PML. La barre de navigation de gauche
contient la déclaration principale du fichier. Pour un fichier pmlobj, il s'agit de la ligne
"define object ...". La barre de navigation de droite contient toutes les déclarations du
fichier PML. Il s'agit des membres et des méthodes. La barre de navigation suit la position
actuelle du curseur et navigue vers une déclaration lorsqu'elle est sélectionnée. La liste de
la barre de navigation correspond à la liste de l'explorateur PML, tout comme les icônes.

Copyright 2012 à l'année en cours. 1 :18 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Ci-dessous, la barre de navigation de droite est développée.

1.11 PMLCop
PMLCop est une application console qui vérifie les fichiers PML. Elle imprime un rapport
dans la fenêtre de sortie. PML Cop est accessible via l'explorateur PML.

Remarque : elle n'est actuellement disponible que pour les employés internes d'AVEVA et
n'a pas encore été diffusée à l'extérieur.

Copyright 2012 à l'année en cours. 1 :19 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.11.1 Exécuter PMLCop


L'option 'Run PML Cop' permet d'exécuter PML Cop normalement tout en imprimant toutes
les données de sortie dans la fenêtre de sortie. Il ne signalera que les erreurs et les
avertissements. Il ne signale pas les avertissements relatifs à l'orthographe ou à la
grammaire. PML Cop a également des règles plus sévères que PML Studio et signalera
'$P' et 'Q VAR ...' comme des erreurs. Cela est dû au fait que PML Cop suppose que le
fichier est prêt pour la production et que ces lignes ne sont pas acceptables dans un code
de production.

1.12 Documentation PML


PMLDoc est une application console qui documente les fichiers PML. Elle crée un dossier
de fichiers html pour chaque fichier PML. La documentation PML est accessible via le
menu PML ou l'explorateur PML. Elle n'est actuellement disponible que pour les employés
internes d'AVEVA et n'a pas encore été diffusée à l'extérieur.
Menu PML :

Menu contextuel de l'explorateur PML :

Copyright 2012 à l'année en cours. 1 :20 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Documenter ce Crée un fichier ou un dossier de documentation sans lien, ce


fichier/ Documenter qui signifie qu'il n'y a pas de liens entre les fichiers HTML. Un
ce aperçu du fichier HTML sera affiché pour les fichiers simples,
tandis que les fichiers multiples (un dossier) demanderont
simplement un emplacement d'enregistrement.
Document AllCrée un dossier de documentation lié, ce qui signifie qu'il existe des
liens entre les fichiers HTML permettant une navigation interne.
Le dossier est entièrement interne et peut être déplacé
n'importe où. Le dossier PML documenté est le dossier racine
de l'explorateur PML. Une boîte de dialogue demande un
emplacement de sauvegarde pour la documentation.

1.13 Contrôle de l'état d'avancement de la production


Le contrôle de production est utilisé pour vérifier le fichier PML actuel avant de l'enregistrer
dans le contrôle de source. Il vérifie que le fichier PML ne comporte pas d'erreurs avec
PMLCop et qu'il se trouve dans le bon fichier WIX. Il s'ouvre et affiche les résultats dans la
fenêtre de sortie (la position par défaut est ancrée au bas de l'écran). PML Cop a des
règles plus sévères que PML Studio, par exemple '$P' est un avertissement dans PML
Studio mais une erreur dans PML Cop parce qu'un tel code ne devrait pas se trouver dans
un code prêt pour la production.

Note : Cette option n'est pas disponible sur la version externe de PML

Studio. Menu PML :

Copyright 2012 à l'année en cours. 1 :21 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Menu contextuel de l'explorateur PML :

1.14 Vérificateur d'orthographe


Le correcteur orthographique est désactivé et activé dans Outils -> Options -> Editeur de
texte -> PML -> Correcteur orthographique. La vérification des fautes d'orthographe dans
les chaînes et les commentaires peut être désactivée et activée séparément. Les mots
individuels à ajouter au correcteur orthographique sont ajoutés dans la première liste
intitulée Mots acceptés. Les fichiers de mots à accepter sont ajoutés dans la deuxième liste
intitulée Mots acceptés dans les fichiers du dictionnaire. Ce correcteur orthographique est
basé sur Hunspell.

Copyright 2012 à l'année en cours. 1 :22 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Les erreurs sont affichées sous forme d'avertissements dans l'éditeur de texte.

1.14.1 Mots spécifiques à AVEVA


Il existe une liste de mots spécifiques à AVEVA qui ne sont pas signalés comme des
fautes d'orthographe. Ces fichiers sont stockés sous les noms pml.dic, appspell.dic et
desvir.dic.

1.14.2 Dictionnaires supplémentaires


Vous pouvez également ajouter des fichiers contenant des mots que vous souhaitez voir
acceptés par le correcteur orthographique. Ces fichiers doivent avoir la même forme que
les dictionnaires spécifiques AVEVA. Ils doivent avoir l'extension '.dic', chaque mot est sur
une ligne séparée et '#' indique des commentaires.

1.14.3 Correction automatique des fautes d'orthographe


La boîte de dialogue "Corriger l'orthographe" est accessible via le menu contextuel de
l'éditeur de texte. Elle n'est disponible que pour les fautes d'orthographe et lorsque la
vérification orthographique est activée. Le mot peut être ajouté au dictionnaire, il apparaîtra
alors dans la liste des mots acceptés dans les options du correcteur orthographique. Le
mot peut également être remplacé par un mot acceptable.

Copyright 2012 à l'année en cours. 1 :23 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.15 Vérificateur de grammaire


Le vérificateur de grammaire est activé ou désactivé dans Outils -> Options -> Editeur de
texte -> PML -> Vérificateur de grammaire. La valeur par défaut est désactivée. La
vérification des fautes de grammaire dans les chaînes de caractères et les commentaires
peut être désactivée et activée séparément.
Note : Le correcteur grammatical provient de Microsoft Word et nécessite une installation
locale de Microsoft Word pour fonctionner correctement.

Copyright 2012 à l'année en cours. 1 :24 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Les erreurs sont affichées sous forme d'avertissements dans l'éditeur de texte.

1.16 Stylisme
Styliser les fichiers PML en corrigeant la casse, l'indentation et en ajoutant des crochets.

Copyright 2012 à l'année en cours. 1 :25 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Fix Casing Fixetous les boîtiers dans le fichier PML actuel.


• Les références d'objets sont toutes en majuscules.
• Les références de forme, de fonction et de
commandement sont toutes en camel case.
• Les mots-clés PML tels que "if" et "setup" sont tous en
minuscules.

Ajouter des parenthèsesAjoute des parenthèses à toutes les instructions IF dans le


fichier PML actuel.

Fill Indentation Fixe l'indentation dans le fichier PML actuel.


• IF, HANDLE et DO sont en retrait.
• L'objet, la forme, la fonction et le commandement sont en retrait.
• Les gadgets FRAME, VIEW, RGROUP et BAR sont
indentés.
• Supprime les espaces à la fin du texte.
• Supprime les onglets.
Fixer toutEffectue toutes les autres commandes de stylisme en même temps.

1.17 Bribes
Les snippets sont des extraits de code PML insérables et réutilisables.

1.17.1 Utilisation des snippets


Les snippets par défaut sont stockés dans le dossier d'installation de PML Studio.
Différents snippets sont disponibles, tels qu'une boucle DO ou un schéma de base d'un
objet. La liste des snippets se trouve dans Outils -> Gestionnaire de snippets de code.
Ils peuvent être activés de différentes manières :
• Raccourci par défaut Ctrl+K, Ctrl+X (bien que cela soit modifiable dans Outils -> Options...)
• Édition -> Intellisense -> Insérer un extrait...
• Menu contextuel du clic droit.
• Saisissez le raccourci d'un extrait (par exemple, "if" pour le bloc IF) et appuyez sur la touche de
tabulation.

Copyright 2012 à l'année en cours. 1 :26 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

Insérer un extrait ajoutera l'extrait de code avec des espaces en surbrillance pour des
informations supplémentaires.

SurroundsWith est utilisé lorsque le code est sélectionné. Le code sélectionné est entouré
par l'extrait ; ceci est utile lors de la création d'un bloc IF.

1.17.2 Informations importantes


Il existe des extraits de documentation pour les méthodes et les fichiers, dont les
raccourcis sont respectivement "docm" et "docf". Il existe également des extraits pour les
objets, les formulaires, les méthodes, etc. dont les en-têtes sont déjà inclus.

1.17.3 Créer un extrait


1. Créez un dossier, "MyDocuments\PML Studio\Snippets" est suggéré mais pas nécessaire.

Copyright 2012 à l'année en cours. 1 :27 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

2. Placez tous les snippets dans ce dossier et dans les sous-dossiers éventuels. Les
snippets doivent porter l'extension ".snippet"
3. Enregistrer le dossier dans le gestionnaire de code snippets à l'aide du bouton
"Ajouter...", sous la langue correcte - PML.

1.18 Modèles
La présentation standard et les composants d'un fichier PML sont stockés dans un fichier
modèle, par exemple un fichier pmlobj contenant un en-tête, un objet et une méthode.

1.18.1 Menu - Nouveau fichier


On y accède par Fichier > Nouveau >
Fichier. Il existe deux types de modèles :
• Fichiers PML par défaut - Il s'agit de fichiers simples standard qui sont stockés dans le
répertoire d'installation.
• Modèles généraux - Comme *.txt, tous ces modèles ne fonctionnent pas.

Copyright 2012 à l'année en cours. 1 :28 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
Introduction

1.18.2 PML Explorer - Nouveau fichier

Modèles La liste des modèles est constituée des modèles PML par
défaut et des modèles PML définis par l'utilisateur.

Nom du fichier Automatiquement vide. Nom de fichier sans extension.


Auteur Ce champ est automatiquement alimenté par le nom de
l'utilisateur, mais il peut également être modifié.
Date de création Automatiquement renseignée avec la date du jour, mais aussi avec la date
de création.
modifiable.
Description Automatiquement rempli avec le nom du fichier divisé en utilisant camel
mais il est également modifiable.

1.18.3 Créer un modèle


Tous les modèles créés par l'utilisateur doivent être placés dans MyDocuments\PML
Studio\Templates (ou MyDocuments\Visual Studio [version]\Templates\MyPMLTemplates
pour le PML Studio intégré). Un fichier VSDIR doit également être créé pour fournir des
informations sur les modèles. Le format d'un fichier VSDIR peut être trouvé ici. Il ne doit y
avoir qu'un seul fichier VSDIR dans le dossier. Tous les modèles créés par l'utilisateur
n'apparaîtront que dans la boîte de dialogue Nouveau fichier de l'Explorateur PML.

Copyright 2012 à l'année en cours. 1 :29 1.1


AVEVA Solutions Limited et ses filiales. Tous
les droits sont réservés.
Guide de l'utilisateur AVEVA
PML Studio
ÅVüVA

Vous aimerez peut-être aussi