Podstawy korzystania z Apps Script w Arkuszach Google nr 5: tworzenie wykresu i prezentowanie danych w Prezentacjach

Podstawy korzystania z Apps Script w Arkuszach Google nr 5:

tworzenie wykresu i prezentowanie danych w Prezentacjach

Informacje o tym ćwiczeniu (w Codelabs)

Ostatnia aktualizacja: kwi 4, 2022

Autorzy: Google Workspace Developer Relations

1. Wstęp

Witamy w piątej części playlisty z podstawowymi informacjami o skrypcie aplikacji wykorzystującym Arkusze Google. Z tego ćwiczenia z ćwiczenia z programowania dowiesz się, jak korzystać z usługi Arkusz kalkulacyjny w języku Apps Script, by tworzyć wykresy zbiorów danych. Dowiedz się też, jak korzystać z usługi Prezentacje, aby wyeksportować wykres do nowej prezentacji w Prezentacjach Google.

Czego się nauczysz

• Jak utworzyć wykres liniowy za pomocą Apps Script.
• Jak wyeksportować wykresy do nowej prezentacji w Prezentacjach?
• Jak wyświetlać okna użytkownikom w Arkuszach.

Uwaga: w tym ćwiczeniu z programowania będziesz pracować głównie z arkuszem kalkulacyjnym Apps Script, aby tworzyć osadzone wykresy i nimi zarządzać.

Apps Script ma też własną usługę Wykresy danych. Jednak służy on głównie do tworzenia i edytowania wykresów przeznaczonych do użytku w aplikacjach innych niż Arkusze Google. Te ćwiczenia nie obejmują tych przypadków użycia.

Zanim zaczniesz

To piąte ćwiczenie z programowania na playliście Podstawy Apps Script w Arkuszach Google. Zanim rozpoczniesz te ćwiczenia z programowania, wykonaj te czynności:

1. Makra i funkcje niestandardowe
2. Arkusze kalkulacyjne, arkusze kalkulacyjne i zakresy
3. Praca z danymi
4. Formatowanie danych

Czego potrzebujesz

• Omówienie podstawowych tematów Apps Script omówionych w poprzednich ćwiczeniach z tej playlisty.
• Podstawowe informacje o edytorze Apps Script
• Podstawowe informacje o Arkuszach Google
• Możliwość czytania Arkuszy notacja A1
• Podstawowa znajomość JavaScriptu i jego klasy String

2. Skonfiguruj

Aby kontynuować, potrzebujesz arkusza kalkulacyjnego z danymi. Tak jak wcześniej udostępniliśmy arkusz danych, który możesz skopiować do tych ćwiczeń. Wykonaj te czynności:

1. Kliknij ten link, aby skopiować arkusz danych, a następnie kliknij Utwórz kopię. Nowy arkusz kalkulacyjny zostanie umieszczony w folderze na Dysku Google o nazwie „Kopia dat dat i kursów wymiany walut w USD”.
2. Kliknij tytuł arkusza kalkulacyjnego i zmień go z pola „Kopia dat dat i kursów walut w USD” na „Daty i kursy wymiany w USD”. Twój arkusz powinien wyglądać następująco: z podstawowymi informacjami na temat różnych kursów wymiany walut w różnych dniach:

3. Aby otworzyć edytor skryptów, kliknij Rozszerzenia > Apps Script.

Aby zaoszczędzić Twój czas, dodaliśmy do niego trochę kodu, który pozwoli Ci skonfigurować niestandardowe menu w tym arkuszu kalkulacyjnym. Menu mogło zostać wyświetlone po otwarciu kopii arkusza kalkulacyjnego:

Uwaga: więcej informacji o menu niestandardowych i onOpen() znajdziesz w ćwiczeniach z kursu Praca z danymi.

Ważne: skopiowany arkusz kalkulacyjny jest powiązany z projektem skryptu, więc gdy zostanie skopiowany, sam projekt skryptu. Pamiętaj, że jest to kopia oryginalnego projektu skryptu – zmiany w kopii nie zostaną odzwierciedlone w oryginalnej wersji i odwrotnie.

Dzięki temu arkuszowi projektowemu możesz rozpocząć ćwiczenia z programowania. Aby dowiedzieć się więcej o wykresach i czynnikach uruchamiających opartych na czasie, przejdź do następnej sekcji.

3. Tworzenie wykresu w Arkuszach za pomocą Apps Script

Załóżmy, że chcesz zaprojektować wykres w celu wizualizacji zbioru danych. Skrypty Apps Script umożliwiają tworzenie, edytowanie i wstawianie wykresów w Arkuszach Google. Jeśli wykres jest umieszczony w arkuszu kalkulacyjnym, nazywany jest wysłanym wykresem.

Wykresy służą do wizualizacji jednej lub kilku serii danych. W przypadku wykresów umieszczonych na stronie dane pochodzą zwykle z arkusza kalkulacyjnego. Zazwyczaj aktualizowanie danych w arkuszu kalkulacyjnym powoduje też automatyczną aktualizację wykresu w Arkuszach.

Możesz używać Apps Script, by tworzyć własne wykresy umieszczone na stronie lub aktualizować istniejące. W tej sekcji opisujemy podstawy tworzenia wykresów umieszczonych w Arkuszach za pomocą Apps Script oraz usługi Spreadsheet.

Zastrzeżenie: chociaż w języku Apps Script można wykonywać wiele czynności dotyczących wykresów, jest kilka rzeczy, które można zrobić. W usłudze Arkusze jest dostępnych kilka klas EmbeddedChart, ale nie wszystkie opcje konfiguracji są dostępne dla wykresu. Ponadto Apps Script korzysta z interfejsu Google Charts API, który ma własne ograniczenia.

Ze względu na te limity warto często korzystać z Apps Script do tworzenia podstawowych wykresów oraz ręcznego edytowania, a następnie ręcznego dostosowania formatowania w Arkuszach. W przypadku Apps Script może nie być możliwe zautomatyzowanie wszystkich procesów związanych z wykresami, ale można to zrobić w znacznym stopniu.

Wdrażanie

W kopii arkusza kalkulacyjnego danych „Daty i kursy wymiany” znajdziesz kursy wymiany (1 dolara amerykańskiego) na różne waluty z różnych dat. Zaimplementujesz funkcję Apps Script, która tworzy wykres do wizualizacji części tych danych.

Wykonaj te czynności:

1. W edytorze Apps Script dodaj następującą funkcję na końcu skryptu Code.gs skryptu po funkcji onOpen():

/**
 * Creates and inserts an embedded
 * line chart into the active sheet.
 */
function createEmbeddedLineChart() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartDataRange = sheet.getRange(
    'Dates and USD Exchange Rates dataset!A2:F102');
  var hAxisOptions = {
    slantedText: true,
    slantedTextAngle: 60,
    gridlines: {
      count: 12
    }
  };
  
  var lineChartBuilder = sheet.newChart().asLineChart();
  var chart = lineChartBuilder
    .addRange(chartDataRange)
    .setPosition(5, 8, 0, 0)
    .setTitle('USD Exchange rates')
    .setNumHeaders(1)
    .setLegendPosition(Charts.Position.RIGHT)
    .setOption('hAxis', hAxisOptions)
    .setOption("useFirstColumnAsDomain", true)
    .build();
 
  sheet.insertChart(chart);  
}

2. Zapisz projekt skryptu.

Weryfikacja kodu

Dodany przez Ciebie kod implementuje funkcję o nazwie menu Wykres i dane o stawkach w USD, która służy do utworzenia podstawowego wykresu liniowego. Sprawdźmy ten kod.

W pierwszych wierszach zostały skonfigurowane te 3 zmienne:

• sheet: odwołanie do bieżącego aktywnego arkusza.
• chartDataRange: zakres danych, który chcesz zwizualizować. Kod używa notacji A1 do określenia zakresu komórek od A2 do F102 w arkuszu o nazwie Daty i USD Kursy wymiany. Nazywając arkusz, upewniamy się, że element menu działa, nawet jeśli aktywny jest inny arkusz, ponieważ zakres zawsze obejmuje pozycję danych. Na początku wiersza 2 uwzględnimy nagłówki kolumn, a na wykresie wyświetli się tylko 100 ostatnich dat (wierszy).
• hAxisOptions: podstawowy obiekt JavaScript, który zawiera informacje o kodzie, które są używane w kodzie do konfigurowania wyglądu osi poziomej. W szczególności ustawiają one etykiety tekstowe osi poziomej na skosie o 60 stopni i ustawiają liczbę pionowych linii siatki na 12.

W kolejnym wierszu tworzony jest obiekt Kreatora wykresów liniowych. Wykresy umieszczone w Apps Script są tworzone za pomocą wzorca projektora. Pełne omówienie tego wzoru projektowego jest niedostępne dla tego ćwiczenia z programowania, więc na razie wystarczy zapoznać się z usługą Spreadsheet, gdzie znajdziesz kilka klas EmbeddedChartBuilder. Aby utworzyć wykres, musisz najpierw utworzyć kod osadzonego obiektu kreatora, użyć jego metod do określenia ustawień wykresu, a następnie wywołać metodę build() w celu utworzenia ostatecznego obiektu EmbeddedChart. Twój kod nigdy nie modyfikuje bezpośrednio obiektu EmbeddedChart, ponieważ całą konfiguracją wykresu zarządza się za pomocą klas kreatora.

Usługa Arkusz kalkulacyjny zawiera nadrzędną klasę EmbeddedChartBuilder i wiele klas podrzędnych (takich jak EmbeddedLineChartBuilder), które dziedziczą z niej klasy. Klasy podrzędne umożliwiają Apps Script podanie metod konfiguracji wykresów kreatora, które są stosowane tylko do określonych typów wykresów. Na przykład klasa EmbeddedPieChartBuilder udostępnia metodę set3D(), która ma zastosowanie tylko do wykresów kołowych.

W Twoim kodzie ten wiersz tworzy zmienną obiektu kreatora lineChartBuilder:

var lineChartBuilder = sheet.newChart().asLineChart();

Kod wywołuje metodę Sheet.newChart(), by utworzyć obiekt EmbeddedChartBuilder, a potem używa EmbeddedChartBuilder.asLineChart(), by ustawić typ konstruktora na EmbeddedLineChartBuilder.

Następnie kod tworzy kompilację za pomocą metody lineChartBuilder. Ta część kodu to seria wywołań metody definiujących ustawienia wykresu, a po niej wywołania build() służące do utworzenia wykresu. Jak widziliśmy w poprzednich ćwiczeniach z programowania, kod korzysta z łańcucha metod, dzięki czemu kod jest czytelny dla człowieka. Oto wyniki metody metody:

• addRange(range): definiuje zakres danych wyświetlany na wykresie.
• setPosition(anchorRowPos, anchorColPos, offsetX, offsetY): określa miejsce umieszczenia wykresu na arkuszu. Kod ten zastępuje lewy górny róg wykresu komórki H5.
• setTitle(title): określa tytuł wykresu.
• setNumHeaders(headers): określ liczbę wierszy lub kolumn w zakresie danych, które mają być traktowane jako nagłówki. W kodzie jest on używany jako pierwszy wiersz zakresu dat jako nagłówki, co oznacza, że tekst w tym wierszu jest używany jako etykiety poszczególnych serii danych na wykresie.
• setLegendPosition(position): przenosi legendę do prawej strony wykresu. Ta metoda używa wyliczenia Charts.Position jako parametru.
• setOption(option, value): ustawia zaawansowane opcje wykresu. W tym kodzie kod powoduje ustawienie opcji hAxis na obiekt hAxisOptions. Za pomocą tej metody można ustawić kilka opcji. Opcje i możliwe wartości poszczególnych typów wykresów są wymienione w Galerii wykresów API. Na przykład opcje konfiguracji wykresów liniowych opisano w artykule Opcje konfiguracji wykresu liniowego. Metoda setOption(option, value) jest zaawansowanych tematów, dlatego lepiej z niej nie korzystać, dopóki nie będzie Ci łatwiej tworzyć wykresy w Apps Script.
• build() – tworzy i zwraca obiekt EmbeddedChart przy użyciu powyższych ustawień.

Na koniec kod wywołuje metodę Sheet.insertChart(chart), aby umieścić utworzony wykres w aktywnym arkuszu.

Wyniki

Aby sprawdzić działanie funkcji formatowania, wykonaj te czynności:

1. Zapisz projekt skryptu w edytorze Apps Script, jeśli jeszcze go nie masz.
2. Kliknij element menu Prezentuj zbiór danych > Data i kursy wymiany w USD.

Uwaga: jeśli używasz konta gmail.com, przy pierwszym użyciu skryptu może pojawić się okno „Ta aplikacja nie jest zweryfikowana”. Google używa tego ustawienia, aby ostrzegać użytkowników, którzy mogą używać kodu od nieznanych lub niezaufanych autorów. Jeśli widzisz to okno, oznacza to, że możesz kontynuować, ponieważ jesteś właścicielem skryptu. Aby kontynuować autoryzowanie skryptu, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie:

1. W oknie niezweryfikowanej aplikacji kliknij Zaawansowane.
2. Kliknij Przejdź do dat i kursów wymiany w USD (niebezpieczne).
3. Kliknij Zezwól.

W trakcie tych kilku ćwiczeń możesz otrzymywać kilka próśb o przyznanie uprawnień. Więcej informacji o tym procesie znajdziesz w artykule Autoryzacja usług Google.

Twój skrypt umieszcza teraz nowy wykres po prawej stronie danych:

Gratulacje, udało Ci się utworzyć wbudowany wykres liniowy za pomocą Apps Script. Z następnej sekcji dowiesz się, jak wyeksportować wykres do Prezentacji Google.

4. Eksportowanie wykresów do Prezentacji

Jedną z największych zalet Apps Script jest to, że pozwala ono łatwo przenosić dane z jednej aplikacji Google Workspace do drugiej. Większość z nich ma własną usługę Apps Script, podobną do usługi Arkusze. Na przykład w Gmailu jest dostępna usługa Gmail, w Dokumentach Google jest dostępna usługa Dokumenty, a w Prezentacjach Google – usługa Prezentacje. Dzięki tym wbudowanym usługom możesz wyodrębniać dane z jednej aplikacji, przetwarzać je i zapisywać wyniki w innej.

Z tej sekcji dowiesz się, jak wyeksportować każdy umieszczony wykres w arkuszu kalkulacyjnym Google do nowej prezentacji w Prezentacjach Google. Zobaczysz też w Arkuszach niestandardowe sposoby wyświetlania niestandardowych wiadomości od użytkowników.

Uwaga: gdy korzystasz z usługi Prezentacje, skrypty mogą tworzyć obiekty Presentation, wypełniać je Slides i Layouts, a następnie dodawać PageElements, takie jak Shapes, TextRanges i Lines. W przypadku opcji Prezentacje usługa jest prawie taka sama jak usługa Arkusz kalkulacyjny.

Skrypty aplikacji mogą być bardzo przydatne w Prezentacjach Google, ale w ramach tego ćwiczenia będziesz tworzyć prezentację, tworzyć slajdy i importować wykresy do slajdów. Więcej informacji znajdziesz w dokumentacji rozszerzania Prezentacji Google.

Wdrażanie

W tym miejscu wdrożysz funkcję o nazwie menu Prezentuj zbiór danych > Eksportuj wykresy do Prezentacji. Wykonaj te czynności:

1. W edytorze Apps Script dodaj następującą funkcję na końcu skryptu Code.gs skryptu po funkcji createEmbeddedLineChart():

/**
 * Create a Slides presentation and export
 * all the embedded charts in this spreadsheet
 * to it, one chart per slide.
 */
function exportChartsToSlides() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // Fetch a list of all embedded charts in this
  // spreadsheet.
  var charts = [];
  var sheets = ss.getSheets();
  for (var i = 0; i < sheets.length; i++) {
    charts = charts.concat(sheets[i].getCharts());
  }
  
  // If there aren't any charts, display a toast
  // message and return without doing anything
  // else.
  if (charts.length == 0) {
    ss.toast('No charts to export!');
    return;
  }
  
  // Create a Slides presentation, removing the default
  // title slide.
  var presentationTitle =
    ss.getName() + " Presentation";
  var slides = SlidesApp.create(presentationTitle);
  slides.getSlides()[0].remove();  
  
  // Add charts to the presentation, one chart per slide.
  var position = {left: 40, top: 30};
  var size = {height: 340, width: 430};
  for (var i = 0; i < charts.length; i++) {
    var newSlide = slides.appendSlide();
    newSlide.insertSheetsChart(
      charts[i],
      position.left,
      position.top,
      size.width,
      size.height);   
  }
  
  // Create and display a dialog telling the user where to
  // find the new presentation.
  var slidesUrl = slides.getUrl();
  var html = "<p>Find it in your home Drive folder:</p>"
      + "<p><a href=\"" + slidesUrl + "\" target=\"_blank\">"
      + presentationTitle + "</a></p>";
  
  SpreadsheetApp.getUi().showModalDialog(
    HtmlService.createHtmlOutput(html)
      .setHeight(120)
      .setWidth(350),
      "Created a presentation!"
  );
}

2. Zapisz projekt skryptu.

Weryfikacja kodu

Ten kod może być krótszy od oczekiwanego. Zobaczmy, co robi, dzieląc kod na pięć sekcji:

1. Pobierz wykresy

Pierwsze kilka wierszy przeszukuje aktywny arkusz kalkulacyjny, by znaleźć wszystkie osadzone wykresy i zebrać je w tablicy charts. Te wiersze korzystają z metody Spreadsheet.getSheets() oraz metody Sheet.getCharts() do pobierania list arkuszy i wykresów. Metoda JavaScript Array.concat() służy do dołączania listy wykresów z każdego arkusza do tabeli charts.

2. Sprawdź, czy istnieją wykresy do wyeksportowania

Kod sprawdza, czy są jakieś wykresy do wyeksportowania. Chcemy uniknąć tworzenia pustej prezentacji, więc jeśli nie ma żadnych wykresów, kod utworzy komunikat z komunikatem za pomocą Spreadsheet.toast(message). To krótkie okno dialogowe z komunikatem, które pojawia się w prawym dolnym rogu Arkuszy i pozostaje przez kilka sekund, a potem znika:

Ważne: komunikat informujący o tym, że coś się stało, jest świetne, ale nie jest to warte polecenia. W tym przypadku komunikat informujący o tym, że menu zakończyło się pomyślnie, ale nie przyniosło żadnego efektu, ponieważ nie ma wykresów do wyeksportowania.

Jeśli kod didn't spowoduje wyświetlenie komunikatu, będzie to wyglądało tak, jakby nic nie robiło w menu, a użytkownik mógł odnieść wrażenie, że skrypt jest uszkodzony. Zawsze warto informować użytkowników o działaniach skryptów, nawet jeśli są w nich błędy.

Jeśli nie ma żadnych wykresów do wyeksportowania, kod tworzy komunikat informujący i kończy działanie bez żadnych dodatkowych działań. Jeśli pojawią się wykresy do wyeksportowania, w kolejnych wierszach za pomocą kodu zostanie utworzona prezentacja.

3. Tworzenie prezentacji

Utworzono zmienną presentationTitle zawierającą nazwę nowego pliku prezentacji. Jest on ustawiony jako nazwa arkusza kalkulacyjnego z dołączoną na końcu ciągiem Presentation&quot. Następnie kod wywołuje metodę usługi Prezentacje SlidesApp.create(name), aby utworzyć prezentację.

Uwaga: klasa SlidesApp jest klasą nadrzędną w Prezentacjach, podobnie jak SpreadsheetApp to klasa nadrzędna w przypadku arkusza kalkulacyjnego.

Nowe prezentacje tworzy się za pomocą jednego, pustego slajdu. Nie chcemy tego w naszej prezentacji, więc kod usuwa go z tagów Presentation.getSlides() i Slide.remove().

4. Eksportowanie wykresów

W następnej sekcji kod określa parametry position i size obiektów JavaScript, które określają, gdzie zaimportowane slajdy mają się znaleźć na slajdzie, i jak duży ma być wykres (w pikselach).

Uwaga: elementy strony Prezentacji, takie jak zaimportowane wykresy, pola tekstowe i kształty, wymagają określonych pozycji i rozmiarów. Więcej informacji o tym, jak Apps Script ustawia te wartości, znajdziesz w przewodniku Rozmiar i położenie elementów strony.

Kod jest zapętlony na wszystkich wykresach na liście. Dla każdego wykresu tworzona jest właściwość newSlide z Presentation.appendSlide(), która dodaje slajd na końcu prezentacji. Metoda Slide.insertSheetsChart(sourceChart, left, top, width, height) służy do importowania wykresu do slajdu o określonych wartościach position i size.

5. Udostępnianie lokalizacji prezentacji

Na koniec kod musi poinformować użytkownika, gdzie znajduje się nowa prezentacja. Najlepiej użyj linku, który otworzy się po kliknięciu. W tym celu kod korzysta z usługi HTML Apps Script Apps Script, tworząc niestandardowe okno modalne. Okna modalne (nazywane też oknami niestandardowymi w Apps Script) to okna, które wyświetlają się w interfejsie Arkuszy. Niestandardowe okna dialogowe uniemożliwiają użytkownikowi interakcję z Arkuszami.

Ważne: okna dialogowe modalne przydają się, gdy skrypt musi zawierać konkretne informacje od użytkownika, aby można było kontynuować pracę lub gdy chcesz mieć pewność, że użytkownik zobaczy jakiś element, zanim będzie mógł kontynuować pracę w Arkuszach Google.

Usługa HTML Apps Script pozwala w pełni kontrolować styl i zawartość niestandardowych okien dialogowych za pomocą standardowych języków HTML i JavaScript. Oznacza to, że możesz dodawać do okna tekst, przyciski, obrazy i inne elementy interaktywne. Te tematy są niedostępne w ramach tego ćwiczenia, ale jeśli chcesz dowiedzieć się więcej, możesz skorzystać z przewodników dotyczących tworzenia i wyświetlania treści HTML oraz komunikacji z serwerem.

Aby utworzyć okno niestandardowe, kod musi zawierać kod HTML, który określa zawartość. Znajdziesz ją w zmiennej html. Zawierają one krótki akapit i hiperlink. hiperlink to zmienna presentationTitle połączona z adresem URL prezentacji dostarczonym przez Presentation.getUrl(); Zawiera ona też atrybut target="_blank", dzięki czemu prezentacja jest otwierana w nowej karcie przeglądarki, a nie w oknie.

Kod HTML jest analizowany w obiekcie HtmlOutput metodą HtmlService.createHtmlOutput(html). Obiekt HtmlOutput umożliwia kodowi ustawianie rozmiaru niestandardowego okna za pomocą tagów HtmlOutput.setHeight(height) i HtmlOutput.setWidth(width).

Gdy utworzysz htmlOutput, kod użyje metody Ui.showModalDialog(htmlOutput, title), aby wyświetlić okno dialogowe z określonym tytułem.

Wyniki

Po wdrożeniu drugiego elementu menu możesz go zobaczyć w praktyce. Aby przetestować funkcję exportChartsToSlides():

1. Zapisz projekt skryptu w edytorze Apps Script, jeśli jeszcze go nie masz.
2. Otwórz arkusz kalkulacyjny i kliknij element menu Prezentuj zbiór danych > Wykres &Daty i kursy walut w USD, aby utworzyć wykres do wyeksportowania. Będzie on zakotwiczony w komórce H5 w aktywnym arkuszu.
3. Kliknij element menu Prezentuj zbiór danych > Eksportuj wykresy do Prezentacji. Może pojawić się prośba o ponowną autoryzację skryptu.
4. Skrypt powinien przetworzyć żądanie i wyświetlić okno niestandardowe.
5. Aby otworzyć nową prezentację w Prezentacjach, kliknij link Daty i kursy wymiany w USD:

Jeśli chcesz, możesz też dodać więcej wykresów do arkusza kalkulacyjnego i ponownie wybrać pozycję menu, aby utworzyć prezentację z wieloma slajdami.

Uwaga: wykresy widoczne w prezentacji to połączone wykresy. Oznacza to, że nadal są połączone z oryginalnym wykresem w Arkuszach. Jeśli wprowadzisz zmiany w pierwotnym wykresie w Arkuszach, możesz zaktualizować połączony wykres w Prezentacjach, używając przycisku Aktualizuj. Możesz też wymusić odświeżenie, korzystając z metody SheetCharts.refresh().

Możesz teraz eksportować wykresy utworzone w Arkuszach do prezentacji w Prezentacjach. Możesz też napisać kod, aby utworzyć okno niestandardowe.

Ćwiczenia z programowania zostały ukończone. Przejdź do następnej sekcji, aby sprawdzić zdobytą wiedzę.

5. Podsumowanie

Gratulacje! To już wszystkie ćwiczenia z programowania i cała playlista Podstawy aplikacji Apps Script w Arkuszach Google. Możesz wykorzystać zasady przedstawione na tej playliście, aby rozszerzyć możliwości Arkuszy i poznać możliwości Apps Script.

Czy te ćwiczenia są przydatne?

TakNie

Czego się nauczyliśmy

• Jak utworzyć wbudowany wykres liniowy za pomocą Apps Script.
• Jak wyświetlać użytkownikowi komunikaty i niestandardowe okna dialogowe w Arkuszach.
• Jak wyeksportować wykres do nowej prezentacji w Prezentacjach?

Kluczowe pojęcia:

1. Usługa Arkusz kalkulacyjny korzysta z osadzonego wykresu i powiązanych z nim klas klas, aby tworzyć i modyfikować wykresy wyświetlane w Arkuszach. Usługa Wykresy służą do tworzenia i modyfikowania wykresów używanych poza Arkuszami, na przykład w aplikacjach internetowych Apps Script.
2. Tosty są używane w Arkuszach do zapewniania użytkownikom krótkich komunikatów o alertach bez konieczności podejmowania działań.
3. Okna niestandardowe to okna modalne utworzone w językach HTML i JavaScript. Niestandardowe okna dialogowe uniemożliwiają użytkownikowi interakcję z Arkuszami. Okna niestandardowe świetnie sprawdzają się w przypadku prośby użytkownika o wpisanie informacji, które musi uruchomić skrypt, lub o zgodę na czytanie określonego arkusza, zanim będzie chciał pracę z Arkuszy.
4. W przypadku kopiowania pliku ze skryptem powiązanym z kontenerem jego kopia zachowuje kopię skryptu. Jeśli zmienisz kopię, nie zostanie ona odzwierciedlona w oryginałie i odwrotnie.
5. Połączone wykresy w Prezentacjach są połączone z oryginalnymi wykresami w Arkuszach. Jeśli edytujesz pierwotny wykres w Arkuszach, możesz zaktualizować połączony wykres w Prezentacjach, aby odzwierciedlał on zmiany.

Kluczowe terminy:

• Aktywny (stan): wskazuje, że arkusz kalkulacyjny, arkusz, zakres lub komórka są tym, który użytkownik aktualnie wyświetla lub podświetla.
• Aktywna komórka: jedna podświetlona komórka w aktywnym arkuszu z zaznaczonym kursorem.
• Aktywny zakres: grupa zawierająca co najmniej 1 komórkę w aktywnym arkuszu.
• Autoryzacja: proces przyznający użytkownikom uprawnienia, które pozwalają skryptom Apps Script na dostęp do danych użytkownika w odpowiednich usługach Google lub na inne działania w jego imieniu.
• Skrypt powiązany z kontenerem: dowolny skrypt powiązany z dokumentem Google Workspace, np. Arkusz Google lub Dokument Google.
• Okno niestandardowe: modalne okno dialogowe z możliwością dostosowania, utworzone na podstawie kodu HTML i JavaScript, używane do przekazywania informacji o użytkownikach lub interakcji. Niestandardowe okna dialogowe uniemożliwiają użytkownikowi interakcję z Arkuszami.
• Umieszczanie wykresu: wykres umieszczony w arkuszu kalkulacyjnym.
• EmbeddedChartBuilder: klasa lub kreator służący do tworzenia lub edytowania właściwości EmbeddedChart.
• Funkcja pomocnicza: funkcja (zwykle prywatna), która jest wywoływana przez inną osobę i wykonuje małe zadania podrzędne. Funkcje pomocnicze są używane, gdy podzadanie jest wykonywane wiele razy w różnych miejscach.
• JSON: format pliku służący do definiowania obiektów danych i ich cech z tekstu.
• onOpen(): jeśli zdefiniowano go w skrypcie, jest to prosta reguła uruchamiana przy każdym otwarciu lub ponownym załadowaniu pliku.
• Połączony wykres: w Prezentacjach wykres, który jest połączony z oryginalnym wykresem w Arkuszach. Jeśli edytujesz pierwotny wykres w Arkuszach, możesz zaktualizować połączony wykres w Prezentacjach, aby odzwierciedlał on zmiany.
• Okno dialogowe: przejdź do niestandardowego okna.
• Prezentacja: plik Prezentacji Google zapisany na Dysku Google. Klasa Presentation umożliwia dostęp do prezentacji i ich modyfikowanie.
• Zakres**: grupa co najmniej jednej sąsiedniej komórki w arkuszu. Klasa Range** umożliwia odczytywanie i aktualizowanie zakresów w arkuszu.
• Edytor skryptów: edytor kodu przeglądarki w języku Apps Script.
• Proste wyzwalacze: podtyp reguł w Apps Script z zarezerwowanymi nazwami funkcji i określonymi ograniczeniami.
• Arkusz**: pojedyncza strona arkusza kalkulacyjnego. Czasami odnoszą się do pliku Arkuszy Google na Dysku Google. Klasa Sheet** umożliwia otwieranie i modyfikowanie arkuszy.
• Slajd: pojedynczy slajd w prezentacji. Klasa Slide umożliwia wyświetlanie i modyfikowanie slajdów.
• SlidesApp: ta klasa służy jako klasa nadrzędna w przypadku usługi Prezentacje i zapewnia punkt początkowy kodu służącego do odczytu lub manipulowania danymi Prezentacji Google.
• SpreadsheetApp: ta klasa służy jako klasa nadrzędna usługi w Arkuszach Google i stanowi punkt wyjścia do odczytywania i edytowania danych Arkuszy Google.
• Arkusz kalkulacyjny**: plik Arkuszy Google znajdujący się na Dysku Google. Klasa Spreadsheet** umożliwia dostęp do arkuszy kalkulacyjnych i ich modyfikowanie.
• Usługa arkusza kalkulacyjnego: usługa Apps Script, która umożliwia skryptom tworzenie, modyfikowanie i modyfikowanie plików Arkuszy Google.
• Toa: to krótkie okno dialogowe informujące użytkowników o pewnych zdarzeniach lub procesach w Arkuszach Google.
• Aktywatory: zdarzenie kluczowe dla funkcji Apps Script. Kiedy zdarzenie (na przykład otwarcie arkusza kalkulacyjnego) następuje, reguła uruchamia się, a następnie automatycznie wykonuje powiązaną funkcję Apps Script.
• Usługa pobierania adresów URL: usługa Apps Script, która umożliwia skryptom łączenie się z punktami końcowymi URL, aby wysyłać żądania i otrzymywać odpowiedzi.

Co dalej

Playlista została ukończona. Jednak to wciąż więcej informacji na temat Apps Script.

Zapoznaj się z tymi zasobami:

• Dokumentacja dla deweloperów Apps Script
• Przewodniki dotyczące Apps Script
• Dokumentacja dotycząca Apps Script
• Pytania dotyczące Apps Script na stronie StackOverflow
• Przykładowe kody Apps Script na GitHubie

Powodzenia!

Czy ta playlista ćwiczeń z programowania była pomocna?

TakNie

Czy w przyszłości chcesz się zapoznać z ćwiczeniami z programowania dotyczącymi Apps Script?

TakNie