Réserver une Démo

SVP notez : Cette page d’aide n’est pas pour la dernière version d’Enterprise Architect. La dernière aide peut être trouvée ici.

Pré. Proc.

Créer une Query SQL personnalisée

Lors de la définition de votre propre instruction SQL pour un fragment de gabarit , un certain nombre d'options sont disponibles pour vous aider à fournir le format de rapport souhaité. La requête dépend du SGBD, de sorte que la structure peut varier en fonction du fichier de référentiel spécifique ou du type de SGBD que vous utilisez.

Options Query

Option

Description

Voir également

Sous-chaînes de macro

Dans le champ de texte principal de l'onglet, tapez la Query SQL qui doit être exécuter sur votre modèle. Vous pouvez utiliser #<macro>#s comme substitutions de string , comme pour les autres requêtes de recherche SQL.

La Query SQL peut référencer l' ID de l'élément, du diagramme ou Paquetage en cours de traitement par le document gabarit , à l'aide des macros :

  • #OBJECTID#
  • #DIAGRAMIDE#
  • #PACKAGEID#
Par exemple:
  • SELECT Count ( Object_Type ) AS CountOfActors
    DE t_objet
    WHERE Object_Type = "Acteur" et Package_ID = #PACKAGEID#
Il existe un certain nombre d'autres macros utiles telles que :
  • #Concat <valeur1>, <valeur2>, ...#
  • #WC# Caractère générique pour votre type de base de données spécifique.
Pour plus de détails, consultez la rubrique d'aide Créer des définitions de recherche .
Créer des définitions de recherche

Notes formatées (hors .eap)

Pour les champs de notes , comme les Notes d'élément (t_object. note ), la mise en forme est stockée sous forme de texte enrichi. Il est possible de transformer un champ de note à partir de données brutes en texte enrichi lisible en fournissant une colonne au format suivant :

{<nom du champ>.Formatted}

Ceci est défini dans la section Custom du Gabarit . Par exemple :

  • personnalisé >
    { Note .Formaté }
    < personnalisé
Dans votre instruction SQL Query personnalisée, vous devez utiliser un alias correspondant au nom du champ gabarit ; par exemple (dans MySQL):
  • SÉLECTIONNER ea_guid AS CLASSGUID, Object_Type AS CLASSTYPE, Nom, Note comme " Note .Formatted"
    DE t_objet
    Object_ID=#OBJECTID#

Notes formatées pour les référentiels .eap

Pour les notes formatées utilisant des référentiels de fichiers .eap, le format nécessite :

{<nom du champ>.Formatted}

Par exemple:

  • personnalisé >
    { Note .Formaté}
    < personnalisé
Dans votre instruction de Query SQL personnalisée, formatez l'alias de champ en tant que '[<fieldname>-Formatted]'. Par exemple:
  • SÉLECTIONNER ea_guid AS CLASSGUID, Object_Type AS CLASSTYPE, Nom, Note AS [Note-Formatted]
    DE t_objet
    Object_ID=#OBJECTID#

Liens hypertexte (hors .eap)

Vous pouvez créer des entrées de colonne dans des hyperliens référençant d'autres entrées dans le document généré. Le champ d'en-tête de colonne (dans le texte du gabarit , dans le panneau 'Personnalisé') doit respecter le format :

<nom du champ>.Lien hypertexte

Par exemple:

  • personnalisé >
    { Type .Hyperlien}
    < personnalisé
Les entrées de colonne SQL, ou valeurs, doivent avoir le format : { guid }< LABEL>

Par exemple:

  • SELECT # Concat ea_guid , Nom # comme " Type .Hyperlien"
    DE t_objet
    Object_ID = # OBJECTID # ;

Note : ceci utilise le #Concat ...# pour concaténer la référence GUID et l'expression extérieure du lien hypertexte.

Dans ce format, {guid} est le GUID de l'élément à lier et LABEL est le texte du lien hypertexte (tel que le nom de l'élément), inséré manuellement ou renvoyé par une autre commande. Par exemple:

{570CFDAB-00A4-48d9-AE87-9CD6920418C0}Classe2

Dans le rapport généré, cela s'affiche sous la forme d'un lien hypertexte "Class2", qui renvoie à la description de Class2 dans le document.

Cet exemple renvoie le nom du lien hypertexte de chaque classe de base (parent) de l'élément actuellement signalé :

  • SELECT # Concat t_object. ea_guid, t_object . Nom # AS " BaseClassName.Hyperlien"
    FROM t_object, t_connector
    WHERE t_connector.Start_Object_ID = #OBJECTID#
    AND t_object.Object_ID = t_connector.End_Object_ID
    AND t_connector.Connector_Type = 'Généralisation'

Cette requête peut renvoyer plusieurs entrées, auquel cas les entrées sont rapportées une par ligne. Vous pouvez, si nécessaire, avoir plusieurs instructions de requête Hyperlink, séparées par des virgules. Vous pouvez créer un lien hypertexte vers les éléments signalés, les attributs, les opérations, les diagrammes et Paquetages .

Créer des définitions de recherche

Liens hypertexte pour les référentiels.eap

Le format de nom de champ Hyperlien pour les référentiels .EAP nécessite :

  • personnalisé >
    {<nom du champ> . Lien hypertexte}
    < personnalisé
Et le SQL utilise : [<fieldname>-Hyperlink] :
  • SELECT #Concat t_object . ea_guid, t_object.Name# AS [BaseClassName-Hyperlink]
    FROM t_object, t_connector
    WHERE t_connector . Start_Object_ID = #OBJECTID#
    AND t_object.Object_ID = t_connector.End_Object_ID
    AND t_connector.Connector_Type = 'Généralisation'

Notes

  • Un filtre d'élément ne s'appliquera pas à la section "Personnalisé" d'un fragment de Gabarit
  • Dans vos instructions SQL, vous pouvez référencer les détails du modèle en utilisant :
    - #OBJECTID# renvoie l' ID de l'élément en cours de traitement par le gabarit du document
    - #PACKAGEID# et #Package# renvoient l' ID du Paquetage en cours
    traité par le gabarit du document
    - #Author# prend le nom d'utilisateur du champ 'Auteur' dans la page 'Général' du
    Boîte de dialogue "Préférences", afin que la recherche définie puisse être effectuée sur les objets créés
    par cet utilisateur (cette valeur peut être réinitialisée manuellement dans la boîte de dialogue 'Préférences')
  • Vous pouvez tester votre Query SQL à l'aide de l'éditeur SQL dans la fenêtre Rechercher dans Projet