Tworzenie lub edytowanie skoroszytu platformy Azure

2025-05-06

W tym artykule opisano sposób tworzenia nowego skoroszytu i sposobu dodawania elementów do skoroszytu platformy Azure.

Ten klip wideo przeprowadzi Cię przez proces tworzenia skoroszytów.

Tworzenie nowego skoroszytu platformy Azure

Aby utworzyć nowy skoroszyt platformy Azure:

Na stronie Skoroszyty platformy Azure wybierz pusty szablon lub kliknij Nowy na górnym pasku narzędzi.
Połącz dowolne z tych elementów, aby dodać je do skoroszytu:
- Tekst
- Obraz
- Wideo
- Parametry
- Zapytania
- Wykresy metryk
- Linki
- Grupy
- Opcje konfiguracji

Uwaga

Aby dodać nowe elementy do skoroszytu, upewnij się, że jesteś w trybie edycji , wybierając pozycję Edytuj na pasku narzędzi.

Dodaj tekst

Arkusze robocze pozwalają autorom na włączanie bloków tekstu do swoich arkuszy. Tekst może być ludzką analizą danych, informacjami, które ułatwiają użytkownikom interpretowanie danych, nagłówków sekcji itp.

Tekst jest dodawany za pomocą kontrolki markdown, do której autor może dodać swoją zawartość. Autor może używać pełnych możliwości formatowania języka Markdown. Te możliwości obejmują różne style nagłówków i czcionek, hiperlinki, tabele itp. Język Markdown umożliwia autorom tworzenie rozbudowanych raportów podobnych do tych w Word lub Portal, a także narracji analitycznych. Tekst może zawierać wartości parametrów w tekście markdown, a odwołania do tych parametrów są aktualizowane w miarę zmiany parametrów.

Tryb edycji:

Tryb podglądu:

Aby dodać tekst do skoroszytu platformy Azure:

Dodaj krok tekstowy, wykonując jedną z następujących czynności:
- Wybierz pozycję Dodaj i Dodaj tekst poniżej istniejącego elementu lub w dolnej części skoroszytu.
- Wybierz wielokropek (...) po prawej stronie przycisku Edytuj obok jednego z elementów w skoroszycie, a następnie wybierz pozycję Dodaj , a następnie dodaj tekst.
Wprowadź tekst markdown do pola edytora.
Użyj opcji Styl tekstu, aby przełączać się między zwykłym markdownem a markdownem opakowanym standardowym stylem informacyjnym/ostrzeżeniem/sukcesem/błędem portalu Azure.

Wskazówka

Użyj tego arkusza markdown, aby wyświetlić różne opcje formatowania.
Użyj karty Podgląd, aby zobaczyć, jak wygląda zawartość. Podgląd pokazuje zawartość wewnątrz przewijanego obszaru, aby ograniczyć jego rozmiar, ale podczas działania programu zawartość markdown rozszerza się, aby wypełnić taką przestrzeń, jakiej potrzebuje, bez paska przewijania.
Wybierz pozycję Zakończono edytowanie.

Style tekstu

Dostępne są następujące style tekstu:

Styl	Opis
równina	Nie zastosowano żadnego formatowania
Informacja	Styl "info" portalu z ikoną podobną do `ℹ` i niebieskim tłem.
błąd	Styl „błędu” portalu z ikoną `❌` lub podobną i czerwonym tłem
powodzenie	Styl sukcesu portalu z ikoną `✔` lub podobną oraz zielonym tłem
sprzedaż uzupełniająca	Styl zachęcania do zakupu dodatkowego na portalu z ikoną `🚀` lub podobną i fioletowym tłem
ostrzeżenie	Styl „ostrzeżenie” w portalu, z ikoną `⚠` lub podobną oraz niebieskim tłem.

Możesz również wybrać parametr tekstowy jako źródło stylu. Wartość parametru musi być jedną z powyższych wartości tekstowych. Brak wartości lub niezrozpoznawalnej wartości jest traktowany jako styl plain.

Przykłady stylu tekstu

Przykład stylu informacji:

Przykład stylu ostrzeżenia:

Dodawanie zapytań

Skoroszyty platformy Azure umożliwiają wykonywanie zapytań względem dowolnego z obsługiwanych źródeł danych skoroszytu.

Na przykład, możesz skorzystać z usługi Azure Resource Health, aby łatwiej zobaczyć wszelkie problemy z usługą wpływające na Twoje zasoby. Możesz również wykonywać zapytania dotyczące metryk usługi Azure Monitor, czyli danych liczbowych zbieranych w regularnych odstępach czasu. Metryki usługi Azure Monitor zawierają informacje o aspekcie systemu w określonym czasie.

Aby dodać zapytanie do skoroszytu platformy Azure:

Dodaj zapytanie, wykonując jedną z następujących czynności:
- Wybierz pozycję Dodaj i Dodaj zapytanie poniżej istniejącego elementu lub w dolnej części skoroszytu.
- Wybierz wielokropek (...) po prawej stronie przycisku Edytuj obok jednego z elementów w skoroszycie, a następnie wybierz pozycję Dodaj, a następnie pozycję Dodaj zapytanie.
Wybierz źródło danych dla zapytania. Pozostałe pola są określane na podstawie wybranego źródła.
Wybierz inne wartości, które są wymagane na podstawie wybranego źródła danych.

Uwaga

Podczas wybierania typu zasobu należy wziąć pod uwagę uprawnienia użytkownika. Jeśli na przykład masz uprawnienia do odczytu dla zasobu, ale nie dla obszaru roboczego usługi Log Analytics, do którego zasób wysyła dane telemetryczne, musisz wybrać zasób dla typu zasobu aby wyświetlić dane.
Wybierz wizualizację dla swojego skoroszytu.
W sekcji zapytania wprowadź zapytanie lub wybierz z listy przykładowych zapytań, wybierając Przykłady, a następnie edytuj zapytanie według własnych upodobań.
Wybierz pozycję Uruchom zapytanie.
Jeśli masz pewność, że masz zapytanie, które chcesz umieścić w skoroszycie, wybierz pozycję Gotowe edytowanie.

Najlepsze praktyki dotyczące zapytań w dziennikach

Zdefiniuj reguły podsumowania, aby agregować dane, które chcesz wizualizować. Zamiast wykonywać zapytania dotyczące dużych zestawów danych lub długich zakresów czasu, utwórz reguły podsumowania w celu agregowania potrzebnych danych z co najmniej jednej tabeli, gdy dane docierają do obszaru roboczego usługi Log Analytics. Wizualizowanie zagregowanych danych bezpośrednio z niestandardowej tabeli podsumowanych danych, zamiast wykonywania zapytań dotyczących danych pierwotnych z co najmniej jednej tabeli, poprawia wydajność zapytań i zmniejsza błędy zapytań i limity czasu.
Użyj najmniejszych możliwych zakresów czasu. Dłuższy zakres czasu, wolniejsze zapytania i więcej zwracanych danych. Dla dłuższych zakresów czasu może być konieczne skorzystanie z wolniejszego magazynu danych "chłodnych", co sprawia, że zapytanie jest jeszcze wolniejsze. Domyślnie jest to najkrótszy przydatny zakres czasu, ale umożliwia użytkownikowi wybranie większego zakresu czasu, który może być wolniejszy.
Użyj specjalnej wartości "Wszystkie" na listach rozwijanych. W ustawieniach parametrów listy rozwijanej można dodać specjalny element Wszystkie. Możesz użyć wartości specjalnej. Prawidłowe użycie elementu specjalnego All może znacznie uprościć zapytania.
Chroń przed brakującymi kolumnami. Jeśli używasz niestandardowej tabeli lub kolumn niestandardowych, zaprojektuj szablon tak, aby działał, jeśli w obszarze roboczym brakuje kolumny. Zobacz funkcję column_ifexists.
Zabezpiecz się przed brakującą tabelą. Jeśli szablon jest zainstalowany jako część rozwiązania lub w innych przypadkach, w których tabele są zagwarantowane, sprawdzanie brakujących kolumn jest niepotrzebne. Jeśli tworzysz szablony ogólne, które mogą być widoczne w dowolnym zasobie lub obszarze roboczym, warto chronić tabele, które nie istnieją.

Język zapytań usługi Log Analytics nie ma funkcji table_ifexists , takiej jak funkcja do testowania kolumn. Istnieją jednak pewne sposoby sprawdzania, czy tabela istnieje. Na przykład, możesz użyć fuzzy union. Podczas wykonywania połączenia zbiorów (union), możesz użyć ustawienia isfuzzy=true, aby pozwolić, by połączenie kontynuowało się, nawet jeśli niektóre z tabel nie istnieją. Możesz dodać zapytanie parametrów w skoroszycie, które sprawdza istnienie tabeli i ukrywa część zawartości, jeśli tabela nie istnieje. Elementy, które nie są widoczne, nie są uruchamiane, więc można zaprojektować szablon tak, aby inne zapytania w skoroszycie, które nie uruchomią się, jeśli tabela nie istnieje, nie były uruchamiane, dopóki test nie potwierdzi, że tabela istnieje.

Na przykład:
```
let MissingTable = view () { print isMissing=1 };
union isfuzzy=true MissingTable, (AzureDiagnostics | getschema | summarize c=count() | project isMissing=iff(c > 0, 0, 1))
| top 1 by isMissing asc
```
To zapytanie zwraca wartość 1 , jeśli tabela AzureDiagnostics nie istnieje w obszarze roboczym. Jeśli rzeczywista tabela nie istnieje, zwracany jest fałszywy wiersz z tabeli MissingTable. Jeśli jakiekolwiek kolumny istnieją w schemacie tabeli AzureDiagnostics , zwracana jest wartość 0 . Można użyć tej wartości jako wartości parametru i warunkowo ukryć kroki zapytania, chyba że wartość parametru wynosi 0. Możesz również użyć widoczności warunkowej, aby wyświetlić tekst informujący, że w bieżącym obszarze roboczym brakuje tabeli, oraz skierować użytkownika do dokumentacji dotyczącej wprowadzenia.

Zamiast ukrywać kroki, możesz po prostu chcieć uzyskać wynik bez żadnych wierszy. Możesz zmienić MissingTable na pustą tabelę danych z odpowiednim zgodnym schematem.
```
let MissingTable = datatable(ResourceId: string) [];
union isfuzzy=true MissingTable, (AzureDiagnostics
| extend ResourceId = column_ifexists('ResourceId', '')
```
W takim przypadku zapytanie nie zwraca żadnych wierszy, jeśli brakuje tabeli AzureDiagnostics lub jeśli w tabeli brakuje kolumny ResourceId .

Samouczek — zapytania dotyczące dzienników zorientowanych na zasoby w skoroszytach

Ten film wideo pokazuje, jak używać zapytań dotyczących dzienników zasobów w Workbookach platformy Azure. Zawiera również porady i wskazówki dotyczące włączania zaawansowanych scenariuszy i zwiększania wydajności.

Parametr typu zasobu dynamicznego

Używa zakresów dynamicznych do bardziej wydajnego wykonywania zapytań. Poniższy fragment używa tej heurystyki:

Poszczególne zasoby: jeśli liczba wybranych zasobów jest mniejsza lub równa 5
Grupy zasobów: jeśli liczba zasobów przekracza 5, ale liczba grup zasobów, do których należą zasoby, jest mniejsza lub równa 3
Subskrypcje: inaczej

Resources
| take 1
| project x = dynamic(["microsoft.compute/virtualmachines", "microsoft.compute/virtualmachinescalesets", "microsoft.resources/resourcegroups", "microsoft.resources/subscriptions"])
| mvexpand x to typeof(string)
| extend jkey = 1
| join kind = inner (Resources
| where id in~ ({VirtualMachines})
| summarize Subs = dcount(subscriptionId), resourceGroups = dcount(resourceGroup), resourceCount = count()
| extend jkey = 1) on jkey
| project x, label = 'x',
    selected = case(
        x in ('microsoft.compute/virtualmachinescalesets', 'microsoft.compute/virtualmachines') and resourceCount <= 5, true,
        x == 'microsoft.resources/resourcegroups' and resourceGroups <= 3 and resourceCount > 5, true,
        x == 'microsoft.resources/subscriptions' and resourceGroups > 3 and resourceCount > 5, true,
        false)

Statyczny zakres zasobów na potrzeby wykonywania zapytań dotyczących wielu typów zasobów

[
    { "value":"microsoft.compute/virtualmachines", "label":"Virtual machine", "selected":true },
    { "value":"microsoft.compute/virtualmachinescaleset", "label":"Virtual machine scale set", "selected":true }
]

Parametr zasobu pogrupowany według typu zasobu

Resources
| where type =~ 'microsoft.compute/virtualmachines' or type =~ 'microsoft.compute/virtualmachinescalesets'
| where resourceGroup in~({ResourceGroups})
| project value = id, label = id, selected = false,
    group = iff(type =~ 'microsoft.compute/virtualmachines', 'Virtual machines', 'Virtual machine scale sets')

Dodawanie parametrów

Dane wejściowe można zbierać od użytkowników i odwoływać się do niego w innych częściach skoroszytu przy użyciu parametrów. Użyj parametrów, aby określić zakres zestawu wyników lub ustawić odpowiednią wizualizację. Parametry ułatwiają tworzenie interaktywnych raportów i doświadczeń. Aby uzyskać więcej informacji na temat sposobu użycia parametrów, zobacz parametry skoroszytu.

Skoroszyty umożliwiają kontrolowanie sposobu prezentowania kontrolek parametrów konsumentom — pole tekstowe lub lista rozwijana, pojedynczy lub wielokrotny wybór, wartości z tekstu, JSON, KQL lub Azure Resource Graph itp.

Obejrzyj to wideo, aby dowiedzieć się, jak używać parametrów i danych dziennika w skoroszytach platformy Azure.

Aby dodać parametr do skoroszytu platformy Azure:

Dodaj parametr, wykonując jedną z następujących czynności:
- Wybierz pozycję Dodaj i Dodaj parametr poniżej istniejącego elementu lub w dolnej części skoroszytu.
- Wybierz wielokropek (...) po prawej stronie przycisku Edytuj obok jednego z elementów w skoroszycie, a następnie wybierz pozycję Dodaj , a następnie pozycję Dodaj parametr.
W nowym okienku parametrów, które zostanie wyświetlone, wprowadź wartości dla tych pól:
- Nazwa parametru: Nazwy parametrów nie mogą zawierać spacji ani znaków specjalnych
- Nazwa wyświetlana: nazwy wyświetlane mogą zawierać spacje, znaki specjalne, emoji itp.
- Typ parametru:
- Wymagane:
Wybierz pozycję Zakończono edytowanie.

Dodawanie wykresów metryk

Większość zasobów platformy Azure emituje dane metryk dotyczące stanu i kondycji, takie jak wykorzystanie procesora CPU, dostępność magazynu, liczba transakcji bazy danych, żądania aplikacji zakończone niepowodzeniem itp. Za pomocą skoroszytów można tworzyć wizualizacje danych metryk jako wykresy szeregów czasowych.

W poniższym przykładzie pokazano liczbę transakcji na koncie magazynowym w ciągu poprzedniej godziny. Dzięki temu właściciel magazynu może zobaczyć trend transakcji i wyszukać anomalie w zachowaniu.

Aby dodać wykres metryki do skoroszytu platformy Azure:

Dodaj wykres metryki, wykonując jedną z następujących czynności:
- Wybierz pozycję Dodaj i Dodaj metryki poniżej istniejącego elementu lub w dolnej części skoroszytu.
- Wybierz wielokropek (...) po prawej stronie przycisku Edytuj obok jednego z elementów w skoroszycie, a następnie wybierz pozycję Dodaj, a następnie dodaj metrykę.
Wybierz typ zasobu, zasoby, które chcesz objąć, przestrzeń nazw i nazwę metryki oraz agregację, której chcesz użyć.
Ustaw inne parametry w razie potrzeby, takie jak zakres czasu, podział według, wizualizacja, rozmiar i paleta kolorów.
Wybierz pozycję Zakończono edytowanie.

Wykres metryczny jest w trybie edycji.

Parametry wykresu metrycznego

Parametr	Wyjaśnienie	Przykład
Typ zasobu	Docelowy typ zasobu	Pamięć masowa lub maszyna wirtualna.
Zasoby	Zestaw zasobów do uzyskania wartości metryk	MyStorage1
Namespace	Przestrzeń nazw z metryką	Przechowywanie > Blob
Wskaźnik	Metryka do wizualizacji	Przechowywanie > Blob > Transakcje
Agregacja	Funkcja agregacji do zastosowania do metryki	Suma, Liczba, Średnia itp.
Przedział czasu	Przedział czasu do wyświetlenia metryki	Ostatnia godzina, ostatnie 24 godziny itp.
Wizualizacja	Wizualizacja do wykorzystania	Obszar, kolumna, linia, wykres punktowy, siatka
Podziel według	Opcjonalnie podziel metrykę według wymiaru	Transakcje według typu geograficznego
Rozmiar	Pionowy rozmiar kontrolki	Mały, średni lub duży
Paleta kolorów	Paleta kolorów do użycia na wykresie. Ignorowane, jeśli używany jest parametr `Split by`.	Niebieski, zielony, czerwony itp.

Przykłady wykresów metrycznych

Transakcje podzielone według nazwy interfejsu API jako wykres liniowy

Transakcje podzielone według rodzaju odpowiedzi jako duży wykres słupkowy

Średnie opóźnienie jako wykres punktowy

Dodawanie łączy

Możesz użyć linków do tworzenia linków do innych widoków, skoroszytów, innych elementów w skoroszycie lub do tworzenia widoków zakładkowych w skoroszycie. Łącza można stylować jako hiperlinki, przyciski i karty.

Obejrzyj to wideo, aby dowiedzieć się, jak używać kart, grup i linków kontekstowych w skoroszytach platformy Azure:

Style linków

Style można stosować do samego elementu linku i do poszczególnych linków.

Style elementu łącza

Styl	Przykład	Uwagi
Lista punktowana		Domyślnie, łącza są wyświetlane jako lista punktowana, po jednym łączu na każdej linii. Pola Tekst przed linkiem i Tekst po łączem mogą służyć do dodawania większej liczby tekstu przed elementami linku lub po nim.
Lista		Linki są wyświetlane jako lista bez wypunktowania.
Akapit		Linki są wyświetlane jako akapit łączy, owinięty jak akapit tekstu.
Nawigacja		Łącza są wyświetlane jako łącza z pionowymi liniami lub kreskami (\|) między poszczególnymi łączami.
Karty		Linki są wyświetlane jako karty. Każde łącze jest wyświetlane jako karta, a do poszczególnych linków nie mają zastosowania opcje stylów łączy. Zapoznaj się z poniższą sekcją kart , aby dowiedzieć się, jak skonfigurować karty.
Pasek narzędzi		Linki są wyświetlane w witrynie Azure Portal ze stylizowanym paskiem narzędzi z ikonami i tekstem. Każdy link jest wyświetlany jako przycisk paska narzędzi. Zobacz sekcję paska narzędzi poniżej, aby dowiedzieć się, jak skonfigurować paski narzędzi.

Style odnośników

Styl	Opis
Odnośnik	Domyślnie linki są wyświetlane jako hiperłącze. Linki URL mogą mieć tylko styl linku.
Przycisk (Podstawowy)	Link jest wyświetlany jako przycisk "podstawowy" w portalu, zazwyczaj niebieski kolor
Przycisk (Pomocniczy)	Linki są wyświetlane jako przycisk "pomocniczy" w portalu, zwykle "przezroczysty" kolor, biały przycisk w jasnych motywach i ciemny szary przycisk w motywach ciemnych.

Jeśli wymagane parametry są używane w tekście przycisku, tekście etykietki narzędzia lub w polach wartości, a wymagany parametr nie jest ustawiony podczas używania przycisków, przycisk jest wyłączony. Tej funkcji można na przykład użyć, aby wyłączyć przyciski, gdy żadna wartość nie jest zaznaczona w innym parametrze lub kontrolce.

Działania dotyczące linków

Linki mogą korzystać ze wszystkich akcji dostępnych w akcjach linków oraz mają dodatkowo dwie inne akcje dostępne.

Akcja	Opis
Ustawianie wartości parametru	Parametr można ustawić na wartość, gdy użytkownik skoroszytu wybierze link, przycisk lub kartę. Karty są często skonfigurowane do ustawiania parametru na wartość, która ukrywa i wyświetla inne części skoroszytu na podstawie tej wartości.
Przewiń do kroku	Gdy użytkownik skoroszytu wybierze link, skoroszyt przeniesie fokus i przewinie się, aby uczynić kolejny krok widocznym. Tej akcji można użyć do utworzenia "spisu treści" lub "wróć na górę" stylowego doświadczenia.

Karty

W większości przypadków linki tabulacji są łączone z akcją Ustaw wartość parametru.

Utwórz karty

Aby dodać karty do skoroszytu Azure:

Wybierz Dodaj>Dodaj linki/karty.
Ustaw styl na karty.
Wprowadź nazwę zakładki dla każdej zakładki.
W kolumnie Akcje wybierz Ustaw wartość parametru dla każdej zakładki.
W kolumnie Wartośćustaw tę samą nazwę parametru (na przykład selectedTab) dla każdej zakładki.
W kolumnie Ustawieniawprowadź różną wartość dla każdej zakładki.

Oto przykład skonfigurowany do utworzenia dwóch kart, gdzie wybranie którejkolwiek z kart ustawia parametr selectedTab na inną wartość.

Uwaga

Przykład pokazuje jedynie, jak trzecia zakładka jest edytowana, aby wyświetlić symbole zastępcze nazwy i wartości parametru.

Przykładowy skoroszyt z powyższymi kartami jest dostępny w przykładowych skoroszytach platformy Azure z linkami.

Dodaj zawartość do kart

Edytuj zawartość skoroszytu, którą chcesz dodać do konkretnej karty.
W Zaawansowanych ustawieniach wybierz Uczyń ten element widocznym warunkowo.
Wybierz Dodaj warunek, wprowadź Nazwę parametru (na przykład, selectedTab), ustaw Porównanie na równa się, i ustaw Wartość parametru na wartość przypisaną do karty (na przykład, 1).

Domyślnie pierwsza karta jest wybrana, początkowo ustawiając selectedTab na 1, co sprawia, że ten krok jest widoczny. Wybranie drugiej zakładki zmienia wartość parametru na 2, a wyświetlana jest inna zawartość.

Ograniczenia kart

Linki URL nie są obsługiwane w kartach. Adres URL w karcie jest wyświetlany jako nieaktywna karta.
Na kartach nie jest obsługiwane żadne formatowanie elementów. Elementy są wyświetlane jako karty, a wyświetlane jest tylko pole nazwy karty (tekst linku). Pola, które nie są wykorzystywane w formacie zakładki, są ukryte w trybie edycji.
Pierwsza karta jest domyślnie zaznaczona, wywołując dowolną akcję określoną na karcie. Jeśli działanie pierwszej karty otwiera inny widok, widok pojawi się, gdy tylko zostaną utworzone karty.
Za pomocą kart można otwierać inne widoki, ale ta funkcja powinna być używana oszczędnie, ponieważ większość użytkowników nie spodziewa się nawigować, wybierając kartę. Jeśli inne karty ustawiają parametr na określoną wartość, karta otwierająca widok nie zmieni tej wartości, więc pozostała część zawartości skoroszytu będzie nadal wyświetlać widok lub dane dla poprzedniej karty.

Paski narzędzi

Użyj stylu paska narzędzi, aby linki zostały wyświetlone jako pasek narzędzi. W stylu paska narzędzi autor musi wypełnić pola dla:

Tekst przycisku, który ma być wyświetlany na pasku narzędzi. Parametry mogą być używane w tym polu.
Ikona, ikona do wyświetlenia na pasku narzędzi.
Tekst etykiety, tekst, który ma być wyświetlany na etykiecie przycisku paska narzędzi. Parametry mogą być używane w tym polu.

Jeśli jakiekolwiek wymagane parametry są używane w tekście przycisku, tekście podpowiedzi lub polach wartości, i wymagany parametr jest nieustawiony, przycisk paska narzędziowego jest wyłączony. Można to na przykład użyć do wyłączenia przycisków paska narzędzi, gdy żadna wartość nie jest zaznaczona w innym parametrze/kontrolce.

Przykładowy skoroszyt z paskami narzędzi, parametrami globalnymi i ARM Actions jest dostępny w przykładowych skoroszytach Azure wraz z linkami.

Dodawanie grup

Element grupy w skoroszycie umożliwia logiczne grupowanie zestawu kroków w skoroszycie.

Grupy w skoroszytach są przydatne w przypadku kilku rzeczy:

Układ: Jeśli chcesz, aby elementy były zorganizowane w pionie, możesz utworzyć grupę elementów, które będą ułożone jeden na drugim, i ustawić szerokość grupy jako procentową, zamiast ustawiać szerokość procentową dla wszystkich poszczególnych elementów.
Widoczność: jeśli chcesz, aby kilka elementów było ukrywanych lub pokazywanych razem, można ustawić widoczność całej grupy elementów, zamiast ustawiać ustawienia widoczności dla każdego pojedynczego elementu. Może to być przydatne w szablonach korzystających z kart, ponieważ można użyć grupy jako zawartości karty, a cała grupa może być ukryta/wyświetlana na podstawie parametru ustawionego przez wybraną kartę.
Wydajność: jeśli masz duży szablon z wieloma sekcjami lub kartami, możesz przekonwertować każdą sekcję na własną podplatformę i użyć grup, aby załadować wszystkie podtemplaty w szablonie najwyższego poziomu. Zawartość podszablonów nie zostanie załadowana ani uruchomiona, dopóki użytkownik nie uczyni tych grup widocznymi. Dowiedz się więcej na temat dzielenia dużego szablonu na wiele szablonów.

Aby dodać grupę do skoroszytu:

Dodaj parametr, wykonując jedną z następujących czynności:
- Wybierz pozycję Dodaj i Dodaj grupę poniżej istniejącego elementu lub w dolnej części skoroszytu.
- Wybierz wielokropek (...) po prawej stronie przycisku Edytuj obok jednego z elementów w skoroszycie, a następnie wybierz pozycję Dodaj, a następnie pozycję Dodaj grupę.
Wybierz elementy dla grupy.
Wybierz pozycję Zakończono edytowanie.

Jest to grupa w trybie odczytu z dwoma elementami wewnątrz: elementem tekstowym i elementem zapytania.

W trybie edycji możesz zobaczyć, że te dwa elementy faktycznie znajdują się w elemencie grupy. Na poniższym zrzucie ekranu grupa jest w trybie edycji. Grupa zawiera dwa elementy wewnątrz obszaru zaznaczonego linią przerywaną. Każdy element może być w trybie edycji lub odczytu, niezależnie od siebie. Na przykład krok tekstowy jest w trybie edycji, gdy krok zapytania jest w trybie odczytu.

Określanie zakresu grupy

Grupa jest traktowana jako nowy zakres w skoroszycie. Wszystkie parametry utworzone w grupie są widoczne tylko wewnątrz grupy. Dotyczy to również funkcji scalania (merge) — dane można wyświetlać tylko wewnątrz ich grupy lub na poziomie nadrzędnym.

Typy grup

Możesz określić typ grupy do dodania do skoroszytu. Istnieją dwa typy grup:

Edytowalne: grupa w skoroszycie umożliwia dodawanie, usuwanie lub edytowanie zawartości elementów w grupie. Jest to najczęściej używane do celów układu i widoczności.
Z szablonu: Grupa w skoroszycie ładuje się z zawartości innego skoroszytu na podstawie jego ID. Zawartość tego skoroszytu jest ładowana i scalana do skoroszytu w czasie wykonywania. W trybie edycji nie można zmodyfikować żadnej zawartości grupy, ponieważ po prostu załadują ponownie z szablonu przy następnym załadowaniu elementu. Podczas ładowania grupy z szablonu użyj pełnego identyfikatora zasobu platformy Azure istniejącej książki roboczej.

Typy obciążenia

Możesz określić, jak i kiedy zawartość grupy jest ładowana.

Lenowe ładowanie

Ładowanie z opóźnieniem jest ustawieniem domyślnym. W przypadku ładowania leniwego grupa jest ładowana tylko wtedy, gdy element jest widoczny. Dzięki temu grupa może być używana przez elementy zakładek. Jeśli karta nigdy nie zostanie wybrana, grupa nigdy nie stanie się widoczna i dlatego zawartość nie zostanie załadowana.

W przypadku grup utworzonych na podstawie szablonu zawartość szablonu nie zostanie pobrana, a elementy w grupie nie zostaną utworzone, dopóki grupa nie stanie się widoczna. Użytkownicy widzą pokrętła postępu dla całej grupy podczas pobierania zawartości.

Jawne ładowanie

W tym trybie jest wyświetlany przycisk, w którym byłaby grupa, a żadna zawartość nie jest pobierana ani tworzona, dopóki użytkownik jawnie nie wybierze przycisku, aby załadować zawartość. Jest to przydatne w scenariuszach, w których zawartość może być kosztowna do obliczeń lub rzadko używana. Autor może określić tekst, który ma być wyświetlany na przycisku.

Ten zrzut ekranu przedstawia jawne ustawienia ładowania ze skonfigurowanym przyciskiem "Załaduj więcej".

Jest to grupa przed załadowaniem do skoroszytu:

Grupa po załadowaniu do skoroszytu:

Tryb zawsze włączony

W trybie Zawsze zawartość grupy jest zawsze ładowana i tworzona zaraz po załadowaniu skoroszytu. Jest to najczęściej używane, gdy używasz grupy tylko do celów układu, gdzie zawartość będzie zawsze widoczna.

Używanie szablonów wewnątrz grupy

Gdy grupa jest skonfigurowana do ładowania z szablonu, domyślnie ta zawartość jest ładowana w trybie leniwym i będzie ładowana tylko wtedy, gdy grupa jest widoczna.

Po załadowaniu szablonu do grupy skoroszyt próbuje scalić wszystkie parametry zadeklarowane w szablonie z parametrami, które już istnieją w grupie. Wszystkie parametry, które już istnieją w skoroszycie o identycznych nazwach, zostaną połączone z szablonem w trakcie jego ładowania. Jeśli wszystkie parametry w etapie parametru zostaną scalone, cały etap parametrów zniknie.

Przykład 1: Wszystkie parametry mają identyczne nazwy

Załóżmy, że masz szablon, który ma dwa parametry u góry, parametr zakresu czasu i parametr tekstowy o nazwie "Filter":

Następnie element grupy ładuje drugi szablon, który ma własne dwa parametry i krok tekstowy, gdzie parametry mają taką samą nazwę:

Po załadowaniu drugiego szablonu do grupy zduplikowane parametry zostaną scalone. Ponieważ wszystkie parametry zostały scalone, krok wewnętrznych parametrów jest również scalony, co powoduje, że grupa ostatecznie zawiera tylko krok tekstowy.

Przykład 2: Jeden parametr ma identyczną nazwę

Załóżmy, że masz szablon, który ma dwa parametry u góry, parametr zakresu czasu i parametr tekstowy o nazwie "FilterB" ():

Po załadowaniu szablonu elementu grupy, parametr TimeRange jest usuwany z grupy. Skoroszyt zawiera początkowy krok parametrów z TimeRange i Filter, a parametr grupy obejmuje tylko FilterB.

Jeśli załadowany szablon zawierałby TimeRange i Filter (zamiast FilterB), to wynikowy skoroszyt miałby krok parametrów i grupę z pozostałym tylko krokiem tekstowym.

Dzielenie dużego szablonu na wiele szablonów

Aby zwiększyć wydajność, warto podzielić duży szablon na wiele mniejszych szablonów, które ładują część zawartości w trybie leniwym lub na żądanie przez użytkownika. Dzięki temu początkowe ładowanie jest szybsze, ponieważ szablon najwyższego poziomu może być mniejszy.

Podczas dzielenia szablonu na części należy w zasadzie podzielić szablon na wiele szablonów (podtemplaty), które działają pojedynczo. Jeśli szablon najwyższego poziomu ma parametr TimeRange używany przez inne elementy, podplata musi również mieć element parametrów definiujący parametr o tej samej dokładnej nazwie. Subszablony będą działały niezależnie i mogą ładować się wewnątrz większych szablonów jako grupy.

Aby przekształcić większy szablon w wiele podszablonów:

Utwórz nową pustą grupę w górnej części skoroszytu po parametrach udostępnionych. Ta nowa grupa stanie się ostatecznie subszablonem.
Utwórz kopię kroku parametrów udostępnionych, a następnie użyj przenoszenia do grupy , aby przenieść kopię do grupy utworzonej w kroku 1. Ten parametr umożliwia działanie podszablonu niezależnie od szablonu zewnętrznego i zostanie scalony po załadowaniu go do szablonu zewnętrznego.

Uwaga

Szablony podrzędne nie muszą technicznie mieć parametrów, które są połączone, jeśli nigdy nie zamierzasz, aby były widoczne osobno. Jeśli jednak podtemplaty nie mają parametrów, bardzo trudno będzie je edytować lub debugować, jeśli będzie to konieczne później.
Przenieś każdy element w skoroszycie, który chcesz umieścić w podszablonie, do grupy utworzonej w kroku 1.
Jeśli poszczególne kroki przeniesione w kroku 3 miały warunkową widoczność, to staje się ona widocznością grupy zewnętrznej (jak w przypadku użycia na kartach). Usuń je z elementów wewnątrz grupy i dodaj to ustawienie widoczności do samej grupy. Zapisz tutaj, aby uniknąć utraty zmian, i/lub wyeksportuj i zapisz kopię zawartości pliku json.
Jeśli chcesz, aby ta grupa została załadowana z szablonu, możesz użyć przycisku Edytuj na pasku narzędzi w grupie. Spowoduje to otwarcie tylko zawartości tej grupy jako skoroszytu w nowym oknie. Następnie możesz zapisać go odpowiednio i zamknąć ten widok skoroszytu (nie zamykaj przeglądarki, tylko ten widok, aby wrócić do poprzedniego edytowanego skoroszytu).
Następnie możesz zmienić krok grupy, aby ładować z szablonu, i ustawić pole Identyfikator Szablonu na skoroszyt/szablon, który utworzyłeś w kroku 5. Aby pracować z identyfikatorami skoroszytów, źródło musi być pełnym identyfikatorem zasobu platformy Azure udostępnionego skoroszytu. Naciśnij przycisk Załaduj, a zawartość tej grupy zostanie teraz załadowana z tego podszablonu, a nie zapisana w zewnętrznym skoroszycie.

Dodawanie obrazu

Skoroszyty umożliwiają autorom dołączenie obrazów do treści. Użyj elementu obrazu, aby udostępnić ułatwienia wizualne, takie jak diagramy, zrzuty ekranu i inne informacje wizualne.

Aby dodać obraz w skoroszycie:

Dodaj obraz, wykonując jedną z następujących czynności:
- Wybierz pozycję Dodaj i Dodaj obraz poniżej istniejącego elementu lub w dolnej części skoroszytu.
- Wybierz wielokropek (...) po prawej stronie przycisku Edytuj obok jednego z elementów w skoroszycie, a następnie wybierz pozycję Dodaj , a następnie pozycję Dodaj obraz.
Wprowadź adres URL obrazu w podanym polu.
Podaj dodatkowe ustawienia, takie jak tytuł obrazu, rozmiar i tekst alternatywny. Ustawienie rozmiaru obrazu na pełny rozmiar powoduje ustawienie oryginalnego rozmiaru obrazu.

Dodawanie wideo

Arkusze robocze umożliwiają autorom osadzanie treści wideo w twoim arkuszu.

Aby dodać wideo w skoroszycie:

Dodaj film wideo, wykonując jedną z następujących czynności:
- Wybierz pozycję Dodaj i Dodaj wideo poniżej istniejącego elementu lub w dolnej części skoroszytu.
- Wybierz wielokropek (...) po prawej stronie przycisku Edytuj obok jednego z elementów w skoroszycie, a następnie wybierz pozycję Dodaj , a następnie dodaj wideo.
Wprowadź adres URL wideo w podanym polu.
Podaj dodatkowe ustawienia, takie jak tytuł wideo, rozmiar i tekst alternatywny.