ObjectId — funkcja wykresu
Funkcja arkusza ObjectId() zwraca identyfikator obiektu, w którym oceniane jest wyrażenie. Ta funkcja przyjmuje opcjonalny argument określający, jakiego typu obiektu dotyczy funkcja. Obiekt ten może być arkuszem lub wizualizacją. Funkcja ta jest dostępna tylko w wyrażeniach wykresu.
Składnia:
ObjectId([object_type_str])
Typ zwracanych danych: ciąg znaków
Jedyny argument funkcji, object_type_str, jest opcjonalny i odnosi się do wartości ciągu reprezentującej typ obiektu.
| Argument | Opis |
|---|---|
| object_type_str | Wartość ciągu reprezentująca typ ocenianego obiektu. |
Jeśli w wyrażeniu funkcji nie określono żadnego argumentu, ObjectId() zwraca identyfikator obiektu, w którym użyto wyrażenia. Aby zwrócić identyfikator obiektu arkusza, w którym pojawia się wizualizacja, użyj funkcji ObjectId(‘arkusz’).
W przypadku obiektów wizualizacji zagnieżdżonych w innych obiektach wizualizacji określ żądany typ obiektu w argumencie funkcji, aby uzyskać inne wyniki. Na przykład dla wykresu Tekst i grafika w kontenerze użyj 'text-image', aby zwrócić obiekt Tekst i grafika, oraz 'container', aby zwrócić identyfikator kontenera.
Wykonaj następujące czynności:
-
W trybie analizy dodaj następujący tekst do adresu URL:
/options/developer
-
Kliknij wizualizację prawym przyciskiem myszy, a następnie kliknij
Programista. -
W obszarze Właściwości uzyskaj identyfikator obiektu z nagłówka okna dialogowego i typ obiektu z właściwości „qType”.
Ograniczenia:
Ta funkcja może dać nieoczekiwane wyniki, jeżeli zostanie wywołana w obiekcie (na przykład przycisku) w kontenerze, który jest elementem głównym. To ograniczenie dotyczy też elementów głównych panelu filtrowania, które są kontenerami pól listy. Wynika to ze sposobu używania hierarchii obiektów przez elementy główne.
Wyrażenie wykresu ObjectId(‘arkusz’) zwróci w takich przypadkach pusty ciąg znaków, natomiast ObjectId(‘element główny’) pokaże identyfikator elementu głównego będącego właścicielem.
Funkcja ObjectId() jest często używana w połączeniu z następującymi funkcjami:
| Funkcja | Interakcja |
|---|---|
| if — funkcja skryptu i funkcja wykresu | Funkcji if i ObjectId można używać razem do tworzenia wyrażeń warunkowych. Na przykład wizualizacje mogą uzyskać kolorowanie warunkowe za pomocą wyrażeń korzystających z tych funkcji. |
| InObject — funkcja wykresu | Podobnie jak if funkcja InObject jest również używana z ObjectId do tworzenia wyrażeń warunkowych. |
Przykład 1 — Zwracanie identyfikatora obiektu wykresu
Poniższy podstawowy przykład pokazuje, jak zwrócić identyfikator wizualizacji.
Wykonaj następujące czynności:
-
Otwórz nowy arkusz i przeciągnij wykres Tekst i grafika na arkusz.
-
Na panelu właściwości kliknij Dodaj miarę.
-
Kliknij
, aby otworzyć edytor wyrażeń. -
Wklej następujące wyrażenie do okna dialogowego:
=ObjectId() -
Kliknij przycisk Zastosuj.
Identyfikator obiektu Tekst i grafika jest wyświetlany w wizualizacji.
Ten sam wynik można osiągnąć za pomocą następującego wyrażenia:
Przykład 2 — Zwracanie identyfikatora arkusza
Poniższy podstawowy przykład pokazuje, jak zwrócić identyfikator arkusza, w którym pojawia się wizualizacja.
Wykonaj następujące czynności:
-
Otwórz nowy arkusz i przeciągnij wykres Tekst i grafika na arkusz.
-
Na panelu właściwości kliknij Dodaj miarę.
-
Kliknij
, aby otworzyć edytor wyrażeń. -
Wklej następujące wyrażenie do okna dialogowego:
=ObjectId('sheet') -
Kliknij przycisk Zastosuj.
Identyfikator arkusza jest wyświetlany na wizualizacji.
Przykład 3 — Wyrażenie zagnieżdżone
Poniższy przykład pokazuje, jak funkcja ObjectId() może być zagnieżdżona w innych wyrażeniach.
Wykonaj następujące czynności:
-
Otwórz nowy arkusz i przeciągnij wykres Tekst i grafika na arkusz.
-
Na panelu właściwości kliknij Dodaj miarę.
-
Kliknij
, aby otworzyć edytor wyrażeń. -
Wklej następujące wyrażenie do okna dialogowego:
=if(InObject(ObjectId('text-image')), 'In Text & image', 'Not in Text & image')
-
Kliknij przycisk Zastosuj.
Na wykresie pojawia się tekst In Text & image, wskazując, że obiekt, do którego odwołuje się wyrażenie, to wykres Tekst i grafika.
Aby uzyskać bardziej szczegółowy przykład użycia kolorowania warunkowego, zobacz przykład dotyczący InObject — funkcja wykresu.