Förklaring av rapportformat

Slå på rapportmodulen och Ange e-postadressen/e-postadresserna i fält 1 «E-postadress för att ta emot rapporter». Du kan ange flera e-postadresser separerade med kommatecken om du vill.

Endringer från föregående version

Detta är första versionen, så det är nytt. Version 1 har 24 exportkolonner.

Senare versioner vill få nya filt lagt till slutet, kolonnen kommer alltid i samma serieföljd och har identisk överskrift. Alla händelser betraktar samma namn. Det vill si att nyare versioner kommer att vara bakoverkompatible, och att funktioner skrivna för att läsa version 1 kan också fungera med nyare versioner.

ERRATA/rättelser av själva detta dokument som beskriver version 1:

1. Ingen foreløpig.

Sänder

Rapportera skickas för alla företag kl 08:00 varje måndag «Oslotid». Om något skulle gå galet och vi måste få se på funktionen, vilket kommer att rapportera inbördes belastningar från och med tidpunkten förra rapporten skickas. 08:00:00.

Första gången du aktiverar rapportmodulen, får en automatisk rapport från sista 2 veckor. Du kan kontakta oss om du önskar rapport från och med ett annat tidpunkt.

Åpning

CSV-filer är bara text, och du kan öppna dem med ett regneark till exempel.

Tidsbegrensning

Vi kan inte leverera logg från före 1. januari 1970 00:00:00 UTC och heller inte från framtiden (bör gå betalt för alla våra kunder). År 2038-problemet är tatt høyde för. Vi får ett problem vid årsskiftet 9999/10000 e.v.t. men vil oppdatere appen i god tid för det.

Datakällor

De flesta filtarna i loggen lagras «som de var den gangen». Till exempel visar loggens verktygsnamn som var vid tidpunkten händelsen inträffade. Därför kan samma verktyg hete olika ting genom loggen.

Noen filtning hämtas på exporttidspunktet, och tjäna kan därför ha varit forskjellig på hendelsestidspunktet:

1. Ansattnumre
2. Utleiepris

Detta är en typisk filtare som inte uppdateras särskilt ofta, men om du har ändrats på dem under veckans lopp, visas alltså intjänad på exporttidspunktet (som temmelig säkert är måndag 08:00).

Ingen filt räknas ut på exporttidspunkt, som datafelter, «dager/timer/minutter/sekunder ute» och antalet på lager. Detta kunde varit gjort med enkla former i regneark, men nu har vi gjort det för dig 🙂

Eksempelfil

- som visar alla händelsetyper och några värden för var och en av dem. Det finns också en kort förklaring i själva filen, se detaljer nedan.

Nödvändiga inställningar

För att exporten ska fungera måste du:

1. markera kryssrutan för «Rapport» under Företagsinställningar
2. fylla i «E-post för att ta emot rapporter» under Företagsinställningar

- du kan ange flera e-postadresser separerade med komma om du vill skicka till flera.

Format

Roboten skickar ett e-postmeddelande till adressen(erna) som anges i fältet «E-postadress för export» under Företagsinställningar.

E-postmeddelandet innehåller lite text och 1 bifogad CSV-fil. En CSV-fil bifogas alltid, även om det inte har hänt något sedan senast.

CSV-filens format och syntax (standard CSV):

1. Teckenuppsättning UTF-8
2. Fältavgränsare är komma ,
3. Radavgränsare är LF (\n , 0x0a)
4. Decimalavgränsare är punkt .
5. Tidszon är Europe/Oslo och tar hänsyn till sommar/vintertid. Tiden kan gå bakåt på vissa ställen i loggen, specifikt runt 02:00-03:00 sista söndagen i mars och oktober, så länge Norge använder sommartid. Den interna tidsstämpeln går dock aldrig bakåt, eftersom den använder UTC. Google använder inte skottsekunder, så tider som 23:59:60 bör inte förekomma.
6. Datumformat är «ÅÅÅÅ-MM-DD TT:MM:SS» till exempel «2022-05-17 08:15:01» för 17 maj 2022 kl 08:15:01 Oslo-tid
7. Fält som innehåller dubbla citattecken " eller komma , formateras så här (standard CSV):

- 1 «Fältet får omslutande dubbla citattecken» - 2 Eventuella " i texten blir "" i CSV-filen Exempel: text "i citattecken, dubbla", och separerad med komma blir «text ""i citattecken, dubbla"", och separerad med komma» - Rad 1 är rubriker - Rad 2 och nedåt har händelsetyper eller eventuella felmeddelanden. Om det inte har hänt något får du bara rubrikerna, men du får alltid ett e-postmeddelande med bifogat kalkylblad.

Händelsetyper

Händelserna är sorterade i kronologisk ordning, stigande. Olika fält (kolumner) i CSV-filen fylls i beroende på vilken typ av händelse det gäller.

Gemensamma värden

Alla händelsetyper har dessa värden:

1. händelse-ID (unikt, även över exporter och företag)
2. namn och anställningsnummer på användaren som har gjort något
3. datum i Europe/Oslo-tidszonen, med hänsyn till sommar/vintertid.
4. tidsstämpel (UNIX-tidsstämpel, dvs. antal sekunder från 1 januari 1970, UTC). Snabbt sätt att konvertera till annan tidszon och sommar/vintertid i Excel är formeln =1500598288/86400+date(1970,1,1). Formeln kan behöva semikolon istället, om dina regionala inställningar är inställda på det.
5. anteckningsfält är tillgängligt på de flesta händelser.
6. verktygsnamn och verktygs-ID på verktygshändelser

extra värden för vissa händelsetyper:

take

loggar när en användare tar över ett verktyg själv. Värden:

1. antal dagar/timmar/minuter/sekunder föregående användare hade verktyget. Beräknas inte om föregående användare var ett lager. Beräknas inte om verktyget var utplacerat i det ögonblick det togs över.

give

loggar när en användare manuellt ger ett verktyg till någon (eller till ett lager). Värden:

1. användare/lager som fick verktyget, och dennes anställningsnummer (lager har inte anställningsnummer)
2. antal dagar/timmar/minuter/sekunder nuvarande användare hade verktyget. Beräknas inte om verktyget var utplacerat i det ögonblick det gavs vidare, och det ges till en vanlig användare.

place

loggar när en användare placerar ut ett verktyg på en fysisk plats. Användaren kommer fortfarande att stå som ansvarig för verktyget internt i företaget. Värden:

1. plats där det placerades ut (textbeskrivning) och/eller
2. plats där det placerades ut (hämtad via GPS eller vald manuellt på karta)
3. antal dagar/timmar/minuter/sekunder nuvarande användare hade verktyget innan utplacering.

andra värden som kontaktperson etc. kommer som separata uppdateringar med händelsetypen «placeupdate»

placeupdate

loggar när en användare uppdaterar kontaktinformation för ett utplacerat verktyg. Värden:

1. ett av fälten: returnByDate, placedContactEmail, placedContactPhone, placedContactPerson

unplace

loggar när en användare hämtar in verktyget från utplacering. Värden:

1. antal dagar/timmar/minuter/sekunder verktyget var utplacerat innan det hämtades.

stocktake

loggar när en användare tar ut lagerhållna varor. Värden:

1. antal i lager före och efter händelsen
2. antal uttaget
3. enhet varan förs i (kg, ton, m² etc)

stockgive

loggar när en användare lägger in lagerhållna varor. Värden:

1. antal i lager före och efter händelsen
2. antal inlagt
3. enhet varan förs i (kg, ton, m² etc)

losttool

loggar när en användare rapporterar verktyget som förlorat

foundtool

loggar när en användare rapporterar att verktyget har hittats igen

Hur man importerar rapporter till kalkylblad

Om du använder Libreoffice, OpenOffice, Google Sheets eller Numbers, du kan helt enkelt öppna CSV-filen och välja UTF-8, kommaseparerad.

Excel är lite annorlunda, eftersom det av någon anledning inte frågar efter filterinställningar när du öppnar CSV.
Så för att öppna CSV-filen i Excel behöver du:

1. Öppna ett nytt kalkylblad
2. Gå till Data → Hämta externa data → Från text

1. Välj CSV-filen
2. Välj kodning UTF8
3. Välj separerad med tecken (inte fast längd)

1. Välj kommatecken som enda fältseparator (och '' för text; det är vanligtvis inställt där som standard)

1. Tryck på Nästa / Klar ett par gånger

Nu kan du göra vanliga kalkylbladssaker med informationen