前页 | 后页 |
查询能力
客户可以查询模型并检索符合特定条件的资源。在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
学到更多
- 都柏林核心1.1 (在线资源)
- FOAF (在线资源)
- OSLC查询语法 (在线资源)
- oslc.where (在线资源)
- oslc.select (在线资源)
- 用户认证令牌