Översikt Produktionssystemet

Sammanfattning

Med produktionssystemet avses funktioner som administrerar, styr och sammanställer uppgifter om vad som avverkas och transporteras från skog till bilväg. Förutom rapportering av producerade volymer från skördare och skotare hanteras även uppgifter om skördares mätnoggrannhet. Som stöd för detta finns ett antal funktioner där vissa enbart är åtkomliga via användargränssnittet medan andra även kan hanteras med hjälp av integrationer till eller från Biometria.

• Maskinregister – uppgifter om de skogsmaskiner som rapporterar.
• Uppdragsgivarinställning – styrparametrar för hur produktionsrapportering för en viss uppdragsgivare ska hanteras.
• Maskinförarkoppling – administration av vilka användare som ska kunna använda Rapp för sin rapportering av producerade volymer.
• Produktionsunderlag – styrdokumentet för produktionsrapportering som definierar vad som kan rapporteras på ett objekt samt vilka aktörer som ska få ta del av vad som rapporteras.
• Rätta – gränssnitt för rättning av produktionsresultat som avvisats på grund av att de inte uppfyller kraven vid kontroller mot Biometrias masterdataregister och produktionsunderlaget.
• Korrigera – gränssnitt för ändring av uppgifter i ett godkänt produktionsresultat som av någon anledning blivit fel.
• Produktionsstyrning – gränssnitt för uppladdning av styrdokument som ska distribueras till skogsmaskiner med hjälp av Sender XC
• StanForD-filer – lagring och åtkomst till insända filer i StanForD-format.
• Kvantitetsrapportering – gränssnitt för inmatning av kvantiteter som underlag för logistiksystem då produktionsrapportering med hjälp av Sender XC eller Rapp inte används.

Funktionerna nås via menyn som öppnas via knappen med tre streck upp till vänster i produktionssystemets användargränssnitt.

Produktionssystemet föds med indata genom rapportering av StanForD-filer med hjälp av Sender XC, egen integrationslösning för av StanForD-filer eller genom inknappning av producerade volymer i det separata webgränssnittet Rapp.

För att få åtkomst till produktionssystemet krävs att användaren beställer en behörighet. Olika nivåer i behörigheten styr om användaren enbart ska titta eller också kunna ändra uppgifter i produktionssystemet som är kopplade till företaget användaren tillhör. Hur beställning av detta sker beskrivs inte i denna handbok.

Förenklad beskrivning av informationsflödet

En översiktlig beskrivning av flödet av information genom produktionssystemet beskrivs här. Mer detaljerad beskrivning av de olika stegen finns i andra delar av handboken.

I affärssystemet skapas ett Förstaledskontrakt med affärsuppgörelsen mellan säljare och köpare i det första affärsledet. I affärssystemet skapas även ett Avtalsobjekt för att hålla ihop volymen från ett  avverkningsobjekt. När avtalsobjektet aktiveras skapas ett Produktionsunderlag med samma identitet i Produktionssystemet. Produktionsunderlaget kompletteras med rader som definierar vad som ska  godkännas vid produktionsrapporteringen på det aktuella objektet. På produktionsunderlaget finns det även möjlighet att definiera vilka aktörer, i egenskap av olika aktörsroller, som ska få behörighet till det som produktionsrapporteras. Produktionsunderlaget kompletteras även med uppgift om Destinerad mottagare och Destinerad mottagningsplats när det användarskapade transportunderlaget aktiverats om uppgifter överensstämmer.

När skördaren och/eller skotaren rapporterar volymer bearbetas den insända StanForD-filen så att det skapas ett eller flera produktionsresultat. Dessa är av olika resultattyper beroende på vad de innehåller. Produktionsresultaten som innehåller uppgifter om vad som skördats eller skotats kontrolleras mot uppgifter på produktionsunderlaget. Uppfylls kontrollen godkänns de och  kompletteras med uppgifter från produktionsunderlaget. Godkända produktionsresultat skickas dels till Biometrias Rapportportal dels till företagen som prenumererar på integrationsmeddelanden i form av papiNet-meddelanden. papiNet-formatet som används för produktionsresultat med skördade volymer är MeasuringTicket ProductionTicket och för produktionsresultat med skotade volymer DeliveryMessage Shipment Advice.

Hantering för användare som har behörighet till flera företag

Även om en användare fått fullmakt och behörighet att administrera uppgifter för mer än ett företag går det inte att hantera mer än ett i taget i produktionssystemet. Det går således inte att blanda uppgifter från flera företag samtidigt i olika söklistor. Byte till annat företag som användaren har behörighet till sker i anslutning till användarnamnet som visas på den gröna listen längst upp till höger. Har användaren
behörighet till mer än ett företag visas där en liten vit triangel under namnet. Det är via den bytet till ett annat företag sker.

Maskinregistret

En förutsättning för att skördade och skotade volymer ska kunna rapporteras med hjälp av Sender XC, Rapp eller via integration till produktionssystemet är att maskinen finns registrerad i maskinregistret med  ett unikt SDCID. I maskinregistret finns även uppgifter om maskinen, kontaktuppgifter, vilket Utförande avverkningsföretag maskinen tillhör (ägs av) och vilken/vilka uppdragsgivare maskiner har. I  maskinregistret registreras även om maskinen uppfyller kraven för att godkännas enligt instruktionen för kvalitetssäkrad mätning och kan användas för ersättningsgrundande skördarmätning.

Layout och funktion

Startläget när maskinregistret öppnas är att samtliga aktiva maskiner som användaren är behörig till visas i en scrollningsbar lista. För användare med behörighet till aktör som agerar som uppdragsgivare betyder det att det är de maskiner där det egna företaget är registrerad som uppdragsgivare.

Är det många maskiner blir de uppdelade i ett antal ”sidor” som det går att växla mellan med hjälp av siffrorna och pilarna längst ner. 

Omsortering i listan kan ske genom att klicka i kolumnrubriken.

Skapa nytt SDCID

Det är Biometria som har behörighet att efter beställning lägga till en helt ny maskin med ett nytt SDCID i maskinregistret.

Inaktivera SDCID

Biometria kan efter beställning inaktivera en fysisk maskin som inte längre ska kunna produktionsrapportera. Statusen på maskinen i maskinregistret blir då Inaktiv och den markeras med grå bakgrund i listan. På inaktiverade maskiner går det inte göra några ändringar i maskinregistret. En maskin ska inte inaktiveras bara för att den slutar rapportera för en viss uppdragsgivare. Möjlighet finns att återaktivera maskinen.

Sökfunktion

Direkt i startbilden går det att filtrera på maskintyp (skördare, skotare eller drivare) eller genom att skriva sökbegrepp i ett ”fritextfält”. Genom att kryssa i rutan Visa alla visas samtliga maskiner och inte enbart de användaren är uppdragsgivare för.

Inmatningsbilden för mer en detaljerad filtrering på olika parametrar öppnas med knappen med förstoringsglas längst upp till höger.

Se uppgifter som registrerats på en maskin

För att se vad som finns registrerat på en maskin i maskinregistret klickar man på raden för maskinen i listan. Det visas då en detaljbild uppdelad i ett att antal olika sektioner som kan öppnas. Antalet sektioner kan variera beroende på vilken behörighetsnivå användaren har.

Nedan följer en kort beskrivning av de uppgifter som finns registrerade på en maskin i registret.

SDCID

SDCID är den unika identiteten på en fysisk maskin. Uppgifter ändras inte när en maskin byter ägare eller börjar rapportera mot en ny uppdragsgivare. Ett SDCID ska inte heller flyttas över från en maskin till en annan. 

Formatet för SDCID är ”sdcgpx” följt av 4 eller 6 siffror. Alla maskiner som tilldelats ett SDCID för rapportering har 4-siffriga SDCID och behåller dessa i VIOL 3 medan nya maskiner som skapas upp för VIOL 3 får 6-siffriga SDCID.

SDCID utgör tillsammans med en PIN-kod inloggningsuppgiften mot Biometria vid rapportering med Sender XC. Se kapitel 3.6.

Nytt för VIOL 3 är att även maskiner som enbart rapporterar med hjälp av Rapp behöver finnas registrerade i maskinregistret med ett unikt SDCID.

SDCID skapas av Biometria efter beställning.

Maskintyp

Anger om den registrerade maskinen är en skördare, skotare eller en drivare. Har främst betydelse vid utsökningar i maskinregistret. Anges genom att välja ett alternativ i en rullningslist. Registreras/redigeras av Biometria.

Tillverkare

Tillverkare (märke) för maskinen. Textfält för inmatning. Registreras/redigeras av Biometria. Uppgiften från registret lagras i produktionsresultat skapade med hjälp av Rapp. I produktionsresultat skapade vid filinsändning hämtas maskintillverkare från den insända filen.

Modell

Maskinmodell. Textfält för inmatning. Registreras/redigeras av Biometria. Uppgiften från registret lagras i produktionsresultat skapade med hjälp av Rapp. I produktionsresultat skapade vid filinsändning hämtas modell från den insända filen.

Tillverkningsår

Maskinens tillverkningsår. Årtal registreras med siffor. Registreras/redigeras av Biometria.

Chassinummer

Maskinens chassinummer. Textfält som registreras/redigeras av Biometria.

Registreringsnummer

Skotares registreringsnummer. Textfält som registreras/redigeras av Biometria.

Kontaktperson

Kontaktperson för maskinen. Kan användas för utsökning i maskinregistret. Visas för uppdragsgivare som är registrerad på maskinen.

Telefonnummer till kontaktperson

Telefonnummer till kontaktpersonen för maskinen. Visas för uppdragsgivare som är registrerad på maskinen.

E-postadress tillkontaktperson

E-postadress till kontaktpersonen för maskinen. Visas för uppdragsgivare som är registrerad på maskinen.

Utförande avverkningsföretag

Ägaren av maskinen registreras som Utförande avverkningsföretag på maskinen i maskinregistret. Det kan vid varje tidpunkt bara registreras ett företag. Byter maskinen ägare ska Utförande avverkningsföretag ändras i  registret. Uppgiften som registreras i maskinregistret är företaget i fältet Företagsnamn. Det går enbart att välja företag som finns registrerade i Biometrias aktörsregister. När företagets huvudkod eller namn skrivs in i fältet visas valbara alternativ. Utförande avverkningsföretag ska anges på huvudkodsnivå.

Övriga uppgifter (Organisationsnummer, Adress, Postadress, Kontaktperson, Telefonnummer till kontaktperson och E-postadress till kontaktperson) hämtas från Biometrias aktörsregister och är inte redigerbara i maskinregistret.

Uppdragsgivare

Här anges vilken/vilka uppdragsgivare maskinen har. En uppdragsgivare ser inte om maskinen även rapporterar för andra uppdragsgivare. Uppdragsgivare anges på huvudkodsnivå genom att skriva in företags huvudkod eller namn i fältet företagsnamn. Det går enbart att registrera företag som finns registrerade i Biometrias aktörsregister. Börjar en maskin rapportera mot en ny uppdragsgivare läggs denna till med automatik i maskinregistret, men då med färre uppgifter. För varje uppdragsgivare kan maskinnummer, klartext för maskinnummer, Kontaktperson, Telefonnummer till kontaktperson och E-postadress till kontaktperson registreras.

Maskinnummer (uppdragsgivare)

Uppdragsgivarens identitet för maskinen. Anges med 1 – 6 siffror. Används för utsökning och registreras på produktionsresultaten vid användning av Rapp. Vid rapportering med hjälp av fil är det maskinnumret i den insända filen som lagras på produktionsresultaten som genereras. Undantaget är om det i uppdragsgivarinställning är angivet att maskinnummer ska sättas till samma som siffrorna i SDCID.

Klartext för maskinnummer (uppdragsgivare)

Klartexten som ska användas i söklistor och uppföljningsrapporter för maskinen när den rapporterar för uppdragsgivaren.

Kontaktperson (uppdragsgivare)

Kontaktperson hos uppdragsgivaren för maskinen. Obligatorisk att ange vid registrering av ny uppdragsgivare.

Telefonnummer till kontaktperson (uppdragsgivare)

Telefonnummer till kontaktpersonen hos uppdragsgivaren för maskinen. Obligatorisk att ange vid registrering av ny uppdragsgivare.

E-postadress till kontaktperson (uppdragsgivare)

E-postadress till kontaktpersonen hos uppdragsgivaren för maskinen.

Revisorsföretag och Revisor med kontaktuppgifter

Revisorsföretag är den aktör som är ackrediterad att godkänna att en maskin uppfyller kraven som finns definierade i instruktionen för ”Kvalitetssäkrad mätning”. Är för närvarande Biometria men kan även vara andra företag. Vilket företag som agerar som revisorsföretag för en maskin kan bara registreras av Biometria. Revisorsföretag anges genom att skriva in företagets huvudkod eller namn i fältet Revisorsföretag. Det går enbart att registrera företag som finns registrerade i Biometrias aktörsregister. Utöver detta registreras vilken Revisor (Kvalitetstekniker) på revisorsföretag som ansvarar för revisionerna på maskinen. Det som registreras är namn, telefonnummer och e-post.

Revisioner

Här registrerar Revisorsföretaget de revisioner som har utförs på maskinen samt om den vid den tidpunkten uppfyller kravet enligt instruktionen. Implementerat är två olika typer av godkännande trots att det i gällande instruktion för ”Kvalitetssäkrad mätning” enbart finns en som omfattar både ”Mätnoggrannhet” och ”Ersättningsgrundande skördarmätning”. Använd knappen ”Lägg till revision” för ny revision. På befintlig revison går det att redigera godkännande nivå för ”Mätnoggrannhet” och  "Ersättningsgrundande skördarmätning” men inte datum. Uppgiften om vem som utfört revisionen hämtas från vad som är registrerat under Revisor vid tidpunkten. Aktuell godkännandenivå lagras på produktionsresultaten som genereras från filerna skördaren rapporterar. Gjorda revisioner på maskinen listas och är synliga för maskinens uppdragsgivare.

Ersättningsgrundande skördarmätning (revision)

Här visas om maskinen är godkänd att användas på objekt där skördarens mätning används för avräkning mot skogsägaren. Förutom att det på förstaledskontrakt och avtalsobjekt registreras nödvändiga uppgifter för tillämpning av Ersättningsgrundande skördarmätning är det ett krav att maskinen också är registrerad som Godkänd här för att det ska skapas och skickas underlag för mätresultat och leveranser från produktionssystemet till affärssystemet när skördaren produktionsrapporterar mot objektet. Fältet är inte redigerbart utan en maskin blir enligt gällande instruktion godkänd för ersättningsgrundande skördarmätning om revisor angivit att den har Godkänd eller Väl godkänd mätnoggrannhet. 

Mätnoggrannhet (revision)

Implementerat är möjlighet att registrera om maskiner är Väl godkänd, Godkänd, Ej godkänd eller Ej bedömd enligt kraven definierade i instruktionen.

Revisionsdatum

Datum för när revisionen är utförd. Skrivs in.

3.5.23 Sender XC-installationer

Under denna flik generar Biometria PIN-koder för installation av Sender XC. PINkoden kan enbart användas för en Sender XC-installation på en dator. Finns det behov att installera Sender XC på flera datorer för att kunna skicka filer från samma maskin måste en PIN-kod per installation skapas.

PIN-kod skapas med knappen Begär pinkod. PIN-koden är inte synlig i maskinregistret utan skickas till beställaren som SMS till det telefonnummer och/eller E-post till den E-postadress som anges. En PIN-kod är giltigt 30 dagar från att den skapas. Under Begär pinkod visas datum och giltighetstid på tidigare skapade PIN-koder som ännu inte aktiverats i en Sender XC-installation.

När Sender XC har installerats och verifierats med en PIN-kod på en dator visas uppgifter om detta. 

Verifierad enhet (Sender XC-installationer)

Datornamn på enheten Sender XC-installerats på. Returneras från datorn installationen skett på och kan inte justeras i maskinregistret.

Verifierad enhet – klartext (Sender XC-installationer)

Ett aliasnamn på datorn installationen skett på. Kan redigeras av Biometria.

Verifieringstidpunkt (Sender XC-installationer)

Tidpunkten när PIN-koden verifierats vid installationen.

Senaste rapporterad aktivitet (Sender XC-installationer)

Senaste tidpunkten Sender XC i den aktuella datorn kommunicerat med Biometria.

Programversion (Sender XC-installationer)

Versionsbeteckning för Sender XC-installationen

Konfiguration (Sender XC-installationer)

Beteckningen på version och styrfiler i Sender XC-installationen.

Status

Längst upp till vänster presenteras om maskinen har status Aktiv eller Inaktiv.

Skapa PIN-kod för Sender XC-installation

För att ansluta sig och kunna rapportera filer till Biometria med hjälp av Sender XC krävs förutom ett SDCID en PIN-kod. Den anges en gång vid installationen av Sender XC. En PIN-kod är giltig i 30 dagar från att den skapas och kan enbart användas för en installation på en dator. Den blir sedan förbrukad. Behöver ominstallation ske på grund av till exempel datorbyte i maskinen måste ny PIN-kod beställas. Detsamma gäller om det finns behov att kunna skicka filer från samma maskin från fler olika datorer. Ny PIN-kod kan bara skapas av Biometria.

Uppdragsgivarinställning

Funktion

För att ett företag ska kunna produktionsrapportera med fil eller Rapp måste företaget finnas upplagd med en uppdragsgivarinställning. Inställningarna innehåller uppgifter och val som påverkar rapportering och funktioner vid tolkning av insända StanForD-filer. Inställningarna anges på företagsnivå (huvudkod) och kan inte differentieras för olika delar inom ett företag. En användare ser uppdragsgivarinställningarna för sitt företag och inga andra. Det enda som uppdragsgivaren själv kan ändra är att lägga till/ta bort kontaktpersoner för Rapp. Övrigt administreras av Biometria. Det finns ingen retroaktivitet i uppdragsgivarinställningen. En ändring påverkar enbart det produktionsrapporteras efter ändringen.

Uppgifter som anges i en uppdragsgivarinställning

Uppdragsgivare

Uppdragsgivare i produktionssystemet är samma aktör som köparen på förstaledskontraktet. Anges här på huvudkodsnivå. Klartext hämtas från aktörsregistret.

Gpx-nummer

En unik identitet Biometria tilldelar uppdragsgivaren när den ska börja med produktionsrapportering. Formatet är ”gpx” följt av 3 siffror, till exempel gpx100. Detta är en obligatorisk uppgift som måste finnas i alla insända  produktionsfiler. Uppgiften läggs till med automatik vid rapportering med Sender XC.

SDCID som maskinnummer

Möjlighet att styra så att siffrorna i SDCID även lagras som maskinnummer vid filinsändning oavsett vilket maskinnummer som finns i den insända filen. Alternativ Ja eller Nej.

Återkoppling till maskin vid fel

Detaljeringsnivå vid återkoppling till Sender XC finns i två nivåer. Inställningen styr hur mycket uppgifter som återkopplingsmeddelandet till Sender XC innehåller när en insänd fil resulterat i avvisade produktionsresultat på grund av att insänd kombination av Producerat handelssortiment + Producerat för mottagningsplats saknas på aktuellt produktionsunderlag. Med valet Enkel visas att rapporterad kombination av Producerat handelssortiment + Producerat för mottagningsplats saknas på produktionsrapportering, med alternativet Detaljerad även information om vilka alternativ som finns registrerade på produktionsunderlaget.

Skogsbränsleberäkning

Möjlighet finns att styra om beräkning av potentiell kvantitet skogsbränsle (GROT) ska beräknas med hjälp av övriga uppgifter i den insända produktionsfilen från en skördare. Beräkning sker med hjälp av algoritm framtagen av skogforsk. Förutom att det här är inställt att skogsbränsle ska beräknas krävs det i skördaren lagras vilka stammar som grotanpassas vid avverkningen. Skogsbränsle beräknas enbart på dessa stammar.

Kan rapportera i Rapp

Anger om skördare eller skotare kan anslutas för att börja produktionsrapportera kvantiteter med hjälp av Rapp på avtalsobjekt som tillhör uppdragsgivaren.

Nedre diametergräns för stamfelsved (mm)

Nedre toppdiametergräns på stockar som ska räknas med i stamfelsveden på en stam. För att en stocks volym ska räknas som stamfelsved krävs att den apterats till ett ej sågbart handelssortiment samt att toppdiametern på den är större än den gräns som angivits här. Förvalt värde är 140 mm.

Forestfuelsetting (inställningsfil)

Namnet på styrfilen med parametrar som styr hur skogsbränsleberäkningen hos Biometria ska ske.

Kontaktpersoner Rapp

För företag som har angivit att Rapp kan användas anges namn och e-postadress på kontaktpersoner som ska få e-post angående maskinförarkopplingar Rapp. Det går att registrera flera kontaktpersoner för Rapp på ett företag. Användare med behörighet till uppdragsgivaren kan själv lägga till eller ta bort kontaktperson för Rapp.

Undanhåll vissa identifikationsdata för specifika aktörer

Hur många detaljuppgifter i ett produktionsresultat som blir tillgängliga för andra än uppdragsgivaren beror på vilken roll aktören har på produktionsresultatet. Detta styrs av en framtagen behörighetsmatris. Möjlighet finns för uppdragsgivaren att för definierade aktörer, som anges här, blanka ut ett antal ytterligare uppgifter kopplade till den producerande maskinen när de har aktörsrollen Leveransansvarig eller Mottagare på produktionsresultat som kommer från uppdragsgivaren. Detta trots att det i grundläget är uppgifter som aktören ska se enligt  behörighetsmatrisen. Vilka uppgifter det är visas genom att klicka på utropstecknet till höger om rubriken.

Produktionsunderlag

Produktionsunderlaget har två huvudsyften. Dels att definiera vad som ska godkännas vid produktionsrapportering, dels vilka aktörer som ska få behörighet att se produktionsresultaten som tillhör det. Ett produktionsunderlag kan administreras via integration från externa system eller direkt i produktionssystemet. Det är också möjligt att beställa en integration av produktionsunderlag från Biometria. Ett produktionsunderlag har samma identitet som avtalsobjektet det tillhör. Det är samma produktionsunderlag som används för kontroller av produktionsrapportering från både skördare och skotare. Om detta skiljer sig åt måste därför produktionsunderlaget omfatta bruttot av dessa två rapporteringar.

Behörig till produktionsunderlag

Det är i första hand Uppdragsgivaren på ett produktionsunderlag som kan se och administrera det. Om Uppdragsgivaren anger ett företag som Ansvarigt avverkningsföretag på produktionsunderlaget blir också detta behörig till  att administrera det. Ansvarigt avverkningsföretag angiven på huvudnivå i produktionsunderlaget ser hela produktionsunderlaget. Medan den aktör som är angiven som Ansvarigt avverkningsföretag på en enskild produktionsunderlagsrad enbart får behörighet till just den raden.

Layout och funktion

Startläget när funktionen öppnas är att alla produktionsunderlag som användaren har behörighet till och som ännu inte kompletterats med uppgifter, listas en rad per produktionsunderlag. Dessa betecknas som ”Ohanterat” i gränssnittet.

Förutom möjligheten att ändra filtreringen till att listningen även tar med de hanterade produktionsunderlagen går det också att göra sökning i ett fritextfält längst upp till höger. Genom att skriva något där kommer det fram alternativ som kan användas för filtrering. För att öppna ett gränssnitt där en mer detaljerad filtrering kan ske används knappen med förstoringsglas uppe till höger.

Ett produktionsunderlag i listan öppnas genom dubbelklick på raden eller med markering och knappen Visa valt underlag.

De uppgifter som presenteras eller anges på huvudnivå gäller hela produktionsunderlaget medan uppgifter på en specifik rad bara har betydelse för de  produktionsresultat som kopplas mot den.

Ett ”Ohanterat” produktionsunderlag måste kompletteras med produktionsunderlagsrader för att det ska fungera att rapportera mot det.

Ohanterade produktionsunderlag har orange färg i svarslistan, Hanterade produktionsunderlag som inte kompletterats med destineringsuppgifter har grå färg och de som kompletterats på minst en produktionsunderlagsrad med Destinerad mottagare har grön färg.

Listan med produktionsunderlag som visas på skärmen kan skrivas ut eller kopieras till en Excel-fil via knappen Exportera nere till vänster. 

Sökfunktion

En mer detaljerad sökfunktion med möjlighet att filtrera på flera olika parametrar öppnas via knappen med ett förstoringsglas längst upp till höger. Möjlighet finns att filtrera på en eller flera av dessa parametrar. För varje parameter går det att ange inget eller ett val i listan som visas. Det går inte att göra filtrering på annat än vad som föreslås som alternativ. Observera att valt alternativ i grundbildens startläge (Ohanterat/Hanterat) följer med till sökbilden när den öppnas. 

Säljare

Säljare på tillhörande förstaledskontrakt. Önskat alternativ visas genom att skriva in namn (privatperson eller företag) eller huvudkod-internt nummer (företag).

Uppdragsgivare/Första köpare

Uppdragsgivare är densamme som köparen på tillhörande förstaledskontrakt. Önskat alternativ visas genom att skriva in namn eller kod. 

Avtalsobjekt

Önskat alternativ visas genom att skriva in avtalsobjektnummer eller klartext på avtalsobjekt. Produktionsunderlaget har samma nummer som Avtalsobjektet.

Förstaledskontraktsnummer

Den systemskapade unika identiteten på förstaledskontraktet. Önskat alternativ visas genom att skriva in identiteten.

Förstaledskontrakt (egen referens)

Förutom den systemskapade identiteten på förstaledskontraktet kan det finnas en egen identitet som företaget självt bestämt. Önskat alternativ visas genom att skriva in identiteten.

Anskaffningsform

Väljs bland alternativen i rullningslisten.

Avtalsform

Väljs bland alternativen i rullningslisten.

Avverkningsform

Väljs bland alternativen i rullningslisten.

Producerat handelssortiment

Filtrerar fram produktionsunderlag där angivet Producerat handelssortiment finns med på en produktionsunderlagsrad.

Producerat för mottagningsplats

Filtrerar fram produktionsunderlag där angivet Producerat för mottagningsplats finns med på en produktionsunderlagsrad.

Mottagare

Filtrerar fram produktionsunderlag där vald aktör förekommer som Planerad mottagare. Önskat alternativ visas genom att skriva in huvudkod eller namn.

Ersättningsgrundande skördarmätning

Kryssas rutan för, sker filtrering så att enbart produktionsunderlag som innehåller referens till objekt där ersättningsgrundande skördarmätning ska tillämpas visas.

Ersättningsgrundande handelssortiment

Kan används under förutsättning att Ersättningsgrundande skördarmätning är ikryssad. Filtrering sker genom att välja något av de handelssortiment som kan användas vid redovisning av ersättningsgrundande skördarmätning. Se Figur 9.

Giltig under

Genom att ange ett datum här går det att filtrera fram enbart de produktionsunderlag som har en giltighetstid som omfattar det datumet.

Status

Möjlighet att filtrera fram produktionsunderlag tillhörande Aktivt respektive Avslutat avtalsobjekt. Avslutat blir avtalsobjektet när dess giltighetstid har löpt ut.

Fritext

Här går det att ange valfri uppgift som finns lagrad på ett produktionsunderlag och använda det för filtrering. Observera att förutsättningen för filtrering är att önskad uppgift går att välja bland alternativen som föreslås.

Hur ett produktionsunderlag skapas

När ett avtalsobjekt aktiveras skapas det med automatik ett produktionsunderlag i produktionssystemet. De villkor som behöver vara uppfyllda är att förstaledskontraktet har värdet Nej för ”Avtalsobjekt (AO) avser industri” samt att det är ett förstaledskontrakt med Industrimätning vald som Ersättningsgrundande mätning. Se separat beskrivning av vad som krävs i Förstaledskontrakt och Avtalsobjekt för att skördarens mätning ska bli ersättningsgrundande i affären med den säljande skogsägaren.

Uppgifter som behöver läggas till på ett nytt Produktionsunderlag

Den första, automatskapade, versionen av produktionsunderlaget måste kompletteras med produktionsunderlagsrader för att det ska bli användbart. För ett nytt produktionsunderlag kan det ske genom att utnyttja en sparad produktionsunderlagsmall (Använd mall) eller genom att lägga till nya produktionsunderlagsrader en i taget (Lägg till rad).

Kravet på produktionsunderlaget är att det innehåller rader med alla kombinationer av Producerat handelssortiment + Producerat för mottagningsplats som är aktuella och för objektet. Det är enbart produktionsresultat med de kombinationerna som kommer godkännas. Produktionsunderlaget bör därför återspegla innehållet i den objektinstruktion skördaren eller skotaren använder för objektet.

Obligatorisk uppgift att ange på en ny produktionsunderlagsrad är Producerat handelssortiment. Den anges genom att skriva kod eller klartext och sedan välja något av de alternativ som visas. Det är enbart handelssortiment som finns registrerade i Biometrias register som kan väljas.

Producerat för mottagningsplats är inte obligatoriskt att ange men utelämnas uppgiften krävs det att produktionsresultatet också saknar denna uppgift för att det ska matcha. Producerat för mottagningsplats anges genom att skriva in kod eller klartext. Enbart mottagningsplatser som finns registrerade i Biometrias register kan väljas.

Den aktör som anges i Planerad mottagare får behörighet i denna roll till de produktionsresultat som matchar produktionsunderlagsraden redan innan raden har kompletterats med Destinerad mottagare från destineringen. När raden kompletteras med Destinerad mottagare töms Planerad mottagare. Då upphör också möjligheten att ange en aktör som Planerad mottagare på den raden.

Den aktör som anges som Leveransansvarig på produktionsunderlagsraden får behörighet till produktionsresultaten som matchar raden i den aktörsrollen.

Ansvarigt avverkningsföretag som anges på radnivå i ett produktionsunderlag, ger denna aktör behörighet till produktionsresultaten som matchar just den raden. Anges Ansvarigt avverkningsföretag på huvudnivå, får den behörighet till alla produktionsresultat som tillhör produktionsunderlaget. Aktören som är Ansvarigt avverkningsföretag på en produktionsunderlagsrad, får också behörighet att administrera redigerbara uppgifter på raden.

Logistikinformationsmottagare är också en uppgift som lagras på produktionsunderlagsraden men kan inte anges där. Den hämtas i stället från avtalsobjektet om den angivits där för ett handelssortiment eller en  sortimentskategori som motsvarar produktionsunderlagsraden. Denna matchning och uppdatering sker både om Logistikinformationsmottagaren finns angiven på avtalsobjektet när produktionsunderlagsraden skapas eller om den registreras på avtalsobjektet efteråt. Ändras eller raderas Logistikinformationsmottagaren på avtalsobjektet påverkar detta också uppgiften på produktionsunderlaget med automatik så att de överensstämmer.

Det går inte att ändra Producerat handelssortiment eller Producerat för mottagningsplats på en sparad rad. Önskas en annan kombination än den som finns på en sparad rad måste en ny rad läggas till. Övriga uppgifter på en befintlig produktionsunderlagsrad kan anges eller ändras men uppgiften lagras då enbart på produktionsresultat som skapas efter ändringstidpunkten. Det är ingen retroaktivitet för befintliga produktionsresultat.

Utöver roller som anges på en produktionsunderlagsrad, är det tre roller som kan anges på huvudnivå så att de lagras på alla produktionsresultat kopplade till produktionsunderlaget oavsett om eller vilken produktionsunderlagsrad de matchas mot. Ingen av dessa är obligatorisk att fylla i.

Utförande avverkningsföretag skördare kan anges här, om produktionsresultaten med skotade volymer ska kompletteras med uppgift om vilket företag som utfört skördningen. Vilket Utförande avverkningsföretag skördare, som lagras på produktionsresultaten med skördade volymer hämtas från uppgift i filerna som skördaren rapporterar.

Utförande avverkningsföretag skotare kan anges här om produktionsresultaten med skördade volymer ska kompletteras med uppgift om vilket företag som utfört skotningen. Vilket Utförande avverkningsföretag skotare som lagras på produktionsresultaten med skotade volymer hämtas från uppgift i filerna som skotaren rapporterar. Ansvarigt avverkningsföretag som anges får behörighet till allt som produktionsrapporteras mot produktionsunderlaget. Det ger också denna aktör behörighet att administrera hela produktionsunderlaget.

Komplettera Produktionsunderlag med fler rader

Det är möjligt att komplettera ett produktionsunderlag med nya rader via knappen Lägg till rad. Kravet är att raden inte innehåller samma kombination av Producerat handelssortiment + Producerat för mottagningsplats som annan rad på produktionsunderlaget.

Via knappen med tre punkter längst till höger på en produktionsunderlagsrad går det också att Kopiera uppgifter på en befintlig rad till en ny men innan den sparas måste antingen Producerat handelssortiment eller Producerat för mottagningsplats ändras så att kombinationen blir unik.

Via knappen med tre punkter går det även att Inaktivera rad om den inte längre ska användas. Möjlighet finns att återaktivera rad om det behövs. 

Undantag vid matchning av produktionsresultat

För produktionsresultat som redovisar skördad kvantitet för oklassade stockar (till exempel 431-1 Stamdelar Tall), volym med fällda ej upparbetade stammar (419-1 Träddelar Barr & Löv, Färsk) samt de som redovisar skogsbränsle (519-1 Helgrot Barr & Löv, Färsk) sker en matchning och komplettering av uppgifter från en produktionsunderlagsrad om det finns på det finns en sådan på det aktuella produktionsunderlaget men de blir godkända även om det saknas en matchande produktionsunderlagsrad.

Undantagna från reglerna kring matchning mot uppgifter på produktionsunderlag är också de resultat som skapas i tjänsten för kvantitetsrapportering.

Produktionsresultat med resultatundertypen Stam eller Lass behöver inte matcha mot uppgifter på en produktionsunderlagsrad. För dessa räcker det att avtalsobjektsnumret är rätt. Detta gäller även Kvalitetsresultaten med uppgift om utförda kontrollmätningar på en stam.

Uppdatering av produktionsunderlag med destinerad mottagare

När en destinering av ett handelssortiment mot en mottagningsplats skett på ett avtalsobjekt kan en produktionsunderlagsrad uppdateras med Destinerad mottagare och Destinerad mottagningsplats om nödvändiga uppgifter överensstämmer.

Regler för att produktionsunderlagsrad ska uppdateras med destinerad mottagare

Något av följande alternativ måste uppfyllas för att Destinerad mottagare ska lagras på en produktionsunderlagsrad:

Producerat handelssortiment + Producerat för mottagningsplats i destinering överensstämmer med dessa uppgifter på en produktionsunderlagsrad.

Producerat handelssortiment + Destinerad mottagningsplats (om Producerat för mottagningsplats är utelämnad) i destinering överensstämmer med Producerat handelssortiment och Producerat för mottagningsplats på en produktionsunderlagsrad.

Destinerat handelssortiment (om Producerat handelssortiment är utelämnat) + Producerat för mottagningsplats i destinering överensstämmer med Producerat handelssortiment och Producerat för mottagningsplats på en produktionsunderlagsrad.

Destinerat handelssortiment (om Producerat handelssortiment är utelämnat) + Destinerad mottagningsplats (om Producerat för mottagningsplats är utelämnad) i destinering överensstämmer med Producerat  handelssortiment och Producerat för mottagningsplats på en produktionsunderlagsrad.

Detta innebär att Destinerad mottagare inte kan lagras på produktionsunderlagsrader som saknar uppgift i Producerat för mottagningsplats.

En produktionsunderlagsrad kan enbart uppdateras med en Destinerad mottagare så i de fall det finns flera aktiva destineringar av ett handelssortiment som var och en uppfyller villkoren för uppdatering av en produktionsunderlagsrad är det den första matchningen som gäller.

Händelse som uppdaterar en produktionsunderlagrad med Destinerad mottagare

Det krävs att en destinering blivit godkänd och fått statusen Destinerad samt att något av villkoren i föregående avsnitt uppfylls som en produktionsunderlagsrad uppdateras med Destinerad mottagare. Det räcker således inte  att det finns en Destinering med statusen Avropad.

Produktionsunderlagsrad som uppdaterats med Destinerad mottagare

När uppgifter från destineringen överensstämmer med uppgifter på produktionsunderlagsraden uppdateras den med Destinerad mottagare och Destinerad mottagningsplats. Samtidigt blir raden också grönmarkerad i  produktionssystemets klient. Eventuell Planerad mottagare som fanns angiven på den aktuella raden tas bort med automatik.

I de fall det redan finns produktionsresultat som matchats mot den aktuella produktionsunderlagsraden skapas det en ny version av dessa kompletterade med Destinerad mottagare. Dessa förmedlas till berörda aktörer om integration finns. Aktör som förekommit som Planerad mottagare men som inte blir Destinerad mottagare på ett produktionsresultat får information om detta via integrationsmeddelande. Nya produktionsresultat som matchar mot raden efter destineringen kompletteras direkt med Destinerad mottagare.

Ändring av destinerad mottagare

En Destinerad mottagare går att ersätta med en annan om den befintliga destineringens Giltig t.o.m. har passerats eller att transportinstruktionen fått status återkallad.

Produktionsunderlagsmall

Arbetet i produktionssystemet underlättas om mallar skapas och utnyttjas för produktionsunderlag. Genom en mall går det på ett enkelt sätt att återanvända en uppsättning med produktionsunderlagsrader som ofta förekommer inom ett visst område och därmed minska risken för att något av misstag glöms vid nyregistrering.

Produktionsunderlagsmallen innehåller uppgifter som finns på produktionsunderlagsraderna. Uppgifter på huvudnivå i produktionsunderlaget ingår inte i mallen. En produktionsunderlagsmall kan användas på helt nya (ohanterade) produktionsunderlag som saknar rader.

Skapa mall utifrån ett befintligt produktionsunderlag

Uppgifterna som finns på produktionsunderlagsraderna på ett befintligt produktionsunderlag kan sparas och återanvändas som en mall för nya produktionsunderlag.

På varje mall går det lagra ett antal uppgifter som gör det enklare hitta den när den ska användas.

En produktionsunderlagsmall är enbart åtkomlig för användare som tillhör uppdragsgivaren den är registrerad på.

Uppdatera befintlig produktionsunderlagsmall

För att uppdatera en befintlig produktionsunderlagsmall med till exempel andra uppgifter eller fler rader behöver den öppnas via menyvalet Produktionsunderlagsmall. Leta fram den mall som ska justeras i listan som visas. Är listan lång kan sökfunktionen som nås via knappen med förstoringsglas längts upp till höger användas. I den kan filtrering på uppgifter lagrade på eller i mallen användas för att begränsa urvalet. När önskad mall hittats kan uppgifter i den ändras.

Det går också att via knappen Kopiera mall återanvända uppgifterna i en befintlig mall och spara ner den med ett nytt namn.

Knappen Ta bort mall raderar den helt.

Använda produktionsunderlagmall

Enbart ohanterade produktionsunderlag går att komplettera med uppgifter från en sparad mall. Öppna produktionsunderlaget som automatskapats och leta fram önskad produktionsunderlagsmall via knappen Använd mall. Från listan med sparade mallar väljs den som ska användas genom markering och knappen Förhandsgranska mall. Då visas innehållet i mallen tillsammans med produktionsunderlaget den ska användas för. I detta läge går det att antingen via knappen Avbryt förhandsgranskning ångra sig och återställa produktionsunderlaget eller välja Applicera mall för att lagra ner mallens rader på produktionsunderlaget. När väl raderna från en  produktionsunderlagsmall har applicerats går det inte att ångra sig och välja en annan mall. Däremot är det fullt möjligt att komplettera produktionsunderlaget med nya rader eller ändra någon av de ändringsbara uppgifterna i den.

Hur produktionsrapporterade uppgifter delas upp

Hur produktionsrapporterade uppgifter delas upp och lagras i olika typer av produktionsresultat. Olika sätt att produktionsrapportera ger olika typer av resultat vid bearbetningen i produktionssystemet. De resultatundertyperna som finns är Produktionsresultat skördare sortiment, Produktionsresultat skotare sortiment, Produktionsresultat skördare stam, Produktionsresultat skotare lass, Kvalitetsresultat skördare.

Rapportering av filer enligt StanForD

Biometria stödjer i VIOL 3 rapportering av både StanForD2010 (version 3.x) och StanForD-classic men då all bearbetning och tolkning sker i StanForD2010-formatet så är det första steget i bearbetningen av StanForD-classic formaten att de konverteras till StanForD2010. Rekommendationen är att alla maskiner som kan rapporterar i StanForD2010.

Produktionsrapportering fil, skördare

StanForD2010-format hpr och StanForD-classicformat pri. Det första som sker är att sortera bort stammar som rapporterats tidigare så att nya produktionsresultat enbart innehåller nyrapporterad kvantitet. Identiteten på en stam i denna dubblettkontroll är kombinationen Machinekey+ObjectKey+StemKey i hpr-filen. Nästa uppdelning är att sortera stammarna i filen så att stammar som refererar till olika Object-Definitioner och SubObject-Definitioner särhålls i olika produktionsresultat. För dessa skapas sedan dels ett produktionsresultat med resultatundertypen Stam som innehåller uppgifter om de avverkade stammarna (Trädslag, DBH, Volym, Upparbetningstyp mm) dels ett antal produktionsresultat med resultatundertypen Sortiment. I varje sortimentsresultat redovisas enbart uppgifter om stockarna som refererar till en och samma ProductDefinition i StanForD-filen. Som exempel kan det bli ett produktionsresultat med alla tallsågtimmerstockar, ett med alla gransågtimmerstockar, ett med alla granmassavedsstockar, ett med alla barrmassavedsstockar från tall, ett med alla barrmassavedsstockar från gran och ett med alla lövmassavedsstockar. För varje stock i sortimentsresultatet lagras en rad uppgifter från filen.

Produktionsrapportering fil, skotare

StanForD2010-format fpr och StanForD-classicformat prl. Det första som sker är att lass som rapporterats tidigare sorteras bort så att nya produktionsresultat enbart innehåller nyrapporterad kvantitet. Identiteten på ett lass i denna dubblettkontroll är kombinationen Machinekey+ObjectKey+LoadKey i fprfilen. Nästa steg är att sortera lassen efter objekt och delobjekt så att inte volymer från olika objekt/delobjekt i en fil summeras och redovisas i samma produktionsresultat. För dessa skapas sedan dels ett produktionsresultat med resultatundertypen Lass som innehåller uppgifter om de utskotade lassen i filen (till exempel summerad volym i m3f respektive ton samt skotningsavstånd) dels ett antal produktionsresultat med resultatundertypen Sortiment med brytning på förekommande kombinationer av Producerat handelssortiment (Delivery) och Avlägg (Location).

Produktionsrapportering Rapp, skördare

Resulterar i produktionsresultat med resultatundertypen Sortiment. Med Rapp går det att välja de kombinationer av Producerat handelssortiment + Producerat för mottagningsplats som förekommer på det aktuella  produktionsunderlaget. Det blir ett produktionsresultat per sådan kombination. Produktionsresultaten innehåller summerad volym per handelssortiment, inga uppgifter på stocknivå. 

Produktionsrapportering Rapp, skotare

Resulterar i produktionsresultat med resultatundertypen Sortiment. Med Rapp går det att välja de kombinationer av Producerat handelssortiment + Producerat för mottagningsplats som förekommer på det aktuella produktionsunderlaget samt vilket avlägg från avtalsobjektet som skotningen skett till. Det blir ett produktionsresultat per sådan kombination.

Kvantitetsrapportering

Resulterar i ett produktionsresultat med resultattypen Kvantitet och resultatundertypen Sortiment. Vilka handelssortiment respektive avlägg som går att rapportera styrs av uppgifter på det aktuella avtalsobjektet i stället för produktionsunderlaget. Ytterligare beskrivning av kvantitetsrapportering finns i separat handbok.

Kvalitet skördare

StanForD2010-format hqc och StanForD-classicformat ktr. Det skapas ett resultat för varje kontrollstam i filen. På resultatet kan det finnas en, två eller tre mätningar beroende på vad som rapporteras. Första mätningen (M1) avser maskinens mätning, andra mätningen (M2) förarens kontrollmätning och tredje mätningen (M3) revisorns (kvalitetsteknikerns) kontrollmätning. Samma kontrollstam kan rapporteras flera gånger där den kompletteras med fler mätningar för varje gång. Förutom detta lagras uppgifter om vilka kalibreringar av längd- respektive diametermätningen som skett i maskinen. Dessa lagras separat och inte tillsammans med kontrollstammen. Kalibreringsuppgifter presenteras inte i produktionssystemet men kan följas i Rapportportalen.

Varifrån uppgifter på produktionsresultat hämtas i insända StanForD-filer

En beskrivning av vilka uppgifter som lagras på produktionsresultat och varifrån dessa hämtas i StanForD-filer finns beskrivet i dessa dokument.

Skotarens produktion
Biometria-regler vid tolkning av fpr.

Skördarens produktion
Biometria-regler vid tolkning av hpr.

Uppföljning av Skördarens mätkvalitet
Biometria-regler vid tolkning av hqc.

Dokumenten finns åtkomliga bland Biometrias integrationsspecifikationer.

Hantering av slutsignal vid produktionsrapportering

En skördare eller skotare kan rapportera att skördning eller skotning är klar på objektet. Denna uppgift lagras på produktionsresultaten som genereras från den rapporteringen. Men det skapas även nya produktionsresultat, utan någon volym, med slutsignalen för de handelssortiment som maskinen tidigare har rapporterat på objektet. Detta för att alla aktörer som är intressenter av vad som produktionsrapporteras ska få kännedom om att alla producerade handelssortiment på objektet är slutskördade eller slutskotade, även om inte alla handelssortiment förekommer med kvantitet i den sista rapporteringen.

Specifika handelssortiment och produkter vid produktionsrapportering

Produktionsresultat som genereras vid produktionsrapportering får i de allra flesta fall ett Producerat handelssortiment som hämtats från en av de produktdefinitioner som skördaren använder vid apteringen. Det sammanfaller då ofta också med det handelssortiment som destineras och sedan mäts in vid industrin. Det förekommer dock ett antal handelssortiment och produkter som är mer specifikt knutna till själva produktionsrapporteringen. Vissa genereras av Biometria vid tolkningen av den insända filen medan andra behöver finnas med i produktdefinition i en skördaren använder.

Titta på innehållet i ett produktionsresultat

Vad som lagrats på ett enskilt produktionsresultat går att titta på i gränssnitten Rätta och Korrigera som nås via menyn. I Rätta visas de produktionsresultat som är avvisade och därmed inte heller förmedlats vidare externt via  integration eller till rapportportalen. I Korrigera visas den senaste versionen av godkända produktionsresultat. Produktionsresultatets Redovisningstidpunkt visar när den aktuella versionen blev godkänd.

Gemensamt för både Rätta och Korrigera är att uppgifterna presenteras uppdelade i ett antal olika ”sektioner” som kan öppnas och stängas. Vilka sektioner som finns beror på vilken resultattyp och resultatundertyp produktionsresultatet har.

ID

Innehåller en blandning av uppgifter som hämtas från förstaledskontrakt och avtalsobjektet som produktionsresultatet tillhör och uppgifter från rapporteringen.

Objektsidentitet

Objektets identitet i den insända StanForD-filen.

DelobjektID

Identiteten på delobjektet i den insända StanForD-filen. Uppgiften är inte obligatorisk.

Starttidpunkt

Objektets starttid i den insända StanForD-filen. För produktionsresultat från Rapp sätts starttidpunkt till samma som maskinens första rapportering på avtalsobjektet.

Mättidpunkt

Mättidpunkt för ett produktionsresultat är vid filinsändning detsamma som tidpunkten när den insända filen sparades av skördaren eller skotaren. För produktionsresultat som skapats med hjälp av Rapp är det tidpunkten för när registreringen gjordes.

Skotarstatus avtalsobjekt respektive Skördarstatus avtalsobjekt

Signal från skördaren eller skotaren att rapporteringen på avtalsobjektet är avslutat.

Utförande avverkningsföretag skördare

Företaget som utfört skördningen på objektet. Hämtas från uppgift i den insända filen för produktionsresultat skördare. Hämtas från produktionsunderlaget om den angivits där för produktionsresultat skotare. För produktionsresultat rapporterade med Rapp från vald maskin i maskinregistret.

Utförande avverkningsföretag skotare

Företaget som utfört skotningen på objektet. Hämtas från uppgift i den insända filen för produktionsresultat skotare. Hämtas från produktionsunderlaget om den angivits där för produktionsresultat skördare. För produktionsresultat rapporterade med Rapp från vald maskin i maskinregistret.

Ersättningsgrundande skördarmätning

Visar om maskinen är godkänd för att användas för ersättningsgrundande skördarmätning. Lagras på produktionsresultat skördare. Uppgiften hämtas från maskinregistret.

Mätnoggrannhet

Visar om maskinen är uppfyller kraven i instruktionen för mätnoggrannhet. Lagras på produktionsresultat skördare. Uppgiften hämtas från maskinregistret.

Revisorsföretag

Aktören som följer upp mätnoggrannheten för maskinen och bedömt om den uppfyller kraven. Lagras på produktionsresultat skördare. Uppgiften hämtas från maskinregistret.

Revisor

Aktören som följer upp mätnoggrannheten för maskinen och bedömt om den uppfyller kraven. Lagras på produktionsresultat skördare. Uppgiften hämtas från maskinregistret.

Producerat handelssortiment

En sektion som finns på produktionsresultat med resultatundertypen sortiment. Innehåller uppgifter och summerad kvantitet i olika enheter för vad som skördats eller skotats. Det är bland annat Producerat handelssortiment, Producerat för mottagningsplats, Produktklass (Produkt-ID), Produktversion och ProductUser-ID. I denna sektion visas även vilka aktörer i olika roller som hämtas från den produktionsunderlagsrad som produktionsresultatet matchats mot och därmed fått behörighet till det. Det visas också om produktionsresultatet har kompletterats med Destinerad mottagare från destineringen.

Volym m3f (omvandlad)

Kvantiteten utryckt i m3 fub. I de fall rapportering har skett i m3 fub är det samma som Volym m3f (rapporterad). I de fall rapportering enbart skett i annan enhet är den omräknad till m3 fub via omräkningstal för handelssortimentet registrerat i Biometria masterdataregister.

Stock

Förekommer på produktionsresultat skördare resultatundertyp Sortiment från filinsändning. Innehåller uppgifter som lagrats på varje enskild stock.

Stam

Förekommer på produktionsresultat skördare resultatundertyp Stam. Innehåller uppgifter som lagrats på varje enskild stam i produktionsresultatet.

Lass

Förekommer på produktionsresultat skotare resultatundertyp Lass. Innehåller uppgifter som lagrats på varje enskilt lass i produktionsresultatet.

Maskin

Innehåller uppgifter om maskinen som rapporterat produktionsresultatet. För produktionsresultat genererade från filinsändningar är det uppgifter om maskinen som finns i den insända filen som lagras. För produktionsresultat genererade med hjälp av Rapp hämtas uppgifterna från maskinregistret.

Allmänt

Innehåller bland annat uppgift om vilken fil som produktionsresultatet är genererat från.

Rätta, Korrigera eller Makulera produktionsresultat

I gränssnittet Rätta går det att se och rätta till uppgifter i produktionsresultat som blivit avvisade på grund av att de fastnat i kontroller av verksamhetsregler som finns definierade. Att ett produktionsresultat blir avvisat kan antingen bero på att något i rapporteringen blivit fel eller att uppgifterna i det inte matchar någon produktionsunderlagsrad med samma kombination av Producerat handelssortiment och Producerat för mottagningsplats.
Beror avvisningen på felaktigheter i produktionsresultatet kan de rättas till i Rättagränssnittet. Beror avvisningen på att det saknas en produktionsunderlagsrad som matchar det avvisade produktionsresultatet är det  produktionsunderlaget som ska kompletteras.

Gränssnittet för att Korrigera ett produktionsresultat liknar i stor utsträckning det för att Rätta avvisade produktionsresultat. Funktioner beskrivs därför tillsammans här.

Sökfunktion

När gränssnittet öppnas listas alla produktionsresultat som användaren är behörig till. Grundsortering är att de med senast avvisningsdatum/redovisningsdatum hamnar överst. Omsortering kan ske genom att klicka i kolumnrubriken.

Förvalt för Rätta är att filtreringen är inställd på avvisningsdatum och för Korrigera på redovisningsdatum från och med den första i föregående kalendermånaden.

Är det många rader delas de upp i ett antal ”sidor” som det går att växla mellan med hjälp av pilarna längst ner.

I startbilden går det att göra en grov filtrering med rullningslisterna för Resultattyp och Resultatundertyp. Där går också göra sökning via ett fritextfält. En mer detaljerad filtrering går att göra i sökbilden som nås via knappen med förstoringsglas längst upp till höger.

För varje parameter går det där att ange inget eller ett val i listan som visas. Det går inte att göra filtrering på annat än vad som föreslås som alternativ.

Mätdatum

Datum från och med och Datum till och med. Mätdatum i produktionsresultat från insända filer är den insända filens spardatum. För produktionsresultat från Rapp är det tidpunkten för när det skapas.

Avvisningsdatum

Enbart aktuell i sökfunktionen för Avvisade produktionsresultat i Rätta. Datum från och med och Datum till och med. Avvisningsdatum är datumet produktionsresultatet blev avvisat. Startläge är från och med den första i föregående kalendermånad men det kan justeras.

Avvisningsorsak

Enbart aktuell i sökfunktionen för Avvisade produktionsresultat i Rätta. Orsak till att produktionsresultat avvisats. Anges med hjälp av standardiserade koder och klartexter. Ett produktionsresultat kan bli avvisat av flera orsaker.

Uppdragsgivare/Förste köpare

Uppdragsgivare är densamme som köparen på Förstaledskontraktet produktionsresultatet är kopplat till via avtalsobjektet.

Avtalsobjekt

Önskat alternativ visas genom att skriva in avtalsobjektnummer eller klartext på avtalsobjekt.

Redovisningsdatum

Enbart aktuell i sökfunktionen för godkända produktionsresultat i Korrigera. Redovisningsdatum är datumet när senaste versionen av produktionsresultatet blev godkänt. Startläge är från och med den första i föregående kalendermånad men det kan justeras.

Säljare

Säljare på tillhörande förstaledskontrakt. Önskat alternativ visas genom att skriva in namn (privatperson eller företag) eller huvudkod-internt nummer (företag).

Avtalsformer

Väljs bland alternativen i rullningslisten.

Maskinnummer

Uppdragsgivarens identitet på maskinen.

SDCID

Maskinens unika Biometria-identitet i maskinregistret.

Utförande avverkningsföretag skördare

Aktören som agerar med denna roll på ett produktionsresultat. Önskat alternativ visas genom att skriva in namn eller kod.

Utförande avverkningsföretag skotare

Aktören som agerar med denna roll på ett produktionsresultat. Önskat alternativ visas genom att skriva in namn eller kod.

Producerat handelssortiment

Det produktionsrapporterade handelssortimentet. Skriv in kod eller klartext för handelssortimentet. Önskat alternativ väljs bland alternativen som visas.

Producerat för mottagningsplats

Den produktionsrapporterade mottagningsplatsen. Skriv in kod eller klartext för mottagningsplatsen. Önskat alternativ väljs bland alternativen som visas.

Resultat-ID

Den unika identiteten på ett produktionsresultat.

Radnummer

Enbart aktuell i Korrigera. Produktionsunderlagets radnummer som produktionsresultatet matchat och blivit godkänt mot.

Fritext

Här går det att ange valfri uppgift som finns lagrad på ett produktionsresultat och använda det för filtrering. Observera att förutsättningen för att filtrering är att önskat val går att välja bland alternativen som föreslås.

Rätta ett avvisat produktionsresultat

I listan med avvisade produktionsresultat finns en kolumn Avorsak med en kod som beskriver anledningen. Genom att peka med markören över koden visas en mer förklarande text vad den betyder.

Med dubbelklick på raden med det avvisade produktionsresultatet öppnas det.

När ett giltigt värde har skrivits in i dessa fält tänds Spara-knappen nere till höger. När det sparas sker en ny kontroll om de nya uppgifterna i det är godkända. Ett rättat och godkänt produktionsresultat försvinner från listan med avvisningarna. Innehåller det fortfarande fel blir det avvisat på nytt och det blir ett meddelande under notifieringsklockan längst upp till höger i gränssnittet.

Om avvisningen beror på att det saknas en produktionsunderlagsrad som motsvarar innehållet i det avvisade produktionsresultatet räcker det att lägga till en matchande rad på produktionsunderlaget. När det skett behöver inte det avvisade produktionsresultaten sparas om utan kontrollen sker på nytt med automatik.

Rätta flera avvisade produktionsresultat

Det är möjligt att rätta samma uppgift på flera produktionsresultat samtidigt genom en massrättning. Vilka uppgifter som går att rätta på avvisade produktionsresultat beror på vilken resultattyp och resultatundertyp de har.

Om man vill tömma ett fält från innehåll i massrättningen markeras ”hänglås-tecknet” över fältet.

När rättningen är gjord trycker man på Spara-knappen. Klarar rättningen kontrollerna blir produktionsresultaten godkända och försvinner från de avvisade. Uppfylls inte kontrollen efter rättning förblir resultaten avvisade. Det skapas då också ett meddelande som är åtkomligt via notifieringsklockan längst upp till höger i gränssnittet.

Korrigera ett eller flera produktionsresultat

Korrigering av produktionsresultat görs på samma sätt som vid rättning. Det är enbart möjligt att korrigera uppgifter i fält som är aktiva i gränssnittet. Vid korrigering genomförs samma kontroller av innehållet som för nya produktionsresultat. Godkänns korrigeringen blir det en ny version av resultatet och redovisningsdatumet på det ändras till tidpunkten för korrigeringen. Godkänns inte korrigeringen i kontrollen behåller produktionsresultatet samma innehåll som det hade i senast godkända version. En misslyckad korrigering visas också som ett meddelande notifiering under notifieringsklockan längst upp till höger i gränssnittet.

Korrigering kan utföras på ett produktionsresultat i taget eller på flera samtidigt om samma uppgift ska korrigeras på flera produktionsresultat. Se beskrivning i kapitel 9.2 och 9.3.

Makulera produktionsresultat

Makulering av ett produktionsresultat innebär att resultatet tas bort och att innehållet i det försvinner i uppföljningar i Rapportportalen. Makulering av ett eller flera avvisade eller godkända produktionsresultat görs på
samma sätt som vid rättning eller korrigering med skillnad att i stället för att spara en ändring av innehållet i det används Makulera-knappen. Det är inte möjligt att ångra en makulering av ett produktionsresultat. Se beskrivning i kapitel 9.2 och 9.3.

Automatiska korrigeringar i produktionsresultat

Produktionsresultat med resultatundertypen Sortiment kompletteras automatiskt när den produktionsunderlagsrad som de matchats mot uppdateras med Destinerad mottagare eller  Logistikinformationsmottagare. Med uppdateringen får produktionsresultaten också en ny version och ett nytt redovisningsdatum.

Destinerad mottagare

När en produktionsunderlagsrad kompletteras med Destinerad mottagare enligt villkoren beskrivna i kapitel 5.6.1 skapas det en ny version av alla produktionsresultat som tidigare har matchats mot den produktionsunderlagsraden. Samtidigt tas eventuell Planerad mottagare bort på den nya versionen av produktionsresultaten.

Logistikinformationsmottagare

Om Logistikinformationsmottagare läggs till, ändras eller tas bort på ett avtalsobjekt och detta leder till en ändring på produktionsunderlaget skapas det en ny version av alla produktionsresultat som tidigare matchats mot produktionsunderlagsraderna som förändrats. Innehållet i den nya versionen motsvarar ändringen.

Produktionsstyrning

Med Produktionsstyrning avses funktionen att distribuera ut nya eller uppdaterade instruktionsmeddelanden i StanForD2010-format till skördare och skotare via Sender XC.

Produktionsstyrningsmeddelande kan laddas upp till Biometria via integration eller via gränssnittet i produktionssystemet. För åtkomst till detta gränssnitt krävs att användaren har beställt en utökad behörighet i form av systemrollen Produktionsstyrningsadministratör eller Produktionsstyrningsombud. Filer som laddas upp får endast ha filnamn som innehåller a-z, A-Z, 0-9 samt tecknen ”–” och ” _”. I filer som innehåller otillåtna tecken tas de otillåtna tecknen bort från filnamnet.

Adresserad produktionsstyrning

Ett eller flera instruktionsmeddelanden kan adresseras till en eller flera skogsmaskiner genom att i StanForD2010-envelope ange dess SDCID som adress i elementet TransmissionReceiver. Det är enbart StanForD2010-format som kan lagras som huvuddokument i ett StanForD2010-envelope. Andra filformat kan hanteras som bilagor.

Oadresserad produktionsstyrning

Produktinstruktioner (.pin) kan även förmedlas till skördare med hjälp av oadresserad produktionsstyrning. Med det menas att en uppladdade pin-fil förmedlas till alla maskiner som tidigare har rapporterat volymer på dess  ProductUser-ID. Grundinställningen är att pin-filen förmedlas till alla maskiner som rapporterat med det aktuella ProductUser-ID de senaste 2 månaderna.

Oadresserad produktionsstyrning kan ske antingen genom att direkt ladda upp en pin-fil eller genom att ladda upp den inuti ett oadresserat StanForD2010-envelope. Om ett oadresserat StanForD2010-envelope innehåller flera StanForD-meddelanden förmedlas samtliga till de maskiner som rapporterat volymer på något ProductUser-ID som förekommer.

Tidsgränsen för hur många månader bakåt sökning ska ske för att hitta rapporterande maskiner går att styra via ett extension-element ”MonthsMatching”. Maximal tidsgräns är 12 månader. Saknas detta element är det de senaste 2 månaderna som gäller.

Uppladdning av produktionsstyrningsmeddelande via gränssnittet

Gränssnittet för Produktionsstyrning nås via menyn i produktionssystemet av behöriga användare. Uppladdningsgränssnittet öppnas med knappen Skicka produktionsstyrningsfil längst ner till vänster.

När ett produktionsstyrningsmeddelande laddats upp i gränssnittet skickas det ett kvittensmejl till användaren som gjort uppladdningen. Det skickas även en kvittens till den mejladress som angivits i elementet Email under BusinessSender i den uppladdade env-filen. Kvittensmejlet beskriver i klartext resultatet av uppladdningen och vilka maskiner (SDCID) som produktionsstyrningsmeddelandena gjorts tillgängliga för. Bifogat finns även samma information lagrad i ett ena-meddelande som är StanForD2010-formatet för denna typ av kvittens.

Biometria har ingen funktion för att skapa adresserade eller oadresserade StanForD2010-envelope med de meddelanden som ska laddas upp för förmedling till maskiner via produktionsstyrning utan det måste ske i andra verktyg.

Uppföljning av produktionsstyrningsmeddelande via gränssnittet

En lista med tidigare uppladdningar visas i gränssnittet för produktionsstyrning. Denna visar i startläget namnet på den uppladdade filen, Status huruvida uppladdningen har gått bra, tidpunkt för uppladdningen samt vilken användare som gjort den och vilket företag denne tillhör.

Ett exempel på att en uppladdning inte fungerar är när man försökt adressera till ett SDCID som inte har Sender XC installerat.

Genom att dubbelklicka på en rad visas mer detaljerad information om den uppladdade  produktionsstyrningsfilen.

Förutom tidpunkten när uppladdning skett visas också i kolumnen Mottagen datum när meddelandet har laddats ner av den adresserade maskinens Sender XC.

För pin-filer visas också uppgift om vilket ProductUserID och Produktversion de innehåller för att underlätta identifieringen.

I detaljbilden finns möjlighet att se och ladda ner de produktionsstyrningsmeddelanden som förmedlats.

StanForD-filer

Under detta menyval går det att se och ladda ner StanForD-filer som rapporterats till Biometria som användaren är behörig till. Insända StanForD-filerna finns i de flesta fall lagrade i två olika varianter. Rådatafil är originalfilen med det format och innehåll den hade när den kom till Biometria. För StanForD-formaten som innehåller uppgifter om vad skördaren eller skotaren har producerat eller uppföljning av skördaren mätning skapas det dessutom en Analysfil med ett innehåll som bearbetats av Biometria.

*Schemavalideringen är inte strikt. Vissa formatfel i filerna som inte påverkar den väsentliga informationen i filen accepteras och är inte stoppande för att det ska skapas analysfiler. I dessa fall finns information lagrat om detta i analysfilen.

Behörighet till insända StanForD-filer

Utförande avverkningsföretag

Aktörer som agerar som Utförande avverkningsföretag i rapporteringen är behörig att se alla filer som rapporteras av deras maskiner; Skördad och skotad produktion, Skördares kvalitetsuppföljning samt driftsuppföljning.

Uppdragsgivare

Aktörer som agerar som uppdragsgivare till den rapporterande maskinen är behörig att se filer med skördad och skotad produktion samt skördares kvalitetsfil. Uppdragsgivaren är inte behörig till driftsuppföljningsfiler. 

Sökfunktion

Startbilden visar en lista med alla insända filer som användaren är behörig till sorterade så att de senaste hamnar överst. Förvalt är att det är filer insända från och med den första i föregående kalendermånad som kommer med. Är det många filer delas presentationen upp i sidor som det går att växla mellan i bildens nedre del. Med hjälp av rullningslisterna i startbilden går det att välja antingen Rådatafil eller Analysfil samt filtrera på rapporteringstyperna Skördare produktion, Skotare produktion, Skördare kvalitet samt Driftsrapportering. Det finns också ett fält för fritextsökning där valfritt sökbegrepp kan anges.

En mer detaljerad sökfunktion nås via knappen med förstoringsglas uppe till höger. I den går det att begränsa urvalet med hjälp av följande begrepp:

SDCID

Maskinens unika identitet.

Virkesordernummer

Viol-identiteten på ett objekt i VIOL 2. Observera att en StanForD2010-fil kan innehålla uppgifter från mer än ett objekt och virkesorder. Aktuell så länge VIOL 2 och VIOL 3 förekommer parallellt.

Avtalsobjektsnummer

Viol-identiteten på ett objekt i VIOL 3. Observera att en StanForD2010-fil kan innehålla uppgifter från mer än ett objekt och avtalsobjekt.

Uppdragsgivare huvudkod

Huvudkod för den insändande maskinens uppdragsgivare. I denna sökfunktion går det enbart att ange uppdragsgivare på huvudkodsnivå.

Utförande avverkningsföretag huvudkod

Huvudkod för utförande avverkningsföretag i den insända filen.

Inskicksdatum inom intervall

Möjlighet att begränsa perioden för när filerna skickats till Biometria med hjälp av Från och med- och Till och med- datum. Förvalt är från och med den första i föregående kalendermånaden.

Filändelse

Filändelse på den insända rådatafilen.

Källsystem

Aktuell så länge VIOL 2 och VIOL 3 finns i drift parallellt. Anger om den insända filen bearbetats i VIOL 2 eller VIOL 3.

Fritext

Fritextfält för utsökning.

Nedladdning av insända StanForD-filer

Filer som finns lagrade under StanForD-filer kan laddas ner till egen dator för egna analyser eller bearbetningar. Det gäller såväl Rådatafiler som Analysfiler.

Nedladdning av en enskild fil sker genom att markera raden i listan och trycka på knappen Ladda ner fil längst ner till höger. Den laddas då ner direkt till egen dator. 

Ska flera filer laddas ner i samtidigt markeras alla dessa i listan, antingen en rad i taget eller via plustecknet i kolumnrubriken för att få med samtliga rader listan. När önskat antal filer markerats trycker man på knappen Beställ nedladdning av … filer längst ner till höger. Det skapas då en beställning för nedladdning.

När den är klar får användaren ett e-postmeddelande samt ett meddelande under notifieringsklockan uppe till höger.

De nedladdade filerna hamnar i en komprimerad mapp under nedladdade filer. Denna måste först extraheras innan StanForD-filer i den går att analysera.

Metadatafil vid nedladdning av flera filer

Den nedladdade mappen innehåller även en metadata fil om vilka filer som finns samt vilka valideringsfel som resp fil innehåller. Namnet på metadatafilen är:
downloaded-files-metadata-<genererad-uid>.json

Schemat för metadatafilen ser ut enligt nedan. För mer information om resp valideringsfel se referens 1.

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "File of metadata for batch download",
"description": "List of metaadata per file on batch download",
"$defs": {
"whitelistErrorCodeEnum": {
"type": "string",
"enum": [
"STANFORD_VAL001",
"STANFORD_VAL002",
"STANFORD_VAL003",
"STANFORD_VAL004",
"STANFORD_VAL005",
"STANFORD_VAL006",
"STANFORD_VAL007",
"STANFORD_VAL008",
"STANFORD_VAL009",
"STANFORD_VAL010",
"STANFORD_VAL011",
"STANFORD_VAL012",
"STANFORD_VAL013",
"STANFORD_VAL014",
"STANFORD_VAL015",
"STANFORD_VAL016",
"STANFORD_VAL017",
"STANFORD_VAL018",
"STANFORD_VAL019",
"STANFORD_VAL020",
"STANFORD_VAL021"
]
},
"whitelistError": {
"type": "object",
"properties": {
"fileName": {
"type": "string"
},
"whitelistErrorCodes": {
"type": [ "array", "null" ],
"items": { "$ref": "#/$defs/whitelistErrorCodeEnum" }
}
},
"required": [ "fileName" ]
}
},
"type": "array",
"items": { "$ref": "#/$defs/whitelistError" }
}

Exempelfil:
Exempel på en nedladdning där 4 filer hämtats:

[{"FileName":"gpx100-sdcgpx0001-dc664a55_7e7c_4321_9f72_4deff7d7b6ae-X1.13-
testtisdag_STest_100_162_638482434566898925-kopia.hpr","WhitelistErrorCodes":[]},
{"FileName":"gpx100-sdcgpx0001-dc664a55_7e7c_4321_9f72_4deff7d7b6ae-X1.13-
testtisdag_STest_100_162_638482434566898925.hpr","WhitelistErrorCodes":[
"STANFORD_VAL019","STANFORD_VAL019","STANFORD_VAL019"]},
{"FileName":"gpx999-sdcgpx1234-6e1e88a8_9bad_4ca6_9049_7db109c7b215-X1.13.0-
C20240328090536.hqc","WhitelistErrorCodes":["STANFORD_VAL014"]},
{"FileName":"gpx999-sdcgpx1234-00000201_4071_2024_0301_000000000101-X1.11-StanForD3.5-2020-01-
14_1414_11714_testKalibrering4.hqc","WhitelistErrorCodes":["STANFORD_VAL004"]}]

Referenser

1. Appendix 2 StanForD-Biometria Technical Communication Guidelines for VIOL 3 1.0
http://www.biometria.se/ -> Viol3 -> Integrationer -> Integrationsspecifikationer