Forklaring af rapportformat

Tænd rapportmodulet, og udfyld e-mail(e) i felt 1 «E-mail til modtagelse af rapporter». Du kan indtaste flere e-mails adskilt af kommaer, hvis du ønsker det.

Ændringer fra den forrige version

Dette er den første version, så alt er nyt. Version 1 har 24 eksportkolonner.

Senere versioner vil have nye felter tilføjet til sidst, kolonnerne kommer altid i samme rækkefølge og har identiske overskrifter. Alle hændelsestyper vil beholde de samme navne. Det betyder, at nyere versioner vil være bagudkompatible, og at funktioner skrevet til at læse version 1 også vil fungere med nyere versioner.

ERRATA/rettelser til selve dette dokument, der beskriver version 1:

1. Ingen endnu.

Sender

Rapporterne sendes for alle virksomheder kl. 08:00 hver mandag «Oslo-tid». Hvis noget skulle gå galt, og vi er nødt til at rette rapportfunktionen, vil den næste rapport indeholde hændelser fra det tidspunkt, den forrige rapport blev sendt. Det betyder, at du normalt vil Få ugentlige rapporter med, hvad der er sket fra mandag til mandag kl. 08:00. Det er stort set det. Afhængigt af serverbelastningen kan rapporteringen starte lidt før eller efter kl. 08:00:00.

Første gang du aktiverer rapportmodulet, får du automatisk en rapport fra de sidste 2 uger. Du kan kontakte os, hvis du ønsker en rapport fra et andet tidspunkt.

Åbner

CSV-filer er bare almindelig tekst, og du kan f.eks. åbne dem med et regneark.

Tidsgrænse

Vi kan ikke levere logs fra før 1. januar 1970 kl. 00:00:00 UTC og heller ikke fra fremtiden (burde fungere fint for alle vores kunder). År 2038-problemet er blevet løst. Vi vil have en udstedes ved årsskiftet 9999/10000 CE, men vil opdatere appen i god tid.

Datakilder

De fleste felter i loggen gemmes «som de var på det tidspunkt». For eksempel viser loggen værktøjsnavne, som de var på det tidspunkt, hvor hændelsen fandt sted. Derfor kan det samme værktøj kaldes forskellige ting nede i loggen.

Nogle felter hentes på eksporttidspunktet, og værdien kan derfor have været anderledes på tidspunktet for hændelsen:

1. Medarbejderantal
2. Lejepris

Dette er typisk felter, der ikke opdateres særlig ofte, men hvis du har ændret dem i løbet af ugen, vil værdien på eksporttidspunktet (som stort set er mandag kl. 08:00) blive vist.

Nogle felter beregnes på eksporttidspunktet, såsom datofelter, «dage/timer/minutter/sekunder ude» og antal på lager. Dette kunne have været gjort med simple formler i regneark, men nu har vi gjort det for dig 🙂

Eksempelfil

- som viser alle hændelsestyperne og nogle værdier for hver af dem. Der er også en kort forklaring i selve filen, se detaljer nedenfor her.

Nødvendige indstillinger

For at eksporten skal fungere, skal du:

1. markere afkrydsningsfeltet for «Rapport» under Virksomhedsindstillinger
2. udfylde «E-mail til at modtage rapporter» under Virksomhedsindstillinger

- du kan indtaste flere e-mailadresser adskilt med komma, hvis du vil sende til flere.

Format

Robotten sender en e-mail til adressen(e) angivet i feltet «E-mailadresse til eksport» under Virksomhedsindstillinger.

E-mailen indeholder lidt tekst og 1 vedhæftet CSV-fil. Der vil altid være vedhæftet en CSV-fil, selvom der ikke har været nogen hændelser siden sidst.

CSV-filens format og syntaks (standard CSV):

1. Tegnsæt UTF-8
2. Feltseparator er komma ,
3. Linjeseparator er LF (\n , 0x0a)
4. Decimalseparator er punktum .
5. Tidszone er Europe/Oslo og tager højde for sommer/vintertid. Tiden kan gå baglæns visse steder i loggen, specifikt omkring 02:00-03:00 sidste søndag i marts og oktober, så længe Norge bruger sommertid. Det interne timestamp går dog aldrig baglæns, da det bruger UTC. Google bruger ikke skudsekunder, så tidspunkter som 23:59:60 bør ikke forekomme.
6. Datoformat er «ÅÅÅÅ-MM-DD TT:MM:SS» for eksempel «2022-05-17 08:15:01» for 17. maj 2022 kl 08:15:01 Oslo-tid
7. Felter der indeholder dobbelte anførselstegn " eller komma , formateres sådan (standard CSV):

- 1 «Feltet får omsluttende dobbelte anførselstegn» - 2 Eventuelle " i teksten bliver til "" i CSV-filen Eksempel: tekst "i anførselstegn, dobbelte", og adskilt med komma bliver til «tekst ""i anførselstegn, dobbelte"", og adskilt med komma» - Linje 1 er overskrifter - Linje 2 og nedefter har hændelsestyper eller eventuelle fejlmeddelelser. Hvis der ikke har været nogen hændelser, får du kun overskrifterne, men du får altid en e-mail med vedhæftet regneark.

Hændelsestyper

Hændelserne er sorteret i kronologisk rækkefølge, stigende. Forskellige felter (kolonner) i CSV-filen udfyldes afhængigt af hvilken type hændelse det drejer sig om.

Fælles værdier

Alle hændelsestyper har disse værdier:

1. hændelses-ID (unikt, også på tværs af eksporter og virksomheder)
2. navn og medarbejdernummer på brugeren der har gjort noget
3. dato i Europe/Oslo-tidszonen, med hensyn til sommer/vintertid.
4. timestamp (UNIX timestamp, dvs. antal sekunder fra 1. januar 1970, UTC). Hurtig måde at konvertere til anden tidszone og sommer/vintertid i Excel er formlen =1500598288/86400+date(1970,1,1). Formlen kan have brug for semikolon i stedet, hvis dine regionale indstillinger er sat til det.
5. notatfelt er tilgængeligt på de fleste hændelser.
6. værktøjsnavn og værktøjs-ID på værktøjshændelser

ekstra værdier for visse hændelsestyper:

take

logger når en bruger overtager et værktøj selv. Værdier:

1. antal dage/timer/minutter/sekunder den forrige bruger havde værktøjet. Beregnes ikke hvis den forrige bruger var et lager. Beregnes ikke hvis værktøjet var udplaceret i det øjeblik det blev overtaget.

give

logger når en bruger manuelt giver et værktøj til nogen (eller til et lager). Værdier:

1. bruger/lager der modtog værktøjet, og dennes medarbejdernummer (lagre har ikke medarbejdernummer)
2. antal dage/timer/minutter/sekunder den nuværende bruger havde værktøjet. Beregnes ikke hvis værktøjet var udplaceret i det øjeblik det blev givet videre, og det gives til en almindelig bruger.

place

logger når en bruger udplacerer et værktøj på et fysisk sted. Brugeren vil stadig stå som ansvarlig for værktøjet internt i virksomheden. Værdier:

1. sted det blev udplaceret (tekstbeskrivelse) og/eller
2. lokation det blev udplaceret (hentet via GPS eller valgt manuelt på kort)
3. antal dage/timer/minutter/sekunder den nuværende bruger havde værktøjet før udplacering.

andre værdier som kontaktperson osv. vil komme som separate opdateringer med hændelsestypen «placeupdate»

placeupdate

logger når en bruger opdaterer kontaktoplysninger for et udplaceret værktøj. Værdier:

1. et af felterne: returnByDate, placedContactEmail, placedContactPhone, placedContactPerson

unplace

logger når en bruger henter værktøjet tilbage fra udplacering. Værdier:

1. antal dage/timer/minutter/sekunder værktøjet var udplaceret før det blev hentet.

stocktake

logger når en bruger tager lagervarer ud. Værdier:

1. antal på lager før og efter hændelsen
2. antal taget ud
3. enhed varen føres i (kg, tons, m² osv)

stockgive

logger når en bruger lægger lagervarer ind. Værdier:

1. antal på lager før og efter hændelsen
2. antal lagt ind
3. enhed varen føres i (kg, tons, m² osv)

losttool

logger når en bruger melder værktøjet som tabt

foundtool

logger når en bruger melder at værktøjet er fundet igen

Sådan importerer du rapporter til regneark

Hvis du bruger Libreoffice, Openoffice, Google Regneark eller Numbers, kan du bare åbne CSV-filen og vælge UTF-8, kommasepareret.

Excel er lidt anderledes, fordi den af ​​en eller anden grund ikke beder om filterindstillinger, når du åbner CSV-filen.
Så for at åbne CSV-filen i Excel skal du:

1. Åbne et nyt regneark
2. Gå til Data → Hent eksterne data → Fra tekst

1. Vælg CSV-filen
2. Vælg kodning UTF8
3. Vælg Afgrænset af tegn (ikke fast længde)

1. Vælg Komma som den eneste feltseparator (og '' for tekst; det står normalt allerede)

1. Tryk på Næste / Udført et par gange

Nu kan du lave normale regnearksopgaver med informationen