Właściwości Text i GlobalText zmiennych globalnych i ustawienia niestandardowe

Każdy widżet na dashboardzie ma własny silnik arkusza kalkulacyjnego. Jeżeli kilka widżetów zawiera odwołania do tych samych obiektów globalnych, obiekty te są klonowane do silnika każdego widżetu. Dlatego też, jeżeli dwa widżety zawierają odwołania do tej samej zmiennej globalnej, możesz zaktualizować tą zmienną w jednym widżecie bez wpływu na wartość sklonowanej zmiennej. Służy to umożliwieniu równoległych obliczeń wielu widżetów.

Właściwość Text zmiennej globalnej zwraca wartość zmiennej wyłącznie w bieżącym widżecie. Czasami jednak wartość zmiennej globalnej musi być dostępna dla każdego widżetu na dashboardzie. Właściwość GlobalText zmiennej globalnej zwraca wartość ostatnio zapisaną przez którykolwiek widżet na dashboardzie.

Właściwość GlobalText wymaga dodatkowej komunikacji z serwerem, aby pobrać najnowszą wartość z repozytorium. Zalecamy używanie właściwości GlobalText tylko w przypadku, gdy konieczne jest pobranie najnowszej wartości.

Uwaga

Klient Application Studio nie może otrzymać najnowszej wartości. Dlatego testy należy wykonać w dashboardach.

Aby zaobserwować różnicę pomiędzy właściwościami Tekst i GlobalText, możesz posłużyć się następującym przykładem:

  1. Utwórz zmienną globalną o nazwie gv_test i wartości Wartość z widżetu 1.
  2. Utwórz dwa raporty o nazwach Raport 1 i Raport 2.
  3. W osobnych komórkach w Raporcie 1 określ =globalvariables.gv_test.text=globalvariables.gv_test.globaltext.
  4. W Raporcie 2 zdefiniuj akcję ustawiającą wartość gv_test na Wartość z widżetu 2.
  5. W osobnych komórkach określ =globalvariables.gv_test.text=globalvariables.gv_test.globaltext.
  6. Dodaj obydwa raporty do dashboardu.
    Widżety wyświetlają następujące wartości:
    Właściwość Widżet Raport 1 Widżet Raport 2
    Text Wartość z widżetu 1 Wartość z widżetu 1
    GlobalText Wartość z widżetu 1 Wartość z widżetu 1
  7. Wykonaj akcję w widżecie Raport 2.
    W widżecie Raport 2 wartości zwracane przez zmienne Tekst i GlobalText zostają zmienione na Wartość z widżetu 2.
  8. Odśwież dashboard.
    Widżety wyświetlają teraz następujące wartości:
    Właściwość Widżet Raport 1 Widżet Raport 2
    Text Wartość z widżetu 1 Wartość z widżetu 2
    GlobalText Wartość z widżetu 2 Wartość z widżetu 2