語法
AttributeValue("TableName", "AttributeName", row-reference,)
參數
TableName
- 如果文字函數用於關聯式表格的文字儲存格中,則此為選擇性參數。如果文字函數用於文字物件中,且報表中只有一個關聯式表格,則 table-name 參數為選擇性;否則為必要參數。
AttributeName
- 此為必要參數。此 attribute-name 必須對應至關聯式表格資料欄軸或關聯式表格 POV 上的 attribute-name。
row-reference
- 此為選擇性參數。如果未提供 row-reference 參數,且屬性值文字函數出現在關聯式方格的文字儲存格中,則會使用關聯式表格中的「目前」資料列。如果屬性值文字函數出現在文字物件中,且 attribute-name 位於資料欄軸上,則 row-reference 為必要參數。資料列參考可以包含偏移量 (例如:row-reference 1(5) 將傳回資料列 1 中第 5 個元組的屬性值)。
Note:
- 如果屬性值函數未指定 table-name 參數並出現在文字物件中,且報表中有兩個或多個關聯式表格,則會發生驗證錯誤。
- 如果 attribute-name 參數不在資料欄軸或 POV 上,或只出現在聚總函數 (例如:Count()、Max() 等) 內,則會發生驗證錯誤。
範例
- AttributeValue("Artifact Actions.User"):將傳回關聯式表格目前資料列中指定 attribute-name 的屬性值,或 POV 上指定 attribute-name 的屬性值。
- AttributeValue("Artifact Actions.User", 1(5)):將傳回關聯式表格第 5 個資料列中指定 attribute-name 的屬性值。如果 attribute-name 在 POV 上,則此語法無效。將會發生驗證錯誤。如果關聯式表格結果集沒有 5 個資料列,則會傳回空白字串。
- AttributeValue("Table 1", "Artifact Actions.User", 1(5)):
- AttributeValue("Table 1", "Artifact Actions.User", 1(5)):將傳回指定關聯式表格第 5 個資料列中指定 attribute-name 的屬性值。如果 attribute-name 在 POV 上,則此語法無效。將會發生驗證錯誤。如果關聯式表格結果集沒有 5 個資料列,則會傳回空白字串。