Welke informatie er kan worden opgehaald is te vinden op:
https://uwaccountnaam.clockwise.info/api/v2/doc#reports
Er is een endpoint voor:
- geschreven uren
- koppelingen
- projecten
- medewerkers
Aan een enpoint kunnen een aantal paramaters worden meegegeven om de informatie te filteren.
Bijvoorbeeld:
start (startdatum voor het ophalen van de uren)
organisationid – id van afdeling of medewerker
structureid – id van klant(groep) of project
export_ch1_id – om alleen geexporteerde uren op te halen ( bijvoorbeeld uren die al verloond zijn)
En er is in te stellen welke velden er moeten worden opgehaald. Dit kan door los de veldnamen te op
te geven of door de kopjes van de velden te nomen.
Standaard wordt alleen het id veld teruggegeven.
Er moet verplicht een limit worden meegegeven. Deze kan worden gezet op 10000 (tienduizend) Als er geen limit wordt meegegeven worden er standaard 10 resultaten getoond.
Een voorbeeld endpoint zou zijn:
https://uwaccountnaam.clockwise.info/api/v2/report/flat/hours?fields=defaultfields,projectfields,salesfields&limit=10000
Om de gegevens te kunnen ophalen moet er een gebruiker zijn met rechten de gegevens in te zien.
Maak in uw ClockWise account een medewerker aan met deze rechten.
Dit is de medewerker waarmee u met Basic authentication kunt inloggen vanuit PowerBi of Qlik en verbinding kunt leggen naar ClockWise. Deze medewerker moet in ClockWise toegang hebben tot de rapportage Uren.
Voorbeeld Qlik
Open de Qlik app en klik op Create new sheet
Geef de sheet een naam en klik op de sheet om de sheet te editen
In het menu om de sheet te wijzigen staan opties.
Voor het ophalen van de gegevens en het maken van de connectie met de ClockWise data klik op het pijltje rechts van Data manager.
Kies data Load editor. Het editing menu om data in te laden verschijnt.
In het linker gedeelte kunnen kunnen secties worden aangemaakt om het gegenereerde script in te delen of om zelf scripts in te maken.
In het voorbeeld maken we een data Connectie voor hours en resources.
Daarvoor maken we eerst een sectie Hours aan. Klik op het + teken en geef de sectie de naam Hours.
Klik daarna op Create new connection in het rechtemenu.
Kies REST in de lijst. Er verschijnt een pop-up waar u de gegevens van het endpoint kunt invullen.
Scroll naar beneden en vul bij Authentication Schema Basic in met de gegevens van de data user
Scroll naar Additional request parameters
Scroll naar Query headers
Scroll naar Pagination om ervoor te zorgen dat de data gepagineerd per 10000 wordt opgehaald. De instellingen zijn als volgt:
klik Test connection en save
de connectie is opgeslagen en staat in het rechtermenu
Klik load data boven Data Connection om de data in te laden. Als alles goed gaat wordt de melding App saved Finished succesfully teruggegeven.
Als je de gegevens in deze app wilt laden moet het inladen vanuit het script worden aangeroepen.
Voeg in het linkermenu een tab hours toe.
Dit script kun je automatisch laten genereren door in het data connectie menu naar de connectie te gaan en te klikken op select data. (het middelste icoon)
Vink root aan om de data in te laden. De data wordt zichtbaar in een tabel.
Onder de tabel staat het script wat er voor zorgt dat de data wordt ingeladen.
Klik op Insert script om het script aan te maken.
Klik je in het linkermenu op Hours dan zie je het script en de velden die opgehaald zijn.
Stel dat je kolom namen wilt wijzigen dan kan dat direct in het script maar ook weer via de “select data “ knop bij de connectie.
Stel je wilt de kolom data veranderen in datum ( zie onderstaand)
Dan staat er in het script [date] AS [datum],
Klik op de data Load editor en kies Data manager
Klik op Run load script.
En vervolgens op Synchronise scripted tables. De hours table wordt ingeladen
Hierna is een auto generated script ontstaan. Dit is te zien in de Data load editor
Als er een REST connectie moet worden toegevoegd , vanauit de app moet daar toegang toe zijn. Ze moeten dan iedere keer met een script worden toegevoegd.
Als u wijzigingen maakt in het script en er is een auto generated file dan moet de autogenerated file opnieuw worden gedefinieerd.
Door naar Run Load script via de dat manager te gaan en synchronise script te doen.