预订演示
前页 后页

创建自定义 SQL查询

当定义你自己的#

模板片段的声明 有许多选项可用于帮助提供所需的报告格式。该查询依赖于 DBMS,因此结构可能会根据您使用的特定存储库文件或 DBMS 类型而有所不同。

查询选项

选项

描述

也见

宏子字符串

在选项卡的主文本字段中,键入#

那运行在你的查询模型上运行。您可以使用 #<macro>#s 作为string替换,就像其他#

搜索查询。

#

可以引用文档模板当前正在处理的元素查询、图表或包的ID,使用宏:

  • #对象ID#
  • #图表#
  • #PACKAGEID#
例如:
  • SELECT计数( Object_Type )作为 CountOfActors
    FROM t_object
    WHERE Object_Type = “参与者”和 Package_ID =参与者
还有许多其他有用的宏,例如:
  • #Concat <value1>, <value2>, ...#
  • #WC# 用于特定数据库类型的通配符。
有关更多详细信息,请参阅创建搜索定义帮助主题。
创建搜索定义

格式化注记规格(不包括 .eap)

对于注记字段,如元素注记(t_object.注记),格式存储为富文本。通过提供以下格式的列,可以将注记字段从原始数据处理为可读的富文本:

{<字段名>.Formatted}

这是在模板的自定义部分中定义的。例如:

  • 定制>
    {注记.格式化}
    < 自定义
在你的自定义#

查询语句,您必须使用与模板字段名称匹配的别名;例如(在MySQL中):

  • SELECT ea_guid AS CLASSGUID, Object_Type AS CLASSTYPE,名称,注记as "注记.Formatted"
    t_object
    其中Object_ID=#OBJECTID#

.eap 存储库的格式化注记

对于使用 .eap 文件存储库的格式化注记,格式要求:

{<字段名>.Formatted}

例如:

  • 定制 >
    {注记.格式化}
    < 自定义
在你的自定义#

查询语句将字段别名格式化为“[<fieldname>-Formatted]”。例如:

  • SELECT ea_guid AS CLASSGUID, Object_Type AS CLASSTYPE,名称,注记AS [Note-Formatted]
    t_object
    其中Object_ID=#OBJECTID#

超链接(不包括 .eap)

您可以将列条目制作成引用生成文档中其他条目的超链接。列标题字段(在模板文本中,在“自定义”面板中)必须使用以下格式:

<字段名>.超链接

例如:

  • 定制 >
    {类型.超链接}
    < 自定义
#

列条目或值必须具有以下格式: { guid }< LABEL>

例如:

  • SELECT #连接 ea_guid , 名称# as "类型.超链接"
    FROM t_object
    在哪里 Object_ID = # OBJECTID # ;

注记:这里使用#Concat ...# 来连接GUID引用和超链接的向外表达。

在这种格式中,{guid} 是要链接到的元素的GUID ,而 LABEL 是超链接文本(例如元素名称),可以是手动插入的,也可以是从另一个命令返回的。例如:

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

在生成的报告中,这显示为超链接“Class2”,它链接到文档中 Class2 的描述。

此示例返回当前报告的元素的每个基(父)类的超链接名称:

  • SELECT #连接 t_object。 ea_guid, t_object .名称# AS " BaseClassName.超链接"
    FROM t_object, t_connector
    WHERE t_connector.Start_Object_ID = #OBJECTID#
    AND t_object.Object_ID = t_connector.End_Object_ID
    AND概括= '关于'

此查询可能返回多个条目,在这种情况下,每行报告一个条目。如果需要,您可以拥有多个以逗号分隔的超链接查询语句。您可以超链接到报告的元素、属性、操作、图表和包。

创建搜索定义

.eap 存储库的超链接

.EAP 存储库的超链接字段名称格式要求:

  • 定制 >
    {<字段名> .超链接}
    < 自定义
和#

使用:[<字段名>-超链接]:

  • SELECT #Concat t_object ea_guid, t_object.Name# AS [BaseClassName-Hyperlink]
    FROM t_object, t_connector
    哪里t_connector Start_Object_ID = #OBJECTID#
    AND t_object.Object_ID = t_connector.End_Object_ID
    AND概括= '关于'

注记

  • 元素过滤器将不适用于模板片段中的“自定义”部分
  • 在你的#
    您可以使用以下方式参考模型详细信息的声明:
    - #OBJECTID#返回文档模板当前正在处理的元素的ID
    - #包#和#Package#返回当前包裹的ID
    由文档模板处理
    - #Author# 从“常规”页面的“作者”字段中获取用户名
    “首选项”对话框,因此可以对创建的对象执行定义的搜索
    由该用户(可以在“首选项”对话框中手动重新设置此值)
  • 你可以测试你的#
    使用#
    查询#
    在项目中查找窗口中的编辑器