Les commandes
Commandes sur les objets
• .Créer ou .Create : création d'un objet
• .Modifier ou .Update : modification d'un MetaAttribute d'objet
• .Supprimer ou .Delete : suppression d'un objet
Vous pouvez utiliser les verbes indifféremment en français ou en anglais.Commandes sur les liens
• .Relier ou .Connect : création d'un lien entre deux objets
• .Délier ou .Disconnect : suppression d'un lien entre deux objets
• .Changer ou .Change : modification d'un MetaAttribute de lien
Vous pouvez utiliser les verbes indifféremment en français ou en anglais.Autres Commandes
• .Valider ou .Validate : provoque un enregistrement intermédiaire lors de l'import
• .Description ou .Description : provoque un affichage dans la fenêtre d'import
Les règles à respecter
Les fichiers de commandes doivent respecter les règles suivantes :
• Les lignes de commandes sont de 5000 caractères au maximum.
• Les noms des objets sont limités à :
• 63 caractères pour les types d'objet sans espace de nommage (namespace).
• 255 caractères pour les types d'objet avec espace de nommage (nom ou nom local).
• Les commandes commencent par un verbe à l'infinitif préfixé par un ".".
Vous pouvez utiliser ces verbes indifféremment en français ou en anglais.• Le "." de la commande doit être en première colonne.
• Le caractère de continuation est le tiret (-) en fin de ligne.
• Le caractère "commentaire" est le tiret (-) en début de ligne.
• Les guillemets (") doivent être utilisés pour limiter les valeurs qui contiennent des blancs ou des caractères autres que des chiffres et des lettres.
Remarques
• Certains objets ne sont pas valides fonctionnellement tant qu'un de leurs MetaAttributes n'est pas renseigné ou qu'un lien n'est pas défini. Par exemple, un objet de type diagramme doit être relié à un autre objet par un lien de type description. On dit que le diagramme décrit cet objet.
• Pour échanger des données entre deux environnements HOPEX, ils doivent posséder des métamodèles identiques et des graphes d'utilisateurs cohérents.
Les commandes en fonction du type de fichier
Chaque commande doit être constituée :
• d'un verbe, qui indique l'action à effectuer
• d'une liste de paramètre nécessaire pour effectuer cette action (type et nom des objets)
• d'un mot clé ".CHK" qui va être suivi de la liste des IdAbs des objets impactés par cette commande.
Le fait de répéter dans la commande le nom de l'objet et son IdAbs permet de l'exécuter correctement même si l'objet a été renommé.La différence entre une commande d'un fichier ".MGR" et la même commande d'un fichier ".MGL" réside dans le ".CHK" :
• elles ont le même verbe
• elles ont la même liste de paramètres
• le ".CHK" du MGL contient en plus, en dernière position l'IdAbs de l'utilisateur qui a passé la commande.
Le troisième format de fichier (obsolète dans cette version) est ".MGE". Dans ces fichiers, les commandes ne disposent pas du .CHK. Les IdAbs sont attribués au fur et à mesure. Il est alors impossible de traiter les objets "namespacés" pour lesquels l'IdAbs de l'espace de nommage ne peut pas être attribué, car il fait partie de leur nom. Les références au métamodèle
Chaque instance du métamodèle (MetaClass, MetaAttribute, …) peut être préfixé de son IdAbs. Ceci assure la pérennité des fichiers en dépit des renommages qui pourraient être effectués dans le métamodèle.
Exemple :
"~OsUiS9B5iiQ0[Operation]" est équivalent à "Operation".