Integration af tredjepartsdata til GoBright View
GoBright View kan vise data eller information fra eksterne kilder. Til dette kan der udvikles tilpassede integrationer. Hvis du er interesseret, bedes du læse denne artikel omhyggeligt.
Sådan fungerer det
I GoBright View vises alt indhold ved hjælp af widgets. Widgets med dynamiske (eksterne) data modtager data fra en datakilde. Tilpassede integrationer kan udvikles af GoBright for at vise data fra eksterne kilder i GoBright View.
Datakilde
Datakilden henter dataene fra en ekstern kilde, formaterer dem, håndterer caching og leverer derefter dataene til widgetten, så den kan bruge dem. En datakilde er skrevet i JavaScript.
En datakilde kan have en eller flere widgets tilknyttet.
Datakilden henter som standard data hvert 5. minut ved at hente dem fra en ekstern API.
Datakilden er knyttet til en widget, og widgeten er knyttet til et dias. Diaset vises på en skærm ved receptionen.
Hver spiller/skærm indhenter og gemmer dataene selv via datakilden.
Widget
Widget'en visualiserer data. En widget består af tre elementer: HTML, CSS og JavaScript. HTML er altid påkrævet, men både CSS og JavaScript er valgfrie.
En widget kan have ingen eller én datakilde tildelt, men aldrig mere end én.
Eksempler:
- En vejrdatakilde kan have flere widgets knyttet til sig. En widget, der viser den aktuelle temperatur, og en anden widget, der viser vejrudsigten for de kommende dage.
- En tabelwidget med et bestemt design kan knyttes til en datakilde, og en anden tabelwidget med et andet design kan også knyttes til den samme datakilde og vise de samme data på en anden måde.
- En QR-kode-widget er et eksempel på en widget uden en datakilde, der er knyttet til den. Al den nødvendige logik udføres i widgetten, og der kræves ingen eksterne data.
Når GoBright udvikler en brugerdefineret integration med eksterne data, oprettes der mindst en datakilde og en widget, da dette er inkluderet i artikelnummeret 'GB-VIEW-EXTAPIQUERY-GENERAL'. Afhængigt af sagen kræves der flere datakilder og/eller widgets for at opfylde kundens krav. Separate widgets kan bestilles ved hjælp af artikelnr. 'GB-VIEW-EXTAPIQUERY-WIDGET'.
En almindelig ting med brugerdefinerede integrationer er et dashboard til at præsentere data. I mange tilfælde består dette dashboard af flere widgets. I GoBright View oprettes en skabelon, der indeholder disse widgets.
Den nøjagtige mængde datakilder og widgets, der kræves til et dashboard, afhænger helt af sagen.
Krav til udvikling af en tilpasset integration
Data
Når GoBright udvikle en widget og en datakilde til en kunde, fordi dataene skal visualiseres i GoBright , GoBright adgang til rådataene.
I de fleste tilfælde stammer disse data fra et eksternt API, og GoBright kendskab til den eksterne datastruktur.
Dataene skal derfor leveres af kunden eller den tredjepart, vi skal integrere med. GoBright , at disse data er strukturerede, og at leveringen er pålidelig. Dataene kan leveres via et API i JSON- eller XML-format.
- Der skal også leveres en komplet API-dokumentation .
- Der skal være en teknisk kontaktperson til rådighed (helst en produktansvarlig hos den tredjepart, vi skal integrere med), som kan hjælpe os med at forstå de delte data og den delte dokumentation samt besvare andre spørgsmål i forbindelse med denne implementering, der vedrører tredjepartens implementering.
Så er det tid til at fastlægge kravene. Skal dataene filtreres og/eller sorteres på en eller anden måde?
Det er naturligvis kun data, der kan hentes fra API'en, der kan vises. Kontakt din API-udbyder for at få flere oplysninger.
Bemærk: GoBright gemmer ikke data i længere perioder. Eventuelle nødvendige historiske data skal hentes via API'en, hver gang vi indhenter data fra API'en.
Design
Kunden leverer en skitse/tegning af den ønskede præsentation af data. Dette viser, hvordan dataene skal præsenteres på de digitale skærme ved hjælp af Widgets. Som tidligere nævnt er det kun data, der kan hentes fra API'en, der kan vises.
Det er også nødvendigt at få en skriftlig beskrivelse af de parametre, der kan tilpasses, og som kan gøre widgeten lidt mere fleksibel.
I en visning af et skema for en skole vil man for eksempel måske have en parameter, der viser data for »elever« eller for »lærere«. Dette kan indstilles via en rullemenu. Afhængigt af denne indstilling kan præsentationen af dataene ændre sig en smule.
Bestil
Først når en ordre er modtaget af GoBright , og de øvrige krav (se nedenfor) er opfyldt, kan GoBright begynde at udvikle den tilpassede integration.
I bestillingen kræves mindst ét artikelnummer 'GB-VIEW-EXTAPIQUERY-GENERAL'. Denne artikel indeholder en datakilde og en widget. Hvis der er behov for flere datakilder og/eller widgets, skal de tilføjes til ordren. Artikelnummeret for en separat widget er 'GB-VIEW-EXTAPIQUERY-WIDGET'.
Kontakt din GoBright for mere information.
Tidslinje
Fra det øjeblik, hvor fase 2 (se nedenfor) er færdiggjort, og GoBright har godkendt, at alle nødvendige oplysninger foreligger, er den anslåede udviklingstid ca. 8 uger.
Fase 1: Modtagelse af PO og indsamlede data
Fase 2: Planlægning og kontrol af leverede data og anmodninger
Fase 3: Design af widget (som et billede i jpg- eller png-format)
Fase 4: Udvikling af datakilder
Fase 5: Udvikling af widgets
Fase 6: Intern testning
Fase 7: Test i kundens miljø
Fase 8: Endelig levering
Opdatering af widget og datakilde efter levering
Vær opmærksom på, at widgeten og datakilden er udviklet i JavaScript, HTML og CSS. Med de rette udviklingsfærdigheder bør I selv kunne ændre widgeten og datakilden.
GoBright kan GoBright klare dette for dig. Du kan via din GoBright anmode om et tilbud på dette ekstra arbejde.
Se nogle af de brugerdefinerede widgets, vi tidligere har udviklet: Brugerdefinerede widgets