ObjectId - 圖表函數
ObjectId() 圖表函數傳回用以評估運算式的物件 ID。 該函數採用選用引數，指定該函數顧慮哪個物件類型。物件可以是工作表或視覺化。此函數僅可用於圖表運算式。
語法：
ObjectId([object_type_str])
傳回的資料類型： 字串
函數的唯一引數 object_type_str 是選用性質，意指呈現物件類型的字串值。
| 引數 | 描述 |
|---|---|
| object_type_str | 呈現評估中物件類型的字串值。 |
若在函數運算式中未指定任何引數， ObjectId() 會傳回使用運算式的物件 ID 。若要傳回其中顯示視覺化的工作表物件 ID，使用 ObjectId('sheet')。
若視覺化物件內嵌於其他視覺化物件內部，請在函數引數中指定所需物件類型以獲得不同結果。例如，對於容器內部的文字與 影像圖表，使用 'text-image' 以傳回文字與 影像物件，並使用 'container' 以傳回容器 ID 。
請執行下列動作：
-
在分析模式中，將下列文字新增至 URL：
/options/developer
-
用滑鼠右鍵按一下視覺化，然後按一下
開發人員。 -
在屬性之下，從對話方塊標頭取得物件 ID，然後從 "qType" 屬性取得物件類型。
限制：
在作為主項目之容器內部的物件 (例如按鈕) 中叫用時，此函數可以提供意外結果。此限制也適用於篩選窗格主項目，這是一些清單方塊的容器。其原因是主項目使用物件階層的方式。
圖表運算式 ObjectId('sheet') 將會在這些情況下傳回空的字串，其中 ObjectId('masterobject') 將會顯示擁有主項目的識別碼。
ObjectId() 通常用於組合下列函數：
| 函數 | 互動 |
|---|---|
| if - 指令碼與圖表函數 | if 和 ObjectId 函數可以一起使用，以建立條件運算式。例如，視覺化可能會透過使用這些函數的運算式實現條件式著色。 |
| InObject - 圖表函數 | 與 if 類似，InObject 也能搭配 ObjectId 使用，以建立條件運算式。 |
範例 1 – 傳回圖表物件 ID
下列基本範例呈現如何傳回視覺化的 ID 。
請執行下列動作：
-
開啟新的工作表並將文字與影像圖表拖曳到工作表。
-
在屬性面板中，按一下新增量值。
-
按一下
可開啟運算式編輯器。 -
在對話方塊中貼上以下運算式：
=ObjectId() -
按一下套用。
文字與影像物件的 ID 顥示在視覺化中。
可以使用下列運算式達到相同結果：
範例 2 – 傳回工作表 ID
下列基本範例呈現如何傳回其中顯示視覺化的工作表 ID 。
請執行下列動作：
-
開啟新的工作表並將文字與影像圖表拖曳到工作表。
-
在屬性面板中，按一下新增量值。
-
按一下
可開啟運算式編輯器。 -
在對話方塊中貼上以下運算式：
=ObjectId('sheet') -
按一下套用。
工作表的 ID 顥示在視覺化中。
範例 3 – 巢狀運算式
下列範例顯示 ObjectId() 函數可以如何內嵌於其他運算式內部。
請執行下列動作：
-
開啟新的工作表並將文字與影像圖表拖曳到工作表。
-
在屬性面板中，按一下新增量值。
-
按一下
可開啟運算式編輯器。 -
在對話方塊中貼上以下運算式：
=if(InObject(ObjectId('text-image')), 'In Text & image', 'Not in Text & image')
-
按一下套用。
文字 In Text & image (在文字與影像中) 會顯示在圖表中，指示運算式中參考的物件是文字與影像圖表。
如需更詳細的條件式著色使用範例，請參閱 InObject - 圖表函數 的範例。