Typowy proces sprawdzania zmian w wizualizacji utworzonej przez społeczność polega na przesłaniu plików do GCS, a następnie odświeżeniu raportu w Studio danych. To działa, ale oznacza, że możesz spędzić dużo czasu, czekając na wprowadzenie zmian. dscc-gen umożliwia natychmiastowe wyświetlanie zmian w kodzie wizualizacji, co skraca czas potrzebny na napisanie wizualizacji utworzonej przez społeczność.
Na początek upewnij się, że masz zainstalowane npm w wersji 5.2.0 lub nowszej i gsutil. Następnie uruchom polecenie:
npx @google/dscc-gen viz
Pierwsza konfiguracja
dscc-gen zawiera domyślny lokalny zbiór danych, który prawdopodobnie nie jest reprezentatywny dla danych, które chcesz wizualizować. Aby dostosować ten zbiór danych do swoich potrzeb:
- Zaktualizuj konfigurację na stronie
src/index.json. - Uruchom
npm run update_message. Spowoduje to wdrożenie w Twoim koszudevwizualizacji, która wyświetla wiadomość w formacie łatwym do skopiowania. - Utwórz nowy raport i połącz go ze zbiorem danych, który reprezentuje dane, jakie chcesz wizualizować.
- Dodaj wizualizację utworzoną przez społeczność, używając jako identyfikatora komponentu koszyka
dev. - Skopiuj zawartość wizualizacji do pliku
scripts/data/localData.js. Te dane będą używane podczas tworzenia aplikacji lokalnie.
Skrypty
W przypadku projektów wizualizacji utworzonych za pomocą narzędzia dscc-gen dostępne są te skrypty:
| Polecenie | Działanie |
|---|---|
npm run start
|
Uruchom lokalny serwer i wyświetl podgląd wizualizacji |
npm run update_message |
Zaktualizuj wiadomość za pomocą parametru objectFormat. |
npm run build:dev
|
Kompiluj pliki z ./src do ./build z wyłączonym buforowaniem. |
npm run push:dev |
Skopiuj pliki z build do zasobnika dev. |
npm run build:prod
|
Twórz pliki z ./src w ./build z włączoną pamięcią podręczną. |
npm run push:prod
|
Skopiuj pliki z build do zasobnika prod. |
Polecenie update_message domyślnie przyjmuje wartość objectFormat. Aby użyć parametru tableFormat, zmień parametry w skrypcie update_message w zadaniu package.json z -f object na -f table.
Ćwiczenia z programowania
Aby dowiedzieć się, jak korzystać z narzędzi, zapoznaj się z ćwiczeniami z programowania dscc-gen.
