Selaa SaaS-yhteisöjä Twitterissä, LinkedInissä, Redditissä, Discordissa, anna sille nimet ja näet yhteisen teeman monissa niistä. Tällä teemalla voi olla monia nimiä: BI, analytics, insights ja niin edelleen. Se on luonnollista, teemme liiketoimintaa, keräämme tietoja, onnistumme tai epäonnistumme. Haluamme tarkastella kaikkea tätä, saada jonkin verran järkeä käytettävissämme olevista tiedoista ja ryhtyä toimiin. Tämä tarve on tuottanut monia projekteja ja työkaluja, jotka helpottavat jokaisen dataan tutustumisen haluavan elämää. Mutta kun ihmisillä on, ihmiset haluavat enemmän. Ja BI:n ja analytiikan maailmassa "enemmän" tulee usein upotuksen, brändäyksen, mukautetun tyylin ja pääsyn muodossa ja niin edelleen. Tämä merkitsee enemmän työtä kehittäjille ja enemmän aikaa tilille. Joten luonnollisesti on ollut tarvetta BI-työkaluille, joiden avulla sinulla on kaikki.
Tehdään luettelo haasteista, joita saatat kohdata näiden hallintapaneelien rakentajana ja ylläpitäjänä:
- Haluat asettaa hallintapaneelit loppukäyttäjien tai katsojien saataville omasta sovelluksestasi tai alustastasi
- Haluat pystyä hallitsemaan erilaisia kojelautakokoelmia (eli "integraatioita")
- Haluat pystyä myöntämään tiettyjä käyttäjäoikeuksia kojetaulujen ja tietojoukkojen kokoelmalle
- Haluat varmistaa, että käyttäjillä on pääsy vain heille tärkeisiin tietoihin
Cumul.io tarjoaa kutsumamme työkalun integraatiot joka auttaa ratkaisemaan nämä haasteet. Tässä artikkelissa opastan sinut läpi, mitä integraatiot ovat ja miten ne määritetään. Hienoa on, että useimpiin yllä oleviin kohtiin vaaditaan vain vähän koodia ja suurin osa voidaan asettaa koodin sisällä Cumul.io UI.
Taustaa - Integraatiot
An Integraatio Cumul.io:ssa on rakenne, joka määrittelee kokoelman koontinäyttöjä, jotka on tarkoitettu käytettäviksi yhdessä (esim. samassa sovelluksessa). Se on myös meidän tapamme Upottaa kojelaudat sovellukseen. Toisin sanoen, jos haluat upottaa kojelaudat sovellukseen, annamme sovellukselle pääsyn integraatioon, johon ne kuuluvat. Voit liittää koontinäyttöjä integraatioon ja hallita, minkä tyyppiset käyttöoikeudet integroinnin loppukäyttäjillä on näihin koontipaneeleihin ja heidän käyttämiinsä tietokokonaisuuksiin. Kojelauta voi olla osa useita integraatioita, mutta sillä voi olla erilaiset käyttöoikeudet eri integraatioissa. Mitä tulee upottamiseen, käytettävissä on useita SDK:ita, jotka tekevät elämästä helppoa riippumatta siitä, miltä pinosi näyttää. 😊
Kun sinulla on Cumul.io-tili ja jos olet Cumul.io-organisaation "omistaja", voit hallita ja ylläpitää kaikkia integraatioitasi Integraatiot-välilehden kautta. Katsotaanpa esimerkkiä Cumul.io-tilistä. Alla näet hallintapaneelit, jotka yksi Cumul.io-käyttäjä on saattanut luoda:
Vaikka nämä ovat kaikki tämän käyttäjän luomia hallintapaneeleja, on todennäköistä, että kaikkia koontinäyttöjä ei ole tarkoitettu samoille loppukäyttäjille tai samalle sovellukselle. Joten tämän Cumul.io-tilin omistaja loisi ja ylläpitäisi integraatiota (tai enemmän!) 💪 Katsotaanpa, miltä se voisi näyttää hänen kohdallaan:
Joten näyttää siltä, että tämän Cumul.io-tilin omistaja ylläpitää kahta erillistä sovellusta.
Katsotaan nyt, miltä integraation luominen ja sen kojelautailujen upottaminen sovellukseen näyttäisi. Hyvä uutinen on, kuten aiemmin mainittiin, että monet vaiheet, jotka sinun on suoritettava, voidaan tehdä Cumul.io-käyttöliittymässä.
Vastuuvapauslauseke: Tässä artikkelissa keskityn vain integrointiosaan. Joten jätän väliin kaiken, mikä liittyy kojelaudan luomiseen ja suunnitteluun, ja aloitamme esivalmistetuilla kuvitteellisilla kojelaudoilla.
Mitä aiomme tehdä:
Integraation luominen
Yksinkertaisuuden vuoksi luodaan toistaiseksi vain yksi integraatio. Kuvitellaan, että meillä on analytiikka-alusta, jota ylläpidämme yrityksellemme. Haluamme tarjota loppukäyttäjillemme kolme hallintapaneelia: Marketing Dashboard, Sales Dashboard ja Leads Dashboard.
Oletetaan, että kaikista hallintapaneeleista, jotka tämä tili on luonut tai joilla on käyttöoikeus, he haluavat käyttää tässä nimenomaisessa projektissa vain seuraavia:
Uusi integraatio
Luodaksesi integroinnin siirrymme Integraatiot-välilehteen ja valitse Uusi integrointi. Avautuva dialogi antaa jo jonkinlaisen käsityksen siitä, mitkä ovat seuraavat vaiheesi:
Hallintapaneelien valitseminen
Seuraavaksi voit valita, mitkä hallintapaneeleistasi sisällytetään tähän integraatioon. Voit myös antaa integraatiolle nimen, jonka tässä olen päättänyt olla "Very Important Integration":
Kun olet vahvistanut valintasi, voit määrittää kullekin kojelaudalle etanan (erittäin suositeltavaa). Niitä voidaan myöhemmin käyttää upottaessasi kojelaudat sovellukseesi. Myöhemmin huomaat, että slugien avulla on helppo viitata käyttöliittymäkoodissa oleviin koontipaneeleihin ja myös kojetaulujen vaihtaminen on helpompaa tarvittaessa (koska sinun ei tarvitse huolehtia käyttöliittymäkoodin kojelautatunnuksista).
Käyttöoikeudet
Tämän jälkeen pääset määrittämään integraation käyttöoikeudet tietojoukkoon, jota sen hallintapaneelit käyttävät. Tässä asetetaan tämä "Voi katsella". Lisätietoja käyttöoikeuksista ja niiden sisältämistä ominaisuuksista on meidän tietojoukkojen liittäminen integraatioihin:
Suodattimet ja parametrit (ja usean vuokralaisen käyttöoikeudet)
Sivuhuomautus: Helpottaakseen usean vuokraajan käyttöä – mikä olisi järkevää tässä kuvitteellisessa asetelmassa – Cumul.io mahdollistaa parametrien ja suodattimien asettamisen kojelaudan käyttämille tietojoukoille. Tämä tarkoittaa, että jokainen käyttäjä, joka kirjautuu analytiikka-alustaan, näkee kojelaudoissa vain ne tiedot, joihin heillä on henkilökohtaisesti pääsy. Voit kuvitella, että tässä skenaariossa käyttöoikeus perustuisi siihen, millä osastolla loppukäyttäjä työskentelee yrityksessä. Lisätietoja usean vuokrauksen määrittämisestä Cumul.io:lla on artikkelissamme, "Multi-Tenancy on Cumul.io Dashboards with Auth0". Tämä voidaan tehdä kojelaudan suunnitteluprosessissa (jonka ohitamme), mikä helpottaa suodattimien tekemisen visualisointia. Mutta tässä asetamme nämä suodattimet integroinnin luomisprosessissa.
Tässä asetamme suodattimet, joita tietojoukoissa mahdollisesti tarvitaan. Tässä skenaariossa, kun suodatamme käyttäjien osastojen perusteella, määrittelemme a department
parametri ja suodatin sen perusteella:
Ja voilà! Kun olet määrittänyt ne, olet luonut integraation onnistuneesti. Seuraava dialogi antaa sinulle ohjeet siitä, mitkä ovat seuraavat vaiheet integroinnin upottamiseksi:
Nyt voit nähdä tämän upouuden Integraation Integrointi-välilehdessä. Sieltä pääset myös nopeasti käsiksi integraatiotunnukseen, jota käytetään myöhemmin kojelaudoiden upottamiseen.
Hyviä uutisia! Kun integraatiosi on luotu, voit aina muokata sitä. Voit myös poistaa tai lisätä koontipaneeleja, muuttaa kojetaulujen osia tai käyttöoikeuksia. Sinun ei siis tarvitse huolehtia uusien integraatioiden luomisesta sovelluksesi muuttuessa ja kehittyessä. Ja koska integroinnin muokkaaminen tapahtuu käyttöliittymän sisällä, sinun ei tarvitse huolehtia siitä, että kehittäjä määrittää kaiken uudelleen. Ei-tekniset käyttäjät voivat mukauttaa näitä integraatioita liikkeellä ollessaan.
Hallintapaneelien upottaminen
Katsotaan mihin haluamme päästä. Haluamme tarjota kojelaudat mukautetussa sovelluksessa. Yksinkertainen, käyttäjä kirjautuu sovellukseen, sovelluksessa on kojelautat, he näkevät kojelaudat, joissa on heidän näkemyksensä. Se voisi näyttää esimerkiksi seuraavalta:
Jollakin oli hyvin tarkka näkemys siitä, kuinka he halusivat tarjota kojelaudat loppukäyttäjälle. He halusivat sivupalkin, jossa he voivat selata jokaisen kojelaudan läpi. Se olisi myös voinut olla jotain täysin erilaista. Keskitymme siihen, kuinka voimme upottaa nämä hallintapaneelit sovellukseemme riippumatta siitä, miltä isäntäsovellus näyttää.
Cumul.io sisältää joukon julkisesti saatavilla olevia SDK:ita. Tässä näytän sinulle, mitä tekisit, jos käyttäisit Node SDK. Tutustu kehittäjäasiakirjat nähdäksesi mitä muita SDK:ita on saatavilla, ja ohjeita niiden käyttöön.
Vaihe 1: Luo SSO-tunnukset loppukäyttäjillesi
Ennen kuin voit luoda SSO-tunnuksia loppukäyttäjillesi, sinun on varmistettava, että luot API-avaimen ja -tunnuksen Cumul.io-palvelussa. Voit tehdä tämän Cumul.io-profiilistasi. Organisaation omistajan, jolla on pääsy integraatioon, tulee luoda ja käyttää tämän API-avaimen ja tunnuksen SSO-valtuutuspyynnön tekemiseen. Kun olet tehnyt tämän, luodaan ensin Cumul.io-asiakas, joka tehdään sovelluksen palvelinpuolella:
const Cumulio = require("cumulio"); const client = new Cumulio({ api_key: '<YOUR API KEY>', api_token: '<YOUR API TOKEN>',
});
Nyt voimme luoda SSO-tunnuksen loppukäyttäjälle. Lisätietoja tästä API-kutsusta ja pakollisista kentistä löytyy meidän kehittäjädokumentaatio luomisesta SSO rahakkeita.
let promise = client.create('authorization', { integration_id: '<THE INTEGRATION ID>', type: 'sso', expiry: '24 hours', inactivity_interval: '10 minutes', username: '< A unique identifier for your end user >', name: '< end-user name >', email: '< end-user email >', suborganization: '< end-user suborganization >', role: 'viewer', metadata: {}
});
Tässä huomaa, kuinka olemme lisänneet valinnaisen metadata
ala. Täällä voit antaa parametrit ja arvot, joilla haluat suodattaa koontinäyttöjen tietojoukot. Esimerkissä, jota olemme käyneet läpi, olemme suodattaneet osaston perusteella, jotta lisäisimme tämän metatietoihin. Ihannetapauksessa saat nämä tiedot käyttämältäsi todennuspalveluntarjoajalta. Katso a yksityiskohtaisen selvityksen siitä, kuinka olemme tehneet tämän Auth0:n kanssa.
Tämä pyyntö palauttaa JSON-objektin, joka sisältää valtuutustunnuksen ja tunnuksen, jota käytetään myöhemmin avaimen/tunnisteen yhdistelmänä koontinäyttöjen upottamiseen asiakaspuolelle.
Jotain muuta, jonka voit valinnaisesti lisätä tähän, mikä on melko siistiä, on CSS-ominaisuus. Näin voit määrittää mukautetun ulkoasun jokaiselle käyttäjälle (tai käyttäjäryhmälle). Saman sovelluksen osalta Angelina vs Brad Marketing Dashboard voisi näyttää tältä:
Vaihe 2: Upota
Hyppäsimme siellä hieman eteenpäin. Loimme SSO-tunnuksia loppukäyttäjille, mutta emme ole vielä upottaneet kojetauluja sovellukseen. Katsotaanpa sitä. Ensin sinun tulee asentaa ja tuoda Web-komponentti.
import '@cumul.io/cumulio-dashboard';
Kun komponentti on tuotu, voit käyttää sitä ikään kuin se olisi HTML-tunniste. Tässä voit upottaa hallintapaneelisi:
<cumulio-dashboard dashboardId="< a dashboard id >" dashboardSlug="< a dashboard slug >" authKey="< SSO key from step 1 >" authToken="< SSO token from step 1 >">
</cumulio-dashboard>
Tässä on muutamia vaihtoehtoja. Voit joko antaa kojelaudan tunnuksen mille tahansa kojelaudalle, jonka haluat upottaa, tai voit antaa kojelaudan tunnuksen, jonka määritimme integrointiasetuksissa (siksi suosittelen tätä, se on paljon helpompaa tehdä se tällä tavalla). Tarkempia tietoja kojetaulujen upottamisesta saat myös meidän sivuiltamme kehittäjän dokumentaatio.
Mukava tapa tehdä tämä vaihe on tietysti vain määrittää hallintapaneelikomponentin runko HTML-tiedostossasi ja täyttää loput siitä sovelluksesi asiakaspuolelta. Olen tehnyt seuraavaa, vaikka se ei tietenkään ole ainoa tapa:
Olen lisännyt kojelautakomponentin tunnuksella dashboard
:
<cumulio-dashboard id="dashboard"></cumulio-dashboard>
Sitten olen hakenut tämän komponentin asiakaskoodista seuraavasti:
const dashboardElement = document.getElementById("dashboard");
Sitten pyydän SSO-tunnusta sovellukseni palvelinpuolelta, joka palauttaa vaaditun avaimen ja tunnuksen lisättäväksi kojelautakomponenttiin. Oletetaan, että meillä on kääretoiminto getDashboardAuthorizationToken()
joka tekee tämän puolestamme ja palauttaa vastauksen palvelinpuolen SSO-tunnuspyynnöstä. Seuraavaksi yksinkertaisesti täytämme kojelautakomponentin vastaavasti:
const authorizationToken = await getDashboardAuthorizationToken();
if (authorizationToken.id && authorizationToken.token) { dashboardElement.authToken = authorizationToken.token; dashboardElement.authKey = authorizationToken.id; dashboardElement.dashboardSlug = "marketing|sales|leads";
}
Huomaa, kuinka aiemmissa vaiheissa päätin määrittää kojelaudoilleni etanat, jotka ovat osa tätä integraatiota. Tämä tarkoittaa, että voin välttää kojelaudan tunnusten etsimisen ja lisäämisen dashboardId
yhtenä parametreistani dashboardElement
. Sen sijaan voin tarjota yhden etanoista marketing
, sales
or leads
ja olen valmis! Tietenkin sinun on määritettävä hakemuksellesi jonkinlainen valintaprosessi päättääksesi, mihin ja milloin upotat minkä tahansa kojelaudan.
Siinä se ihmiset! Olemme luoneet onnistuneesti integraation Cumul.io-palveluun, ja muutamalla koodirivillä olemme voineet upottaa sen hallintapaneelit sovellukseemme 🎉 Kuvittele nyt tilanne, jossa sinun on ylläpidettävä useita sovelluksia kerralla joko sama yritys tai erillinen yritys. Riippumatta skenaariostasi, olen varma, että voit kuvitella, kuinka jos sinulla on useita hallintapaneeleja, joissa jokaisen on mentävä eri paikkoihin ja jokaisella niistä on oltava erilaiset käyttöoikeudet riippuen siitä, missä he ovat ja missä mennään. .. Kuinka se voi nopeasti riistäytyä käsistä. Integraatioiden avulla voit hallita tätä yksinkertaisesti ja siististi, kaikki yhdessä paikassa, ja kuten näet, enimmäkseen Cumul.io-käyttöliittymästä.
Täällä voit tehdä paljon muutakin, mitä emme ole käyneet läpi yksityiskohtaisesti. Kuten käyttäjäkohtaisten mukautettujen teemojen ja CSS:n lisääminen. Emme myöskään käyneet läpi, kuinka parametrit ja suodattimet asetetaan kojelaudoissa tai miten niitä käytetään isäntäsovelluksessasi, jotta sinulla on usean vuokraajan asetukset. Alta löydät linkkejä hyödyllisiin opetusohjelmiin ja dokumentaatioon näitä vaiheita varten, jos olet kiinnostunut.
Lähde: https://css-tricks.com/embedded-analytics-made-simple-with-cumul-io-integrations/
- '
- "
- &
- 11
- 7
- 9
- 98
- pääsy
- Tili
- Toiminta
- Kaikki
- Analytics
- api
- sovelluksen
- Hakemus
- sovellukset
- artikkeli
- Authentication
- lupa
- Bitti
- branding
- rakentaja
- liiketoiminta
- soittaa
- muuttaa
- koodi
- Yhteinen
- yhteisöjen
- yritys
- komponentti
- Luominen
- kojelauta
- tiedot
- Malli
- yksityiskohta
- Kehittäjä
- kehittäjille
- epäsopu
- päättyy
- Kasvot
- Fields
- suodattimet
- Etunimi
- Keskittää
- muoto
- toiminto
- hyvä
- Ryhmä
- tätä
- Miten
- Miten
- HTTPS
- Ihmiset
- ajatus
- tuovan
- tiedot
- tiedot
- oivalluksia
- integraatio
- integraatiot
- IT
- JavaScript
- avain
- Lista
- Marketing
- nimet
- Siisti
- uutiset
- Vaihtoehto
- Vaihtoehdot
- organisaatio
- Muut
- omistaja
- foorumi
- valmistettu
- Profiili
- projekti
- hankkeet
- omaisuus
- vastaus
- REST
- Tuotto
- SaaS
- myynti
- tunne
- setti
- asetus
- Yksinkertainen
- So
- SOLVE
- Sponsored
- maailma
- teema
- aika
- symbolinen
- tokens
- opetusohjelmat
- viserrys
- ui
- us
- Käyttäjät
- Näytä
- visio
- KUKA
- sisällä
- sanoja
- Referenssit
- toimii
- maailman-