Streamovanie údajov z Tabuliek Google na informačný panel: 6 krokov

2024 Autor: John Day | [email protected]. Naposledy zmenené: 2024-01-30 11:57

Tabuľky vynikajú pri manipulácii s údajmi, ale pri ich nezobrazovaní. Práve preto sa začalo objavovať toľko špecializovaných spoločností na vizualizáciu dát a BI dashboard. Problém väčšiny týchto výrobkov je, že sú zvyčajne drahé a ich inštalácia je náročná. Tento tutoriál vám ukáže jednoduchý a lacný spôsob, ako vytvoriť krásny, zdieľateľný informačný panel na aktualizáciu v reálnom čase z vašich údajov v Tabuľkách Google.

Zásoby

• Tabuľky Google: Výkonná tabuľka, ktorú môžete použiť vo svojom webovom prehliadači (bezplatne).
• Počiatočný stav: Služba streamovania a vizualizácie údajov, ktorú môžete použiť na vytváranie informačných panelov v reálnom čase vo webovom prehliadači (zadarmo pre študentov, 9,99 dolárov mesačne alebo 99 dolárov ročne pre všetkých ostatných).

Krok 1: Ako to funguje

Počiatočný stav je služba streamovania údajov, čo znamená, že do jej API môžete vložiť údaje z časových radov (t. J. Údaje s časovou pečiatkou). Inými slovami, ak je teplota 50 stupňov o 17:45, tieto informácie môžeme ľahko odoslať ako údajový bod do rozhrania API počiatočného stavu. Akonáhle sú tieto údaje vo vašom účte, môžete ich zobraziť vo vizualizáciách a vytvoriť si vlastný informačný panel, ktorý si môžete prezrieť vo webovom prehliadači. Stačí, aby ste Tabuľky Google odoslali údaje z tabuľky na váš účet Počiatočný stav, keď ich chcete odoslať.

Tabuľky Google majú úžasnú skriptovaciu funkciu, ktorú môžeme použiť na vytvorenie vlastnej funkcie, ktorá to dokáže. Stačí nám do Google Scriptu napísať funkciu, ktorá bude odosielať údaje do API počiatočného stavu. Zavolanie tejto funkcie do tabuľky bude jednoduché a umožní vám odoslať akékoľvek údaje, ktoré chceme

Krok 2: Vytvorte balík údajov o počiatočnom stave

Zaregistrujte si účet Počiatočný stav tu, ak ho ešte nemáte. Akonáhle ste zaregistrovaní a prihlásení, kliknite na ikonu +cloud v hornej časti poličky vedra a vytvorte nový segment dát. Toto bude cieľ pre vaše streamované údaje v Tabuľkách Google. Na odosielanie údajov do tohto vedra potrebujete dva kľúče. Jeden je prístupový kľúč vášho súkromného účtu, ktorý bude smerovať údaje do vášho účtu. Druhý kľúč je Bucket Key, ktorý slúži na určenie, do ktorého dátového segmentu vo vašom účte sa majú údaje dostať. V dialógovom okne New Bucket Key môžete zadať ľubovoľný názov kľúča vedra. Zobrazí sa aj váš prístupový kľúč. Kliknutím na tlačidlo Vytvoriť vytvorte nový segment údajov. Na poli s vedrami sa zobrazí nový segment dát. Kliknutím na odkaz Nastavenia pod názvom dátového segmentu zobrazíte vedrový kľúč a prístupový kľúč. Tieto kľúče budete potrebovať na ďalší krok. Váš dátový segment počiatočného stavu je pripravený na príjem údajov.

Krok 3: Vytvorte skript Google

Vytvorte novú tabuľku Tabuliek Google. Kliknutím na Nástroje -> Editor skriptov otvoríte editor Google Script. Skopírujte a prilepte do editora skriptov nasledujúcu funkciu:

funkcia streamData (signalName, hodnota, povoliť) {

var accessKey = 'UMIESTNITE KLÍČ PRÍSTUPU TU'; var bucketKey = 'UMIESTNITE KĽÚČOVÝ KLÍČ TU'; if (! signalName) {signalName = 'UnknownData'; } if (enable) {var url = 'https://groker.init.st/api/events?accessKey=' + accessKey + '& bucketKey =' + bucketKey + '&' + encodeURIComponent (signalName) + '=' + encodeURIComponent (hodnota); UrlFetchApp.fetch (url); návratový signálNázov + '=' + hodnota; }}

Prístupový kľúč k počiatočnému stavu účtu budete musieť umiestniť na riadok 2 a kľúč k počiatočnému stavu účtu na riadok 3 podľa pokynov. Kliknutím na Súbor -> Uložiť uložíte tento skript a použijete všetky zmeny (ak zmeny neuložíte, tabuľka nemôže používať túto novú funkciu).

Pozrime sa na funkciu, ktorú sme práve vytvorili. streamData (signalName, value, enable) vyžaduje tri vstupné parametre. signalName je názov toku údajov (napr. Teplota). hodnota je aktuálna hodnota toku údajov (napr. 50). enable je TRUE alebo FALSE a používa sa na ovládanie, kedy skutočne odosielame údaje do nášho dátového segmentu. Riadok 8 je riadok kódu, ktorý v skutočnosti volá API počiatočného stavu pomocou parametrov adresy URL.

Môžete to otestovať úpravou bunky vo svojej tabuľke podľa vzorca: = streamData („moje číslo“, 1, PRAVDA) a stlačením klávesu ENTER. Ak boli údaje úspešne odoslané, bunka by mala vrátiť myNumber = 1.

Vráťte sa na svoj účet Počiatočný stav a kliknite na svoj nový segment dát. Mali by ste vidieť, že číslo 1 bolo odoslané do nového dátového toku s názvom myNumber. Pohrajte sa so zmenou hodnoty a signalName a sledujte, ako sa zmení váš informačný panel.

Krok 4: Príklad tabuľky

Tento odkaz vás zavedie na príklad tabuľky, ktorá používa funkciu streamData na dvoch rôznych miestach, jedným na odoslanie hodnoty myNumber a druhým na odoslanie hodnoty myString. Tento príklad budete musieť skopírovať a zopakovaním kroku 2 pridať vlastnú funkciu Google Script, aby ste sa s touto tabuľkou mohli pohrať. Povolenie je uvedené v C2. Jednoducho zmeňte toto na FALSE, aby ste vykonali zmeny bez odosielania akýchkoľvek nechcených údajov do vášho dátového úložiska, a späť na TRUE, aby ste povolili streamovanie údajov.

Všimnite si, že čísla, reťazce alebo dokonca emodži môžete streamovať na svoj hlavný panel. Kedykoľvek sa zmení akákoľvek vstupná premenná, funkcia streamData vykoná a odošle údaje.

Krok 5: Zadanie časových pečiatok (streamovanie údajov z minulosti)

Prvý príklad jednoducho odosiela údaje prostredníctvom parametrov adresy URL vždy, keď sa zmení vstup údajov do našej funkcie Google Script. Časová pečiatka použitá pre tento údajový bod je kedykoľvek, keď API prijme údaje. Čo keď chcete zadať časovú pečiatku? Čo napríklad chcete poslať údaje spred mesiaca na váš informačný panel? Počiatočný stav API (dokumentácia tu) nám to umožňuje. Potrebujeme napísať inú funkciu Google Script, ktorá ako vstupný parameter preberá časovú pečiatku:

funkcia streamDataTime (signalName, hodnota, timestamp, povoliť) {

if (! signalName) {signalName = 'UnknownData'; } var headersIS = {'X-IS-AccessKey': 'UMIESTNIŤ KĽÚČ PRÍSTUPU TU', 'X-IS-BucketKey': 'UMIESTNIŤ KĽÚČOVÝ KĽÚČ TU', 'Prijať-verzia': '~ 0'} var údaje = {'key': signalName, 'value': value, 'iso8601': timestamp}; var options = {'method': 'post', 'contentType': 'application/json', 'headers': headersIS, 'payload': JSON.stringify (data)}; if (enable) {UrlFetchApp.fetch ('https://groker.init.st/api/events', options); návratový signálNázov + '=' + hodnota; }}

Vyššie uvedený skript Google pridáva vstupný parameter časovej pečiatky. Tento skript volá API počiatočného stavu odoslaním objektu JSON prostredníctvom HTTPS POST. Stačí, ak na riadkoch 6 a 7 zadáte prístupový kľúč počiatočného stavu a kľúč vedra.

Časová pečiatka musí mať formát iso8601 (informácie o iso8601). Príkladom časovej pečiatky iso8601 je „2019-01–01T18: 00: 00-06: 00“. Táto časová pečiatka je ekvivalentná 1. januára 2019, 18:00 CT. Časť „-06: 00“časovej pečiatky určuje časové pásmo. Ak nezadáte svoje časové pásmo, predpokladá sa, že čas je UTC. Keď svoje údaje zobrazíte v počiatočnom stave v dlaždiciach, na zobrazenie vašich údajov sa použije miestne časové pásmo vášho prehliadača.

Tento odkaz vás zavedie na príklad tabuľky, ktorá používa funkciu streamDataTime v stĺpci F. Tento príklad budete musieť skopírovať a zopakovaním kroku 2 pridať vlastnú funkciu Google Script, aby ste sa s touto tabuľkou mohli pohrať. Tento príklad zaznamenáva počet návštevníkov webových stránok za každý januárový deň v mesiaci.

Streamovanie tejto ukážkovej tabuľky na informačný panel Počiatočný stav môže vyzerať ako vyššie (tento informačný panel si môžete pozrieť na https://go.init.st/v8sknuq). Všimnite si časovú os v hornej časti panela, ktorá sa zhoduje s časovými pečiatkami uvedenými v údajoch Tabuliek Google (stĺpec D). Tento informačný panel používa na pridanie kontextu do dlaždíc meradlo a emodži. Presné rozloženie hlavného panela môžete do svojho príkladu importovať podľa týchto pokynov. Na svoj informačný panel môžete pridať obrázok na pozadí, aby mali vaše údaje ďalší kontext.

Krok 6: Záver

Do tabuľky Tabuliek Google môžete pridať ľubovoľný počet KPI a streamovať ich na informačný panel pomocou základných princípov v tomto prípade. Môžete nastaviť viacero tabuliek na odosielanie údajov na jeden informačný panel. Môžete nastaviť senzory alebo iné aplikácie na odosielanie údajov na rovnaký informačný panel, ako je tabuľka v Tabuľkách Google, a dokonca tieto rôzne zdroje údajov vo svojom hlavnom paneli dokonca matematicky kombinovať.