Sirvige SaaS-i kogukondi Twitteris, LinkedInis, Redditis, Discordis, pange sellele nimi ja näete, et paljudes neist ilmub ühine teema. Sellel teemal võib olla mitu nime: BI, analüütika, ülevaated ja nii edasi. See on loomulik, me teeme äri, kogume andmeid, õnnestub või ebaõnnestub. Tahame seda kõike uurida, oma andmeid mõista ja tegutseda. See vajadus on loonud palju projekte ja tööriistu, mis muudavad kõigi andmetega tutvumise soovijate elu veidi lihtsamaks. Aga kui inimestel on, tahavad inimesed enamat. Ja BI ja analüütika maailmas tuleb "rohkem" sageli manustamise, kaubamärgi loomise, kohandatud stiili ja juurdepääsu kujul jne. See tähendab, et arendajatele on rohkem tööd ja rohkem aega arveldamiseks. Seega on loomulikult olnud vajadus BI-tööriistade järele, mis võimaldavad teil seda kõike kasutada.
Teeme nimekirja väljakutsetest, millega võite nende armatuurlaudade koostajana ja hooldajana kokku puutuda.
- Soovite teha armatuurlauad lõppkasutajatele või vaatajatele kättesaadavaks oma rakenduses või platvormis
- Soovite hallata erinevaid armatuurlaua kogusid (st "integratsioone")
- Soovite anda konkreetseid kasutajaõigusi armatuurlaudade ja andmekogumite kogumile
- Soovite tagada, et kasutajatel oleks juurdepääs ainult nende jaoks olulistele andmetele
Cumul.io pakub tööriista, mida me nimetame Integrations mis aitab neid väljakutseid lahendada. Selles artiklis räägin teile, mis on integratsioonid ja kuidas seda seadistada. Lahe on see, et enamiku ülaltoodud punktide jaoks on nõutav minimaalne kood ja enamasti saab selle seadistada Cumul.io UI
Teatud taust — integratsioonid
An Integratsioon Cumul.io on struktuur, mis määratleb armatuurlaudade kogumi, mis on mõeldud koos kasutamiseks (nt samas rakenduses). See on ka see, mida me kasutame Embed armatuurlauad rakendusse. Teisisõnu, armatuurlaudade rakendusse manustamiseks anname rakendusele juurdepääsu integratsioonile, millesse need kuuluvad. Saate siduda armatuurlauad integratsiooniga ja hallata, mis tüüpi juurdepääsuõigused on integratsiooni lõppkasutajatel nendel armatuurlaudadel ja nende kasutatavatel andmekogudel. Armatuurlaud võib olla osa mitmest integratsioonist, kuid sellel võivad erinevate integratsioonide puhul olla erinevad juurdepääsuõigused. Manustamisel on saadaval mitmeid SDK-sid, mis muudavad elu lihtsaks, hoolimata sellest, milline teie virn välja näeb. 😊
Kui teil on Cumul.io konto ja olete Cumul.io organisatsiooni "omanik", saate kõiki oma integratsioone hallata ja hooldada vahekaardi Integratsioonid kaudu. Vaatame Cumul.io konto näidet. Allpool näete juhtpaneele, mille üks Cumul.io kasutaja võis luua:
Kuigi need on kõik armatuurlauad, mille see kasutaja võib olla loonud, ei ole tõenäoline, et kõik armatuurlauad pole mõeldud samadele lõppkasutajatele või samadele rakendustele. Niisiis, selle Cumul.io konto omanik loob ja haldab integratsiooni (või rohkemgi!) 💪 Vaatame, kuidas see tema jaoks välja näha võiks:
Seega näib, et selle Cumul.io konto omanik haldab kahte eraldi rakendust.
Nüüd vaatame, kuidas näeks välja integratsiooni loomise ja selle armatuurlaudade rakendusse manustamise protsess. Hea uudis on see, nagu varem mainitud, palju samme, mida peate tegema, saab teha Cumul.io kasutajaliideses.
Kohustustest loobumine: selle artikli jaoks keskendun ainult integratsiooni osale. Seega jätan vahele kõik, mis on seotud armatuurlaua loomise ja kujundamisega, ning alustame ette valmistatud kujuteldavate armatuurlaudade komplektiga.
Mida me tegema hakkame:
Integratsiooni loomine
Lihtsuse huvides loome praegu ainult ühe integratsiooni. Kujutagem ette, et meil on analüüsiplatvorm, mida oma ettevõtte jaoks hooldame. Soovime oma lõppkasutajatele pakkuda kolme armatuurlauda: turunduse armatuurlaud, müügi juhtpaneel ja müügivihjete armatuurlaud.
Oletame, et kõigist armatuurlaudadest, mille see konto on loonud või millel on juurdepääs, soovivad nad selle konkreetse projekti jaoks kasutada ainult järgmist.
uus Integratsiooni
Integratsiooni loomiseks läheme vahekaardile Integratsioonid ja valime Uus integratsioon. Avanev dialoog annab teile juba aimu, millised on teie järgmised sammud:
Armatuurlaudade valimine
Järgmisena saate valida, millised teie armatuurlauad sellesse integratsiooni kaasatakse. Samuti saate anda integratsioonile nime, milleks olen siinkohal otsustanud, et see on "Väga oluline integratsioon":
Kui olete oma valiku kinnitanud, on teil võimalus määrata iga armatuurlaua jaoks nälkjas (väga soovitatav). Neid saab hiljem kasutada armatuurlaudade oma rakendusse manustamisel. Hiljem näete, et nälkjad muudavad teie kasutajaliidese koodis armatuurlaudadele viitamise lihtsaks ja hõlbustavad vajadusel ka armatuurlaudade asendamist (kuna te ei pea muretsema armatuurlaua ID-de pärast esiosa koodis).
Juurdepääsuõigused
Seejärel saate määrata integratsiooni juurdepääsuõigused andmekogumitele, mida selle armatuurlauad kasutavad. Siin määrame selle väärtuseks "Saab vaadata". Lisateavet juurdepääsuõiguste ja nendega kaasnevate kohta leiate meie veebisaidilt andmekogumite seostamine integratsioonidega:
Filtrid ja parameetrid (ja mitme rentniku juurdepääs)
Külgmärkus. Mitme rentniku juurdepääsu hõlbustamiseks – mis oleks selles kujuteldavas seadistuses mõistlik – võimaldab Cumul.io määrata armatuurlaua kasutatavate andmehulkade parameetreid ja filtreid. See tähendab, et iga kasutaja, kes logib sisse teie analüüsiplatvormile, näeb armatuurlaudadel ainult neid andmeid, millele tal isiklikult on juurdepääs. Võite ette kujutada, et selle stsenaariumi korral põhineb juurdepääs sellel, millises osakonnas lõppkasutaja ettevõttes töötab. Lisateavet selle kohta, kuidas Cumul.io abil mitme üürilepingu seadistada, leiate meie artiklist, "Multi-üürimine Cumul.io armatuurlaudadel koos Auth0-ga". Seda saab teha armatuurlaua kujundamise protsessis (mille me vahele jätame), mis muudab filtrite tegevuse visualiseerimise lihtsamaks. Kuid siin seadistame need filtrid integratsiooni loomise protsessis.
Siin määrame filtrid, mida andmekogudel võib vaja minna. Selle stsenaariumi korral määratleme kasutajate osakondade alusel filtreerides a department
parameeter ja filter selle alusel:
Ja voilà! Kui olete nende seadistamise lõpetanud, olete integratsiooni edukalt loonud. Järgmises dialoogis antakse juhiseid selle kohta, millised on teie järgmised sammud integratsiooni manustamiseks.
Nüüd näete seda uhiuut integratsiooni vahekaardil Integratsioon. Siin on ka kiire juurdepääs integratsiooni ID-le, mida hiljem kasutatakse armatuurlaudade manustamiseks.
Head uudised! Pärast integratsiooni loomist saate seda alati muuta. Saate eemaldada või lisada armatuurlaudu, muuta armatuurlaudade näpunäiteid või juurdepääsuõigusi. Seega ei pea te muretsema uute integratsioonide loomise pärast, kui teie rakendus muutub ja areneb. Ja kuna integratsiooni redigeerimine toimub kasutajaliideses, ei pea te muretsema selle pärast, et arendaja peaks selle kõik uuesti seadistama. Mittetehnilised kasutajad saavad neid integratsioone liikvel olles kohandada.
Armatuurlaudade manustamine
Vaatame, kuhu tahame jõuda. Soovime pakkuda armatuurlaudu kohandatud rakenduses. Lihtne, kasutaja logib rakendusse sisse, rakendusel on armatuurlauad, nad näevad armatuurlaudu nende andmetega, mida neil on lubatud näha. See võib välja näha näiteks järgmine:
Kellelgi oli väga konkreetne nägemus selle kohta, kuidas ta soovis armatuurlaudu lõppkasutajale pakkuda. Nad tahtsid külgriba, kus nad saaksid iga armatuurlauda läbi sirvida. See oleks võinud olla ka midagi täiesti erinevat. Keskendume sellele, kuidas saame need armatuurlauad oma rakendusse manustada, hoolimata sellest, milline hostrakendus välja näeb.
Cumul.io on varustatud avalikult saadaolevate SDK-de komplektiga. Siin näitan teile, mida teeksite, kui kasutaksite Sõlme SDK. Tutvu meie arendajadokumendid et näha, millised teised SDK-d on saadaval, ja juhiseid nende kasutamiseks.
1. samm: looge oma lõppkasutajatele SSO-märgid
Enne kui saate oma lõppkasutajatele SSO-märke genereerida, peate veenduma, et loote rakenduses Cumul.io API-võtme ja märgi. Seda saate teha oma Cumul.io profiili kaudu. Selle API võtme ja loa loob ja kasutab SSO autoriseerimistaotluse tegemiseks organisatsiooni omanik, kellel on juurdepääs integratsioonile. Kui olete selle teinud, looge esmalt Cumul.io klient, mida tehakse rakenduse serveri poolel:
const Cumulio = require("cumulio"); const client = new Cumulio({ api_key: '<YOUR API KEY>', api_token: '<YOUR API TOKEN>',
});
Nüüd saame luua lõppkasutajale SSO-märgi. Lisateabe saamiseks selle API kõne ja kohustuslike väljade kohta vaadake meie arendaja dokumentatsioon genereerimise kohta SSO märkide.
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: {}
});
Siin pange tähele, kuidas oleme lisanud valikulise metadata
valdkonnas. Siin saate sisestada parameetrid ja väärtused, mille alusel soovite armatuurlaudade andmekogumeid filtreerida. Läbivaadatud näites oleme filtreerinud osakonna alusel, nii et lisaksime selle metaandmetesse. Ideaalis saaksite selle teabe teie kasutatavalt autentimisteenuse pakkujalt. Vaata a üksikasjalik selgitus selle kohta, kuidas oleme seda Auth0-ga teinud.
See päring tagastab JSON-objekti, mis sisaldab volituse ID-d ja luba, mida hiljem kasutatakse võtme/märgi kombinatsioonina kliendipoolsete armatuurlaudade manustamiseks.
Midagi muud, mida saate valikuliselt siia lisada, mis on päris lahe, on CSS-i omadus. See võimaldab teil määratleda iga kasutaja (või kasutajarühma) kohandatud välimuse ja tunde. Sama rakenduse puhul võiks Angelina vs Bradi turunduse juhtpaneel välja näha selline:
2. samm: manustamine
Hüppasime seal natuke ette. Lõime lõppkasutajatele SSO-märgid, kuid me pole armatuurlaudu veel rakendusse manustanud. Vaatame seda. Kõigepealt peaksite installima ja importima Veebikomponent.
import '@cumul.io/cumulio-dashboard';
Pärast komponendi importimist saate seda kasutada nagu HTML-märgendit. Siia saate oma armatuurlauad manustada:
<cumulio-dashboard dashboardId="< a dashboard id >" dashboardSlug="< a dashboard slug >" authKey="< SSO key from step 1 >" authToken="< SSO token from step 1 >">
</cumulio-dashboard>
Siin on mõned valikud. Saate anda armatuurlaua ID igale armatuurlauale, mida soovite manustada, või armatuurlaua ID, mille me määratlesime integratsiooni seadistuses (sellepärast soovitan seda tungivalt, nii on see palju loetavam). Täpsemat teavet armatuurlaudade manustamise kohta leiate ka meie lehelt arendaja dokumentatsioon.
Kena viis selle sammu tegemiseks on loomulikult lihtsalt HTML-failis armatuurlaua komponendi skeleti määratlemine ja ülejäänud osa täitmine rakenduse kliendi poolelt. Olen teinud järgmist, kuigi see pole muidugi ainus viis:
Lisasin armatuurlaua komponendi koos ID-ga dashboard
:
<cumulio-dashboard id="dashboard"></cumulio-dashboard>
Seejärel leidsin selle komponendi kliendikoodist järgmiselt:
const dashboardElement = document.getElementById("dashboard");
Seejärel taotlen oma rakenduse serveripoolselt SSO-luba, mis tagastab armatuurlaua komponendile lisamiseks vajaliku võtme ja loa. Oletame, et meil on ümbrisfunktsioon getDashboardAuthorizationToken()
mis teeb seda meie eest ja tagastab serveripoolse SSO loa päringu vastuse. Järgmisena täidame lihtsalt armatuurlaua komponendi vastavalt:
const authorizationToken = await getDashboardAuthorizationToken();
if (authorizationToken.id && authorizationToken.token) { dashboardElement.authToken = authorizationToken.token; dashboardElement.authKey = authorizationToken.id; dashboardElement.dashboardSlug = "marketing|sales|leads";
}
Pange tähele, kuidas ma eelmistes sammudes otsustasin määratleda oma armatuurlaudade jaoks nälkjad, mis on selle integratsiooni osa. See tähendab, et saan vältida armatuurlaua ID-de otsimist ja lisamist dashboardId
kui üks minu parameetritest dashboardElement
. Selle asemel võin pakkuda ühe nälkjatest marketing
, sales
or leads
ja ma olen valmis! Loomulikult peaksite oma rakenduse jaoks seadistama mingi valikuprotsessi, et otsustada, kuhu ja millal millise juhtpaneeli manustada.
See on kõik, inimesed! Oleme Cumul.io-s edukalt integratsiooni loonud ja mõne koodireaga oleme suutnud selle armatuurlauad meie rakendusse manustada 🎉 Kujutage nüüd ette stsenaariumi, kus peate korraga hooldama mitut rakendust, kas sama ettevõte või eraldi. Olenemata teie stsenaariumist, võite kindlasti ette kujutada, kuidas kui teil on mitu armatuurlauda, kus igaüks neist peab minema erinevatesse kohtadesse ja igal neist peavad olema erinevad juurdepääsuõigused olenevalt sellest, kus nad asuvad ja kus me liigume. .. Kuidas see võib kiiresti käest ära minna. Integratsioonid võimaldavad teil seda hallata lihtsal ja kenal viisil ühes kohas ja nagu näete, enamasti Cumul.io kasutajaliideses.
Siin saate teha palju muud, mida me pole üksikasjalikult käsitlenud. Näiteks kasutajapõhiste kohandatud teemade ja CSS-i lisamine. Samuti ei uurinud me, kuidas saate armatuurlaual parameetreid ja filtreid määrata või kuidas neid hostirakenduses kasutada, et teil oleks mitme rentniku seadistus. Altpoolt leiate mõned lingid kasulikele õpetustele ja nende toimingute dokumentatsioonile, kui olete huvitatud.
Allikas: https://css-tricks.com/embedded-analytics-made-simple-with-cumul-io-integrations/
- '
- "
- &
- 11
- 7
- 9
- 98
- juurdepääs
- konto
- tegevus
- Materjal: BPA ja flataatide vaba plastik
- analytics
- API
- app
- taotlus
- rakendused
- artikkel
- Autentimine
- luba
- Natuke
- branding
- ehitaja
- äri
- helistama
- muutma
- kood
- ühine
- Ühenduste
- ettevõte
- komponent
- loomine
- armatuurlaud
- andmed
- Disain
- detail
- arendaja
- Arendajad
- ebakõla
- lõppeb
- nägu
- Valdkonnad
- Filtrid
- esimene
- Keskenduma
- vorm
- funktsioon
- hea
- Grupp
- siin
- Kuidas
- Kuidas
- HTTPS
- Inimestel
- idee
- importivate
- info
- info
- teadmisi
- integratsioon
- integratsioon
- IT
- JavaScript
- Võti
- nimekiri
- Turundus
- nimed
- puhas
- uudised
- valik
- Valikud
- organisatsioon
- Muu
- omanik
- inimesele
- Toodetud
- profiil
- projekt
- projektid
- kinnisvara
- vastus
- REST
- Tulu
- SaaS
- müük
- tunne
- komplekt
- kehtestamine
- lihtne
- So
- LAHENDAGE
- Sponsorite
- maailm
- teema
- aeg
- sümboolne
- märgid
- õpetused
- puperdama
- ui
- us
- Kasutajad
- vaade
- nägemus
- WHO
- jooksul
- sõnad
- Töö
- töötab
- maailm