1. Oracle EssbaseのREST API
  2. タスク
  3. アウトライン・ビューア

メンバーの祖先の取得

get

/essbase/rest/v1/outline/{app}/{cube}/ancestors/{memberUniqueName}

リクエストされたメンバーのすべての祖先を返します。

リクエスト

パス・パラメータ
問合せパラメータ
先頭に戻る

レスポンス

サポートされているメディア・タイプ

200 レスポンス

OK

祖先のリストが正常に返されました。

本体()
ルート・スキーマ : MemberBean
型: object

Essbaseで表示されるメンバー情報の出力は、コンテキストに依存します。次に、メンバーの情報をリクエストしたときに表示されない可能性のあるプロパティの例を示します。

  • consolidation: メンバー集計がデフォルトの加算(+)である場合は表示されません
  • numberOfChildren: リーフレベルのメンバー(子のないメンバー)に対しては表示されません
  • activeAliasName: セッションでデフォルト以外の別名表が使用されていない場合は表示されません
  • attributeType: 属性ディメンション名であるメンバーに対してのみ表示されます
  • shareMembers: ディメンション名のメンバーおよび属性に対しては表示されません。これらは共有メンバーのプロトタイプ・メンバーにできないためです。
  • memberHasUniqueName: アウトラインが重複メンバー対応でない場合は表示されません

ソースの表示

  • このメンバーが勘定科目ディメンションのメンバーである場合はtrue。

  • デフォルト以外の別名表が現在のセッションで使用されている場合は、このメンバーの現在アクティブな別名。

  • aliases
    使用可能なその他のプロパティ: additionalProperties

  • このメンバーが属性ディメンションのメンバーである場合はtrue。

  • このメンバーの子孫の数。

  • このメンバーが最上位レベルのディメンション・メンバー(メンバー名 = ディメンション名)の場合はtrue。

  • このメンバーが属するディメンションの名前。

  • このメンバーの世代番号。ディメンション名は世代1のメンバーであり、世代番号はリーフ・メンバーに1ステップ近づくたびに1ずつ増加します。

  • このメンバーのレベル番号。リーフ・メンバーはレベル0であり、レベル番号はディメンション・ルート・メンバーに1ステップ近づくたびに1ずつ増加します。

  • links

  • このメンバー名がアウトライン内で重複する名前の場合はfalse、その名前が一意の場合はtrue。重複メンバー対応のアウトラインにのみ適用できます。

  • メンバーの名前とは別の、メンバーの永続的な一意の識別子。EssbaseがメンバーIDを自動生成する場合、IDは増分命名パターン(id__0、id__1、id__2など)に従います。

  • このメンバーに割り当てられている場合は、解決順。割り当てられていない場合、メンバーはディメンションの解決順を継承します。解決順には0から127を指定できます。下位の解決順のメンバーは、上位のメンバーの前に計算されます。

  • メンバー名。

  • このメンバーの子の数。

  • アウトラインでこのメンバーの前にある兄弟の数。

  • 指定可能な値: [ "NONE", "NUMERIC", "SMARTLIST", "DATE" ]

    メンバーがメジャーの場合にのみ適用できます。メジャーに指定されている型。たとえば、日付フォーマットを使用して分類されたメジャーの場合はDATE、テキストベースのメジャーの場合はSMARTLIST、NUMERICです。

  • アウトラインでのこのメンバーの一意の名前。アウトラインが重複メンバー対応で、メンバー名が一意でない場合、この一意の名前は、同じ名前を持つ他のメンバーと区別する修飾名になります。たとえば、[Market].[New York].[New York]は一意の名前です。

ネストされたスキーマ : aliases
型: object
使用可能なその他のプロパティ
ソースの表示

400 レスポンス

不正なリクエスト

祖先の取得に失敗しました。

500 レスポンス

サーバーの内部エラーです。

先頭に戻る

例

次の例では、指定されたEssbaseメンバーの祖先を取得する方法を示します。

Essbaseで表示されるメンバー情報の出力は、コンテキストに依存します。通常、デフォルトの情報は含まれていません。次に、メンバーの情報を問い合せたときに表示されない可能性のあるプロパティの例を示します。

  • consolidation: メンバー集計演算子がデフォルトの加算(+)である場合は表示されません
  • numberOfChildren: リーフレベルのメンバー(子のないメンバー)に対しては表示されません
  • activeAliasName: 現在のセッションでデフォルト以外の別名表が使用されていない場合は表示されません
  • attributeType: 属性ディメンション名であるメンバーに対してのみ表示されます
  • shareMembers: ディメンション名のメンバーおよび属性に対しては表示されません。これらは共有メンバーのプロトタイプ・メンバーにできないためです。
  • memberHasUniqueName: アウトラインが重複メンバー対応でない場合は表示されません

cURLコマンドを含むスクリプト

この例では、cURLを使用して、Windowsシェル・スクリプトからREST APIにアクセスします。呼出し元ユーザーのIDおよびパスワードは変数であり、properties.bat内でその変数値が設定されています。 

call properties.bat
curl -X GET "https://myserver.example.com:9001/essbase/rest/v1/outline/ASOSamp/Basic/ancestors/Digital%20Cameras?links=none" -H Accept:application/json -H Content-Type:application/json -o output.json -u %User%:%Password%

レスポンス本体の例

次の情報がoutput.jsonに書き込まれます。 

[
	{
		"name": "Digital Cameras/Camcorders",
		"dimensionName": "Products",
		"numberOfChildren": 3,
		"levelNumber": 1,
		"generationNumber": 4,
		"aliases": {
			"Default": null
		},
		"uniqueName": "Digital Cameras/Camcorders",
		"memberId": "id__513",
		"descendantsCount": 3,
		"parentName": "Personal Electronics",
		"shareMembers": null,
		"hierarchy": "NOTHIERARCHY"
	},
	{
		"name": "Personal Electronics",
		"dimensionName": "Products",
		"numberOfChildren": 3,
		"levelNumber": 2,
		"generationNumber": 3,
		"aliases": {
			"Default": null
		},
		"uniqueName": "Personal Electronics",
		"memberId": "id__512",
		"descendantsCount": 11,
		"parentName": "All Merchandise",
		"shareMembers": null,
		"hierarchy": "NOTHIERARCHY"
	},
	{
		"name": "All Merchandise",
		"dimensionName": "Products",
		"numberOfChildren": 3,
		"levelNumber": 4,
		"generationNumber": 2,
		"aliases": {
			"Default": null
		},
		"uniqueName": "All Merchandise",
		"memberId": "id__511",
		"descendantsCount": 31,
		"parentName": "Products",
		"shareMembers": null
	},
	{
		"name": "Products",
		"numberOfChildren": 2,
		"levelNumber": 5,
		"aliases": {
			"Default": null
		},
		"uniqueName": "Products",
		"memberId": "id__510",
		"descendantsCount": 37,
		"previousSiblingsCount": 8,
		"dimension": true,
		"dataStorageType": "LABELONLY",
		"formatString": null,
		"hierarchy": "MULTIPLEHIERARCHYENABLED",
		"renegadeMember": ""
	}
]
先頭に戻る