Spécification d'un identifiant et d'une requête de classe d'entités de schéma à l'aide de l'éditeur d'identifiant et de requête de Schematics

Les diagrammes schématiques contiennent des entités schématiques créées par le générateur du modèle de diagramme à partir des données en entrée, spécifiées au début de la création du diagramme. Cependant, tout diagramme schématique (quel que soit le générateur associé) peut également contenir des entités de schéma créées à partir de requêtes personnalisées, configurées sur certaines classes d'entités schématiques. Cela signifie que tout contenu de diagramme peut inclure un mélange d'entités de schéma créées à partir d'un générateur et d'entités créées à partir de requêtes personnalisées. De plus, lors de l'utilisation du générateur standard, les diagrammes peuvent être entièrement créés à partir de requêtes personnalisées.

La section suivante explique comment déterminer une requête et des identifiants pour une classe d'entités de schéma associée à un modèle de diagramme de générateur standard configuré pour générer des diagrammes, entièrement créés à partir de requêtes personnalisées, pour chaque usine à gaz.

Remarque :

Pour en savoir plus sur le mode de configuration d'un modèle de diagramme de ce type, consultez la rubrique Spécification d'un identifiant et d'une requête de modèle de diagramme schématique à l'aide de l'éditeur d'identifiant et de requête de Schematics.

Etapes :

1. Modifiez votre jeu de données de schéma dans l'éditeur Jeu de données de schéma.
2. Si les ressources de jeu de données de schéma ne sont pas réorganisées dans une arborescence dans la fenêtre +++Schematic Items, cliquez sur l'option Vues de la barre d'outils de l'éditeur Jeu de données de schéma, puis sur +++Project Tree.
3. Cliquez sur l'entrée de la classe d'entités de schéma pour laquelle vous souhaitez définir une requête personnalisée dans l'arborescence de l'éditeur Jeu de données.
4. Cliquez sur l'onglet Propriétés associé, dans la fenêtre de l'éditeur Jeu de données, sur la droite.
5. Dans la section Requête, cliquez sur la flèche Mode d'évaluation, puis sur +++Query on Generate/Update.
   • Par défaut, les classes d'entités schématiques sont créées via le mode d'évaluation +++No Query : aucune requête personnalisée n'est définie pour la génération des entités de schéma associées.
   • Le mode d'évaluation +++Query on Start Editing doit être défini si vous souhaitez que la requête soit réexécutée de manière dynamique à chaque démarrage d'une session de modification sur le diagramme schématique.

   En savoir plus sur les requêtes personnalisées dynamiques sur les classes d'entités de schéma

   Attention :

   Les règles schématiques fonctionnent uniquement sur les entités de schéma créées via des requêtes personnalisées, pour lesquelles le mode d'évaluation avec interrogation lors de la génération ou de la mise à jour est choisi. Les entités schématiques créées par des requêtes personnalisées (le mode d'évaluation avec interrogation au début de la modification étant sélectionné) sont traitées après l'exécution de la règle lors de la génération et de la mise à jour des diagrammes.

   Le bouton +++Edit Query/Identifier est automatiquement activé.

6. Cliquer sur le bouton +++Edit Query/Identifier .

   La boîte de dialogue +++Query/Identifier Editor s'ouvre :

7. Dans la liste Source de données (1), cliquez sur la source de données souhaitée.

   Toutes les sources de données référencées dans le jeu de données de schéma sont disponibles dans la liste déroulante.

8. Dans la liste Tables (2), cliquez sur la table sur laquelle la requête doit être exécutée.

   Le contenu de la table sélectionnée est automatiquement affiché dans la surface 3.

   Remarque :

   Double-cliquez sur la table de votre choix dans la liste Tables pour que la zone Requête (4) affiche automatiquement une requête par défaut, qui renvoie tous les enregistrements de cette table.

9. Dans la zone Requête (4), saisissez le code SQL de la requête.

   Dans cet exemple, comme vous souhaitez éliminer les éléments associés à une usine à gaz, définissez une requête utilisant le champ plant_number en tant que paramètre :

   Dans la section Paramètres, procédez comme suit :

   • Choisissez l'attribut de schéma qui sera utilisé pour exécuter la requête à partir de la liste déroulante Nom. Cet attribut de schéma est souvent spécifié en tant que modèle de diagramme associé.
   • Sélectionnez la case à cocher +++Is Text si les valeurs d'attribut sont de type textuel. Désélectionnez cette case à cocher pour tout autre type de valeur.
   • Dans le champ +++Test Value, spécifiez une valeur de test avant de cliquer sur Afficher les résultats et de tester le résultat de la requête.

10. Cliquez sur Afficher les résultats.

    Le résultat de la requête est affiché dans la section Résultats (6) :

11. Dans la liste Champs (7), cliquez sur le champ qui sera utilisé pour créer l'identifiant de chaque élément d'entité de schéma renvoyé par la requête, puis utilisez le bouton Se déplacer vers la droite (8) pour valider cette décision.

    Le nom du champ choisi est automatiquement affiché dans la liste Identifiant (9) :

    Remarque :

    • Plusieurs noms de champ peuvent être spécifiés pour la création d'identifiants d'entité de schéma. Dans ce cas, chaque identifiant est obtenu via la concaténation de tous les champs dans leur ordre séquentiel d'entrée ; autrement dit, dans l'ordre de la liste Identifiant. Les champs concaténés présentent un trait d'union. Pour modifier la séquence des champs, cliquez sur le champ que vous souhaitez déplacer dans la liste Identifiant et cliquez ou sur la flèche Déplacer vers le haut ou Déplacer vers le bas, sur la droite de la section Identifiant, jusqu'à ce que la liste respecte l'ordre requis.
    • Des constantes de chaîne peuvent également être configurées pour la création d'identifiants d'entité de schéma. Utilisez le bouton +++Add Identifier situé à droite de la section Identifiant pour ajouter cette chaîne aux identifiants ; elle sera concaténée avec les autres champs spécifiés.

    Attention :

    Lorsque vous configurez des paramètres pour créer des identifiants d'entité de schéma, n'oubliez pas les éléments suivants :

    • Un identifiant ne peut pas inclure plus de 128 caractères.
    • L'identifiant doit être unique pour chaque entité de schéma contenue dans un diagramme.

12. Cliquez sur OK pour valider et mettre un terme à la définition de la requête de la classe d'entités de schéma.

    Le code SQL est automatiquement indiqué dans le champ de surface Requête, sur l'onglet Propriétés de la classe d'entités de schéma.

Attention :

Les paramètres de la section Requête peuvent être configurés et modifiés à n'importe quel moment, pour toute classe d'entités de schéma. Cependant, cette opération ne doit être exécutée qu'en cas de nécessité. En général, on doit configurer la requête de classe d'entités de schéma si cette classe est associée à un modèle de diagramme de générateur standard pour la génération de diagrammes sur la base exclusive de requêtes personnalisées, mais la configuration d'une requête pour une classe d'entités de schéma gérée par n'importe quel autre générateur prédéfini n'est nécessaire que si vous voulez créer des diagrammes mixtes, dont le contenu inclut des entités de schéma générées à partir de données d'entrée spécifiées lors de la génération du diagramme, et d'autres entités, créées à partir de ces requêtes personnalisées.