リソースとリソースフィーチャーの取得

<< 目次を表示 >>

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

リソースとリソースフィーチャーの取得

Enterprise Architectでは、次のリソースおよびそのリソースフィーチャーをHTTP GETで取得できます。

 

    -  モデルルート

    -  パッケージ

    -  要素

    -  ダイアグラム

 

    -  パッケージと要素の接続・ディスカッションとその返信・要求・制約・シナリオ・ファイル・付属ドキュメント・担当者の割り当て・テスト項目・タグ付き値・保守項目・プロジェクト管理の項目

    -  要素の実行時の状態・属性・属性のタグ付き値・操作・操作のタグ付き値・操作のパラメータ

    -  ダイアグラムの画像

 

それぞれのリソースとそのリソースフィーチャーは、GUIDのプレフィックスで区別します。詳細はの「GUID プレフィックス」のページをご覧ください。

 

リソースやリソースフィーチャーを取得する場合には、パラメータ'useridentifier'としてユーザー認証トークンを送付しなければなりません。

詳細は「OSLC RESTful APIを利用するためのユーザー認証」のページをご覧ください。

 

 

モデルルート・パッケージ・ダイアグラム・要素の取得

項目

URL

対象の項目

<protocol>://<server>/<model_name>/oslc/am/resource/<Resource GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/resource/

 

パッケージや要素の接続の取得

項目

URL

接続

<protocol>://<server>/<model_name>/oslc/am/linkedresources/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/linktype/

 

要素の実行時の状態の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/runstates/<Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/runstate/<RunState GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/runstate/

 

要素の属性の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/attributes/<Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/attribute/<Attribute GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/attribute/

 

属性のタグ付き値の取得

項目

URL

指定した属性のすべての項目

<protocol>://<server>/<model_name>/oslc/am/taggedvalues/<Attribute GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/taggedvalue/<Attribute Tagged Value GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/taggedvalue/

 

要素の操作の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/operations/<Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/operation/<Operation GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/operation/

 

操作のタグ付き値の取得

項目

URL

指定した操作のすべての項目

<protocol>://<server>/<model_name>/oslc/am/taggedvalues/<Operation GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/taggedvalue/<Operation Tagged Value GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/taggedvalue/

 

操作のパラメータの取得

項目

URL

指定した操作のすべての項目

<protocol>://<server>/<model_name>/oslc/am/parameters/<Operation GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/parameter/<Parameter GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/operationparameter/

 

パッケージや要素のタグ付き値の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/taggedvalues/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/taggedvalue/<Tagged Value GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/taggedvalue/

 

ディスカッションの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/discussions/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/discussion/<Discussion GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/discussion/

 

ディスカッションの返信の取得

項目

URL

指定したディスカッションのすべての項目

<protocol>://<server>/<model_name>/oslc/am/replies/<Discussion GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/reply/<Reply GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/discussion/

 

パッケージや要素の要求の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/requirements/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/requirement/<Requirement GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/requirement/

 

パッケージや要素の制約の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/constraints/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/constraint/<Constraint GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

protocol>://<server>/<model_name>/oslc/am/rs/constraint/

 

パッケージや要素のシナリオの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/scenarios/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/scenario/<Scenario GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/scenario/

 

パッケージや要素のファイルの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/files/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/file/<File GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/file/

 

パッケージや要素の付属ドキュメントの取得

項目

URL

指定した付属ドキュメント

<protocol>://<server>/<model_name>/oslc/am/linkeddocument/<Linked Document GUID With Prefix>/?useridentifier=<User Authentication Token>

 

パッケージや要素の担当者の割り当ての取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/resourceallocations/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/resourceallocation/<Resource Allocation GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/resourceallocation/

 

パッケージや要素のテスト項目の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/tests/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/test/<Test GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/test/

 

パッケージや要素の変更点の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/changes/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/change/<Change GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/change/

 

パッケージや要素のバグの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/defects/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/defect/<Defect GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/defect/

 

パッケージや要素の問題点の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/issues/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/issue/<Issue GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/issue/

 

パッケージや要素のToDoの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/tasks/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/task/<Task GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/task/

 

パッケージや要素のイベントの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/events/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/event/<Event GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/event/

 

パッケージや要素のディスカッションの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/decisions/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/decision/<Decision GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/decision/

 

パッケージや要素のドキュメントの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/documents/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/document/<Document GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/document/

 

パッケージや要素のユーザー機能の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/mfeatures/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/mfeature/<Feature GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/mfeature/

 

パッケージや要素の作業の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/efforts/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/effort/<Effort GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/effort/

 

パッケージや要素のリスクの取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/risks/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/risk/<Risk GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/risk/

 

パッケージや要素の測定の取得

項目

URL

指定した要素のすべての項目

<protocol>://<server>/<model_name>/oslc/am/metrics/<Package/Element GUID With Prefix>/?useridentifier=<User Authentication Token>

指定した項目のみ

<protocol>://<server>/<model_name>/oslc/am/metric/<Metric GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/metric/

 

ダイアグラムの画像の取得

項目

URL

指定したダイアグラムの画像

<protocol>://<server>/<model_name>/oslc/am/diagramimage/<Diagram Image GUID With Prefix>/?useridentifier=<User Authentication Token>

リソースシェイプ

<protocol>://<server>/<model_name>/oslc/am/rs/diagramimage/

 

 

リソースやリソースフィーチャーの取得例

localhostでポート480で待機しているProクラウドサーバのプロジェクト「firebird_model」を利用する場合の例です。

#

操作方法

1

パッケージの取得:

 

  • パッケージのGUID: {5147E138-1F14-4738-B721-5FCC0F8821A8}
  • ユーザー認証トークン: {72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/resource/pk_{5147E138-1F14-4738-B721-5FCC0F8821A8}/?useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

2

要素の取得:

 

  • 要素のGUID: {24B2D93C-03F1-4761-9BB8-3B837B44E985}
  • ユーザー認証トークン: {72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/resource/el_{24B2D93C-03F1-4761-9BB8-3B837B44E985}/?useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

3

要素が持つすべての操作の取得:

 

  • 要素のGUID: {24B2D93C-03F1-4761-9BB8-3B837B44E985}
  • ユーザー認証トークン: {72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/operations/el_{24B2D93C-03F1-4761-9BB8-3B837B44E985}/?useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

4

操作のプロパティの取得:

 

  • 操作のGUID: {E356ECA8-8C23-4c16-B94B-154A5A9B2B42}
  • ユーザー認証トークン: {72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/operation/op_{E356ECA8-8C23-4c16-B94B-154A5A9B2B42}/?useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

5

要素のテスト項目の取得:

 

  • 要素のGUID: {24B2D93C-03F1-4761-9BB8-3B837B44E985}
  • ユーザー認証トークン: {72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

http://localhost:480/firebird_model/oslc/am/tests/el_{24B2D93C-03F1-4761-9BB8-3B837B44E985}/?useridentifier={72825AF9-E116-48f1-9DF8-77815E66B1A7}

 

注意:

  • OSLCの機能は有料ライセンスが適用されたProクラウドサーバのみで利用できます。
  • GETリクエストは、同時にユーザー認証トークンが渡されない場合には、Proクラウドサーバは何も処理を行いません。

 

 

参照: