oslc.whereパラメータ

<< 目次を表示 >>

ページ位置:  プロジェクトの作成と管理 > Proクラウドサーバ > 有料ライセンスで利用できる機能 > OSLCの利用 > OSLC Architecture Management 2.0 > クエリ >

oslc.whereパラメータ

oslc.whereのクエリパラメータは、SQL文のWHERE句と同様に、取得するリソースの条件を指定します。このパラメータは、Enterprise ArchitectのQuery CapabilityのベースURIに追加する必要があります。

 

    <protocol>://<server>/<model_name>/oslc/am/qc/?oslc.where=<conditions>

 

oslc.whereのクエリパラメータの構文は次のとおりです。
(BNF文法で定義され、OSLC Query Syntax Specificationで指定されています。)

 

 

条件として指定可能なリソースフィーチャーは以下の通りです。

 

 

例

#

操作方法

1

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:title="Class1" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

名前が'Class1'の要素のすべてのリソースを取得します。

2

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:title="Class1" and dcterms:type="Class" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

名前が'Class1'で、種類がClassの要素のすべてのリソースを取得します。

3

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:type="Activity" and dcterms:created > "2020-05-01" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

    あるいは

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:resourcetype ="Element" and dcterms:type="Activity" and dcterms:created > "2020-05-01" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

2020-05-01以降に作成された、種類がActivityの要素のすべてのリソースを取得します。

4

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{foaf:name}="Sparx" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

以下のいずれかも同様:

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{foaf:name="Sparx"} & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{*}="Sparx" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{*="Sparx"} & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

作者が'Sparx'の要素のすべてのリソースを取得します。

5

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{foaf:name} in ["Sparx",”SpxSys”] & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

以下のいずれかも同様:

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{foaf:name in ["Sparx",”SpxSys”]} & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{*} in ["Sparx",”SpxSys”] & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:creator{* in ["Sparx",”SpxSys”]} & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

作者が'Sparx'あるいは'SpxSys'の要素のすべてのリソースを取得します。

6

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:stereotype{ss:fqname} = "BPMN2.0::Activity" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

あるいは:

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:stereotype{ss:fqname = "BPMN2.0::Activity"} & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

BPMN 2.0のActiviti要素のすべてのリソースを取得します。

7

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:parentresourceidentifier="pk_{2DFF8796-9D6F-4381-B2DC-4C7FFEB881E2}" and ss:resourcetype="Element" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

GUIDが{2DFF8796-9D6F-4381-B2DC-4C7FFEB881E2}のパッケージに含まれるすべての要素のすべてのリソースを取得します。

8

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:resourcetype in ["Package","Diagram"] & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

モデル内のすべてのパッケージとダイアグラムを取得します。

9

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:resourcetype = "Diagram and dcterms:type="Custom" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

種類が'Custom'のすべてのダイアグラムを取得します。

なお、ダイアグラムの画像と画像マップを取得するためには、ダイアグラムのXMLに含まれる<ss:features>の項目にあるURLを利用します。

10

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=dcterms:identifier="dg_{5147E138-1F14-4738-B721-5FCC0F882FB8}" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

GUIDが{5147E138-1F14-4738-B721-5FCC0F882FB8}のダイアグラムのすべてのリソースを取得します。

なお、ダイアグラムの画像と画像マップを取得するためには、ダイアグラムのXMLに含まれる<ss:features>の項目にあるURLを利用します。

11

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:linkedresources{*=<http://localhost:480/firebird_model/oslc/am/resource/el_{B55E995C-D8EA-4fa9-9006-7932294961A9}>} & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

'Class1'要素(Enterprise ArchitectのGUIDは {B55E995C-D8EA-4fa9-9006-7932294961A9})につながる要素のすべてのリソースを取得します。

つまり、対象の要素と何らかの接続でつながるすべての要素を取得する、ということです。

12

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=ss:linkedresources{ss:Association=<http://localhost:480/firebird_model/oslc/am/resource/el_{B55E995C-D8EA-4fa9-9006-7932294961A9}>} & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

'Class1'要素(Enterprise ArchitectのGUIDは {B55E995C-D8EA-4fa9-9006-7932294961A9})と関連の接続でつながる要素のすべてのリソースを取得します。

つまり、対象の要素と関連の接続でつながるすべての要素を取得する、ということです。

13

http://localhost:480/firebird_model/oslc/am/qc/?oslc.where=name="Class1" and dcterms:type="Class" & useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

この例は、内容に誤りがあるためエラーになります。nameはありません。

 

注意:
  • OSLCの機能は有料ライセンスが適用されたProクラウドサーバのみで利用できます。
  • 'dcterms:creator' や 'ss:linkedresources' 等の文字列の条件は'=' および 'in'のみが利用できます。
  • 日付の書式はYYYY-MM-DDのみとなります。
  • リソースやリソースフィーチャーの取得は、ユーザー認証トークンを渡すことが必要です。渡されない場合には処理は行いません。

 

 

参照: