前页 后页

查询能力

客户可以查询模型并检索符合特定条件的资源。在Enterprise Architect ,用于访问查询功能的基本URI是:

<协议>:// <服务器> / <型号名称> / oslc / am / qc /

表示特定条件的查询字符串应添加到基本URI,并使用HTTP GET请求发送给模型。 如果URI太长(例如,超过1000个字符),建议使用HTTP POST请求,并将查询字符串放在POST正文中。该请求的响应将为RDF / XML格式。当前, Enterprise Architect支持对Package,Element和Diagram属性的查询(不支持对属性,操作和方案等功能的查询)。

Enterprise Architect支持以下用于指定条件的查询功能参数:

  • oslc.where-指定资源必须满足的条件,并且类似于SQL语句的WHERE子句
  • oslc.select-指定要检索的资源属性,类似于SQL语句的SELECT子句
这些参数可以单独使用,也可以组合使用以指定检索资源的标准。

响应XML的元素

元件

描述

oslc_am:资源

表示OSLC体系结构管理2.0资源及其属性(如资源形状中所定义)。此元素上的属性“ rdf:about”指定用于访问资源的URL。该URL的格式为:

<协议>:// <服务器> / <型号名称> / oslc / am / resource / <带前缀的资源GUID> /

带有名称空间前缀“ dcterms”的元素

都柏林核心元数据元素集中的标准属性。

名称空间前缀为“ foaf”的元素

朋友之友(FOAF)词汇表的标准属性。

带有名称空间前缀“ ss”的元素

定制的Enterprise Architect属性。

检索模型中Actor类型的所有Resources:

  • 网址:http:// localhost:480 / firebird_model / oslc / am / qc /?oslc.where = dcterms:type =“ Actor”
响应如下所示。

<rdf:RDF>

<rdf:说明rdf:about =“ http:// mybuildvm:2480 / firebird_model / oslc / am / qc /”>

<rdfs:member>

<oslc_am:Resource rdf:about =“ http:// localhost:480 / firebird_model / oslc / am / resource / el_ {9EAD1087-BC1A-4b04-804F-748713D10E42} /”>

<rdf:type rdf:resource =“ http://open-services.net/ns/am#Resource” />

<!-资源名称->

<dcterms:title> A1 </ dcterms:title>

<!-资源的企业架构师类型->

<dcterms:type>演员</ dcterms:type>

<!-资源的GUID->

<dcterms:identifier> el_ {9EAD1087-BC1A-4b04-804F-748713D10E42} </ dcterms:identifier>

<!-资源作者->

<dcterms:创建者>

<foaf:Person>

<foaf:name> Sparx </ foaf:name>

</ foaf:人员>

</ dcterms:creator>

<!-资源的创建日期->

<dcterms:created> 2020-06-21 09:40:58 </ dcterms:created>

<!-资源的修改日期->

<dcterms:modified> 2020-07-12 15:43:28 </ dcterms:modified>

<!-资源状态->

<ss:status>建议</ ss:status>

<!-资源的复杂性->

<ss:complexity>简单</ ss:complexity>

<!-资源阶段->

<ss:phase> 1.0 </ ss:phase>

<!-资源版本->

<ss:version> 1.0 </ ss:version>

<!-资源类型->

<ss:resourcetype>元素</ ss:resourcetype>

<!-包含此Actor的Package的GUID->

<ss:parentresourceidentifier> pk_ {56DF19B4-7035-40d2-9030-21D3383562A6} </ ss:parentresourceidentifier>

<!-使用此链接检索此Actor的功能->

<ss:features rdf:resource =“ http:// localhost:480 / firebird_model / oslc / am / features / el_ {9EAD1087-BC1A-4b04-804F-748713D10E42} /” />

<!-使用此链接检索此Actor的连接器->

<ss:nestedresources rdf:resource =“ http:// localhost:480 / firebird_model / oslc / am / nestedresources / el_ {9EAD1087-BC1A-4b04-804F-748713D10E42} /” />

</ oslc_am:资源>

</ rdfs:member>

</ rdf:Description>

</ rdf:RDF>

笔记

  • 可通过Pro Cloud Server使用有效许可证使用此功能
  • 在启用安全性的模型中,您需要在GET请求中提供用户身份验证令牌(通过URL中的“ useridentifier”查询字符串)以检索资源/资源功能XML

学到更多